sending-sdk 0.1.0

SDK Python ufficiale per l'API di Sending.dev (email + WhatsApp + Telegram)

sending-sdk

SDK Python ufficiale per l'API di Sending.dev (email + WhatsApp + Telegram).

I modelli Pydantic sono generati dallo spec OpenAPI; il client e' scritto a mano per la migliore DX.

Installazione

pip install sending-sdk

Si importa come sending:

from sending import Sending

Richiede Python >= 3.10.

Uso

from sending import Sending

client = Sending(api_key="sk_...")

# Email transazionale (accetta un dict oppure un modello Pydantic)
client.emails.send({
    "to": "[e-mail]",
    "from": "[e-mail]",
    "subject": "Benvenuto",
    "html": "<p>Ciao!</p>",
    "idempotencyKey": "welcome-001",
})

# Messaggio multi-canale
client.messages.send({
    "channel": "whatsapp",
    "to": "[phone]",
    "text": "Ciao!",
    "idempotencyKey": "wa-001",
})

Come context manager (chiude la connessione httpx):

with Sending(api_key="sk_...") as client:
    page = client.contacts.list(q="mario", page=1, page_size=50)
    print(page["total"], page["data"])

Client asincrono

Stessa API, su httpx.AsyncClient:

import asyncio
from sending import AsyncSending

async def main():
    async with AsyncSending(api_key="sk_...") as client:
        await client.emails.send({
            "to": "[e-mail]",
            "from": "[e-mail]",
            "subject": "Benvenuto",
            "html": "<p>Ciao!</p>",
            "idempotencyKey": "welcome-001",
        })
        page = await client.contacts.list(q="mario", page=1, page_size=50)
        print(page["total"])

asyncio.run(main())

Modelli tipizzati (opzionali)

from sending import models

body = models.SendEmailInput(
    to="[e-mail]", **{"from": "[e-mail]"},
    subject="Ciao", html="<p>Hi</p>", idempotencyKey="welcome-001",
)
client.emails.send(body)  # serializzato con gli alias corretti (es. "from")

Gestione errori

from sending import SendingError

try:
    client.emails.send({...})
except SendingError as err:
    print(err.status, err.code, err.body)

Risorse disponibili

emails · messages · events · campaigns · contacts · lists · tags · custom_fields · segments · domains · inboxes · email_rules · automations · webhooks · utm · integrations · usage.

Sviluppo

pip install -e ".[dev]"
python scripts/gen.py   # rigenera sending/models.py da openapi.json
pytest

Lo openapi.json viene copiato qui da pnpm openapi:generate (package @sending/openapi).