Welcome to Autoconv!
A Python package that help you build complex Telegram bot conversations with buttons, actions and much more.
This package is built over the awesome Python-Telegram-Bot!

Setup

You can find the package on PyPi (pip).

pip3 install telegram-autoconv

Requirements

• Python 3.9+
• python-telegram-bot 13+

Examples

I know you want examples, in fact there is a beautiful folder with some examples.
In the table below, you can find an example for every functions in the module.
In addition to that, there is a live Telegram bot to showcase every features, @AutoBot.

Function	Example	Documentation
add_keybord	keyboards.py	State
add_text	actions.py	State
add_dynamic_text	actions.py	State
add_action	actions.py	State
add_dynamic_keybord	keyboards.py	State
add_custom_keyboard	keyboards.py	State
add_dynamic_routes	keyboards.py	State
add_dynamic_list	dynamic_list.py	State
add_custom_handler	handlers.py	State
set_long_task	actions.py	State
add_refresh_auth	authorization.py	State
add_operation_buttons	keyboards.py	State
Conversation	conversation.py	Conversation
add_routes	conversation.py	Conversation
set_defaults	defaults.py	Conversation
add_authorized_users	authorization.py	Conversation
state_messages	texts.py	Texts Guide
set_timed_function	async.py	AutoConvHandler
stop_timed_function	async.py	AutoConvHandler
send_autodestroy_message	async.py	AutoConvHandler
restart	autoconv_handler.py	AutoConvHandler
force_state	autoconv_handler.py	AutoConvHandler
save	tdata.py	TelegamData
add	tdata.py	TelegamData
get_or_set	tdata.py	TelegamData

Persistence

If you want to use persistence in your bot, Autoconv provides a simple persistence based on PicklePersistence.
The normal PicklePersistence doesn't work, due to an instance of a Telegram.Message in the user_data, this persistence uses a workaround.

from autoconv.utils.persistence import AutoconvPersistence
persistence = AutoconvPersistence(filename="bot_persistence", bot_token=BOT_TOKEN)
updater = Updater(BOT_TOKEN, persistence=persistence)

WARNING! This persistence will save the bot token in a pickle file.

Documentation

Do you want to read? I got you cover, baby!
No more than a little documentation in the Wiki.

Real World Example

I have a simple movies info Telegram bot publicy available.
You can interact with the Bot (the response time it kinda high, caused by very slow connection) PopCorn (sorry for the italian).
The code (except for the config files) is in this GIST.

---

Do you want to help me?

If you want to contribute you are welcome! I don't have guidelines for now, but contact me on Telegram @Mortafix.
If you want to donate, thank you so much for your support!