telekit 2.3.0b2__tar.gz → 2.4.0b0__tar.gz

{telekit-2.3.0b2 → telekit-2.4.0b0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.3.0b2
+Version: 2.4.0b0
 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,148 +421,72 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.3.0b2
-
-## Inline Buttons
-
-| **Name**         | **Description**                                                                 |
-| ---------------- | ------------------------------------------------------------------------------- |
-| `StaticButton`   | A non-interactive inline button that performs no action when pressed.           |
-| `AnswerButton`   | A button that responds to a callback query with a notification or alert without executing custom logic. |
-
-- `AnswerButton` and its subclasses (`AlertButton`, `NotificationButton`) now support the `persistent` parameter (Defauts to `True`):
-  - `True` — non-blocking hint (does not affect further interactions)
-  - `False` — terminates interaction after click
+# Changes in version 2.4.0b0
 
-## Traits
+## Scheduler
 
-| **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.        |
+- Added `every` decorator for scheduling functions in a background daemon thread.
+- Implemented `PeriodicTask` class to manage periodic execution and error handling.
 
-### TrackHandoffOrigin
+## Telekit DSL
 
-`TrackHandoffOrigin` adds three members to any handler that inherits it:
+### `InstanceDSLHandler`
 
-| **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.               |
+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.
 
-Set `TRACK_HANDOFF_ORIGIN = False` on any subclass to opt out of tracking.
+Use the `*_locally` instance methods instead of the class-level ones:
 
 ```python
-class MyHandler(TrackHandoffOrigin, telekit.Handler):
+class MyHandler(telekit.InstanceDSLHandler):
+    @classmethod
+    def init_handler(cls) -> None:
+        cls.on.message().invoke(cls.handle)
 
     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, ...)` | Display a paginated choice keyboard. |
-| `PAGINATED_CHOICE_BACK_LABEL` | Label for the back navigation button. Defaults to `« Back`. |
-| `PAGINATED_CHOICE_NEXT_LABEL` | Label for the next navigation button. Defaults to `Next »`. |
-| `PAGINATED_CHOICE_PAGE_LABEL` | Label template for the page indicator button. Supports `{page}` and `{pages}` placeholders. Set to `None` to hide. Defaults to `{page} / {pages}`. |
-
-
-```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
-)
+        script = fetch_script_from_db(self.user.id)  # per-user DSL
+        self.analyze_string_locally(script)
+        self.start_script()
 ```
 
-Override labels per handler to localise or restyle navigation:
+| **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.      |
 
-```python
-class MyHandler(PaginatedChoice, telekit.Handler):
-    PAGINATED_CHOICE_BACK_LABEL = "⬅️ Назад"
-    PAGINATED_CHOICE_NEXT_LABEL = "Далі ➡️"
-    PAGINATED_CHOICE_PAGE_LABEL = None  # hide page indicator
-```
+**Security**
 
-<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.                 |
-| `compose_keyboard` | Merge multiple button groups into a single inline keyboard with computed `row_width`. |
-
-### Environment Utils
-
-- `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:
+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
-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
+class SafeDSL(telekit.InstanceDSLHandler):
+    RESTRICTED: list[RestrictedToken] = ["hook", "jinja", "redirect", "handoff", "config"]
+    DEFAULT_TIMEOUT = 120
+    DEFAULT_CONFIG  = {"template": "vars"}
 ```
 
-### Inline Keyboard Utils
-
-`compose_keyboard` combines multiple button groups into a single keyboard and automatically calculates `row_width` for each group.
-
-Each group is laid out independently using its corresponding width from `widths`.
-A width of `-1` means "all buttons in one row" (i.e. ``len(group)``).
-
-| **Param** | **Type**         | **Description**                             |
-|-----------|------------------|---------------------------------------------|
-| `groups`  | `dict[str, Any]` | One or more button groups                   |
-| `widths`  | `Iterable[int]`  | Row width per group or single value for all |
-
-| **Returns** | **Type** |
-|------------|----------|
-| `keyboard` | `dict[str, Any]` |
-| `row_width` | `tuple[int, ...]` |
-
-```py
-# row_width → (1, 3, 3, 3, 2)
-# layout:
-#   |    🆕 Create    |
-#   |  1  |  2  |  3  |
-#   |  4  |  5  |  6  |
-#   |  7  |  8  |  9  |
-#   | « Back | Next » |
-
-keyboard, row_width = compose_keyboard(
-    {"🆕 Create": "create"},
-    {str(n): str(n) for n in range(1, 10)},
-    {"« Back": "back", "Next »": "next"},
-    widths=(-1, 3, -1), # or (1, 3, 2)
-)
-self.chain.set_inline_choice(keyboard, row_width)
-```
+| **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.                                                         |
+
+## Others
+
+- Enhanced `Debug` class with callback query tracing functionality.
+- Refactored `BaseSender` to use `send_or_handle_error`.

{telekit-2.3.0b2 → telekit-2.4.0b0}/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
 
@@ -304,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**:
@@ -332,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**.
 

{telekit-2.3.0b2 → telekit-2.4.0b0}/setup.py

@@ -26,11 +26,11 @@ remove_cache()
 def readme():
     with open('README.md', 'r') as f:
         return f.read()
-  
+    
 def changelog():
     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.0b2 → telekit-2.4.0b0}/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
@@ -25,7 +26,7 @@ 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
@@ -36,6 +37,8 @@ from . import inline_buttons
 from . import dices
 from . import utils
 from . import traits
+from . import debug
+from . import scheduler
 
 Styles = styles.Styles
 
@@ -50,20 +53,24 @@ __all__ = [
     "parameters",
     "inline_buttons",
     "dices",
+    "scheduler",
 
     "Styles",
     "User",
 
     "Server", 
     "Chain", 
+    "Trait",
     "Handler", 
     "CallbackQueryHandler",
 
     "TelekitDSL",
     "DSLHandler",
+    "InstanceDSLHandler",
 
     "Vault", 
     "enable_file_logging",
     "chapters",
     "example",
+    "debug",
 ]

{telekit-2.3.0b2 → telekit-2.4.0b0}/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.0b2 → telekit-2.4.0b0}/telekit/_chain.py

@@ -26,10 +26,11 @@ from telebot.types import Message
 
 # Local modules
 from . import senders
+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
 
@@ -154,8 +155,8 @@ class Chain(ChainInlineKeyboardLogic, ChainEntryLogic):
         self.sender.set_edit_message(None)
         self._previous_message = message
 
-        if self._timeout_warnings_enabled and _handler and not _timeout:
-            library.warning(
+        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.3.0b2 → telekit-2.4.0b0}/telekit/_chain_base.py

@@ -31,14 +31,12 @@ from . import _input_handler
 from . import _timeout
 
 # Logging
-from ._logger import logger
-library = logger.library
+from .debug import Debug
+from ._logger import _library as _library
 
 class ChainBase:
 
     bot: telebot.TeleBot
-
-    _timeout_warnings_enabled: bool = True
     
     @classmethod
     def _init(cls, bot: telebot.TeleBot):
@@ -206,4 +204,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.3.0b2 → telekit-2.4.0b0}/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, library
+from ._chain_base import ChainBase, _library
 
 if typing.TYPE_CHECKING:
     from ._chain import Chain # only for type hints
@@ -249,7 +249,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

{telekit-2.3.0b2 → telekit-2.4.0b0}/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)

{telekit-2.3.0b2 → telekit-2.4.0b0}/telekit/_inline_buttons.py

@@ -26,6 +26,8 @@ from telebot.types import InlineKeyboardButton, CallbackQuery
 from telebot import TeleBot
 from ._callback_query_handler import CallbackQueryHandler
 
+from ._state import TelekitState
+
 __all__ = [
     "InlineButton",
 
@@ -122,6 +124,15 @@ class InlineButton:
             raise ValueError(f"Unknown style: {style!r}. Must be one of {_BUTTON_STYLES_LIST}")
         raise TypeError(f"Style must be str, ButtonStyle, or None, got {type(style)}")
     
+    def _normalize_custom_emoji_id(self, custom_emoji_id: int | str | None) -> str | None:
+        if not custom_emoji_id:
+            return None
+        
+        if not TelekitState.is_premium():
+            return None
+
+        return str(custom_emoji_id)
+    
 class StaticButton(InlineButton):
 
     def __init__(self, *, style: str | None | ButtonStyle = None, **kwargs):