Asyncio

Not familiar with asyncio?

In order to send messages, get info about chats, and use other Telegram features through TGPy, you should understand Python asynchronous functions.

Basically, asynchronous function is a function that runs until completion while not blocking other code parts. It is a feature of modern Python versions.

Let’s say you need to use such function in your TGPy message. To do that, you should place the await keyword before: otherwise, the function won’t run.

result = await some_function()

This way the code snippet will be suspended until some_function() ends, but TGPy itself won’t stop (for instance, the code from another message may run at the same time.)

If you declare some function which uses asynchronous functions, your function must be asynchronous too; for that use async def instead of def.

To learn more about Python async/await, you may read explanation by Tiangolo written for FastAPI — or google something else about it :)

Asyncio in TGPy

You can use top-level async/await in TGPy code:

import asyncio

await asyncio.sleep(10)
print('Done!')

TGPy provides a shortcut to use await as an attribute:

import asyncio

asyncio.sleep(10).await
print('Done!')

In addition, TGPy automatically awaits the last returned value (if needed). Therefore, you may omit await in simple cases:

import asyncio 

asyncio.sleep(10)