telegram-task-bot

Library to setup telegram bots with recurring tasks.

Usage

pip install telegram-task-bot

`.env` Variables

ALLOWED_USERS specifies the users which are allowed, if any, every one is allowed to use the bot.
BOT_TOKEN the token of the bot.
START_MESSAGE the message to be send as response to the start command.

Classes

There are several classes included in this Package.

Task

Base class for recurring tasks.

Configuration

job_name: str Name of the job defined in this task
disable_notifications: bool Disable notifications, flag send to the telegram server
generic: bool Defines if the task looks the same for each user
first_time:time First time to run the task, 0 is now takes a datetime.time
repeat_time: timedelta Defines the time between two executions of the job, takes datetime.timedelta
filename: str Filename under which data specific to this job should be saved

GenericTask

More specific class which adds the possiblity to get the actual value and implements user handling. The data is saved to a JSON file. The callback method ( callback(self, context: telegram.ext.CallbackContext)) must be implemented.

UrlTask

Extension of the GenericTask to simplify the usage for jobs calling a URL and returning the link/ response to the subscribers. It retries every 2 seconds until it gets a response.

This class adds a url field where the information lies.

The handle_response(self, response: Response) must be implemented to extract the data from the request and return the message string.

Example Project

https://github.com/bb4L/digitec_daily_bot

License

LGPLv3

Release files for telegram-task-bot 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for telegram-task-bot 0.1.2
File	Size	Uploaded
telegram-task-bot-0.1.2.tar.gz	9.5 kB	Nov 2, 2020	Details

Release files / telegram-task-bot-0.1.2.tar.gz

Download URL	telegram-task-bot-0.1.2.tar.gz
Size	9.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`942350ef466f60e8a0105f15f236df68596e4db0b40a460ee3628713a8071b5a`
BLAKE2b-256 checksum How to use checksums	`3f8ef8d32036819819ed824de84e935e2c8f65fead0d2791198429a27777e363`
Upload date	Nov 2, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.22.0 setuptools/49.3.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.5`