Python SDK

pip install superartifacts

import os

from superartifacts import SuperArtifacts

sa = SuperArtifacts(api_key=os.environ["SUPERARTIFACTS_API_KEY"])

print(sa.account.whoami()["handle"])

sa.artifacts.publish(
    slug="hello",
    prompt="A one-line hello page",
    html="<!doctype html><h1>Hello</h1>",
)

for artifact in sa.artifacts.list()["artifacts"]:
    print(artifact["slug"])

for row in sa.data.iter_artifact_rows(artifact="hello"):
    print(row)

import asyncio

from superartifacts import AsyncSuperArtifacts


async def main():
    async with AsyncSuperArtifacts() as sa:
        print(await sa.account.whoami())
        async for row in sa.data.iter_artifact_rows(artifact="hello"):
            print(row)


asyncio.run(main())

SuperArtifacts(
    api_key=None,  # or SUPERARTIFACTS_API_KEY
    base_url="https://superartifacts.app",
    timeout=60.0,  # seconds
    max_retries=2,
    http_client=None,  # your own httpx.Client; yours to close
)

page = sa.artifacts.publish(
    slug="launch-notes",
    title="Launch notes",
    prompt="A page of launch notes.",
    html="<h1>Launch notes</h1>",
)
print(page["url"])

from pathlib import Path

sa.artifacts.publish(
    slug="rsvp",
    prompt="An RSVP form.",
    html=Path("rsvp.html").read_text(),
    policy={
        "policyVersion": 1,
        "writes": "upsert",
        "perUser": "single",
        "read": "own",
        "retentionDays": None,
        "recordCap": {"perVisitor": 1, "perArtifact": 500},
        "fields": [
            {"name": "attending", "type": "boolean", "required": False, "pii": "none", "description": "Yes or no."},
        ],
    },
)

for row in sa.data.iter_artifact_rows(artifact="rsvp"):
    print(row)

sa.shares.add_to_artifact(
    artifact="launch-notes",
    emails=["dana@example.com"],
    role="commenter",
)

from superartifacts import NotFoundError

try:
    sa.artifacts.get(artifact="missing")
except NotFoundError as error:
    print(error.code, error.message)

for row in sa.data.iter_rows(dataset="signups"):
    print(row)
for row in sa.data.iter_artifact_rows(artifact="hello"):
    print(row)
for entry in sa.entries.iter(collection="posts"):
    print(entry)
for mention in sa.mentions.iter():
    print(mention)

staged = sa.uploads.upload({"images/hero.png": "./hero.png", "notes.txt": b"hello"})

sa.artifacts.publish(
    slug="hello",
    prompt="A page with a picture",
    html='<!doctype html><img src="images/hero.png">',
    uploads=staged["uploadId"],
)