django-telegram-bot-api 0.1.0__py3-none-any.whl

django_telegram/__init__.py

@@ -0,0 +1,7 @@
+from .dispatcher import Dispatcher  # noqa: F401, I001
+from .handlers import (
+    CommandHandler, MessageHandler, CallbackQueryHandler,  # noqa: F401
+    InlineQueryHandler, ChosenInlineResultHandler,  # noqa: F401
+)
+from .telegram import Telegram  # noqa: F401
+from .telegram_models import Update  # noqa: W292, F401

django_telegram/conf.py

@@ -0,0 +1,33 @@
+from django.conf import settings
+from django.core.exceptions import ImproperlyConfigured
+
+
+class Conf:
+    @property
+    def _s(self) -> dict:
+        return getattr(settings, "TELEGRAM", {})
+
+    def _require(self, name):
+        try:
+            return self._s[name]
+        except KeyError:
+            raise ImproperlyConfigured(
+                f"settings.TELEGRAM['{name}'] is required"
+            ) from None
+
+    # ---- اجباری (ایندکس) ----
+    @property
+    def BOT_TOKEN(self) -> str:
+        return self._require("BOT_TOKEN")
+
+    @property
+    def TM_WEBHOOK_URL(self) -> str:
+        return self._require("TM_WEBHOOK_URL")
+
+    # ---- اختیاری (get با پیش‌فرض) ----
+    @property
+    def PROXY_SOCKS(self) -> str:
+        return self._s.get("PROXY_SOCKS", "")
+
+
+conf = Conf()

django_telegram/dispatcher.py

@@ -0,0 +1,62 @@
+from .handlers import (
+    CallbackQueryHandler,
+    ChosenInlineResultHandler,
+    CommandHandler,
+    InlineQueryHandler,
+    MessageHandler,
+)
+from .telegram_models import Update
+
+
+class Dispatcher:
+    """
+    Dispatcher routes an incoming Telegram update to the user's handler
+    subclasses, based on the type of content in the update.
+
+    Attributes:
+        update (Update): The incoming update object from Telegram.
+
+    Methods:
+        dispatch():
+            - command (text starts with '/')                    -> CommandHandler subclasses
+            - regular message                                    -> MessageHandler subclasses
+            - callback query                                     -> CallBackQueryHandler subclasses
+            - inline query                                       -> InlineQueryHandler subclasses
+            - chosen inline result                               -> ChosenInlineResultHandler subclasses
+            - anything else                                      -> ignored
+    """
+
+    def __init__(self, update: Update | dict | str | bytes):
+        if isinstance(update, Update):
+            self.update = update
+        elif isinstance(update, (str, bytes)):
+            self.update = Update.model_validate_json(update)
+        else:
+            self.update = Update.model_validate(update)
+
+    def dispatch(self):
+        base = self._pick_base()
+        if base is None:
+            return
+
+        for cls in base.__subclasses__():
+            cls().handle(self.update)
+
+    def _pick_base(self):
+        message = self.update.message
+
+        if message:
+            if message.text and message.text.startswith("/"):
+                return CommandHandler
+            return MessageHandler
+
+        if self.update.callback_query:
+            return CallbackQueryHandler
+
+        if self.update.inline_query:
+            return InlineQueryHandler
+
+        if self.update.chosen_inline_result:
+            return ChosenInlineResultHandler
+
+        return None

django_telegram/exceptions.py

@@ -0,0 +1,20 @@
+class TelegramError(Exception):
+    """Base exception for all Telegram API related errors."""
+
+    pass
+
+
+class TelegramAPIError(TelegramError):
+    """Raised when Telegram API returns ok: false."""
+
+    def __init__(self, method: str, error_code: int | None, description: str):
+        self.method = method
+        self.error_code = error_code
+        self.description = description
+        super().__init__(f"[{method}] ({error_code}): {description}")
+
+    def __repr__(self) -> str:
+        return (
+            f"TelegramAPIError(method={self.method!r}, "
+            f"error_code={self.error_code!r}, description={self.description!r})"
+        )

django_telegram/handlers.py

@@ -0,0 +1,10 @@
+class BaseHandler:
+    def handle(self, update):
+        raise NotImplementedError
+
+
+class CommandHandler(BaseHandler): ...
+class MessageHandler(BaseHandler): ...
+class CallbackQueryHandler(BaseHandler): ...
+class InlineQueryHandler(BaseHandler): ...
+class ChosenInlineResultHandler(BaseHandler): ...