telekit 2.2.0a2__tar.gz → 2.3.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.2.0a2
+Version: 2.3.0
 Summary: Declarative, developer-friendly library for building Telegram bots
 Home-page: https://github.com/Romashkaa/telekit
 Author: romashka
@@ -77,7 +77,7 @@ Telekit comes with a [built-in DSL](https://github.com/Romashkaa/telekit/blob/ma
 
 > See the [full example](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
 
-Even in its beta stage, Telekit accelerates bot development, offering typed command parameters, text styling via `Bold()`, `Italic()`, built-in emoji game results for `🎲 🎯 🏀 ⚽ 🎳 🎰`, and much more out of the box. Its declarative design makes bots easier to read, maintain, and extend.
+Even in its beta stage, Telekit accelerates bot development, offering typed command parameters, text styling via `Bold()`, `Italic()`, a built-in declarative calendar picker, emoji game results for `🎲 🎯 🏀 ⚽ 🎳 🎰`, and much more out of the box. Its declarative design makes bots easier to read, maintain, and extend.
 
 **Key features:**  
 - Declarative bot logic with **chains** for effortless handling of complex conversations
@@ -85,6 +85,7 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
 - Automatic handling of [message formatting](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/6_styles.md) via [Sender](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/5_senders.md) and **callback routing**
 - **Deep Linking** support with type-checked [Command Parameters](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/command_trigger_parameters.md) for flexible user input
 - Built-in **Permission** and **Logging** system for user management
+- Reusable **Traits** system for pluggable, self-contained behavior modules
 - Seamless integration with [pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI)
 - Fast to develop and easy-to-extend code
 
@@ -101,7 +102,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
@@ -347,6 +349,42 @@ telekit.Server(BOT_TOKEN).polling()
 
 You can find a [full quiz example](https://github.com/Romashkaa/telekit/blob/main/docs/examples/complete_hotel.md) and [DSL reference](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial/11_telekit_dsl.md) in the repository.
 
+### Traits
+
+Traits are reusable behavior modules you can mix into any handler.
+
+This example demonstrates the simplest way to use the built-in CalendarPick trait. It allows a user to pick a date from an inline calendar and handles the result via a callback.
+
+```py
+from telekit.traits import CalendarPick
+
+class CalendarHandler(CalendarPick, telekit.Handler):
+
+    @classmethod
+    def init_handler(cls) -> None:
+        cls.on.command("calendar").invoke(cls.handle)
+
+    def handle(self) -> None:
+        self.chain.sender.set_title("📅 Choose a date")
+        self.chain.sender.set_message("Select any date — past or future:")
+        self.chain.sender.set_remove_text(False)
+
+        self.calendar_pick(self.handle_date) # HERE
+
+    def handle_date(self, date: datetime.date) -> None:
+        self.chain.sender.set_text(f"You picked: {date}")
+        self.chain.send()
+```
+
+<details>
+  <summary>Result</summary>
+  <table>
+    <tr>
+      <td><img src="./docs/images/calendar.png" alt="Telekit Calendar Example" width="500"></td>
+    </tr>
+  </table>
+</details>
+
 ### Example Bot
 
 You can launch an example bot by **running the following code**:
@@ -367,6 +405,7 @@ It includes example commands, dialogs, keyboards, and style usage.
 - **Styles API** for rich text (`Bold`, `Italic`, `Links`) with **automatic escaping**.
 - Deep linking and **typed command parameters**.
 - **Built-in DSL** for menus, FAQs, and simple bots.
+- Reusable **Traits** for composable, plug-and-play behavior (for example, a built-in declarative calendar picker).
 - **Zero-code** [Obsidian Canvas](https://github.com/Romashkaa/telekit/blob/main/docs/examples/canvas_faq.md) mode.
 - Seamless integration with **pyTelegramBotAPI**.
 
@@ -378,29 +417,6 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.2.0a2
-
-## New Button Types
-
-| **Name**             | **Description**                                          |
-|----------------------|----------------------------------------------------------|
-| `AlertButton`        | A callback button that shows a popup alert when pressed. |
-| `NotificationButton` | A callback button that shows a notification.             |
-
-## User Improvements
-
-| **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.          |
+# Changes in version 2.3.0
 
-- 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__`.
+[View changelog on GitHub](https://github.com/Romashkaa/telekit/blob/main/CHANGELOG.md)

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

@@ -41,7 +41,7 @@ Telekit comes with a [built-in DSL](https://github.com/Romashkaa/telekit/blob/ma
 
 > See the [full example](https://github.com/Romashkaa/telekit/blob/main/docs/examples/quiz.md)
 
-Even in its beta stage, Telekit accelerates bot development, offering typed command parameters, text styling via `Bold()`, `Italic()`, built-in emoji game results for `🎲 🎯 🏀 ⚽ 🎳 🎰`, and much more out of the box. Its declarative design makes bots easier to read, maintain, and extend.
+Even in its beta stage, Telekit accelerates bot development, offering typed command parameters, text styling via `Bold()`, `Italic()`, a built-in declarative calendar picker, emoji game results for `🎲 🎯 🏀 ⚽ 🎳 🎰`, and much more out of the box. Its declarative design makes bots easier to read, maintain, and extend.
 
 **Key features:**  
 - Declarative bot logic with **chains** for effortless handling of complex conversations
@@ -49,6 +49,7 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
 - Automatic handling of [message formatting](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/6_styles.md) via [Sender](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/5_senders.md) and **callback routing**
 - **Deep Linking** support with type-checked [Command Parameters](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/command_trigger_parameters.md) for flexible user input
 - Built-in **Permission** and **Logging** system for user management
+- Reusable **Traits** system for pluggable, self-contained behavior modules
 - Seamless integration with [pyTelegramBotAPI](https://github.com/eternnoir/pyTelegramBotAPI)
 - Fast to develop and easy-to-extend code
 
@@ -65,7 +66,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
@@ -311,6 +313,42 @@ telekit.Server(BOT_TOKEN).polling()
 
 You can find a [full quiz example](https://github.com/Romashkaa/telekit/blob/main/docs/examples/complete_hotel.md) and [DSL reference](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial/11_telekit_dsl.md) in the repository.
 
+### Traits
+
+Traits are reusable behavior modules you can mix into any handler.
+
+This example demonstrates the simplest way to use the built-in CalendarPick trait. It allows a user to pick a date from an inline calendar and handles the result via a callback.
+
+```py
+from telekit.traits import CalendarPick
+
+class CalendarHandler(CalendarPick, telekit.Handler):
+
+    @classmethod
+    def init_handler(cls) -> None:
+        cls.on.command("calendar").invoke(cls.handle)
+
+    def handle(self) -> None:
+        self.chain.sender.set_title("📅 Choose a date")
+        self.chain.sender.set_message("Select any date — past or future:")
+        self.chain.sender.set_remove_text(False)
+
+        self.calendar_pick(self.handle_date) # HERE
+
+    def handle_date(self, date: datetime.date) -> None:
+        self.chain.sender.set_text(f"You picked: {date}")
+        self.chain.send()
+```
+
+<details>
+  <summary>Result</summary>
+  <table>
+    <tr>
+      <td><img src="./docs/images/calendar.png" alt="Telekit Calendar Example" width="500"></td>
+    </tr>
+  </table>
+</details>
+
 ### Example Bot
 
 You can launch an example bot by **running the following code**:
@@ -331,6 +369,7 @@ It includes example commands, dialogs, keyboards, and style usage.
 - **Styles API** for rich text (`Bold`, `Italic`, `Links`) with **automatic escaping**.
 - Deep linking and **typed command parameters**.
 - **Built-in DSL** for menus, FAQs, and simple bots.
+- Reusable **Traits** for composable, plug-and-play behavior (for example, a built-in declarative calendar picker).
 - **Zero-code** [Obsidian Canvas](https://github.com/Romashkaa/telekit/blob/main/docs/examples/canvas_faq.md) mode.
 - Seamless integration with **pyTelegramBotAPI**.
 

{telekit-2.2.0a2 → telekit-2.3.0}/setup.py

@@ -28,8 +28,7 @@ def readme():
         return f.read()
   
 def changelog():
-    with open('CHANGELOG.md', 'r') as f:
-        return f.read()
+    return f"[View changelog on GitHub](https://github.com/Romashkaa/telekit/blob/main/CHANGELOG.md)"
 
 def install_requires():
     with open('telekit/requirements.txt', 'r') as f:

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

@@ -18,6 +18,7 @@
 # 
 
 from ._handler import Handler
+from ._trait import Trait
 from ._chain import Chain
 from ._callback_query_handler import CallbackQueryHandler
 from .server import Server, example
@@ -35,12 +36,15 @@ from . import parameters
 from . import inline_buttons
 from . import dices
 from . import utils
+from . import traits
+from . import debug
 
 Styles = styles.Styles
 
 from ._version import __version__
     
 __all__ = [
+    "traits",
     "utils",
     "senders", 
     "types",
@@ -54,6 +58,7 @@ __all__ = [
 
     "Server", 
     "Chain", 
+    "Trait",
     "Handler", 
     "CallbackQueryHandler",
 
@@ -64,4 +69,5 @@ __all__ = [
     "enable_file_logging",
     "chapters",
     "example",
+    "debug",
 ]

{telekit-2.2.0a2 → telekit-2.3.0}/telekit/_callback_query_handler.py

@@ -40,15 +40,17 @@ class CallbackQueryHandler:
             bot (TeleBot): The Telegram bot instance to be used for sending messages.
         """
         cls.bot = bot
-        cls.user_button_callbacks: dict[int, dict[str, Callable[[telebot.types.CallbackQuery], None]]] = {}
+        cls.user_button_callbacks: dict[int, dict[str, Callable[[CallbackQuery], None]]] = {}
 
         @bot.callback_query_handler(func=lambda call: True)
-        def handle(call: telebot.types.CallbackQuery) -> None:
+        def handle(call: CallbackQuery) -> None:
             if not call.data:
                 return
             
             if call.data.startswith(cls.INLINE_BUTTON):
                 cls._handle_inline_button(call)
+            elif call.data.startswith(cls.STATIC_BUTTON):
+                cls._handle_static_button(call)
             elif call.data.startswith(cls.SUGGEST):
                 cls._handle_suggestion(call)
             else:
@@ -59,7 +61,7 @@ class CallbackQueryHandler:
     # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
 
     @classmethod
-    def _handle_inline_button(cls, call: telebot.types.CallbackQuery):
+    def _handle_inline_button(cls, call: CallbackQuery):
         if not call.data:
             cls.bot.answer_callback_query(call.id, text=cls._invalid_data_answer[0], show_alert=cls._invalid_data_answer[1])
             return
@@ -76,10 +78,19 @@ class CallbackQueryHandler:
             cls.bot.answer_callback_query(call.id, text=cls._button_is_no_active_answer[0], show_alert=cls._button_is_no_active_answer[1])
             return
 
-        cls.remove_user_button_callbacks(call.from_user.id)
+        if not getattr(callback, "_persistent", False):
+            cls.remove_user_button_callbacks(call.from_user.id)
         
         callback(call)
 
+    # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
+    # Static Buttons Handling
+    # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
+
+    @classmethod
+    def _handle_static_button(cls, call: CallbackQuery):
+        cls.bot.answer_callback_query(call.id, text="")
+
     # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
     # Suggestion Handling
     # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
@@ -87,7 +98,7 @@ class CallbackQueryHandler:
     @classmethod
     def _handle_suggestion(cls, call: CallbackQuery):
         text: str = str(call.data)[len(cls.SUGGEST):]
-        cls.simulate(call.message, text, from_user=call.from_user)
+        cls.simulate(call.message, text, from_user=call.from_user) # pyright: ignore[reportArgumentType]
         cls.bot.answer_callback_query(call.id)
 
     @classmethod
@@ -126,9 +137,10 @@ class CallbackQueryHandler:
     # Query Types
     # –––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
 
+    STATIC_BUTTON: str = "static_button"
     INLINE_BUTTON: str = "inline_button:"
     SUGGEST: str = "suggest:"
-
+    
     @classmethod
     def suggest(cls, suggestion: str):
         return f"{cls.SUGGEST}{suggestion}"

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

@@ -26,13 +26,11 @@ from telebot.types import Message
 
 # Local modules
 from . import senders
+from .debug import Debug
 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
 
@@ -157,7 +155,7 @@ class Chain(ChainInlineKeyboardLogic, ChainEntryLogic):
         self.sender.set_edit_message(None)
         self._previous_message = message
 
-        if self._timeout_warnings_enabled and _handler and not _timeout:
+        if Debug.timeout_warnings and _handler and not _timeout:
             library.warning(
                 "Next-message handler is active, but no timeout was set for the chain. "
                 "This may cause the bot to wait indefinitely."

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

@@ -30,11 +30,14 @@ from . import senders
 from . import _input_handler
 from . import _timeout
 
+# Logging
+from .debug import Debug
+from ._logger import logger
+library = logger.library
+
 class ChainBase:
 
     bot: telebot.TeleBot
-
-    _timeout_warnings_enabled: bool = True
     
     @classmethod
     def _init(cls, bot: telebot.TeleBot):
@@ -49,6 +52,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()
@@ -200,4 +205,5 @@ class ChainBase:
     # Timeout API
 
     def disable_timeout_warnings(self, value: bool = True) -> None:
-        self._timeout_warnings_enabled = not value
+        """.. deprecated:: Set ``Debug.timeout_warnings`` directly."""
+        Debug.timeout_warnings = not value

{telekit-2.2.0a2 → telekit-2.3.0}/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.0}/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
@@ -40,8 +40,7 @@ if typing.TYPE_CHECKING:
 class ChainInlineKeyboardLogic(ChainBase):
     def set_inline_keyboard(
             self, 
-            keyboard: dict[str, Callable[[], Any] | InlineButton | str], 
-            *,
+            keyboard: dict[str, Any], 
             row_width: int | Iterable[int] = 1
         ) -> None:
         """
@@ -118,7 +117,6 @@ class ChainInlineKeyboardLogic(ChainBase):
     def inline_keyboard[Caption: str, Value](
             self, 
             keyboard: dict[Caption, Value],
-            *,
             row_width: int | Iterable[int] = 1,
             enable_special_buttons: bool = True
         ) -> Callable[[Callable[[Value], None]], None]:
@@ -151,15 +149,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
                         )
                     )
 
@@ -174,7 +181,6 @@ class ChainInlineKeyboardLogic(ChainBase):
     def inline_choice(
             self, 
             choices: list[Any] | tuple[Any, ...] | dict[str, Any | InlineButton],
-            *,
             row_width: int | Iterable[int] = 1,
             enable_special_buttons: bool = True
         ) -> Callable[[Callable[[Any], None]], None]:
@@ -210,7 +216,6 @@ class ChainInlineKeyboardLogic(ChainBase):
             self,
             func: Callable[[Any], None],
             choices: list[Any] | tuple[Any, ...] | dict[str, Any | InlineButton],
-            *,
             row_width: int | Iterable[int] = 1,
             enable_special_buttons: bool = True
         ) -> None:
@@ -242,18 +247,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 +335,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 +390,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.0}/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.0}/telekit/_init.py

@@ -31,7 +31,7 @@ import telebot
 __all__ = ["init"]
 
 def init(bot: telebot.TeleBot) -> None:
-    TelekitState.init(bot)
+    TelekitState._init(bot)
     BaseSender._init(bot)
     Handler._init(bot)
     Chain._init(bot)