anitya-telegram

Telegram gateway for Anitya release monitoring system

Getting started

Before running application, install dependencies:

pip install -r requirements.txt

Then make config.toml configuration file from config.toml.example. Gateway sets up via consumer_config sections.

Top level parameters are api_key and chat_ids:

• api_key is a Telegram's Bot API key, can be configured via ANITYA_TG_BOT_KEY environment variable;
• chat_ids is the chats identifiers which notifications send to.

Projects section consumer_config.projects consists of:

• id is a project ID from Anitya;
• versions is a versions filter, which filters versions by start of string;
• allow_nonstable - set true if you want receive notifications about non-stable releases too.

To run gateway execute the command below:

fedora-messaging --conf config.toml consume --callback-file anitya_tg_gw.py:TelegramForwardConsumer

Configuration file can be also set up via FEDORA_MESSAGING_CONF environment variable.

Docker

You can use docker images also:

docker pull harbor.smthd.com/anitya-telegram/anitya-telegram:latest

Development

Create virtual environment:

python -m venv .venv

Venv activation / deactivation on Windows:

.venv\Scripts\Activate.ps1
deactivate

To run tests execute the command below:

python -m unittest discover -v anitya_telegram\tests\

Links

• Release monitoring
• Integrating with Anitya
• Quick Start
• Consumers
• Using the API
• fedora-messaging
• Datagrepper - anitya.project.version.update.v2