Metadata-Version: 2.4
Name: awesome-notify-bridge
Version: 0.1.5
Summary: Reusable Telegram and Discord notification helpers
Author: AFATAW Team
Project-URL: Homepage, https://github.com/trunghvbk-afataw/notify-bridge
Project-URL: Repository, https://github.com/trunghvbk-afataw/notify-bridge
Project-URL: Issues, https://github.com/trunghvbk-afataw/notify-bridge/issues
Keywords: discord,notifications,telegram,webhook
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == "dev"
Requires-Dist: pytest>=8.3.0; extra == "dev"
Requires-Dist: twine>=5.1.1; extra == "dev"

# awesome-notify-bridge

Reusable notification helpers for Telegram Bot API and Discord webhook.

- PyPI package: `awesome-notify-bridge`
- Import path: `notify_bridge`

## Install

```bash
pip install awesome-notify-bridge

```

For local development:

```bash
pip install -e .[dev]
```

## Usage

```python
from notify_bridge import send_discord_message, send_telegram_message

send_discord_message(webhook_url="https://discord.com/api/webhooks/...", content="Hello from bot")
send_telegram_message(chat_id="-1001234567890", token="<bot-token>", text="Hello from bot")
```

## Project Links

- Repository: https://github.com/trunghvbk-afataw/notify-bridge
- Issues: https://github.com/trunghvbk-afataw/notify-bridge/issues

## Design Notes

- The package stays project-agnostic: no hardcoded env var names or app-specific wrappers.
- Each consuming project should map its own configuration into `send_telegram_message(...)` and `send_discord_message(...)`.
- Project-specific helpers such as `send_signal()` or `send_hourly()` should live outside this package.

## Release

Build and validate the package locally:

```bash
python -m pip install -e .[dev]
python -m pytest
python -m build
python -m twine check dist/*
```

Upload to PyPI after creating an API token:

```bash
python -m twine upload dist/*
```
