banterbotapi 0.2.4__tar.gz → 0.2.6__tar.gz

{banterbotapi-0.2.4 → banterbotapi-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: banterbotapi
-Version: 0.2.4
+Version: 0.2.6
 Summary: Python SDK for building bots on Banter (banterchat.org) — discord.py-style.
 Author-email: Banter <contact@banterchat.org>
 License-Expression: MIT

{banterbotapi-0.2.4 → banterbotapi-0.2.6}/banterapi/__init__.py

@@ -23,7 +23,7 @@ The library mirrors discord.py conventions where possible. See the Bot,
 Intents, Embed, and Permissions classes for the main entry points.
 """
 
-__version__ = "0.2.4"
+__version__ = "0.2.6"
 
 from .client import Bot
 from .intents import Intents

{banterbotapi-0.2.4 → banterbotapi-0.2.6}/banterapi/client.py

@@ -38,7 +38,7 @@ from .models import User, Guild, Channel, Member, Message
 from .errors import GatewayError
 
 log = logging.getLogger("banterapi.client")
-
+e
 
 # Default REST/gateway URL fragments. Kept as module constants so that
 # the URL derivation in __init__ is easy to trace and future API
@@ -157,71 +157,28 @@ class Bot:
         self._handlers[name] = fn
         return fn
 
-    def command(self, name=None, aliases=None, help=None, slash=False, description="", options=None):
-        """Register a prefix command (optionally also as a slash command).
+    def command(self, name=None, aliases=None, help=None):
+        """Register a prefix command.
 
-        The decorated function is called as ``await fn(ctx, *args)`` —
-        positional arguments are parsed from the message text after the
-        prefix. Argument annotations (``int``, ``float``, ``bool``) are
-        applied automatically by :class:`~banterapi.commands.Command`;
-        ``*args`` and keyword-only (``*, text: str``) signatures are
-        supported.
+        The handler runs when a user types ``<prefix><name> ...`` in a
+        channel the bot can see. Function signature drives arg parsing:
+        ``int`` / ``float`` / ``bool`` annotations convert tokens,
+        ``*args`` collects the rest, ``*, text: str`` consumes the
+        remainder verbatim.
 
         Args:
             name: Command name as typed (without prefix). Defaults to
                 the function name.
-            aliases: Iterable of additional names the command answers
-                to (e.g. ``aliases=["p"]`` for a ``ping`` command).
-            help: Short help text shown in the default ``help`` embed.
-                Defaults to the function's docstring's first line.
-            slash: If ``True``, also register as a slash command at
-                :meth:`sync_commands` time. The user sees it in the
-                ``/`` autocomplete dropdown.
-            description: Slash-command description. Ignored when
-                ``slash=False``. Falls back to ``help`` or the name.
-            options: Iterable of :class:`~banterapi.SlashOption` to
-                expose as typed slash-command arguments. Only
-                applies when ``slash=True``. When a user invokes the
-                slash command, the server parses the typed options
-                and delivers them to the slash handler as
-                ``interaction.options``. Prefix-invocation is
-                unaffected — prefix args continue to parse from the
-                message text via function-signature introspection.
-
-        Usage::
-
-            @bot.command(aliases=["p"], slash=True, description="Health check")
-            async def ping(ctx):
-                await ctx.reply("pong")
+            aliases: Iterable of alternate names.
+            help: Short help text for the default help embed. Defaults
+                to the first line of the function's docstring.
 
-        With typed slash options::
-
-            from banterapi import SlashOption, OPTION_INTEGER
-
-            @bot.command(
-                slash=True, description="Roll a die",
-                options=[SlashOption("sides", type=OPTION_INTEGER, required=False)],
-            )
-            async def roll(ctx, sides: int = 6):
-                await ctx.reply(f"🎲 {sides}")
+        For slash commands (typed options + UI autocomplete), use
+        :meth:`slash_command` — prefix and slash are separate paths.
         """
         def decorator(fn):
             cmd = Command(fn, name=name, aliases=aliases, help=help)
             self._commands.add(cmd)
-            if slash:
-                entry = {
-                    "name": cmd.name,
-                    "description": description or cmd.help or cmd.name,
-                }
-                if options:
-                    # Defer import to avoid a circular: commands.py is
-                    # loaded by client.py, and SlashOption lives there.
-                    from .commands import SlashOption as _SO
-                    entry["options"] = [
-                        (o.to_dict() if isinstance(o, _SO) else dict(o))
-                        for o in options
-                    ]
-                self._slash_commands.append(entry)
             return fn
         return decorator
 
@@ -281,7 +238,7 @@ class Bot:
     def _register_default_help(self):
         from .embed import Embed
 
-        @self.command(name="help", slash=True, description="Show available commands")
+        @self.command(name="help")
         async def _help(ctx):
             visible = [c for c in self._commands.all() if not getattr(c, "_hidden", False)]
             visible.sort(key=lambda c: c.name)
@@ -307,7 +264,7 @@ class Bot:
                     chunks.append(chunk)
                 for i, c in enumerate(chunks):
                     e.add_field("Commands" if i == 0 else "\u200b", c, inline=False)
-            e.set_footer(f"Type {self.command_prefix}<command> or /<command>")
+            e.set_footer(f"Type {self.command_prefix}<command>")
             await ctx.reply(embed=e)
 
     async def sync_commands(self):
@@ -413,11 +370,6 @@ class Bot:
             return
 
         if event_type == "interaction_create":
-            # Route slash-command invocations to their registered
-            # handlers. Falls back to a no-op (plus on_raw_event) if
-            # the command name isn't known — that shouldn't normally
-            # happen because the server filters by command ownership,
-            # but we don't want to crash the dispatch loop on drift.
             from .interactions import Interaction
             interaction = Interaction(payload, client=self)
             handler = self._slash_handlers.get(interaction.command_name)

{banterbotapi-0.2.4 → banterbotapi-0.2.6}/banterbotapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: banterbotapi
-Version: 0.2.4
+Version: 0.2.6
 Summary: Python SDK for building bots on Banter (banterchat.org) — discord.py-style.
 Author-email: Banter <contact@banterchat.org>
 License-Expression: MIT

{banterbotapi-0.2.4 → banterbotapi-0.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "banterbotapi"
-version = "0.2.4"
+version = "0.2.6"
 description = "Python SDK for building bots on Banter (banterchat.org) — discord.py-style."
 readme = "README.md"
 requires-python = ">=3.9"