python-zatolox-bot 0.1.0__tar.gz → 0.1.1__tar.gz

{python_zatolox_bot-0.1.0 → python_zatolox_bot-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-zatolox-bot
-Version: 0.1.0
+Version: 0.1.1
 Summary: SDK ufficiale per costruire bot su Zatolox
 Home-page: https://github.com/zatolox/python-zatolox-bot
 Author: Zatolox

{python_zatolox_bot-0.1.0 → python_zatolox_bot-0.1.1}/python_zatolox_bot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-zatolox-bot
-Version: 0.1.0
+Version: 0.1.1
 Summary: SDK ufficiale per costruire bot su Zatolox
 Home-page: https://github.com/zatolox/python-zatolox-bot
 Author: Zatolox

{python_zatolox_bot-0.1.0 → python_zatolox_bot-0.1.1}/setup.py

@@ -5,7 +5,7 @@ from setuptools import setup, find_packages
 # sono, meno se ne rompono.
 setup(
     name="python-zatolox-bot",
-    version="0.1.0",
+    version="0.1.1",
     description="SDK ufficiale per costruire bot su Zatolox",
     long_description=(
         "Wrapper leggero attorno al gateway HTTP dei bot di Zatolox. "

{python_zatolox_bot-0.1.0 → python_zatolox_bot-0.1.1}/zatolox/__init__.py

@@ -3,5 +3,5 @@
 from .bot import ZatoloxBot, ZatoloxApiError
 from .types import User, Message, CallbackQuery, Update
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 __all__ = ["ZatoloxBot", "ZatoloxApiError", "User", "Message", "CallbackQuery", "Update"]

{python_zatolox_bot-0.1.0 → python_zatolox_bot-0.1.1}/zatolox/bot.py

@@ -91,6 +91,26 @@ class ZatoloxBot:
         result = self._call("getUpdates", params, http="get") or []
         return [Update.from_dict(u) for u in result]
 
+    def set_my_commands(self, commands: List[Any]) -> List[dict]:
+        """
+        Registra i comandi del bot sul server (come setMyCommands di Telegram).
+
+        Il client Zatolox li mostra nel menu "/" della barra input: senza almeno un comando quel
+        menu non compare proprio. Da chiamare una volta all'avvio.
+
+        `commands` accetta forme diverse, per comodita':
+            - dict:  {"command": "start", "description": "avvia il bot"}
+            - tupla: ("start", "avvia il bot")
+        Lo slash iniziale e' facoltativo: lo normalizza il server. Un array vuoto azzera i comandi.
+        """
+        norm: List[dict] = []
+        for c in commands:
+            if isinstance(c, dict):
+                norm.append({"command": str(c.get("command", "")), "description": str(c.get("description", ""))})
+            elif isinstance(c, (tuple, list)) and len(c) >= 2:
+                norm.append({"command": str(c[0]), "description": str(c[1])})
+        return self._call("setMyCommands", {"commands": norm})
+
     # ------------------------------------------------------------------ handler
 
     def add_command_handler(self, command: str, callback: Callable[[Message], None]) -> None:
@@ -113,6 +133,25 @@ class ZatoloxBot:
             return fn
         return deco
 
+    def message_handler(self, fn: Optional[Callable[[Message], None]] = None):
+        """
+        Decoratore per il fallback sul testo LIBERO (i messaggi che non sono comandi) — la base per
+        un bot conversazionale (es. inoltrare il testo a un'IA). Equivale ad add_message_handler.
+
+        Funziona sia nudo sia con le parentesi::
+
+            @bot.message_handler
+            def on_text(msg): ...
+
+            @bot.message_handler()
+            def on_text(msg): ...
+        """
+        def register(f: Callable[[Message], None]) -> Callable[[Message], None]:
+            self.add_message_handler(f)
+            return f
+        # Uso nudo (@bot.message_handler): Python passa gia' la funzione qui.
+        return register(fn) if fn is not None else register
+
     # ------------------------------------------------------------------ instradamento
 
     def _dispatch(self, update: Update) -> None: