telekit 2.5.0rc1__tar.gz → 2.5.2__tar.gz

{telekit-2.5.0rc1 → telekit-2.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.5.0rc1
+Version: 2.5.2
 Summary: Declarative, developer-friendly library for building Telegram bots
 Home-page: https://github.com/Romashkaa/telekit
 Author: romashka
@@ -477,30 +477,16 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.5.0rc1
+# Changes in version 2.5.2
 
-### v2.5.0`b0`
-- Added support for t-strings (PEP 750, Python 3.14+) in `TextEntity`.
+### v2.5.2
+- Add `random_` variable prefix in `DSLHandler` — resolves to a random choice from a `list`/`tuple`/`str` static variable
 
-### v2.5.0`b1`
-- Added `Sender.send_message` method.
-- Added `utils.make_mention` utility for generating `tg://user?id=` mention links.
-- Added new inline button types to `inline_buttons`:
-  - `ContactButton` — mentions a user by Telegram ID via `tg://user?id=`.
-  - `UserLinkButton` — opens a user profile by username; supports pre-filled message text.
-  - `BotLinkButton` — opens a bot by username; supports deep-link `?start=` payload.
-- Added new methods to `InlineKeyboard`:
-  - `add_contact` — adds a `ContactButton`.
-  - `add_user_link` — adds a `UserLinkButton`.
-  - `add_bot_link` — adds a `BotLinkButton`.
+### v2.5.1 `(bug-fix)`
+- Implement `TelegramMarkdownV2Sanitizer` for improved `MarkdownV2` handling
 
-### v2.5.0`b2`
-- Added the `escape` parameter to `telekit.utils.*`:
-  - `make_user_link`
-  - `make_bot_link`
-- `Handler.handlers_dict` now excludes private handlers (classes whose names start with `_`).
-- Added `Debug.duplicate_handler_warnings` to warn about duplicate handler names during initialization.
-- Added `Handler.chat` object (BETA)
+### v2.5.0 `(final)`
+- Refactor `CalendarPick` trait to use `set_keyboard`
 
 ### v2.5.0`b3`
 - Added `utils.Markers` class
@@ -513,3 +499,26 @@ It tries to make Telegram bot development easier.
 - Added styles to `telekit.types`
 - Added `utils.CyclicList`
 - Fixed `_answer_callback_query` to always call `bot.answer_callback_query()`, even without a popup text
+
+### v2.5.0`b2`
+- Added the `escape` parameter to `telekit.utils.*`:
+  - `make_user_link`
+  - `make_bot_link`
+- `Handler.handlers_dict` now excludes private handlers (classes whose names start with `_`).
+- Added `Debug.duplicate_handler_warnings` to warn about duplicate handler names during initialization.
+- Added `Handler.chat` object (BETA)
+
+### v2.5.0`b1`
+- Added `Sender.send_message` method.
+- Added `utils.make_mention` utility for generating `tg://user?id=` mention links.
+- Added new inline button types to `inline_buttons`:
+  - `ContactButton` — mentions a user by Telegram ID via `tg://user?id=`.
+  - `UserLinkButton` — opens a user profile by username; supports pre-filled message text.
+  - `BotLinkButton` — opens a bot by username; supports deep-link `?start=` payload.
+- Added new methods to `InlineKeyboard`:
+  - `add_contact` — adds a `ContactButton`.
+  - `add_user_link` — adds a `UserLinkButton`.
+  - `add_bot_link` — adds a `BotLinkButton`.
+
+### v2.5.0`b0`
+- Added support for t-strings (PEP 750, Python 3.14+) in `TextEntity`.

{telekit-2.5.0rc1 → telekit-2.5.2}/telekit/_telekit_dsl/mixin.py

@@ -18,7 +18,7 @@
 # 
 
 import jinja2
-import re, json, copy
+import re, json, copy, random
 from typing import NoReturn, Callable, Any, Literal
 
 import telekit
@@ -715,10 +715,20 @@ class DSLHandler(telekit.Handler):
 
         if isinstance(value, str):
             return value
+
+    GET_RANDOM_PREFIX = "random_"
         
     def _get_static_var(self, name: str) -> str | None:
-        value = self.script_data.static_vars.get(name)
-        return None if value is None else str(value)
+        if name.startswith(self.GET_RANDOM_PREFIX):
+            name = name[len(self.GET_RANDOM_PREFIX):]
+            seq = self.script_data.static_vars.get(name)
+            if isinstance(seq, (str, list, tuple)):
+                return str(random.choice(seq))
+            else:
+                return str(seq)
+        else:
+            value = self.script_data.static_vars.get(name)
+            return None if value is None else str(value)
     
     def _get_default_var(self, name: str):
         match name:

{telekit-2.5.0rc1 → telekit-2.5.2}/telekit/_version.py

@@ -3,4 +3,4 @@
 # PyPI history: https://pypi.org/project/telekit/#history
 # ––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
 
-__version__ = "2.5.0rc1"
+__version__ = "2.5.2"

{telekit-2.5.0rc1 → telekit-2.5.2}/telekit/example/example_handlers/hotel.py

@@ -58,10 +58,11 @@ script = """
 $ vars {
     ECONOM_PRICE = 50
     COMFORT_PRICE = 120
+    NAME = ["Telekit", "Budapest", "Theft"]
 }
 
 @ main {
-    title = "🏨 Grand Telekit Hotel"
+    title = "🏨 Grand {{random_NAME}} Hotel"
     message = "Welcome, {{first_name}}! Choose your experience and explore our rooms."
     
     buttons (2) {

{telekit-2.5.0rc1 → telekit-2.5.2}/telekit/example/example_handlers/on_text.py

@@ -37,7 +37,7 @@ class OnTextHandler(telekit.Handler):
         if not age:
             age = "An unknown number of"
 
-        self.chain.sender.set_title(Group("Hello, ", Italic(name), "!"))
+        self.chain.sender.set_title("👋 Hello, ", Italic(name), "!")
         self.chain.sender.set_message(Italic(age), " years is a wonderful stage of life!")
         self.chain.disable_timeout_warnings()
         self.chain.send()