telekit 2.5.0b0__tar.gz → 2.5.0b2__tar.gz

{telekit-2.5.0b0 → telekit-2.5.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.5.0b0
+Version: 2.5.0b2
 Summary: Declarative, developer-friendly library for building Telegram bots
 Home-page: https://github.com/Romashkaa/telekit
 Author: romashka
@@ -477,7 +477,27 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.5.0b0
+# Changes in version 2.5.0b2
 
 ### v2.5.0`b0`
 - Added support for t-strings (PEP 750, Python 3.14+) in `TextEntity`.
+
+### 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`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)

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/__init__.py

@@ -30,6 +30,7 @@ from ._user import User
 from ._telekit_dsl.telekit_dsl import TelekitDSL
 from ._telekit_dsl.mixin import DSLHandler, InstanceDSLHandler
 from ._logger import enable_file_logging
+from .chat import Chat
 
 from . import senders
 from . import types
@@ -41,6 +42,7 @@ from . import utils
 from . import traits
 from . import debug
 from . import scheduler
+from . import chat
 
 Styles = styles.Styles
 
@@ -56,11 +58,13 @@ __all__ = [
     "inline_buttons",
     "dices",
     "scheduler",
+    "chat",
 
     "Styles",
     "User",
 
-    "Server", 
+    "Server",
+    "Chat",
     "Chain", 
     "Trait",
     "Handler", 

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/_buildtext/styles.py

@@ -484,13 +484,9 @@ class Mention(Link):
     `Documentation <https://github.com/Romashkaa/telekit/blob/main/docs/tutorial2/6_styles.md>`_ · on GitHub
     """
 
-    def __init__(self, *content, user_id: int, escape: bool = True, sep: Union[str, "TextEntity", "Template"] = ""):
-        url: str = self.gen_link(user_id)
+    def __init__(self, *content, user_id: int | str, escape: bool = True, sep: Union[str, "TextEntity", "Template"] = ""):
+        url: str = telekit.utils.make_mention(user_id)
         super().__init__(*content, url=url, escape=escape, sep=sep)
-
-    @staticmethod
-    def gen_link(user_id: int) -> str:
-        return f"tg://user?id={user_id}"
     
 
 class UserLink(Link):

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/_chain_base.py

@@ -18,7 +18,6 @@
 # 
 
 # Standard library
-import inspect
 from typing import Callable
 
 # Third-party packages

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/_handler.py

@@ -27,8 +27,9 @@ library = logger.library
 from ._chain import Chain
 from ._callback_query_handler import CallbackQueryHandler
 from ._user import User
+from .chat import Chat
 from ._on import On
-from . import senders
+from .debug import Debug
 
 class Handler:
     
@@ -40,6 +41,7 @@ class Handler:
 
     # Instance Attributes
     user: User
+    chat: Chat
     chain: Chain
     message: Message
 
@@ -74,6 +76,12 @@ class Handler:
             handler.on = On(handler, bot)
             handler.init_handler()
 
+            if handler.__name__.startswith("_"):
+                continue
+
+            if handler.__name__ in cls.handlers_dict and Debug.duplicate_handler_warnings:
+                library.warning("Multiple handlers are named 'StartHandler'. Only the last registered handler is available through Handler.handlers_dict.")
+
             cls.handlers_dict[handler.__name__] = handler
     
     @classmethod
@@ -99,6 +107,7 @@ class Handler:
     def __init__(self, message: Message):
         self.message: Message = message
         self.user = User(self.message)
+        self.chat = Chat(self.message.chat.id, self.message.message_thread_id)
         self.new_chain()
 
     def handle(self) -> Any:

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/_init.py

@@ -25,6 +25,7 @@ from ._inline_buttons import InlineButton
 from ._user import User
 from .senders import BaseSender
 from ._state import TelekitState
+from .chat import Chat
 
 import telebot
 
@@ -33,6 +34,7 @@ __all__ = ["init"]
 def init(bot: telebot.TeleBot) -> None:
     TelekitState._init(bot)
     BaseSender._init(bot)
+    Chat._init(bot)
     Handler._init(bot)
     Chain._init(bot)
     InputHandler._init(bot)

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/_inline_buttons.py

@@ -20,12 +20,12 @@
 from typing import Any, Callable
 from enum import Enum
 
-# Third-party packages
 import telebot.types
 from telebot.types import InlineKeyboardButton, CallbackQuery
 from telebot import TeleBot
-from ._callback_query_handler import CallbackQueryHandler
 
+import telekit
+from ._callback_query_handler import CallbackQueryHandler
 from ._state import TelekitState
 
 __all__ = [
@@ -33,6 +33,9 @@ __all__ = [
 
     "StaticButton",
     "LinkButton", 
+    "ContactButton",
+    "UserLinkButton",
+    "BotLinkButton",
     "WebAppButton", 
     "SuggestButton",
     "CopyTextButton",
@@ -57,6 +60,9 @@ class InlineButton:
     """
     Base class for: 
     - `LinkButton`
+        - `ContactButton`
+        - `UserLinkButton`
+        - `BotLinkButton`
     - `WebAppButton`
     - `SuggestButton`
     - `CopyTextButton`
@@ -79,6 +85,9 @@ class InlineButton:
     
     Static: type["StaticButton"]
     Link: type["LinkButton"]
+    Contact: type["ContactButton"]
+    UserLink: type["UserLinkButton"]
+    BotLink: type["BotLinkButton"]
     WebApp: type["WebAppButton"]
     Suggest: type["SuggestButton"]
     CopyText: type["CopyTextButton"]
@@ -157,7 +166,7 @@ class LinkButton(InlineButton):
     :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
     :type style: `str`
 
     :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
@@ -175,7 +184,81 @@ class LinkButton(InlineButton):
             style=self._style,
             **self._kwargs
         )
-    
+
+class ContactButton(LinkButton):
+    """
+    Inline keyboard button that mentions a user by their Telegram ID.
+
+    Generates a ``tg://user?id=<user_id>`` link via :func:`telekit.utils.make_mention`,
+    allowing you to mention a user without knowing their username —
+    subject to their privacy settings.
+
+    :param user_id: Telegram user ID to mention.
+    :type user_id: :class:`str` | :class:`int`
+    :param style: Visual style of the button. Accepts a :class:`~telekit.types.ButtonStyle`
+        enum value or its string equivalent: ``"danger"`` (red), ``"success"`` (green),
+        ``"primary"`` (blue). Defaults to the client-specific style if omitted.
+    :type style: :class:`~telekit.types.ButtonStyle` | :class:`str` | ``None``
+    :param kwargs: Additional keyword arguments forwarded to
+        :class:`~telekit.types.InlineKeyboardButton`.
+    """
+    def __init__(self, user_id: str | int, *, style: str | None | ButtonStyle = None, **kwargs):
+        super().__init__(
+            url=telekit.utils.make_mention(user_id),
+            style=style,
+            **kwargs
+        )
+
+class UserLinkButton(LinkButton):
+    """
+    Inline keyboard button that opens a Telegram profile by username.
+
+    Generates a ``https://t.me/<username>`` link via :func:`telekit.utils.make_user_link`.
+    Optionally pre-fills the message input with ``text``.
+
+    :param username: Telegram username, with or without a leading ``@``.
+    :type username: :class:`str`
+    :param text: Optional message text to pre-fill in the chat input.
+    :type text: :class:`str` | ``None``
+    :param style: Visual style of the button. Accepts a :class:`~telekit.types.ButtonStyle`
+        enum value or its string equivalent: ``"danger"`` (red), ``"success"`` (green),
+        ``"primary"`` (blue). Defaults to the client-specific style if omitted.
+    :type style: :class:`~telekit.types.ButtonStyle` | :class:`str` | ``None``
+    :param kwargs: Additional keyword arguments forwarded to
+        :class:`~telekit.types.InlineKeyboardButton`.
+    """
+    def __init__(self, username: str, text: str | None = None, *, style: str | None | ButtonStyle = None, **kwargs):
+        super().__init__(
+            url=telekit.utils.make_user_link(username, text),
+            style=style,
+            **kwargs
+        )
+
+class BotLinkButton(LinkButton):
+    """
+    Inline keyboard button that opens a Telegram bot by username.
+
+    Generates a ``https://t.me/<botname>`` link via :func:`telekit.utils.make_bot_link`.
+    Optionally appends a deep-link payload via ``?start=``.
+
+    :param botname: Bot username, with or without a leading ``@``.
+    :type botname: :class:`str`
+    :param start: Optional deep-link payload passed as ``?start=``.
+    :type start: :class:`str` | ``None``
+    :param style: Visual style of the button. Accepts a :class:`~telekit.types.ButtonStyle`
+        enum value or its string equivalent: ``"danger"`` (red), ``"success"`` (green),
+        ``"primary"`` (blue). Defaults to the client-specific style if omitted.
+    :type style: :class:`~telekit.types.ButtonStyle` | :class:`str` | ``None``
+    :param kwargs: Additional keyword arguments forwarded to
+        :class:`~telekit.types.InlineKeyboardButton`.
+    """
+    def __init__(self, botname: str, start: str | None = None, *, style: str | None | ButtonStyle = None, **kwargs):
+        super().__init__(
+            url=telekit.utils.make_bot_link(botname, start),
+            style=style,
+            **kwargs
+        )
+
 class WebAppButton(InlineButton):
     """
     This object represents an inline keyboard button that describes a Web App.
@@ -186,7 +269,7 @@ class WebAppButton(InlineButton):
     :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
     :type style: `str`
 
     :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
@@ -215,7 +298,7 @@ class CopyTextButton(InlineButton):
     :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
     :type style: `str`
 
     :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
@@ -255,7 +338,7 @@ class SuggestButton(InlineButton):
     :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
     :type style: `str`
 
     :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
@@ -308,7 +391,7 @@ class CallbackButton(InlineButton):
     :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
     :type style: `str`
 
     :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
@@ -501,7 +584,7 @@ class AlertButton(AnswerButton):
     :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.
+              If omitted, an client-specific default style is used.
     :type style: `str | ButtonStyle | None`
 
     :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
@@ -551,7 +634,7 @@ class NotificationButton(AnswerButton):
     :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.
+              If omitted, an client-specific default style is used.
     :type style: `str | ButtonStyle | None`
 
     :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
@@ -616,7 +699,7 @@ class InvokeButton(CallbackButton):
     :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.
+              If omitted, an client-specific default style is used.
     :type style: `str | ButtonStyle | None`
 
     :param kwargs: Additional keyword arguments passed directly to `InlineKeyboardButton`.
@@ -712,6 +795,9 @@ class InvokeButton(CallbackButton):
         )
     
 InlineButton.Link = LinkButton
+InlineButton.Contact = ContactButton
+InlineButton.UserLink = UserLinkButton
+InlineButton.BotLink = BotLinkButton
 InlineButton.Static = StaticButton
 InlineButton.WebApp = WebAppButton
 InlineButton.Suggest = SuggestButton

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/_inline_keyboard.py

@@ -167,7 +167,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param when: If `False`, the button is not added.
@@ -210,7 +210,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param when: If `False`, the button is not added.
@@ -225,6 +225,128 @@ class InlineKeyboard:
         self._maybe_row()
         return self
 
+    def add_contact(
+        self,
+        text: str,
+        user_id: str | int,
+        *,
+        style: Literal["danger", "success", "primary"] | None | ButtonStyle = None,
+        when: bool | int = True,
+        **kwargs
+    ):
+        """
+        Adds a button that mentions a Telegram user by their ID.
+
+        The button generates a ``tg://user?id=<user_id>`` link via
+        :class:`~telekit.types.ContactButton`, allowing you to mention a user
+        without knowing their username.
+
+        :param text: Label displayed on the button.
+        :type text: :class:`str`
+        :param user_id: Telegram user ID to mention.
+        :type user_id: :class:`str` | :class:`int`
+        :param style: Visual style of the button. Accepts a :class:`~telekit.types.ButtonStyle`
+            enum value or its string equivalent: ``"danger"`` (red), ``"success"`` (green),
+            ``"primary"`` (blue). Defaults to the client-specific style if omitted.
+        :type style: :class:`~telekit.types.ButtonStyle` | :class:`str` | ``None``
+        :param when: If ``False`` (or any falsy value), the button is skipped and not added
+            to the keyboard. Useful for conditional layouts.
+        :type when: :class:`bool` | :class:`int`
+        :param kwargs: Additional keyword arguments forwarded to
+            :class:`~telekit.types.InlineKeyboardButton`.
+        :returns: The current builder instance, for method chaining.
+        :rtype: :class:`Self`
+        """
+        if not when:
+            return self
+        
+        self._current.append((text, ContactButton(user_id, style=style, **kwargs)))
+        self._maybe_row()
+        return self
+
+    def add_user_link(
+        self,
+        text: str,
+        username: str,
+        message: str | None = None,
+        *,
+        style: Literal["danger", "success", "primary"] | None | ButtonStyle = None,
+        when: bool | int = True,
+        **kwargs
+    ):
+        """
+        Adds a button that opens a Telegram user profile by username.
+
+        The button generates a ``https://t.me/<username>`` link via
+        :class:`~telekit.types.UserLinkButton`. Optionally pre-fills
+        the chat input with ``message``.
+
+        :param text: Label displayed on the button.
+        :type text: :class:`str`
+        :param username: Telegram username, with or without a leading ``@``.
+        :type username: :class:`str`
+        :param message: Optional message text to pre-fill in the chat input.
+        :type message: :class:`str` | ``None``
+        :param style: Visual style of the button. Accepts a :class:`~telekit.types.ButtonStyle`
+            enum value or its string equivalent: ``"danger"`` (red), ``"success"`` (green),
+            ``"primary"`` (blue). Defaults to the app-specific style if omitted.
+        :type style: :class:`~telekit.types.ButtonStyle` | :class:`str` | ``None``
+        :param when: If ``False`` (or any falsy value), the button is skipped and not added
+            to the keyboard. Useful for conditional layouts.
+        :type when: :class:`bool` | :class:`int`
+        :param kwargs: Additional keyword arguments forwarded to
+            :class:`~telekit.types.InlineKeyboardButton`.
+        :returns: The current builder instance, for method chaining.
+        :rtype: :class:`Self`
+        """
+        if not when:
+            return self
+        self._current.append((text, UserLinkButton(username, message, style=style, **kwargs)))
+        self._maybe_row()
+        return self
+
+    def add_bot_link(
+            self,
+            text: str,
+            botname: str,
+            start: str | None = None,
+            *,
+            style: Literal["danger", "success", "primary"] | None | ButtonStyle = None,
+            when: bool | int = True,
+            **kwargs
+        ):
+        """
+        Adds a button that opens a Telegram bot by username.
+
+        The button generates a ``https://t.me/<botname>`` link via
+        :class:`~telekit.types.BotLinkButton`. Optionally appends
+        a deep-link payload via ``?start=``.
+
+        :param text: Label displayed on the button.
+        :type text: :class:`str`
+        :param botname: Bot username, with or without a leading ``@``.
+        :type botname: :class:`str`
+        :param start: Optional deep-link payload passed as ``?start=``.
+            Useful for referral links or onboarding flows.
+        :type start: :class:`str` | ``None``
+        :param style: Visual style of the button. Accepts a :class:`~telekit.types.ButtonStyle`
+            enum value or its string equivalent: ``"danger"`` (red), ``"success"`` (green),
+            ``"primary"`` (blue). Defaults to the app-specific style if omitted.
+        :type style: :class:`~telekit.types.ButtonStyle` | :class:`str` | ``None``
+        :param when: If ``False`` (or any falsy value), the button is skipped and not added
+            to the keyboard. Useful for conditional layouts.
+        :type when: :class:`bool` | :class:`int`
+        :param kwargs: Additional keyword arguments forwarded to
+            :class:`~telekit.types.InlineKeyboardButton`.
+        :returns: The current builder instance, for method chaining.
+        :rtype: :class:`Self`
+        """
+        if not when:
+            return self
+        self._current.append((text, BotLinkButton(botname, start, style=style, **kwargs)))
+        self._maybe_row()
+        return self
+
     def add_webapp(
         self,
         text: str,
@@ -246,7 +368,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param when: If `False`, the button is not added.
@@ -283,7 +405,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param strict: If `True`, raises an error when the suggestion exceeds Telegram's 64-byte limit.
@@ -323,7 +445,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param strict: If `True`, raises an error when the text exceeds Telegram's 256-character limit.
@@ -358,7 +480,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param when: If `False`, the button is not added.
@@ -398,7 +520,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param when: If `False`, the button is not added.
@@ -438,7 +560,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param when: If `False`, the button is not added.
@@ -495,7 +617,7 @@ class InlineKeyboard:
         :param style: Style of the button. Must be one of `telekit.types.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.
+              If omitted, an client-specific default style is used.
         :type style: `str`
 
         :param when: If `False`, the button is not added.

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/_version.py

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

telekit-2.5.0b2/telekit/chat.py

@@ -0,0 +1,59 @@
+from typing import Any
+
+from telebot import TeleBot
+from telebot.types import Message
+
+import telekit
+from telekit.styles import TextEntity, Escape, Raw, Group, Bold, Italic
+from ._logger import _library
+
+__all__ = ['Chat']
+
+class Chat:
+
+    bot: TeleBot
+
+    @classmethod
+    def _init(cls, bot: TeleBot):
+        """
+        Initializes the bot instance for the class.
+        """
+        cls.bot = bot
+
+    def __init__(self, chat_id: int, thread_id: int | None = None, previous_user_message: Message | None = None) -> None:
+        self.id = chat_id
+        self.thread_id = thread_id
+        self.previous_user_message = previous_user_message
+
+    def _get_base_params(self) -> dict[str, Any]:
+        return {
+            "chat_id": self.id,
+            "parse_mode": "html",
+            "message_thread_id": self.thread_id
+        }
+
+    def answer(self, text: str | TextEntity):
+        """
+        Sends a text message to the chat.
+
+        Returns:
+            Message | None: The sent message or None if sending failed.
+        """
+        if not isinstance(text, TextEntity):
+            text = Escape(text)
+
+        try:
+            return self.bot.send_message(
+                chat_id           = self.id,
+                message_thread_id = self.thread_id,
+                text              = text.html,
+                parse_mode        = "html",
+            )
+        except Exception as exception:
+            text.debug("html")
+            _library.warning(f"^^^ [chat.answer]: Failed to answer (chat_id={self.id}; thread_id={self.thread_id}): {exception}")
+            return None
+
+    
+
+    

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/debug.py

@@ -2,6 +2,7 @@ class Debug:
     timeout_warnings: bool = False
     deletion_warnings: bool = False
     callback_query_tracing: bool = False
+    duplicate_handler_warnings: bool = True
 
     @classmethod
     def set_all(cls, value: bool) -> None:

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/inline_buttons.py

@@ -22,6 +22,9 @@ from ._inline_buttons import (
     StaticButton,
 
     LinkButton,
+    ContactButton,
+    UserLinkButton,
+    BotLinkButton,
     WebAppButton,
     SuggestButton,
     CopyTextButton,
@@ -41,6 +44,9 @@ __all__ = [
     "StaticButton",
 
     "LinkButton", 
+    "ContactButton",
+    "UserLinkButton",
+    "BotLinkButton",
     "WebAppButton", 
     "SuggestButton",
     "CopyTextButton",

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/senders.py

@@ -1208,10 +1208,29 @@ class BaseSender:
         try:
             configs = self._get_base_params()
             configs["parse_mode"] = "HTML"
-            return self.bot.send_message(text=f"<b>{Escape(title)}</b>\n\n<i>{Escape(message)}.</i>", **configs)
+            return self.bot.send_message(text=f"{Bold(title).html}\n\n{Escape(message).html}", **configs)
         except Exception as exception:
             library.warning(f"Failed to send `error` message: {exception}")
             return None
+
+    def send_message(self, title: str, message: str) -> Message | None:
+        """
+        Sends a custom message with a title and detailed message.
+
+        Args:
+            title (`str` | `TextEntity`): The title of the message.
+            message (`str` | `TextEntity`): The message.
+
+        Returns:
+            Message | None: The sent message or None if sending failed.
+        """
+        try:
+            configs = self._get_base_params()
+            configs["parse_mode"] = "HTML"
+            return self.bot.send_message(text=f"{Bold(title).html}\n\n{Escape(message).html}", **configs)
+        except Exception as exception:
+            library.warning(f"Failed to send message: {exception}")
+            return None
     
     def try_send(self) -> tuple[Message | None, Exception | None]:
         """

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit/utils.py

@@ -322,8 +322,20 @@ def compose_keyboard(
 # Link Generating
 # ––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––
 
-def make_bot_link(botname: str, start: str | None = None) -> str:
-    """Return a t.me link to a bot.
+def make_mention(user_id: int | str) -> str:
+    """
+    Creates a Telegram mention link by user ID.
+
+    Examples::
+
+        make_mention(123456789)
+        >>> 'tg://user?id=123456789'
+    """
+    return f"tg://user?id={user_id}"
+
+def make_bot_link(botname: str, start: str | None = None, escape: bool = True) -> str:
+    """
+    Return a t.me link to a bot.
 
     >>> make_bot_link("UserNameOfBot")
     "https://t.me/UserNameOfBot"
@@ -341,11 +353,12 @@ def make_bot_link(botname: str, start: str | None = None) -> str:
     botname = botname.lstrip("@")
     if start is None:
         return f"https://t.me/{botname}"
-    encoded_start = quote(start, safe="")
+    encoded_start = quote(start, safe="") if escape else start
     return f"https://t.me/{botname}?start={encoded_start}"
 
-def make_user_link(username: str, text: str | None = None) -> str:
-    """Return a t.me link to a user.
+def make_user_link(username: str, text: str | None = None, escape: bool = True) -> str:
+    """
+    Return a t.me link to a user.
 
     >>> make_user_link("UserName")
     "https://t.me/UserName"
@@ -363,7 +376,7 @@ def make_user_link(username: str, text: str | None = None) -> str:
     username = username.lstrip("@")
     if text is None:
         return f"https://t.me/{username}"
-    encoded_text = quote(text, safe="")
+    encoded_text = quote(text, safe="") if escape else text
     return f"https://t.me/{username}?text={encoded_text}"
 
 def make_qrcode(
@@ -384,7 +397,8 @@ def make_qrcode(
     caption_font_size: int | None = None,
     caption_font_color: str | None = None,
 ) -> str:
-    """Return a QuickChart URL that renders a QR code.
+    """
+    Return a QuickChart URL that renders a QR code.
 
     >>> make_qrcode("https://example.com")
     'https://quickchart.io/qr?text=https%3A%2F%2Fexample.com'
@@ -427,9 +441,9 @@ def make_qrcode(
     if margin is not None: 
         params["margin"] = margin
     if dark is not None: 
-        params["dark"] = dark
+        params["dark"] = dark.lstrip("#")
     if light is not None: 
-        params["light"] = light
+        params["light"] = light.lstrip("#")
     if ec_level is not None: 
         params["ecLevel"] = ec_level
     if format is not None: 

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: telekit
-Version: 2.5.0b0
+Version: 2.5.0b2
 Summary: Declarative, developer-friendly library for building Telegram bots
 Home-page: https://github.com/Romashkaa/telekit
 Author: romashka
@@ -477,7 +477,27 @@ It tries to make Telegram bot development easier.
 
 ---
 
-# Changes in version 2.5.0b0
+# Changes in version 2.5.0b2
 
 ### v2.5.0`b0`
 - Added support for t-strings (PEP 750, Python 3.14+) in `TextEntity`.
+
+### 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`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)

{telekit-2.5.0b0 → telekit-2.5.0b2}/telekit.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ telekit/_timeout.py
 telekit/_trait.py
 telekit/_user.py
 telekit/_version.py
+telekit/chat.py
 telekit/debug.py
 telekit/dices.py
 telekit/inline_buttons.py