How rusik636/tigro works
Tigro is a Python microservice framework for Telegram bots. Its principal workflow converts Telegram messages or callbacks into correlated events, routes them to service handlers, collects response commands, and returns responses through RabbitMQ for the gateway to render and send. The graph also includes module composition, handler discovery/decorators, keyboard construction and rendering, and middleware extension points. The README documents service-side event handling, but the sampled sources do not show its broker consumer or complete runtime wiring; those links are documented rather than source-verified.
Main entry points: core.py Event router · aiogram_gateway.py Aiogram gateway · rpc.py RPC client · rabbit_bus.py Rabbit publisher
Components 17
Telegram gateway
- Aiogram gateway
tigro/gateway/aiogram_gateway.py
Broker messaging
- RPC client
tigro/gateway/rpc.py - RabbitMQ
- Rabbit publisher
tigro/transport/rabbit_bus.py - Event and response schemas
tigro/schemas.py - Shared response schema
shared/schemas.py
Service handlers
- Event router
tigro/core.py - Event matchers
tigro/matchers.py - Handler decorators
tigro/decorators.py - Handler discovery
tigro/discovery.py - Module routers
tigro/modules.py - Extension contracts
tigro/contracts.py
Responses and UI
- Handler context
tigro/core.py - Aiogram renderer
tigro/renderers/__init__.py - Keyboard DSL
tigro/keyboard.py
Other components
- Telegram user
- Telegram API
Connections 21
- Telegram user → Telegram API: sends update
README.md - Telegram API → Aiogram gateway: delivers update
README.md - Aiogram gateway → RPC client: calls RPC
tigro/gateway/aiogram_gateway.py - RPC client → RabbitMQ: publishes event
tigro/gateway/rpc.py - RPC client → RabbitMQ: subscribes responses
tigro/gateway/rpc.py - RabbitMQ → Event router: delivers event
README.md - Event router → Event matchers: matches routes
tigro/core.py - Handler decorators → Event matchers: registers matchers
tigro/decorators.py - Handler discovery → Event router: registers handlers
tigro/discovery.py - Module routers → Event router: combines routes
tigro/modules.py - Event router → Handler context: creates context
tigro/core.py - Event router → Rabbit publisher: dispatches responses
tigro/core.py - Rabbit publisher → RabbitMQ: publishes response
tigro/transport/rabbit_bus.py - Handler context → Event and response schemas: forms responses
tigro/core.py - Extension contracts → Event router: defines interfaces
tigro/core.py - Aiogram gateway → Event and response schemas: builds events
tigro/gateway/aiogram_gateway.py - Aiogram gateway → Aiogram renderer: renders markup
tigro/gateway/aiogram_gateway.py - Aiogram renderer → Telegram API: builds Telegram markup
tigro/renderers/__init__.py - Keyboard DSL → Aiogram renderer: provides markup
README.md - Aiogram gateway → Telegram API: sends response
tigro/gateway/aiogram_gateway.py - Shared response schema → Rabbit publisher: types responses
tigro/transport/rabbit_bus.py