Python SDK

uv run --project sdks/python python -c "from elanotes import Client; print(Client)"

import os
from elanotes import Client

with Client("https://api.elanotes.com", token=os.environ["ELA_API_TOKEN"]) as client:
    results = client.search_notes("Paddle", limit=5)
    print(results["results"][0]["provenance"]["slug"])

import uuid
import os
from elanotes import Client

with Client("https://api.elanotes.com", token=os.environ["ELA_API_TOKEN"]) as client:
    receipt = client.write_note(
        "agents/hello.md",
        "---\ntitle: Hello\n---\n\n# Hello\n",
        agent_id="readme",
        idempotency_key=str(uuid.uuid4()),
    )
    if receipt["status"] == "queued":
        print("Pending human review:", receipt["pending_id"])
    elif receipt["status"] == "applied":
        print(receipt["slug"], receipt["version_id"])

import os
from elanotes import Client, ElanotesError

with Client("https://api.elanotes.com", token=os.environ["ELA_API_TOKEN"]) as client:
    note = client.read_note("hello")
    try:
        client.edit_note(
            "hello",
            version_id=note["version_id"],
            old_string="Hello",
            new_string="Hello again",
            agent_id="readme",
        )
    except ElanotesError as exc:
        if exc.reason == "VERSION_MOVED":
            print(exc.hint)
            note = client.read_note("hello")
            client.edit_note(
                "hello",
                version_id=note["version_id"],
                old_string="Hello",
                new_string="Hello again",
                agent_id="readme",
            )