telekit 2.2.0a2__tar.gz → 2.3.0b1__tar.gz

{telekit-2.2.0a2/telekit.egg-info → telekit-2.3.0b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.2.0a2
+Version: 2.3.0b1
 Summary: Declarative, developer-friendly library for building Telegram bots
 Home-page: https://github.com/Romashkaa/telekit
 Author: romashka
@@ -101,7 +101,8 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
     - [Dialogue](https://github.com/Romashkaa/telekit/blob/main/docs/examples/dialogue.md)
     - [Risk Game](https://github.com/Romashkaa/telekit/blob/main/docs/examples/risk_game.md)
     - [Counter](https://github.com/Romashkaa/telekit/blob/main/docs/examples/counter.md)
-    - [Quiz (Telekit DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
+    - [Quiz (DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
+    - [Hotel (DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/complete_hotel.md)
     - [More...](https://github.com/Romashkaa/telekit/blob/main/docs/examples/examples.md)
 
 ## Overview
@@ -378,29 +379,86 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.2.0a2
+# Changes in version 2.3.0b1
 
-## New Button Types
+## Traits
 
-| **Name**             | **Description**                                          |
-|----------------------|----------------------------------------------------------|
-| `AlertButton`        | A callback button that shows a popup alert when pressed. |
-| `NotificationButton` | A callback button that shows a notification.             |
+| **Name**                   | **Description**                                                       |
+| -------------------------- | --------------------------------------------------------------------- |
+| `TrackHandoffOrigin`  | Tracks which handler transferred control to this one via `handoff()`.      |
+| `PaginatedChoice`    | Adds a paginated inline keyboard for choosing from a list of items.        |
 
-## User Improvements
+### TrackHandoffOrigin
 
-| **Name**               | **Description**                                           |
-| ---------------------- | --------------------------------------------------------- |
-| `bio`                  | Bio of the user or description of the chat.               |
-| `birthdate`            | Birthdate of the user, if set and visible.                |
-| `description`          | Description of the group or channel.                      |
-| `mention`              | `tg://user?id=` deep link, works even without a username. |
-| `is_private`           | Whether the message was sent in a private chat.           |
-| `is_group`             | Whether the message was sent in a group.                  |
-| `is_supergroup`        | Whether the message was sent in a supergroup.             |
-| `is_channel`           | Whether the message was sent in a channel.                |
-| `avatar`               | File ID of the user's most recent profile photo.          |
-| `profile_photos_count` | Total number of profile photos the user has set.          |
+`TrackHandoffOrigin` adds three members to any handler that inherits it:
 
-- Refactor: `User` now accepts a `Message` object instead of `chat_id` + `from_user`. All properties are derived from `_sender` (`from_user` or `chat`) and migrated to `cached_property`. Fixed broken `get_id` and `get_full_name` references.
-- Added `__repr__`.
+| **Member**          | **Description**                                                                  |
+| ------------------- | -------------------------------------------------------------------------------- |
+| `handoff_origin`    | The handler instance that handed off to this one, or `None` if invoked directly. |
+| `is_handed_off`     | `True` if this handler was reached via `handoff()`, `False` otherwise.           |
+| `handoff_back()`    | Transfer control back to the origin handler via `self.handoff_origin.handle()`   |
+| `handoff_back_or(handler)` | Like `handoff_back()`, but falls back to `handler` on fail.               |
+
+Set `TRACK_HANDOFF_ORIGIN = False` on any subclass to opt out of tracking.
+
+```python
+class MyHandler(TrackHandoffOrigin, telekit.Handler):
+
+    def handle(self):
+        ...
+        self.chain.set_inline_keyboard({
+            "« Back": self.handoff_back_or(StartHandler)
+        })
+        self.chain.edit()
+```
+
+### PaginatedChoice
+
+Renders a paginated inline keyboard from any dict or iterable.
+Navigation buttons (`« Back`, `Next »`) are added automatically.
+
+| **Member**           | **Description**                                                              |
+| -------------------- | ---------------------------------------------------------------------------- |
+| `paginated_choice(choices, on_choice, on_update, row_width)` | Display a paginated choice keyboard. |
+
+```python
+self.chain.sender.set_title("🔤 What is your initial?")
+self.chain.sender.set_message("Pick the first letter of your name")
+self.chain.sender.set_remove_text(False)
+
+self.paginated_choice(
+    choices="ABCDEFGHIJKLMNOPQRSTUVWXYZ",
+    on_choice=self.handle_letter,
+    row_width=5
+)
+```
+
+<details>
+  <summary>(Click to see the result)</summary>
+  <table>
+    <tr>
+      <td><img src="https://github.com/Romashkaa/telekit/blob/main/docs/images/paginated_choice.png?raw=true" alt="Example" width="300"></td>
+    </tr>
+  </table>
+</details>
+
+`choices` accepts a `dict[str, T]`, or any `Iterable[T]`.
+If only one item is present, `on_choice` is called immediately without rendering a keyboard.
+
+## Utils
+
+| **Name**         | **Description**                                                    |
+| ---------------- | ------------------------------------------------------------------ |
+| `load_env`       | Load all key-value pairs from a `.env` file into a dictionary.     |
+| `read_env_var`   | Read a single variable by name from a `.env` file.                 |
+
+- `read_token` and `read_canvas_path` now support reading from `.env` files.
+  Pass `".env"` to use the default key, or `".env:KEY"` to specify a custom one:
+
+```python
+read_token(".env")                 # reads TOKEN
+read_token(".env:BOT_TOKEN")       # reads BOT_TOKEN
+
+read_canvas_path(".env")           # reads CANVAS_PATH
+read_canvas_path(".env:MY_CANVAS") # reads MY_CANVAS
+```

{telekit-2.2.0a2 → telekit-2.3.0b1}/README.md

@@ -65,7 +65,8 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
     - [Dialogue](https://github.com/Romashkaa/telekit/blob/main/docs/examples/dialogue.md)
     - [Risk Game](https://github.com/Romashkaa/telekit/blob/main/docs/examples/risk_game.md)
     - [Counter](https://github.com/Romashkaa/telekit/blob/main/docs/examples/counter.md)
-    - [Quiz (Telekit DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
+    - [Quiz (DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
+    - [Hotel (DSL)](https://github.com/Romashkaa/telekit/blob/main/docs/examples/complete_hotel.md)
     - [More...](https://github.com/Romashkaa/telekit/blob/main/docs/examples/examples.md)
 
 ## Overview

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/__init__.py

@@ -35,12 +35,14 @@ from . import parameters
 from . import inline_buttons
 from . import dices
 from . import utils
+from . import traits
 
 Styles = styles.Styles
 
 from ._version import __version__
     
 __all__ = [
+    "traits",
     "utils",
     "senders", 
     "types",

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/_chain.py

@@ -28,11 +28,8 @@ from telebot.types import Message
 from . import senders
 from .styles import TextEntity
 
-# Logging
-from ._logger import logger
-library = logger.library
-
 # Chain modules
+from ._chain_base import library
 from ._chain_inline_keyboards_logic import ChainInlineKeyboardLogic
 from ._chain_entry_logic import ChainEntryLogic, TextDocument
 

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/_chain_base.py

@@ -30,6 +30,10 @@ from . import senders
 from . import _input_handler
 from . import _timeout
 
+# Logging
+from ._logger import logger
+library = logger.library
+
 class ChainBase:
 
     bot: telebot.TeleBot
@@ -49,6 +53,8 @@ class ChainBase:
     def __init__(self, chat_id: int, *, previous_message: Message | None = None):
         self.chat_id = chat_id
         self.sender = senders.Sender(chat_id)
+        self.received = None
+        
         self._handler = _input_handler.InputHandler(chat_id)
         self._previous_message = previous_message
         self._timeout_handler = _timeout.TimeoutHandler()

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/_chain_entry_logic.py

@@ -68,6 +68,8 @@ class ChainEntryLogic(ChainBase):
         """
 
         def callback(message: Message) -> bool:
+            self.received = message
+
             if delete_user_response:
                 self.sender.delete_message(message, True)
 
@@ -154,6 +156,8 @@ class ChainEntryLogic(ChainBase):
         """
 
         def callback(message: Message) -> bool:
+            self.received = message
+
             if delete_user_response:
                 self.sender.delete_message(message, True)
 
@@ -246,6 +250,8 @@ class ChainEntryLogic(ChainBase):
         """
 
         def callback(message: Message) -> bool:
+            self.received = message
+
             if delete_user_response:
                 self.sender.delete_message(message, True)
 
@@ -340,6 +346,8 @@ class ChainEntryLogic(ChainBase):
         """
 
         def callback(message: Message) -> bool:
+            self.received = message
+
             if delete_user_response:
                 self.sender.delete_message(message, True)
 
@@ -453,6 +461,8 @@ class ChainEntryLogic(ChainBase):
         """
 
         def callback(message: Message) -> bool:
+            self.received = message
+
             if delete_user_response:
                 self.sender.delete_message(message, True)
 
@@ -592,6 +602,8 @@ class ChainEntryLogic(ChainBase):
         """
 
         def callback(message: Message) -> bool:
+            self.received = message
+            
             if delete_user_response:
                 self.sender.delete_message(message, True)
 

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/_chain_inline_keyboards_logic.py

@@ -32,7 +32,7 @@ from telebot.types import (
 
 from ._callback_query_handler import CallbackQueryHandler
 from ._inline_buttons import InlineButton, CallbackButton
-from ._chain_base import ChainBase
+from ._chain_base import ChainBase, library
 
 if typing.TYPE_CHECKING:
     from ._chain import Chain # only for type hints
@@ -151,15 +151,24 @@ class ChainInlineKeyboardLogic(ChainBase):
             buttons: list[InlineKeyboardButton] = []
 
             for index, (caption, value) in enumerate(keyboard.items()):
-                if enable_special_buttons and isinstance(value, InlineButton):
+                if enable_special_buttons and isinstance(value, InlineButton) and not isinstance(value, CallbackButton):
                     buttons.append(value._compile(caption))
                 else:
+                    if isinstance(value, CallbackButton):
+                        invoker = value.build_invoker(self._cancel_timeout_and_handlers)
+                    else:
+                        invoker = self._get_invoker_with_argument(func, value)
+
                     callback_data = CallbackQueryHandler.inline_button(f"{index}:{random.randint(1000, 9999)}")
-                    callback_functions[callback_data] = self._get_callback_with_argument(func, value)
+                    callback_functions[callback_data] = invoker
+
+                    kwargs: dict[str, Any] = getattr(invoker, "_kwargs", None) or {}
+
                     buttons.append(
                         InlineKeyboardButton(
                             text=caption,
-                            callback_data=callback_data
+                            callback_data=callback_data,
+                            **kwargs
                         )
                     )
 
@@ -242,18 +251,34 @@ class ChainInlineKeyboardLogic(ChainBase):
         buttons: list[InlineKeyboardButton] = []
 
         if not isinstance(choices, dict):
+            for c in choices:
+                if type(c).__str__ is object.__str__:
+                    library.warning(
+                        f"{type(c).__name__} does not implement __str__. "
+                        f"Consider passing a dict with explicit labels.",
+                        stacklevel=3
+                    )
             choices = {str(c): c for c in choices}
 
         for index, (caption, value) in enumerate(choices.items()):
-            if enable_special_buttons and isinstance(value, InlineButton):
+            if enable_special_buttons and isinstance(value, InlineButton) and not isinstance(value, CallbackButton):
                 buttons.append(value._compile(caption))
             else:
+                if isinstance(value, CallbackButton):
+                    invoker = value.build_invoker(self._cancel_timeout_and_handlers)
+                else:
+                    invoker = self._get_invoker_with_argument(func, value)
+
                 callback_data = CallbackQueryHandler.inline_button(f"{index}:{random.randint(1000, 9999)}")
-                callback_functions[callback_data] = self._get_callback_with_argument(func, value)
+                callback_functions[callback_data] = invoker
+
+                kwargs: dict[str, Any] = getattr(invoker, "_kwargs", None) or {}
+
                 buttons.append(
                     InlineKeyboardButton(
                         text=caption,
-                        callback_data=callback_data
+                        callback_data=callback_data,
+                        **kwargs
                     )
                 )
 
@@ -314,21 +339,21 @@ class ChainInlineKeyboardLogic(ChainBase):
 
         self.sender.set_reply_markup(markup)
 
-    def _get_callback_with_argument(self, func: Callable, argument: Any, query_answer: tuple[str, bool] | None = None) -> Callable[[CallbackQuery], None]:
-        def callback(call: CallbackQuery) -> None:
+    def _get_invoker_with_argument(self, callback: Callable, argument: Any, query_answer: tuple[str, bool] | None = None) -> Callable[[CallbackQuery], None]:
+        def invoker(call: CallbackQuery) -> None:
             self._cancel_timeout_and_handlers()
-            func(argument)
+            callback(argument)
             self._answer_callback_query(call, query_answer)
 
-        return callback
+        return invoker
     
-    def _get_callback(self, func: Callable[..., None], query_answer: tuple[str, bool] | None = None) -> Callable[[CallbackQuery], None]:
-        def callback(call: CallbackQuery):
+    def _get_invoker(self, callback: Callable[..., None], query_answer: tuple[str, bool] | None = None) -> Callable[[CallbackQuery], None]:
+        def invoker(call: CallbackQuery):
             self._cancel_timeout_and_handlers()
-            func()
+            callback()
             self._answer_callback_query(call, query_answer)
 
-        return callback
+        return invoker
     
     def _answer_callback_query(self, call: CallbackQuery, query_answer: tuple[str, bool] | None = None):
         if query_answer is None:
@@ -369,8 +394,4 @@ class ChainInlineKeyboardLogic(ChainBase):
                 rows.append(buttons[index:index + last_width])
                 index += last_width
 
-        return rows
-    
-    def _is_valid_telegram_callback(self, data: str) -> bool:
-        byte_size = len(data.encode('utf-8'))
-        return 1 <= byte_size <= 64
+        return rows

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/_handler.py

@@ -225,9 +225,16 @@ class Handler:
         
         handler_instance = handler(self.message)
         handler_instance.chain._set_previous_message(self.chain.get_previous_message())
+        handler_instance._on_handoff(self)
         
         return handler_instance
     
+
+    def _on_handoff(self, origin: "Handler") -> None:
+        """Called when this handler is reached via handoff(). Override to customize."""
+        pass
+    
+
     def freeze(self, func, *args):
         """
         Return a zero-argument callback that invokes the given function

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/_inline_buttons.py

@@ -36,6 +36,7 @@ __all__ = [
     "CallbackButton",
     "AlertButton",
     "NotificationButton",
+    "InvokeButton",
 
     "ButtonStyle"
 ]
@@ -56,8 +57,9 @@ class InlineButton:
     - `SuggestButton`
     - `CopyTextButton`
     - `CallbackButton`
-    - `AlertButton
-    - `NotificationButton
+    - `AlertButton`
+    - `NotificationButton`
+    - `InvokeButton`
     """
 
     _bot: TeleBot
@@ -76,6 +78,7 @@ class InlineButton:
     Callback: type["CallbackButton"]
     Alert: type["AlertButton"]
     Notification: type["NotificationButton"]
+    Invoke: type["InvokeButton"]
     
     Styles: type[ButtonStyle] = ButtonStyle
 
@@ -336,11 +339,11 @@ class CallbackButton(InlineButton):
 
         def __call__(self, call: CallbackQuery):
             self._invoke_chain_callback()
-            self._invoke_callback()
             self._answer_callback_query(call)
+            self._invoke_callback()
 
     def __init__(
-            self, 
+            self,
             callback: Callable[..., Any] | None, 
 
             pass_args: tuple | list | None = None, 
@@ -482,6 +485,130 @@ class NotificationButton(CallbackButton):
             style=style,
             **kwargs
         )
+
+class InvokeButton(CallbackButton):
+    """
+    An inline keyboard button that calls a named method on a given object when pressed.
+
+    Unlike `CallbackButton`, which takes a callable directly, `InvokeButton` resolves
+    the method at invocation time via `getattr(obj, invoke)`.
+
+    :param obj: The object on which the method will be called.
+    :type obj: `Any`
+
+    :param invoke: Name of the method to call on `obj`.
+    :type invoke: `str`
+
+    :param pass_args: Positional arguments to pass into the method.
+    :type pass_args: `tuple | list | None`
+
+    :param pass_kwargs: Keyword arguments to pass into the method.
+    :type pass_kwargs: `dict[str, Any] | None`
+
+    :param answer_text: Optional text to send as an answer to the callback query.
+    :type answer_text: `str | None`
+
+    :param answer_as_alert: If `True`, the answer is shown as a popup alert.
+        If `False`, it appears as a notification at the top of the chat.
+    :type answer_as_alert: `bool`
+
+    :param style: Style of the button. Must be one of `ButtonStyle.DANGER` (red),
+              `*.SUCCESS` (green) or `*.PRIMARY` (blue).
+              You can also pass these as string values: "danger", "success", "primary".
+              If omitted, an app-specific default style is used.
+    :type style: `str | ButtonStyle | None`
+
+    :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
+    :type kwargs: `Any`
+
+    Example::
+
+        self.chain.set_inline_keyboard({
+            "📖 My Deck": InvokeButton(self.handoff(DeckHandler), "handle"),
+        })
+    """
+    class _CallbackInvoker(CallbackButton._CallbackInvoker):
+        def __init__(
+                self,
+                chain_callback: Callable[[], None],
+                
+                obj: Any,
+                invoke: str,
+
+                pass_args: tuple | list | None = None, 
+                pass_kwargs: dict[str, Any] | None = None, 
+
+                answer_text: str | None = None,
+                answer_as_alert: bool = True,
+
+                style: str | None | ButtonStyle = None,
+
+                kwargs: dict[str, Any] = {}
+            ):
+            self._obj = obj
+            self._invoke = invoke
+
+            self._pass_args = pass_args
+            self._pass_kwargs = pass_kwargs
+
+            self._answer_text = answer_text
+            self._answer_as_alert = answer_as_alert
+
+            self._style = style
+
+            self._kwargs = {"style": style} | kwargs
+            
+            self._chain_callback: Callable[[], None] = chain_callback
+
+        def _invoke_callback(self):
+            obj: Any = self.__dict__["_obj"]
+            callback: Any = getattr(obj, self._invoke)
+            
+            args = self._pass_args or ()
+            kwargs = self._pass_kwargs or {}
+
+            callback(*args, **kwargs)
+
+    def __init__(
+            self, 
+            obj: Any,
+            invoke: str,
+
+            pass_args: tuple | list | None = None, 
+            pass_kwargs: dict[str, Any] | None = None, 
+            *,
+            answer_text: str | None = None,
+            answer_as_alert: bool = True,
+
+            style: str | None | ButtonStyle = None,
+
+            **kwargs
+        ):
+        self._obj = obj
+        self._invoke = invoke
+
+        self._pass_args = pass_args
+        self._pass_kwargs = pass_kwargs
+
+        self._answer_text = answer_text
+        self._answer_as_alert = answer_as_alert
+
+        self._style = self._normalize_style(style)
+
+        self._kwargs = kwargs
+        
+    def build_invoker(self, chain_callback: Callable[[], None]) -> _CallbackInvoker:
+        return self._CallbackInvoker(
+            chain_callback=chain_callback,
+            obj=self._obj,
+            invoke=self._invoke,
+            pass_args=self._pass_args,
+            pass_kwargs=self._pass_kwargs,
+            answer_text=self._answer_text,
+            answer_as_alert=self._answer_as_alert,
+            style=self._style,
+            kwargs=self._kwargs
+        )
     
 InlineButton.Link = LinkButton
 InlineButton.WebApp = WebAppButton
@@ -489,4 +616,5 @@ InlineButton.Suggest = SuggestButton
 InlineButton.CopyText = CopyTextButton
 InlineButton.Callback = CallbackButton
 InlineButton.Alert = AlertButton
-InlineButton.Notification = NotificationButton
+InlineButton.Notification = NotificationButton
+InlineButton.Invoke = InvokeButton

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/_telekit_dsl/mixin.py

@@ -368,7 +368,7 @@ class DSLHandler(telekit.Handler):
         if not hasattr(self, "_script_data_factory"):
             message: str = f"{type(self).__name__}().start_script(): Script is not analyzed yet. Call cls.analyze_file() or cls.analyze_string() before starting it."
             library.error(message)
-            self.chain.sender.pyerror(RuntimeError(message))
+            self.chain.sender.send_error("DSLError", message)
             return
 
         self.script_data = self._script_data_factory()
@@ -799,7 +799,7 @@ class DSLHandler(telekit.Handler):
     # ----------------------------------------------------------------------------
 
     def _fail(self, message: str, exception: type[Exception]=Exception):
-        self.chain.sender.error("🤷 Something went wrong...", message)
+        self.chain.sender.send_error("🤷 Something went wrong...", message)
         library.error(message)
         return exception(message)
         

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/_version.py

@@ -3,4 +3,4 @@
 # PyPI history: https://pypi.org/project/telekit/#history
 # ––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
 
-__version__ = "2.2.0a2"
+__version__ = "2.3.0b1"

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/example/example_handlers/entry.py

@@ -44,8 +44,12 @@ class EntryHandler(telekit.Handler):
     # Handling Logic
     # ------------------------------------------
 
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        self._user_data = UserData(self.user.id)
+
     def handle(self) -> None:
-        self._user_data = UserData(self.message.chat.id)
         self.chain.disable_timeout_warnings()
         self.entry_name()
 

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/example/example_handlers/pages.py

@@ -1,6 +1,7 @@
-import telebot.types
 import telekit
 
+from telekit.inline_buttons import CallbackButton
+
 source = """
 # Page Title
 
@@ -46,9 +47,12 @@ class PagesHandler(telekit.Handler):
         self.chain.sender.set_title("Simple Pages Example")
         self.chain.sender.set_message("Here are some common questions and answers to help you get started:")
 
-        @self.chain.inline_keyboard(pages)
-        def _(page: tuple[str, str]) -> None:
-            self.display_page(page)
+        self.chain.set_inline_choice(
+            self.display_page, 
+            pages | {
+                "« Back": CallbackButton(self.handoff_start)
+            }
+        )
 
         self.chain.disable_timeout_warnings()
         self.chain.edit()
@@ -60,4 +64,7 @@ class PagesHandler(telekit.Handler):
         self.chain.sender.set_message(page[1])
 
         self.chain.set_inline_keyboard({"« Back": self.display_home_page})
-        self.chain.edit()
+        self.chain.edit()
+
+    def handoff_start(self):
+        self.handoff("StartHandler").handle()

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/example/example_handlers/text_document.py

@@ -1,11 +1,10 @@
-from telebot.types import Message
 from telekit.types import (
     TextDocument, CopyTextButton, ParseMode
 )
 from telekit.styles import Quote, Escape
 import telekit
     
-class TextDocumentHandler(telekit.Handler):
+class TextDocumentHandler(telekit.traits.TrackHandoffOrigin, telekit.Handler):
 
     @classmethod
     def init_handler(cls) -> None:
@@ -26,6 +25,11 @@ class TextDocumentHandler(telekit.Handler):
             self.handle_text_document,
             allowed_extensions=(".txt", ".py", ".md", ".html")
         )
+        self.chain.set_inline_keyboard(
+            {
+                "« Back": self.handoff_back_or("StartHandler")
+            }
+        )
 
         self.chain.disable_timeout_warnings()
         self.chain.edit()

{telekit-2.2.0a2 → telekit-2.3.0b1}/telekit/inline_buttons.py

@@ -28,6 +28,7 @@ from ._inline_buttons import (
     CallbackButton,
     AlertButton,
     NotificationButton,
+    InvokeButton,
 )
 
 __all__ = [
@@ -41,4 +42,5 @@ __all__ = [
     "CallbackButton",
     "AlertButton",
     "NotificationButton",
+    "InvokeButton",
 ]