banterbotapi 0.2.7__tar.gz → 0.2.9__tar.gz

{banterbotapi-0.2.7 → banterbotapi-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: banterbotapi
-Version: 0.2.7
+Version: 0.2.9
 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.7 → banterbotapi-0.2.9}/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.7"
+__version__ = "0.2.9"
 
 from .client import Bot
 from .intents import Intents

{banterbotapi-0.2.7 → banterbotapi-0.2.9}/banterapi/client.py

@@ -236,36 +236,8 @@ class Bot:
         return decorator
 
     def _register_default_help(self):
-        from .embed import Embed
-
-        @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)
-            e = Embed(
-                title=f"{self.user.username if self.user else 'Bot'} — Commands",
-                description=f"Prefix: `{self.command_prefix}`  ·  {len(visible)} command(s)",
-                color=self.help_color,
-            )
-            lines = []
-            for cmd in visible:
-                aliases = f" · aliases: {', '.join(self.command_prefix + a for a in cmd.aliases)}" if cmd.aliases else ""
-                doc = (cmd.help or "").strip().split("\n", 1)[0]
-                lines.append(f"`{self.command_prefix}{cmd.name}`{aliases} — {doc}" if doc else f"`{self.command_prefix}{cmd.name}`{aliases}")
-            if lines:
-                chunk, chunks = "", []
-                for line in lines:
-                    if len(chunk) + len(line) + 1 > 1000:
-                        chunks.append(chunk)
-                        chunk = line
-                    else:
-                        chunk = f"{chunk}\n{line}" if chunk else line
-                if chunk:
-                    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>")
-            await ctx.reply(embed=e)
+        from . import helpcommand
+        helpcommand.register(self)
 
     async def sync_commands(self):
         """Push the bot's slash-command definitions to the server.
@@ -414,6 +386,21 @@ class Bot:
         d = await self._http.get_guild(guild_id)
         return Guild.from_dict(d) if d else None
 
+    async def edit_guild(self, guild_id, *, name=None, description=None, welcome_channel_id=None):
+        """Edit guild name, description (bio), or welcome channel.
+
+        Requires MANAGE_GUILD in the guild. Server enforces this via
+        the bot's actual roles — SDK-side perm claims are ignored.
+        Bots can't create or delete guilds; only edits are permitted.
+        """
+        d = await self._http.edit_guild(
+            guild_id,
+            name=name,
+            description=description,
+            welcome_channel_id=welcome_channel_id,
+        )
+        return Guild.from_dict(d) if d else None
+
     async def get_member(self, guild_id, user_id):
         """Fetch a guild member by user ID. Returns :class:`Member` or ``None``."""
         d = await self._http.get_member(guild_id, user_id)

banterbotapi-0.2.9/banterapi/helpcommand.py

@@ -0,0 +1,39 @@
+"""Default !help command — registered when ``Bot(help_enabled=True)``.
+
+Kept in its own module so the implementation is easy to find, swap out,
+or copy into a user's bot as a starting template. The default is a
+plain-text listing — no embed, no fancy formatting — because the bot
+author should be free to override with whatever they want, and a
+plain enum is the most predictable starting point.
+
+Slash help is intentionally NOT registered. Slash commands are typed
+features the bot author opts in to; a synthetic ``/help`` would clutter
+every bot's autocomplete with no clear benefit. If you want one,
+register it explicitly via ``@bot.slash_command``.
+"""
+
+
+def register(bot):
+    """Attach the default ``<prefix>help`` prefix command to ``bot``.
+
+    Called by :class:`~banterapi.Bot.__init__` when
+    ``help_enabled=True``. Re-registering ``help`` after this point
+    overwrites the default — the registry's ``add`` is last-write-wins.
+    """
+
+    @bot.command(name="help", help="Lists all registered commands.")
+    async def _help(ctx):
+        cmds = sorted(bot.commands, key=lambda c: c.name)
+        if not cmds:
+            await ctx.reply("No commands registered.")
+            return
+        lines = []
+        for cmd in cmds:
+            doc = (cmd.help or "").strip().split("\n", 1)[0]
+            entry = f"`{bot.command_prefix}{cmd.name}`"
+            if cmd.aliases:
+                entry += " (" + ", ".join(bot.command_prefix + a for a in cmd.aliases) + ")"
+            if doc:
+                entry += f" — {doc}"
+            lines.append(entry)
+        await ctx.reply("\n".join(lines))

{banterbotapi-0.2.7 → banterbotapi-0.2.9}/banterapi/http.py

@@ -361,6 +361,28 @@ class HTTPClient:
             "GET", "/guilds/{guild_id}", guild_id=guild_id,
         ))
 
+    async def edit_guild(self, guild_id, *, name=None, description=None, welcome_channel_id=None):
+        """PATCH /guilds/{guild_id} — partial update.
+
+        Requires MANAGE_GUILD in the target guild. Server enforces the
+        check against the bot's actual roles — SDK-reported perms are
+        ignored. Bots cannot create or delete guilds regardless of
+        perms; those routes aren't exposed for bot tokens.
+
+        Pass ``description=""`` to clear the guild bio.
+        """
+        body = {}
+        if name is not None:
+            body["name"] = name
+        if description is not None:
+            body["description"] = description
+        if welcome_channel_id is not None:
+            body["welcome_channel_id"] = welcome_channel_id
+        return await self.request(
+            Route("PATCH", "/guilds/{guild_id}", guild_id=guild_id),
+            json_body=body,
+        )
+
     async def list_roles(self, guild_id):
         """GET /guilds/{guild_id}/roles"""
         return await self.request(Route(

{banterbotapi-0.2.7 → banterbotapi-0.2.9}/banterbotapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: banterbotapi
-Version: 0.2.7
+Version: 0.2.9
 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.7 → banterbotapi-0.2.9}/banterbotapi.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ banterapi/commands.py
 banterapi/embed.py
 banterapi/errors.py
 banterapi/gateway.py
+banterapi/helpcommand.py
 banterapi/http.py
 banterapi/intents.py
 banterapi/interactions.py

{banterbotapi-0.2.7 → banterbotapi-0.2.9}/pyproject.toml

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