robasedev 0.1.0

Official Robase.dev Python SDK — transactional email for Nigerian developers.

robasedev (Python)

Official Python SDK for Robase.dev — transactional email for Nigerian developers, API-compatible with Resend.

Install

pip install robasedev

Python 3.9+.

Quickstart

import os
from robasedev import Robase

client = Robase(api_key=os.environ["ROBASE_API_KEY"])

email = client.emails.send(
    from_="[e-mail]",
    to="[e-mail]",
    subject="Welcome",
    html="<p>Thanks!</p>",
)
print(email["id"])

Configuration

client = Robase(
    api_key="sk_live_...",
    base_url="https://api.robase.dev",  # override for self-hosted
    timeout=30.0,
    max_retries=2,                     # 5xx / 429 / transport errors
)

Use as a context manager to close the underlying httpx client automatically:

with Robase(api_key=...) as client:
    client.emails.send(...)

Sending

client.emails.send(
    from_="[e-mail]",
    to=["[e-mail]", "[e-mail]"],
    cc="[e-mail]",
    subject="Hi",
    html="<p>…</p>",
    text="fallback",
    reply_to="[e-mail]",
    headers={"X-Campaign": "spring"},
    tags={"campaign": "spring"},
    tracking={"opens": True, "clicks": True},
    attachments=[
        {"filename": "invoice.pdf", "content": b64_bytes, "content_type": "application/pdf"}
    ],
    scheduled_at="2026-05-01T09:00:00Z",
    idempotency_key="welcome-user-42",
)

Batch

out = client.emails.batch([
    {"from_": "[e-mail]", "to": "[e-mail]", "subject": "one", "text": "1"},
    {"from_": "[e-mail]", "to": "[e-mail]", "subject": "two", "text": "2"},
])
for item in out:
    if "error" in item:
        print("failed:", item["error"]["type"])
    else:
        print("queued:", item["id"])

Retrieve + cancel

client.emails.get("em_xyz")
client.emails.cancel("em_xyz")   # raises ValidationError if already sent

Errors

Class	HTTP
AuthenticationError	401
NotFoundError	404
ValidationError	422 — inspect err.type to branch
RateLimitError	429 (err.retry_after in seconds)
ServerError	5xx

The client retries ServerError, RateLimitError, and transport failures with exponential backoff + jitter.

Webhook verification

from robasedev import verify_webhook_signature

@app.post("/webhooks/robase")
async def hook(request):
    body = await request.body()  # raw bytes
    verify_webhook_signature(
        payload=body,
        header=request.headers["Robase-Signature"],
        secret=os.environ["ROBASE_WEBHOOK_SECRET"],
    )
    event = json.loads(body)
    ...

License

MIT.