Modern visionary telegram bot framework.
Project description
telegrinder
— effective and reliable telegram bot building.
- Type hinted & type functional
- Customizable and extensible
- Fast models built on msgspec
- API client powered by fast wreq library
- Both low-level and high-level API
- Convenient dependency injection via nodes
-
A variety of state management tools
○ waiter machine for runtime inline short state funneling
○ state mutator to declare complex state sets
Basic example:
from telegrinder import API, Message, Telegrinder, Token
from telegrinder.modules import setup_logger
from telegrinder.rules import Text
setup_logger(level="INFO")
api = API(token=Token("123:token"))
bot = Telegrinder(api)
@bot.on.message(Text("/start"))
async def start(message: Message) -> None:
me = (await api.get_me()).unwrap()
await message.answer(f"Hello, {message.from_user.full_name}! I'm {me.full_name}.")
bot.run_forever()
Getting started
Install using pip, uv or poetry:
uv add telegrinder
poetry add telegrinder
pip install telegrinder
Or install from source (unstable):
uv add "telegrinder @ git+https://github.com/timoniq/telegrinder@dev"
poetry add git+https://github.com/timoniq/telegrinder@dev
pip install git+https://github.com/timoniq/telegrinder@dev
Documentation
Community
Join one of our forums.
License
Telegrinder is MIT licensed
Copyright © 2022 timoniq
Copyright © 2024 luwqz1
Contributors
We welcome your pull requests (contrubution notes). Telegrinder is built by the community
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file telegrinder-1.1.2.tar.gz.
File metadata
- Download URL: telegrinder-1.1.2.tar.gz
- Upload date:
- Size: 550.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
337c0166d294c116f0437bcfff4afbc5744a6eb0ec9aee6c6ed110f9f35d266c
|
|
| MD5 |
6f36064651abbf0bb3e94d5833a066b6
|
|
| BLAKE2b-256 |
99b940d985d3ddb8d6edc4716d38f717fc8804bda5bc9ce5c7d4ba601c0307a9
|
File details
Details for the file telegrinder-1.1.2-py3-none-any.whl.
File metadata
- Download URL: telegrinder-1.1.2-py3-none-any.whl
- Upload date:
- Size: 333.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f69eabb25f8e4b7dfc7891701425a26f190b40f888cfc14074ee380fe0c1a148
|
|
| MD5 |
3eb35ba1fef79bd21d1687c648410f93
|
|
| BLAKE2b-256 |
8472d2355bbc597084abfb607bd28a47548fa4a1ac527c48e53b75f3d8ee52a2
|
