banterbotapi 0.2.7__tar.gz → 0.2.8__tar.gz

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

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

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

@@ -414,6 +414,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.7 → banterbotapi-0.2.8}/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.8}/banterbotapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: banterbotapi
-Version: 0.2.7
+Version: 0.2.8
 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.8}/pyproject.toml

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