Skip to content

Writing TGPy programs in code editors

author Artyom Ivanov

Editing complex code without syntax highlighting or code autocompletion is inconvenient. If you write a large code snippet for TGPy, you will want to use a code editor instead of the message input field.

Of course, you can write code in an editor and then paste it to Telegram. However, editors will highlight TGPy-specific builtins as undefined and unknown-typed.

You can deal with this by annotating types of builtin variables.

Common TGPy builtins include client, msg, orig, and ctx. So, code with annotations will look like this:

from telethon import TelegramClient
from import Message
from tgpy.context import Context

client: TelegramClient
msg: Message
orig: Message
ctx: Context

# Custom code here

Write your code, copy it and paste to Telegram: this should work.

Unfortunately, editors won’t understand syntax tricks such as .await property-like notation, so you should use normal Python syntax.

By the way, normal Python syntax also forbids top-level await. To avoid syntax errors, you can wrap your code in an async function. Or give up on hacks and have half of your code underlined as errors.

Why not.