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.15

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.15
File	Size	Uploaded
ix_notifiers-2.0.15.tar.gz	11.5 kB	Sep 19, 2026	Details

Built distribution (wheel)

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

Total release size: 22.8 kB

Release files / ix_notifiers-2.0.15.tar.gz

Download URL	ix_notifiers-2.0.15.tar.gz
Size	11.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`8eaa6519c46a4f972595e92490b9940ee4459d0f2c7a1ed9bf025b5550fdb676`
BLAKE2b-256 checksum How to use checksums	`7036dd3aa89c924788d49b8e6fe2b8c5111000c61d2d3b7d2670c10703989877`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.3.3 CPython/3.14.7 Linux/7.0.0-31-generic`

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

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