telekit 2.1.0__tar.gz → 2.2.0a0__tar.gz

{telekit-2.1.0/telekit.egg-info → telekit-2.2.0a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.1.0
+Version: 2.2.0a0
 Summary: Declarative, developer-friendly library for building Telegram bots
 Home-page: https://github.com/Romashkaa/telekit
 Author: romashka
@@ -36,9 +36,9 @@ 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/)
+[![PyPI](https://img.shields.io/pypi/v/telekit.svg)](https://pypi.org/project/telekit/)
 [![Python](https://img.shields.io/pypi/pyversions/telekit.svg)](https://pypi.org/project/telekit/)
-[![PyPi Downloads](https://static.pepy.tech/badge/telekit)](https://pepy.tech/project/telekit)
+[![PyPI Downloads](https://static.pepy.tech/badge/telekit)](https://pepy.tech/project/telekit)
 
 # Telekit
 
@@ -89,7 +89,7 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
 - Fast to develop and easy-to-extend code
 
 [GitHub](https://github.com/Romashkaa/telekit)
-[PyPi](https://pypi.org/project/telekit/)
+[PyPI](https://pypi.org/project/telekit/)
 [Telegram](https://t.me/NotRomashka)
 [Community](https://t.me/+wu-dFrOBFIwyNzc0)
 
@@ -378,20 +378,11 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.1.0
+# Changes in version 2.2.0a0
 
-## Trigger Improvements
+## New Button Types
 
 | **Name** | **Description** |
 |----------|-----------------|
-| `on.text` | *BugFix:* Commands are no longer matched as text triggers. |
-
-- Internal refactor of the `On` class.
-
-## New Utils
-
-| **Name** | **Description** |
-|----------|-----------------|
-| `make_bot_link` | Builds a `t.me` URL to a bot with an optional deep-link payload. |
-| `make_user_link` | Builds a `t.me` URL to a user with an optional pre-filled message. |
-| `make_qrcode` | Generates a [QR code](./docs/examples/qr_gen.md) URL from any text or link. |
+| `AlertButton` | A callback button that shows a popup alert when pressed. |
+| `NotificationButton` | A callback button that shows a brief notification at the top of the chat screen. |

{telekit-2.1.0 → telekit-2.2.0a0}/README.md

@@ -1,8 +1,8 @@
 ![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/)
+[![PyPI](https://img.shields.io/pypi/v/telekit.svg)](https://pypi.org/project/telekit/)
 [![Python](https://img.shields.io/pypi/pyversions/telekit.svg)](https://pypi.org/project/telekit/)
-[![PyPi Downloads](https://static.pepy.tech/badge/telekit)](https://pepy.tech/project/telekit)
+[![PyPI Downloads](https://static.pepy.tech/badge/telekit)](https://pepy.tech/project/telekit)
 
 # Telekit
 
@@ -53,7 +53,7 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
 - Fast to develop and easy-to-extend code
 
 [GitHub](https://github.com/Romashkaa/telekit)
-[PyPi](https://pypi.org/project/telekit/)
+[PyPI](https://pypi.org/project/telekit/)
 [Telegram](https://t.me/NotRomashka)
 [Community](https://t.me/+wu-dFrOBFIwyNzc0)
 

{telekit-2.1.0 → telekit-2.2.0a0}/telekit/_inline_buttons.py

@@ -34,6 +34,8 @@ __all__ = [
     "SuggestButton",
     "CopyTextButton",
     "CallbackButton",
+    "AlertButton",
+    "NotificationButton",
 
     "ButtonStyle"
 ]
@@ -54,6 +56,8 @@ class InlineButton:
     - `SuggestButton`
     - `CopyTextButton`
     - `CallbackButton`
+    - `AlertButton
+    - `NotificationButton
     """
 
     _bot: TeleBot
@@ -70,6 +74,8 @@ class InlineButton:
     Suggest: type["SuggestButton"]
     CopyText: type["CopyTextButton"]
     Callback: type["CallbackButton"]
+    Alert: type["AlertButton"]
+    Notification: type["NotificationButton"]
     
     Styles: type[ButtonStyle] = ButtonStyle
 
@@ -378,8 +384,109 @@ class CallbackButton(InlineButton):
             callback=callback,
         )
     
+class AlertButton(CallbackButton):
+    """
+    An inline keyboard button that shows a popup alert when pressed and terminates the chain.
+
+    When the user presses this button, the specified text is displayed as a modal alert dialog.
+    The chain is finalized: all other buttons in the message become inactive and no further
+    interaction is expected. Typically used as a session-ending buttons.
+
+    :param text: Text to display in the alert popup.
+    :type text: `str | None`
+
+    :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::
+
+        def entry_word(self) -> None:
+            self.chain.sender.set_title("✏️ Add a new word")
+            self.chain.sender.set_message("Type the word you want to save to your dictionary:")
+            self.chain.set_inline_keyboard({
+                "✕ Cancel": AlertButton(text="Cancelled")
+            })
+            self.chain.set_entry_text(
+                self.entry_translation,
+                delete_user_response=True,
+            )
+            self.chain.edit()
+    """
+    def __init__(
+            self,
+            text: str | None = None,
+            *,
+            style: str | None | ButtonStyle = None,
+            **kwargs
+        ):
+        super().__init__(
+            callback=None,
+            answer_text=text,
+            answer_as_alert=True,
+            style=style,
+            **kwargs
+        )
+
+class NotificationButton(CallbackButton):
+    """
+    An inline keyboard button that shows a brief notification at the top of the chat screen
+    when pressed and terminates the chain.
+
+    When the user presses this button, the specified text appears as a short non-blocking
+    notification. The chain is finalized: all other buttons in the message become inactive
+    and no further interaction is expected. Typically used as a session-ending buttons.
+
+    :param text: Text to display in the notification.
+    :type text: `str | None`
+
+    :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::
+
+        def entry_word(self) -> None:
+            self.chain.sender.set_title("✏️ Add a new word")
+            self.chain.sender.set_message("Type the word you want to save to your dictionary:")
+            self.chain.set_inline_keyboard({
+                "✕ Cancel": NotificationButton(text="Cancelled")
+            })
+            self.chain.set_entry_text(
+                self.entry_translation,
+                delete_user_response=True,
+            )
+            self.chain.edit()
+    """
+    def __init__(
+            self,
+            text: str | None = None,
+            *,
+            style: str | None | ButtonStyle = None,
+            **kwargs
+        ):
+        super().__init__(
+            callback=None,
+            answer_text=text,
+            answer_as_alert=False,
+            style=style,
+            **kwargs
+        )
+    
 InlineButton.Link = LinkButton
 InlineButton.WebApp = WebAppButton
 InlineButton.Suggest = SuggestButton
 InlineButton.CopyText = CopyTextButton
-InlineButton.Callback = CallbackButton
+InlineButton.Callback = CallbackButton
+InlineButton.Alert = AlertButton
+InlineButton.Notification = NotificationButton

telekit-2.2.0a0/telekit/_version.py

@@ -0,0 +1,5 @@
+# ––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
+# PyPI package version: https://img.shields.io/pypi/v/telekit.svg
+# ––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
+
+__version__ = "2.2.0a0"

{telekit-2.1.0 → telekit-2.2.0a0}/telekit/example/example_handlers/spells.py

@@ -40,15 +40,15 @@ class SpellsHandler(telekit.Handler):
     # ------------------------------------------
 
     def handle(self) -> None:
-        self.display_home_page()
+        self.display_spells()
 
-    def display_home_page(self) -> None:
+    def display_spells(self) -> None:
         self.chain.sender.set_title("📜 Wizarding Library")
         self.chain.sender.set_message("Select a spell from the list below to see its description:")
 
         self.chain.set_inline_keyboard(
             {
-                title: CallbackButton(self.display_home_page, answer_text=content) 
+                title: CallbackButton(self.display_spells, answer_text=content) 
                 for title, content in spells.items()
             }
         )

{telekit-2.1.0 → telekit-2.2.0a0}/telekit/inline_buttons.py

@@ -19,11 +19,15 @@
 
 from ._inline_buttons import (
     InlineButton,
+
     LinkButton,
     WebAppButton,
     SuggestButton,
     CopyTextButton,
+    
     CallbackButton,
+    AlertButton,
+    NotificationButton,
 )
 
 __all__ = [
@@ -35,4 +39,6 @@ __all__ = [
     "CopyTextButton",
 
     "CallbackButton",
+    "AlertButton",
+    "NotificationButton",
 ]

{telekit-2.1.0 → telekit-2.2.0a0/telekit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.1.0
+Version: 2.2.0a0
 Summary: Declarative, developer-friendly library for building Telegram bots
 Home-page: https://github.com/Romashkaa/telekit
 Author: romashka
@@ -36,9 +36,9 @@ 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/)
+[![PyPI](https://img.shields.io/pypi/v/telekit.svg)](https://pypi.org/project/telekit/)
 [![Python](https://img.shields.io/pypi/pyversions/telekit.svg)](https://pypi.org/project/telekit/)
-[![PyPi Downloads](https://static.pepy.tech/badge/telekit)](https://pepy.tech/project/telekit)
+[![PyPI Downloads](https://static.pepy.tech/badge/telekit)](https://pepy.tech/project/telekit)
 
 # Telekit
 
@@ -89,7 +89,7 @@ Even in its beta stage, Telekit accelerates bot development, offering typed comm
 - Fast to develop and easy-to-extend code
 
 [GitHub](https://github.com/Romashkaa/telekit)
-[PyPi](https://pypi.org/project/telekit/)
+[PyPI](https://pypi.org/project/telekit/)
 [Telegram](https://t.me/NotRomashka)
 [Community](https://t.me/+wu-dFrOBFIwyNzc0)
 
@@ -378,20 +378,11 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.1.0
+# Changes in version 2.2.0a0
 
-## Trigger Improvements
+## New Button Types
 
 | **Name** | **Description** |
 |----------|-----------------|
-| `on.text` | *BugFix:* Commands are no longer matched as text triggers. |
-
-- Internal refactor of the `On` class.
-
-## New Utils
-
-| **Name** | **Description** |
-|----------|-----------------|
-| `make_bot_link` | Builds a `t.me` URL to a bot with an optional deep-link payload. |
-| `make_user_link` | Builds a `t.me` URL to a user with an optional pre-filled message. |
-| `make_qrcode` | Generates a [QR code](./docs/examples/qr_gen.md) URL from any text or link. |
+| `AlertButton` | A callback button that shows a popup alert when pressed. |
+| `NotificationButton` | A callback button that shows a brief notification at the top of the chat screen. |

telekit-2.1.0/telekit/_version.py

@@ -1 +0,0 @@
-__version__ = "2.1.0"