contriwork-notifications 0.1.0

Multi-channel notification client (Pushover, Telegram, Slack, Discord, SMTP, iMessage on macOS) with retry, rate limit, and quiet-hours support.

contriwork-notifications (Python)

Python adapter for the ContriWork notifications port. One API surface, three languages (Python / .NET / npm) — this package is the Python implementation.

Cross-language specification, contract, and release history live in the GitHub repository:

• Root README — ecosystem overview
• CONTRACT.md — language-agnostic port spec
• CHANGELOG.md

Sister packages: Contriwork.Notifications (NuGet), @contriwork/notifications (npm).

Install

pip install contriwork-notifications

Requires Python ≥ 3.13.

Quick start

import asyncio
from contriwork_notifications import (
    NotificationClient, Severity, Payload, SlackWebhookAdapter,
)

client = NotificationClient([SlackWebhookAdapter(webhook_url="https://hooks.slack.com/...")])
result = asyncio.run(
    client.send(Severity.WARN, Payload(title="Build failed", body="See CI for details"))
)
print(result.ok, result.attempts)

For the full set of adapters (InMemoryAdapter, PushoverAdapter, TelegramAdapter, SlackWebhookAdapter, DiscordWebhookAdapter, SmtpAdapter) and the configuration knobs (NotificationConfig, RetryConfig, RateLimitPolicy, QuietHoursConfig), see CONTRACT.md.

Local development

uv sync --all-extras
uv run pytest
uv run ruff check
uv run mypy src

License

MIT — see LICENSE.