python-posthorn 0.3.0

Zero-dependency Python client for the Posthorn HTTP API

python-posthorn

Zero-dependency Python client for Posthorn's HTTP API.

Install locally

pip install -e ./python-posthorn

Basic usage

from python_posthorn import PosthornClient

client = PosthornClient(
    "http://localhost:8888",
    "your-api-key",
    default_path="/api/transactional",
)

response = client.send({"message": "hello"})
print(response)

[!NOTE] The endpoint path and required payload fields are configured per deployment and not fixed by this client. For example, the deployment at rootmab.monperrus.net:8088 exposes its send endpoint at /api/send and requires both message and subject_line:

client = PosthornClient(
    "http://rootmab.monperrus.net:8088",
    "your-api-key",
    default_path="/api/send",
)

response = client.send({"message": "hello", "subject_line": "Greetings"})

Check with the operator of your Posthorn instance for its configured path and required fields.

Features

• GET /healthz
• GET /metrics
• authenticated JSON send requests
• Idempotency-Key support
• typed 200 success and dry-run responses
• typed 422 validation errors
• explicit exception classes for 401, 409, 429, and 502