Introduction

tgintegration is a Python library that helps you test your bots and automate routine tasks on Telegram Messenger. It does so by logging in as a user or interacting in your name using the popular Pyrogram library and mtproto.

See it in action

The Testing Pyramid

When writing software, it is almost always a good idea to have a number of tests for your code (this varies by the complexity of your project). What kinds of tests should be written typically follows the so-called "testing pyramid".

This guideline recommends to have a test suite consisting of a large base of unit tests, a fair number of integration tests, and only very few end-to-end (E2E) or manual tests. In this classification, tgintegration lies in the center and should be seen as a supplement to unit tests that cover the core logic of your bot.

By their nature, integration tests are slower since they interact with multiple systems over the network instead of everything happening on the same machine. The same is true for tgintegration, which reaches out to the Telegram servers to automate an interaction between two conversation partners.