ix-notifiers

A python library for sending one notification to several services at once.

Install

pip install ix-notifiers

Usage

Build a core, register the notifiers you want, then send. notify() returns True when at least one channel accepted the notification.

from ix_notifiers import IxNotifiers

notifiers = IxNotifiers()

# Each keyword is prefixed with the name of the notifier it belongs to. The prefix is
# stripped before the notifier sees it, so `gotify_token` arrives as `token`.
notifiers.register(
    "gotify",
    gotify_url="https://gotify.example.com",
    gotify_token="your-application-token",
    gotify_default_priority=5,
)
notifiers.register("null")

notifiers.notify(title="Deploy", message="finished")

Every core holds its own registry, so two cores in one process do not see each other's notifiers. Registering a name no notifier answers to logs a warning and registers nothing.

Notifiers

Discovery is by filename: every *_notifier.py in the package is available under the name in front of _notifier.

gotify

Posts to a Gotify server's /message endpoint.

Parameter	Mandatory	Default	Description
`gotify_url`	yes	-	base URL of the Gotify server
`gotify_token`	yes	-	application token, kept out of the logs
`gotify_content_type`	no	`text/markdown`	content type of the message body
`gotify_default_priority`	no	`0`	priority for messages that carry none

send() accepts title, message, priority and content_type. A field that is not given is left out of the request, and content_type overrides the default for that one message. A priority that will not convert to an integer is logged and the message is sent without one.

null

Logs the notification at info level and reports success. Useful for a dry run.

Writing a notifier

Add a <name>_notifier.py to the package with a Notifier subclass, a params declaration and a module-level start:

from typing import Any, ClassVar

from .notifier import Notifier


class WebhookNotifier(Notifier):
    """Posts a notification to a webhook."""

    params: ClassVar[dict[str, dict[str, Any]]] = {
        "url": {"mandatory": True, "type": "string"},
        "secret": {"mandatory": True, "redact": True, "type": "string"},
        "timeout": {"default": 10, "type": "integer"},
    }

    def send(self, **kwargs: Any) -> bool:
        """Sends the notification and reports whether it was accepted."""
        ...


start = WebhookNotifier.start

Each parameter declares a type of boolean, integer or string, and optionally mandatory, default and redact. The base class resolves them into self.settings:

a mandatory parameter has to be present, and a supplied 0, False or "" counts as present
an optional parameter falls back to its default, or to None where it declares none
a value of the wrong declared type is rejected, and an integer parameter rejects a boolean
a parameter marked redact has its value masked out of anything the notifier logs through self.redact()

Logging

Every module logs to the ix-notifiers logger and attaches no handler of its own, so the application decides where the records go.

Contributing

See CONTRIBUTING.md. Every change has to pass ruff check, ruff format --check, pylint and the test suite at 100% statement and branch coverage.

Metadata

Release files for ix-notifiers 2.0.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 ix-notifiers 2.0.0
File	Size	Uploaded
ix_notifiers-2.0.0.tar.gz	11.4 kB	Jul 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ix-notifiers 2.0.0
File	Interpreter	ABI	Platform	Reset
ix_notifiers-2.0.0-py3-none-any.whl 11.2 kB Jul 31, 2026	Python 3	none	any	Details

Total release size: 22.6 kB

Release files / ix_notifiers-2.0.0.tar.gz

Download URL	ix_notifiers-2.0.0.tar.gz
Size	11.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`22147dadb57bd2ac3358e927ff41568462819b719d8a765fb5b6fe558b81484a`
BLAKE2b-256 checksum How to use checksums	`aead856de5a1a3a2ddc0bea52a5a022f499479655f00c8e533fac0ed0d200fcd`
Upload date	Jul 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.3.3 CPython/3.14.5 Linux/7.0.0-28-generic`

Release files / ix_notifiers-2.0.0-py3-none-any.whl

Download URL	ix_notifiers-2.0.0-py3-none-any.whl
Size	11.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2ff5e7e5c40e05c37f3d44f4872f67dc1ca5895d6efd0f319235ac6d85a1e825`
BLAKE2b-256 checksum How to use checksums	`2ffa6c29531f1c50c8ca463b04a79221b3e55ed1d9d664a9ff75292e6e3c199d`
Upload date	Jul 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.3.3 CPython/3.14.5 Linux/7.0.0-28-generic`