python-ntfy 0.3.8

An ntfy library aiming for feature completeness

A Python Library For ntfy

An easy-to-use python library for the ntfy notification service. Aiming for full feature support and a super easy to use interface.

Quickstart

1. Install using pip with pip3 install python-ntfy
2. Configure the following environment variables:
   • NTFY_USER: The username for your server (if required)
   • NTFY_PASSWORD: The password for your server (if required)
   • NTFY_SERVER: The server URL (defaults to https://ntft.sh)
3. Setup your application to use the library:

# Import the ntfy client
from python_ntfy import NtfyClient

# Create an `NtfyClient` instance with a topic
client = NtfyClient(topic="Your topic")

# Send a message
client.send("Your message here")

See the full documentation site at https://matthewcane.github.io/python-ntfy/.

Supported Features

• Username + password auth
• Access token auth
• Custom servers
• Sending plaintext messages
• Sending Markdown formatted text messages
• Retrieving cached messages
• Scheduled delivery
• Tags
• Action buttons

Future Features

• Email notifications
• Send to multiple topics at once

Testing and Development

This project uses:

• Poetry as it's dependency manager
• Ruff for linting and code formatting
• MyPy for static type checking
• Pre-Commit for running the above tools before committing

To install dev dependencies, run poetry install --with dev.

To install pre-commit hooks, run pre-commit install.

Linting, Formatting and Type Checking

These can be run with:

• poetry run ruff format
• poetry run ruff check
• poetry run mypy .

These tools are also run in the CI pipeline and must pass before merging.

Tests

This project is aiming for 95% code coverage. Any added features must include comprihensive tests.

Setup Steps

1. Start the test docker container with docker-compose -f tests/assets/test_containers.yml up
2. Run the tests with poetry run pytest --cov

The tests will sent messages to the python_ntfy_testing topic so you will need to view the web interface and subcribe to that topic to see the test messages.