pyyapper 1.6.0__tar.gz → 1.7.0__tar.gz

{pyyapper-1.6.0/src/pyyapper.egg-info → pyyapper-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyyapper
-Version: 1.6.0
+Version: 1.7.0
 Summary: An intuitive, async Python library for the Yapper bot API.
 Author: PyYapper contributors
 License-Expression: MIT

{pyyapper-1.6.0 → pyyapper-1.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyyapper"
-version = "1.6.0"
+version = "1.7.0"
 description = "An intuitive, async Python library for the Yapper bot API."
 readme = "README.md"
 license = "MIT"

{pyyapper-1.6.0 → pyyapper-1.7.0}/src/pyyapper/__init__.py

@@ -19,6 +19,7 @@ from .errors import (
 from .models import (
     User, Server, Channel, Category, Member, Message, Role, VoiceChannel, picture_url,
 )
+from .voice import VoiceCall
 from .presence import Activity, Presence
 from .pagination import Paginator
 from .webhooks import Webhook
@@ -43,7 +44,7 @@ __all__ = [
     "Embed", "Button", "Row",
     "YapperError", "ConfigurationError", "HTTPException",
     "BadRequest", "Unauthorized", "Forbidden", "NotFound", "RateLimited", "ServerError", "ServiceUnavailable",
-    "User", "Server", "Channel", "Category", "Member", "Message", "Role", "VoiceChannel", "picture_url",
+    "User", "Server", "Channel", "Category", "Member", "Message", "Role", "VoiceChannel", "picture_url", "VoiceCall",
     "Activity", "Presence",
     "Paginator", "Webhook", "WaiterRegistry", "wait_for",
     "OAuth2Client", "OAuthError", "generate_state", "generate_pkce",

pyyapper-1.7.0/src/pyyapper/_version.py

@@ -0,0 +1 @@
+__version__ = "1.7.0"

{pyyapper-1.6.0 → pyyapper-1.7.0}/src/pyyapper/bot.py

@@ -183,7 +183,7 @@ class Bot:
         self,
         token: Optional[str] = None,
         *,
-        base_url: str = "https://www.yapper.website/api/bot/v1",
+        base_url: str = "https://www.yapin.gg/api/bot/v1",
         prefixes: Optional[list[str]] = None,
         log: Any = True,
         ignore_bots: bool = True,
@@ -848,6 +848,44 @@ class Bot:
             "user_id": user_id,
         })
 
+    # Voice (music): bot joins a voice channel and plays audio
+    async def join_voice(self, server_id: Any, channel_id: Any) -> Any:
+        """Join a voice channel. Returns a LiveKit ticket dict."""
+        return await self.api("POST", f"/servers/{server_id}/voice/join", {
+            "channel_id": channel_id,
+        })
+
+    async def leave_voice(self, server_id: Any) -> Any:
+        """Leave voice in a server."""
+        return await self.api("POST", f"/servers/{server_id}/voice/leave", {})
+
+    async def connect_voice(self, server_id: Any, channel_id: Any, livekit_module: Any = None) -> Any:
+        """Join voice and return a ticket.
+
+        If ``livekit_module`` (e.g. ``livekit.rtc``) is provided and installed,
+        returns a small helper object exposing ``.source`` (an audio source) and
+        ``.leave()``. Otherwise returns the raw ticket dict from the API.
+        """
+        ticket = await self.join_voice(server_id, channel_id)
+        if livekit_module is None:
+            return ticket
+        # Best-effort LiveKit connection. E2EE key exchange is handled by the
+        # caller per the docs; here we just open the room and expose a source.
+        try:
+            from .voice import VoiceCall
+            room = livekit_module.Room()
+            source = livekit_module.AudioSource(48000, 2)
+            track = livekit_module.LocalAudioTrack.create_audio_track("bot-audio", source)
+            await room.connect(ticket["url"], ticket["token"])
+            await room.local_participant.publish_track(track)
+            obj = VoiceCall(room, source, self, server_id, ticket=ticket)
+            return obj
+        except Exception as e:
+            # Fall back to raw ticket if LiveKit isn't available/compatible.
+            if hasattr(self, "logger"):
+                self.logger.warning("connect_voice LiveKit setup failed: %s", e)
+            return ticket
+
     # ------------------------------------------------------------------ #
     # Channels management
     # ------------------------------------------------------------------ #
@@ -1111,6 +1149,10 @@ class Bot:
                 if m and m.group(1) in self.prefixes and m.group(2).lower() in self.commands:
                     name = m.group(2).lower()
                     args = (m.group(3) or "").strip()
+            # If command_for is set and points at another bot, don't handle.
+            command_for = data.get("command_for")
+            if command_for and self.me is not None and command_for != getattr(self.me, "id", None):
+                name = None
             if name and name in self.commands:
                 ctx.command = name
                 ctx.args = args or ""

{pyyapper-1.6.0 → pyyapper-1.7.0}/src/pyyapper/http.py

@@ -43,7 +43,7 @@ from .errors import (
     exception_for_status,
 )
 
-DEFAULT_BASE = "https://www.yapper.website/api/bot/v1"
+DEFAULT_BASE = "https://www.yapin.gg/api/bot/v1"
 USER_AGENT = "pyyapper/1.0"
 
 

{pyyapper-1.6.0 → pyyapper-1.7.0}/src/pyyapper/models.py

@@ -49,7 +49,7 @@ def picture_url(bucket: str, path: Any) -> Optional[str]:
         return None
     p = str(path)
     if p.startswith("/"):
-        return "https://www.yapper.website" + p
+        return "https://www.yapin.gg" + p
     return f"https://files.yapper.website/{bucket}/{p}"
 
 

{pyyapper-1.6.0 → pyyapper-1.7.0}/src/pyyapper/oauth.py

@@ -36,7 +36,7 @@ class OAuthError(YapperError):
         super().__init__(f"{error}: {description}".strip(": "))
 
 
-DEFAULT_BASE = "https://www.yapper.website"
+DEFAULT_BASE = "https://www.yapin.gg"
 AUTHORIZE_PATH = "/oauth/authorize"
 TOKEN_PATH = "/api/oauth/token"
 ME_PATH = "/api/oauth/me"
@@ -72,7 +72,7 @@ class OAuth2Client:
     redirect_uri:
         Default redirect URI (must match one registered for the app).
     base_url:
-        Yapper base URL. Defaults to ``https://www.yapper.website``.
+        Yapper base URL. Defaults to ``https://www.yapin.gg``.
     session:
         Optional shared :class:`aiohttp.ClientSession`.
     """

pyyapper-1.7.0/src/pyyapper/voice.py

@@ -0,0 +1,44 @@
+"""Voice connection helpers for PyYapper (music bots)."""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+class VoiceCall:
+    """A handle to an active voice connection.
+
+    Attributes:
+        room: the LiveKit room (if connected).
+        source: the audio source to capture frames into.
+        ticket: the raw ticket returned by the API.
+    """
+
+    def __init__(self, room: Any, source: Any, bot: Any, server_id: Any, ticket: Any = None) -> None:
+        self.room = room
+        self.source = source
+        self.bot = bot
+        self.server_id = server_id
+        self.ticket = ticket
+
+    async def leave(self) -> Any:
+        try:
+            if self.room is not None:
+                await self.room.disconnect()
+        except Exception:
+            pass
+        try:
+            await self.bot.leave_voice(self.server_id)
+        except Exception:
+            pass
+        return None
+
+    async def capture_frame(self, frame: Any) -> Any:
+        if self.source is not None and hasattr(self.source, "capture_frame"):
+            return await self.source.capture_frame(frame)
+        return None
+
+    async def wait_for_playout(self) -> Any:
+        if self.source is not None and hasattr(self.source, "wait_for_playout"):
+            return await self.source.wait_for_playout()
+        return None

{pyyapper-1.6.0 → pyyapper-1.7.0}/src/pyyapper/webhooks.py

@@ -35,7 +35,7 @@ import aiohttp
 
 from .errors import HTTPException, RateLimited, exception_for_status
 
-WEBHOOK_BASE = "https://www.yapper.website/api/webhooks"
+WEBHOOK_BASE = "https://www.yapin.gg/api/webhooks"
 USER_AGENT = "pyyapper/1.0"
 
 

{pyyapper-1.6.0 → pyyapper-1.7.0/src/pyyapper.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyyapper
-Version: 1.6.0
+Version: 1.7.0
 Summary: An intuitive, async Python library for the Yapper bot API.
 Author: PyYapper contributors
 License-Expression: MIT

{pyyapper-1.6.0 → pyyapper-1.7.0}/src/pyyapper.egg-info/SOURCES.txt

@@ -19,6 +19,7 @@ src/pyyapper/oauth.py
 src/pyyapper/pagination.py
 src/pyyapper/presence.py
 src/pyyapper/py.typed
+src/pyyapper/voice.py
 src/pyyapper/wait_for.py
 src/pyyapper/webhooks.py
 src/pyyapper.egg-info/PKG-INFO

pyyapper-1.6.0/src/pyyapper/_version.py

@@ -1 +0,0 @@
-__version__ = "1.6.0"