Skip to main content

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:

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.

Metadata

Release files for contriwork-notifications 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for contriwork-notifications 0.1.0
File Size Uploaded Provenance Actions
contriwork_notifications-0.1.0.tar.gz 18.5 kB With provenance Details for contriwork_notifications-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for contriwork-notifications 0.1.0
File Interpreter ABI Platform Actions
contriwork_notifications-0.1.0-py3-none-any.whl Python 3 none any Details for contriwork_notifications-0.1.0-py3-none-any.whl

Total release size: 42.1 kB

Release files / contriwork_notifications-0.1.0.tar.gz

Download URL contriwork_notifications-0.1.0.tar.gz
Size 18.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3c976e22212a7c8f26ba6eb13472d8b6a0508f6c05d4626eb4696ee41ee7c893
BLAKE2b-256 checksum
How to use checksums
1d3ed74c290954ace94c7d48c083e0d2ef9c52587960f7ee2b467b8da96dcd39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 29, 2026.

Transparency log

Release files / contriwork_notifications-0.1.0-py3-none-any.whl

Download URL contriwork_notifications-0.1.0-py3-none-any.whl
Size 23.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8f8dbe9be37a1bd9375ed00f21e6223eb4f6e98b70efb255e76ef3e834dd4209
BLAKE2b-256 checksum
How to use checksums
c687d2f41bd9f81f55ba0da3cc06098f44dc8ff976a2d1f5c95a755371e7c229
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 29, 2026.

Transparency log

Security for contriwork-notifications 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for contriwork_notifications-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page