telekit 2.3.0b3__tar.gz → 2.4.0b1__tar.gz

{telekit-2.3.0b3 → telekit-2.4.0b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.3.0b3
+Version: 2.4.0b1
 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
 
@@ -340,14 +341,54 @@ telekit.Server(BOT_TOKEN).polling()
   <summary>Click to see what you can do with the DSL</summary>
   <table>
     <tr>
-      <td><img src="../images/telekit_example_7.jpg" alt="Telekit Example 7" width="300"></td>
-      <td><img src="../images/telekit_example_8.jpg" alt="Telekit Example 8" width="300"></td>
+      <td><img src="./docs/images/telekit_example_7.jpg" alt="Telekit Example 7" width="300"></td>
+      <td><img src="./docs/images/telekit_example_8.jpg" alt="Telekit Example 8" width="300"></td>
+    </tr>
+    <tr>
+      <td><img src="./docs/images/telekit_example_6.jpg" alt="Telekit Example 7" width="300"></td>
+      <td><img src="./docs/images/telekit_example_1.jpg" alt="Telekit Example 8" width="300"></td>
     </tr>
   </table>
 </details>
 
 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**:
@@ -368,6 +409,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**.
 
@@ -379,6 +421,204 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.3.0b3
+# Changes in version 2.4.0b1
+
+## Inline and Reply Keyboards
+
+### `chain.set_keyboard()`
+
+Universal method for attaching a keyboard to the current chain message.
+Accepts either an `InlineKeyboard` or a `ReplyKeyboard` instance.
+
+```python
+# Inline keyboard
+self.chain.set_keyboard(
+    InlineKeyboard()
+        .add_callback("Click Me!", self.handle)
+    .row()
+        .add_link("YouTube", "https://youtube.com")
+)
+
+# Reply keyboard
+self.chain.set_keyboard(
+    ReplyKeyboard(one_time_keyboard=True)
+        .add_text("Hello!")
+        .add_text("Hi")
+    .row()
+        .add_contact("📱 Share phone")
+)
+```
+
+> [!NOTE]
+> Inline and reply keyboards are mutually exclusive in Telegram.
+> Only one keyboard can be displayed at a time per message.
+> Passing an `InlineKeyboard` attaches buttons directly to the message;
+> passing a `ReplyKeyboard` replaces the user's system keyboard below the input field.
+
+### `InlineKeyboard`
+
+Fluent builder for Telegram inline keyboards. Supports all standard inline button types, conditional rendering via `when=`, and row/column layout helpers.
+
+**Layout helpers**
+
+| **Method**       | **Description**                                                |
+|------------------|----------------------------------------------------------------|
+| `row(when=)`     | Finalize the current row and start a new one.                  |
+| `column_start()` | Enable column mode — every subsequent button gets its own row. |
+| `column_end()`   | Disable column mode and flush the current row.                 |
+
+**Button methods**
+
+| **Method** | **Description** |
+|------------|-----------------|
+| `add(text, button, when=)` | Attach any `InlineButton` instance. |
+| `add_callback(text, callback, pass_args, pass_kwargs, answer_text, answer_as_alert, style, when=)` | Button that fires a callback function. |
+| `add_link(text, url, style, when=)` | Button that opens a URL or `tg://` link. |
+| `add_webapp(text, url, style, when=)` | Button that opens a Telegram Mini App. |
+| `add_suggest(text, suggestion, style, strict, when=)` | Button that simulates the user sending a message. |
+| `add_copy(text, copy_text, style, strict, when=)` | Button that copies text to the clipboard. |
+| `add_static(text, style, when=)` | Decorative button with no action. |
+| `add_alert(text, alert_text, persistent, style, when=)` | Button that shows a popup alert dialog. |
+| `add_notification(text, notification_text, persistent, style, when=)` | Button that shows a brief top-of-chat notification. |
+| `add_invoke(text, obj, invoke, pass_args, pass_kwargs, answer_text, answer_as_alert, style, when=)` | Button that calls a named method on an arbitrary object. |
+
+**Bulk helpers**
+
+| **Method** | **Description** |
+|------------|-----------------|
+| `extend(buttons, column=, when=)` | Add multiple buttons from a `dict[str, InlineButton \| None]` or `list[str]`. |
+| `extend_rows(*rows, when=)` | Append one or more pre-built `list[tuple[str, InlineButton]]` rows. |
+
+All button methods accept a `style` parameter: `"danger"` (red), `"success"` (green), or `"primary"` (blue).
+
+```python
+InlineKeyboard()
+    .add_link("YouTube", "https://youtube.com")
+    .add_copy("Copy Me", "copied!")
+    .add_alert("Info", "This is an alert")
+.row()
+    .add_callback("Click Me!", self.handle)
+.column_start()
+    .add_link("A", "https://example.com")
+    .add_callback("B", self.handle_b)
+.column_end()
+.extend({"Alert": AlertButton("Hi!"), "Notify": NotificationButton("Hey")}, column=True)
+```
+
+### `ReplyKeyboard`
+
+Fluent builder for Telegram reply keyboards. Mirrors the `InlineKeyboard` layout API (`row`, `column_start`, `column_end`, `extend`, `extend_rows`).
+
+**Constructor parameters**
+
+| **Parameter** | **Default** | **Description** |
+|---|---|---|
+| `resize_keyboard` | `True` | Shrink the keyboard to fit its buttons. |
+| `one_time_keyboard` | `False` | Hide the keyboard after the first press. |
+| `input_field_placeholder` | `None` | Placeholder text shown while the keyboard is active (max 64 chars). |
+| `selective` | `False` | Show only to mentioned users or the original sender. |
+| `is_persistent` | `False` | Always show the keyboard; do not collapse it to an icon. |
+
+**Button methods**
+
+| **Method** | **Description** |
+|---|---|
+| `add(text, button, when=)` | Attach any `ReplyButton` instance. |
+| `add_text(text, when=)` | Plain text button — sends the label as a message. |
+| `add_contact(text, when=)` | Prompts the user to share their phone number (private chats only). |
+| `add_location(text, when=)` | Prompts the user to share their geolocation (private chats only). |
+| `add_poll(text, poll_type, when=)` | Opens the poll creation dialog; `poll_type` can be `"quiz"`, `"regular"`, or `None`. |
+| `add_webapp(text, url, when=)` | Opens a Telegram Mini App. |
+| `add_request_user(text, request_id, user_is_bot, user_is_premium, when=)` | Lets the user pick a Telegram user; result returned as a service message. |
+| `add_request_chat(text, request_id, chat_is_channel, chat_is_forum, chat_has_username, chat_is_created, user_administrator_rights, bot_administrator_rights, bot_is_member, when=)` | Lets the user pick a chat; result returned as a service message. |
+
+**Layout helpers** — identical to `InlineKeyboard`
+
+| **Method** | **Description** |
+|---|---|
+| `row(when=)` | Finalize the current row and start a new one. |
+| `column_start()` | Enable column mode — every subsequent button gets its own row. |
+| `column_end()` | Disable column mode and flush the current row. |
+| `extend(buttons, column=, when=)` | Add multiple buttons from a `dict[str, ReplyButton \| None]` or `list[str]`. |
+| `extend_rows(*rows, when=)` | Append one or more pre-built `list[tuple[str, ReplyButton]]` rows. |
+
+```python
+ReplyKeyboard(input_field_placeholder="Choose:", one_time_keyboard=True)
+    .add_text("Hello!")
+    .add_text("Hi")
+.row()
+    .add_contact("📱 Phone")
+    .add_location("📍 Location")
+    .add_poll("📊 Poll")
+.row()
+    .add_request_user("Pick user", request_id=1)
+    .add_request_chat("Pick chat", request_id=2)
+```
+
+## Telekit DSL
+
+### `InstanceDSLHandler`
+
+Instance-oriented variant of `DSLHandler` where each instance carries its own
+`executable_model`, `_script_data_factory`, and `_jinja_env` — allowing multiple
+instances to run completely independent scripts simultaneously.
+
+Use the `*_locally` instance methods instead of the class-level ones:
+
+```python
+class MyHandler(telekit.InstanceDSLHandler):
+    @classmethod
+    def init_handler(cls) -> None:
+        cls.on.message().invoke(cls.handle)
+
+    def handle(self):
+        script = fetch_script_from_db(self.user.id)  # per-user DSL
+        self.analyze_string_locally(script)
+        self.start_script()
+```
+
+| **Method**                              | **Description**                                      |
+| --------------------------------------- | ---------------------------------------------------- |
+| `analyze_file_locally(path, encoding)`  | Analyse a script file on this instance.              |
+| `analyze_string_locally(script)`        | Analyse a DSL string on this instance.               |
+| `analyze_canvas_locally(file_path)`     | Analyse an Obsidian `.canvas` file on this instance. |
+| `analyze_executable_model_locally(model)` | Load a pre-built model dict on this instance.      |
+
+**Security**
+
+When accepting scripts from untrusted users, restrict dangerous features via the
+`RESTRICTED` class attribute. Set `DEFAULT_TIMEOUT` to control the fallback timeout,
+and `DEFAULT_CONFIG` to provide a safe base config.
+
+```python
+class SafeDSL(telekit.InstanceDSLHandler):
+    RESTRICTED: list[RestrictedToken] = ["hook", "jinja", "redirect", "handoff", "config"]
+    DEFAULT_TIMEOUT = 120
+    DEFAULT_CONFIG  = {"template": "vars"}
+```
 
-[View changelog on GitHub](https://github.com/Romashkaa/telekit/blob/main/CHANGELOG.md)
+| **Token**      | **Effect**                                                                                      |
+| -------------- | ----------------------------------------------------------------------------------------------- |
+| `"handoff"`    | Disables `handoff` button type (cross-handler transitions).                                     |
+| `"redirect"`   | Disables `redirect` button type (simulated user messages).                                      |
+| `"hook"`       | Removes all `on_enter`, `on_enter_once`, `on_exit`, `on_timeout` hooks.                        |
+| `"jinja"`      | Forces template engine to `"vars"`; Jinja is never executed.                                    |
+| `"timeout"`    | Ignores per-script `timeout_time`; uses `DEFAULT_TIMEOUT` only.                                 |
+| `"config"`     | Replaces script config with `DEFAULT_CONFIG`; `vars_*` keys are preserved unless `"vars"` is also set. |
+| `"vars"`       | Removes all `vars_*` keys and disables `{{variable}}` substitution.                             |
+| `"images"`     | Strips `image` field from every scene.                                                          |
+| `"links"`      | Disables `link` button type (external URLs).                                                    |
+| `"suggest"`    | Disables `suggest` button type (pre-filled entry suggestions).                                  |
+| `"entry"`      | Disables entry handlers (free-text input routing).                                              |
+| `"next"`       | Disables `next` magic scene navigation.                                                         |
+| `"back"`       | Disables `back` magic scene navigation.                                                         |
+
+## Scheduler
+
+- Added `every` decorator for scheduling functions in a background daemon thread.
+- Implemented `PeriodicTask` class to manage periodic execution and error handling.
+
+## Others
+
+- Enhanced `Debug` class with callback query tracing functionality.
+- Refactored `BaseSender` to use `send_or_handle_error`.

telekit-2.3.0b3/telekit.egg-info/PKG-INFO → telekit-2.4.0b1/README.md

@@ -1,39 +1,3 @@
-Metadata-Version: 2.4
-Name: telekit
-Version: 2.3.0b3
-Summary: Declarative, developer-friendly library for building Telegram bots
-Home-page: https://github.com/Romashkaa/telekit
-Author: romashka
-Author-email: notromashka@gmail.com
-License: GPLv3
-Project-URL: GitHub, https://github.com/Romashkaa/telekit
-Project-URL: Telegram, https://t.me/TelekitLib
-Keywords: telegram bot api declarative tools bot-api
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: charset_normalizer==3.4.2
-Requires-Dist: Jinja2==3.1.6
-Requires-Dist: pyTelegramBotAPI==4.31.0
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
 ![TeleKit](https://github.com/Romashkaa/images/blob/main/TeleKitWide.png?raw=true)
 
 [![PyPI](https://img.shields.io/pypi/v/telekit.svg)](https://pypi.org/project/telekit/)
@@ -77,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
@@ -85,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
 
@@ -340,14 +305,54 @@ telekit.Server(BOT_TOKEN).polling()
   <summary>Click to see what you can do with the DSL</summary>
   <table>
     <tr>
-      <td><img src="../images/telekit_example_7.jpg" alt="Telekit Example 7" width="300"></td>
-      <td><img src="../images/telekit_example_8.jpg" alt="Telekit Example 8" width="300"></td>
+      <td><img src="./docs/images/telekit_example_7.jpg" alt="Telekit Example 7" width="300"></td>
+      <td><img src="./docs/images/telekit_example_8.jpg" alt="Telekit Example 8" width="300"></td>
+    </tr>
+    <tr>
+      <td><img src="./docs/images/telekit_example_6.jpg" alt="Telekit Example 7" width="300"></td>
+      <td><img src="./docs/images/telekit_example_1.jpg" alt="Telekit Example 8" width="300"></td>
     </tr>
   </table>
 </details>
 
 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**:
@@ -368,6 +373,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**.
 
@@ -375,10 +381,4 @@ Telekit doesn't try to be everything.
 It tries to make Telegram bot development easier.
 
 > [!TIP]
-> If you're interested and want to learn more, check out the [Tutorial](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/0_tutorial.md)
-
----
-
-# Changes in version 2.3.0b3
-
-[View changelog on GitHub](https://github.com/Romashkaa/telekit/blob/main/CHANGELOG.md)
+> If you're interested and want to learn more, check out the [Tutorial](https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/0_tutorial.md)

{telekit-2.3.0b3 → telekit-2.4.0b1}/setup.py

@@ -26,10 +26,11 @@ remove_cache()
 def readme():
     with open('README.md', 'r') as f:
         return f.read()
-  
+    
 def changelog():
-    return f"[View changelog on GitHub](https://github.com/Romashkaa/telekit/blob/main/CHANGELOG.md)"
-
+    with open('CHANGELOG.md', 'r') as f:
+        return f.read()
+    
 def install_requires():
     with open('telekit/requirements.txt', 'r') as f:
         return f.read().split("\n")

{telekit-2.3.0b3 → telekit-2.4.0b1}/telekit/__init__.py

@@ -22,11 +22,13 @@ from ._trait import Trait
 from ._chain import Chain
 from ._callback_query_handler import CallbackQueryHandler
 from .server import Server, example
+from ._inline_keyboard import InlineKeyboard
+from ._reply_keyboard import ReplyKeyboard
 from ._snapvault import Vault
 from ._chapters import chapters
 from ._user import User
 from ._telekit_dsl.telekit_dsl import TelekitDSL
-from ._telekit_dsl.mixin import DSLHandler
+from ._telekit_dsl.mixin import DSLHandler, InstanceDSLHandler
 from ._logger import enable_file_logging
 
 from . import senders
@@ -38,6 +40,7 @@ from . import dices
 from . import utils
 from . import traits
 from . import debug
+from . import scheduler
 
 Styles = styles.Styles
 
@@ -52,6 +55,7 @@ __all__ = [
     "parameters",
     "inline_buttons",
     "dices",
+    "scheduler",
 
     "Styles",
     "User",
@@ -62,8 +66,12 @@ __all__ = [
     "Handler", 
     "CallbackQueryHandler",
 
+    "InlineKeyboard",
+    "ReplyKeyboard",
+
     "TelekitDSL",
     "DSLHandler",
+    "InstanceDSLHandler",
 
     "Vault", 
     "enable_file_logging",

{telekit-2.3.0b3 → telekit-2.4.0b1}/telekit/_callback_query_handler.py

@@ -26,6 +26,9 @@ from telebot.types import (
     CallbackQuery
 )
 
+from .debug import Debug
+from ._logger import _library
+
 
 class CallbackQueryHandler:
 
@@ -44,9 +47,18 @@ class CallbackQueryHandler:
 
         @bot.callback_query_handler(func=lambda call: True)
         def handle(call: CallbackQuery) -> None:
+            if Debug.callback_query_tracing:
+                _library.info(
+                    "CallbackQuery("
+                    f"user_id={call.from_user.id}, "
+                    f"data={call.data!r},\n"
+                    f"message_text={call.message.text if call.message else None!r}"
+                    f") - {Debug.callback_query_tracing=}"
+                )
+
             if not call.data:
                 return
-            
+
             if call.data.startswith(cls.INLINE_BUTTON):
                 cls._handle_inline_button(call)
             elif call.data.startswith(cls.STATIC_BUTTON):
@@ -180,11 +192,11 @@ class CallbackQueryHandler:
     
     # (text: str, is_alert: bool)
 
-    _invalid_data_answer: tuple[str, bool] = ("Invalid Call Data (None)", True)
+    _invalid_data_answer: tuple[str, bool] = ("Invalid Call Data", True)
     _button_is_no_active_answer: tuple[str, bool] = ("Button is no longer active", True)
 
     @classmethod
-    def set_invalid_data_answer(cls, answer: str="Invalid Call Data (None)", is_alert: bool=True):
+    def set_invalid_data_answer(cls, answer: str="Invalid Call Data", is_alert: bool=True):
         """
         Sets the response message and type for cases when the received callback data is invalid or empty.
 

{telekit-2.3.0b3 → telekit-2.4.0b1}/telekit/_chain.py

@@ -30,7 +30,7 @@ from .debug import Debug
 from .styles import TextEntity
 
 # Chain modules
-from ._chain_base import library
+from ._chain_base import _library
 from ._chain_inline_keyboards_logic import ChainInlineKeyboardLogic
 from ._chain_entry_logic import ChainEntryLogic, TextDocument
 
@@ -156,7 +156,7 @@ class Chain(ChainInlineKeyboardLogic, ChainEntryLogic):
         self._previous_message = message
 
         if Debug.timeout_warnings and _handler and not _timeout:
-            library.warning(
+            _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.3.0b3 → telekit-2.4.0b1}/telekit/_chain_base.py

@@ -32,8 +32,7 @@ from . import _timeout
 
 # Logging
 from .debug import Debug
-from ._logger import logger
-library = logger.library
+from ._logger import _library as _library
 
 class ChainBase:
 

{telekit-2.3.0b3 → telekit-2.4.0b1}/telekit/_chain_inline_keyboards_logic.py

@@ -31,8 +31,10 @@ from telebot.types import (
 )
 
 from ._callback_query_handler import CallbackQueryHandler
+from ._inline_keyboard import InlineKeyboard
+from ._reply_keyboard import ReplyKeyboard
 from ._inline_buttons import InlineButton, CallbackButton
-from ._chain_base import ChainBase, library
+from ._chain_base import ChainBase, _library
 
 if typing.TYPE_CHECKING:
     from ._chain import Chain # only for type hints
@@ -249,7 +251,7 @@ class ChainInlineKeyboardLogic(ChainBase):
         if not isinstance(choices, dict):
             for c in choices:
                 if type(c).__str__ is object.__str__:
-                    library.warning(
+                    _library.warning(
                         f"{type(c).__name__} does not implement __str__. "
                         f"Consider passing a dict with explicit labels.",
                         stacklevel=3
@@ -335,6 +337,73 @@ class ChainInlineKeyboardLogic(ChainBase):
 
         self.sender.set_reply_markup(markup)
 
+    # 
+
+    def set_keyboard(self, keyboard: InlineKeyboard | ReplyKeyboard) -> None:
+        """
+        Sets a keyboard for the chain from an `InlineKeyboard` or `ReplyKeyboard` object.
+
+        Example::
+
+            from telekit.types import InlineKeyboard, ReplyKeyboard
+
+            # Inline keyboard
+            self.chain.set_keyboard(
+                InlineKeyboard()
+                    .add_callback("Click Me!", self.handle)
+                .row()
+                    .add_link("YouTube", "https://youtube.com")
+            )
+
+            # Reply keyboard
+            self.chain.set_keyboard(
+                ReplyKeyboard(one_time_keyboard=True)
+                    .add_text("Hello!")
+                    .add_text("Hi")
+                .row()
+                    .add_contact("📱 Share phone")
+            )
+        
+        :param keyboard: A constructed `InlineKeyboard` instance with buttons and rows.
+        :type keyboard: `InlineKeyboard`
+        """
+        # --- ReplyKeyboard ---
+        if isinstance(keyboard, ReplyKeyboard):
+            markup = keyboard._compile()
+            self.sender.set_reply_markup(markup)
+            self._handler.set_button_callbacks(None)
+            return
+        
+        # --- InlineKeyboard ---
+        button_callbacks: dict[str, Callable[[CallbackQuery], None]] = {}
+        markup = InlineKeyboardMarkup()
+
+        button_index = 0
+
+        for row in keyboard._compile():
+            compiled_row: list[InlineKeyboardButton] = []
+            for caption, inline_button in row:
+                if isinstance(inline_button, CallbackButton):
+                    invoker = inline_button.build_invoker(self._cancel_timeout_and_handlers)
+                    callback_data = CallbackQueryHandler.inline_button(f"{button_index}:{random.randint(1000, 9999)}")
+                    button_callbacks[callback_data] = invoker
+                    compiled_row.append(
+                        InlineKeyboardButton(
+                            text=caption,
+                            callback_data=callback_data,
+                            **invoker._kwargs # pyright: ignore[reportArgumentType]
+                        )
+                    )
+                else:
+                    compiled_row.append(inline_button._compile(caption))
+                button_index += 1
+            markup.keyboard.append(compiled_row)
+
+        self.sender.set_reply_markup(markup)
+        self._handler.set_button_callbacks(button_callbacks)
+
+    # Utils
+
     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()