paperclip-sdk 0.2.0

Public Python SDK for calling remote functions, with sync and async clients.

paperclip-sdk

Public Python SDK for calling Paperclip remote functions.

Install

poetry add paperclip-sdk

or

pip install paperclip-sdk

Configure authentication

export LEASEKEY_API_KEY="your-api-key"

Sync usage

from paperclip_sdk import PaperclipClient

with PaperclipClient(base_url="https://leasekey.org") as client:
    result = client.call("core.hello_world", name="Ada")
    print(result)

Async usage

import asyncio

from paperclip_sdk import AsyncPaperclipClient


async def main() -> None:
    async with AsyncPaperclipClient(base_url="https://leasekey.org") as client:
        result = await client.call("core.hello_world", name="Ada")
        print(result)


asyncio.run(main())

Function handles

from paperclip_sdk import PaperclipClient

with PaperclipClient(base_url="https://leasekey.org") as client:
    hello_world = client.function("core.hello_world")
    print(hello_world("Ada"))

Async function handles

import asyncio

from paperclip_sdk import AsyncPaperclipClient


async def main() -> None:
    async with AsyncPaperclipClient(base_url="https://leasekey.org") as client:
        hello_world = client.function("core.hello_world")
        print(await hello_world("Ada"))


asyncio.run(main())

Typed exceptions

from paperclip_sdk import (
    PaperclipAuthenticationError,
    PaperclipNotFoundError,
    PaperclipPermissionError,
    PaperclipRateLimitError,
    PaperclipServerError,
    PaperclipTransportError,
    PaperclipInvalidResponseError,
)

Notes

• The default base URL is https://leasekey.org, so passing base_url is optional.
• The SDK automatically sends User-Agent: paperclip-sdk/<version>.
• The SDK also sends X-Leasekey-SDK-Version: <version>.
• Built-in retry behavior covers retryable transport failures and these HTTP statuses: 408, 425, 429, 502, 503, 504.