loopbot-discord-sdk 1.0.0__py3-none-any.whl

loopbot/builders/action_row.py

@@ -0,0 +1,40 @@
+"""
+Action Row Builder for grouping components
+"""
+
+from typing import Any, Dict, List, Union
+
+from .button import ButtonBuilder
+from .select_menu import SelectMenuBuilder
+
+
+class ActionRowBuilder:
+    """Builder for Discord action rows"""
+
+    def __init__(self):
+        self._components: List[Dict[str, Any]] = []
+
+    def add_button(self, button: ButtonBuilder) -> "ActionRowBuilder":
+        """Add a button to the row"""
+        self._components.append(button.to_dict())
+        return self
+
+    def add_select_menu(self, select: "SelectMenuBuilder") -> "ActionRowBuilder":
+        """Add a select menu to the row"""
+        self._components.append(select.to_dict())
+        return self
+
+    def add_component(self, component: Union[Dict[str, Any], Any]) -> "ActionRowBuilder":
+        """Add a component to the row"""
+        if hasattr(component, "to_dict"):
+            self._components.append(component.to_dict())
+        else:
+            self._components.append(component)
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        return {
+            "type": 1,
+            "components": self._components,
+        }

loopbot/builders/button.py

@@ -0,0 +1,58 @@
+"""
+Button Builder for Discord buttons
+"""
+
+from enum import IntEnum
+from typing import Any, Dict, Optional
+
+
+class ButtonStyle(IntEnum):
+    PRIMARY = 1
+    SECONDARY = 2
+    SUCCESS = 3
+    DANGER = 4
+    LINK = 5
+
+
+class ButtonBuilder:
+    """Builder for Discord buttons"""
+
+    def __init__(self):
+        self._button: Dict[str, Any] = {"type": 2}
+
+    def set_custom_id(self, custom_id: str) -> "ButtonBuilder":
+        """Set the button custom ID"""
+        self._button["custom_id"] = custom_id
+        return self
+
+    def set_label(self, label: str) -> "ButtonBuilder":
+        """Set the button label"""
+        self._button["label"] = label
+        return self
+
+    def set_style(self, style: ButtonStyle) -> "ButtonBuilder":
+        """Set the button style"""
+        self._button["style"] = int(style)
+        return self
+
+    def set_emoji(self, name: str, id: Optional[str] = None) -> "ButtonBuilder":
+        """Set the button emoji"""
+        self._button["emoji"] = {"name": name}
+        if id:
+            self._button["emoji"]["id"] = id
+        return self
+
+    def set_url(self, url: str) -> "ButtonBuilder":
+        """Set the button URL (for link buttons)"""
+        self._button["url"] = url
+        self._button["style"] = int(ButtonStyle.LINK)
+        return self
+
+    def set_disabled(self, disabled: bool = True) -> "ButtonBuilder":
+        """Set whether the button is disabled"""
+        self._button["disabled"] = disabled
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        return self._button

loopbot/builders/container.py

@@ -0,0 +1,61 @@
+"""
+Container Builder for Discord Components V2
+"""
+
+from typing import Any, Dict, List, Union
+
+
+class ContainerBuilder:
+    """Builder for Discord Container components (requires IS_COMPONENTS_V2 flag)"""
+
+    def __init__(self):
+        self._components: List[Dict[str, Any]] = []
+        self._accent_color: int | None = None
+        self._spoiler: bool = False
+
+    def add_component(self, component: Union[Dict[str, Any], Any]) -> "ContainerBuilder":
+        """Add a child component"""
+        if hasattr(component, "to_dict"):
+            self._components.append(component.to_dict())
+        else:
+            self._components.append(component)
+        return self
+
+    def add_text(self, content: str) -> "ContainerBuilder":
+        """Add a text display component"""
+        self._components.append({
+            "type": 10,
+            "content": content,
+        })
+        return self
+
+    def add_separator(self, divider: bool = True, spacing: int = 1) -> "ContainerBuilder":
+        """Add a separator component"""
+        self._components.append({
+            "type": 14,
+            "divider": divider,
+            "spacing": spacing,
+        })
+        return self
+
+    def set_accent_color(self, color: int) -> "ContainerBuilder":
+        """Set the accent color (RGB value)"""
+        self._accent_color = color
+        return self
+
+    def set_spoiler(self, spoiler: bool = True) -> "ContainerBuilder":
+        """Set whether container is a spoiler"""
+        self._spoiler = spoiler
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        result: Dict[str, Any] = {
+            "type": 17,
+            "components": self._components,
+        }
+        if self._accent_color is not None:
+            result["accent_color"] = self._accent_color
+        if self._spoiler:
+            result["spoiler"] = self._spoiler
+        return result

loopbot/builders/embed.py

@@ -0,0 +1,95 @@
+"""
+Embed Builder for Discord rich embeds
+"""
+
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+
+class EmbedBuilder:
+    """Builder for Discord embeds"""
+
+    def __init__(self):
+        self._embed: Dict[str, Any] = {}
+
+    def set_title(self, title: str) -> "EmbedBuilder":
+        """Set the embed title"""
+        self._embed["title"] = title
+        return self
+
+    def set_description(self, description: str) -> "EmbedBuilder":
+        """Set the embed description"""
+        self._embed["description"] = description
+        return self
+
+    def set_url(self, url: str) -> "EmbedBuilder":
+        """Set the embed URL"""
+        self._embed["url"] = url
+        return self
+
+    def set_color(self, color: int) -> "EmbedBuilder":
+        """Set the embed color (RGB integer)"""
+        self._embed["color"] = color
+        return self
+
+    def set_timestamp(self, timestamp: Optional[datetime] = None) -> "EmbedBuilder":
+        """Set the embed timestamp"""
+        if timestamp is None:
+            timestamp = datetime.utcnow()
+        self._embed["timestamp"] = timestamp.isoformat()
+        return self
+
+    def set_footer(
+        self,
+        text: str,
+        icon_url: Optional[str] = None,
+    ) -> "EmbedBuilder":
+        """Set the embed footer"""
+        self._embed["footer"] = {"text": text}
+        if icon_url:
+            self._embed["footer"]["icon_url"] = icon_url
+        return self
+
+    def set_image(self, url: str) -> "EmbedBuilder":
+        """Set the embed image"""
+        self._embed["image"] = {"url": url}
+        return self
+
+    def set_thumbnail(self, url: str) -> "EmbedBuilder":
+        """Set the embed thumbnail"""
+        self._embed["thumbnail"] = {"url": url}
+        return self
+
+    def set_author(
+        self,
+        name: str,
+        url: Optional[str] = None,
+        icon_url: Optional[str] = None,
+    ) -> "EmbedBuilder":
+        """Set the embed author"""
+        self._embed["author"] = {"name": name}
+        if url:
+            self._embed["author"]["url"] = url
+        if icon_url:
+            self._embed["author"]["icon_url"] = icon_url
+        return self
+
+    def add_field(
+        self,
+        name: str,
+        value: str,
+        inline: bool = False,
+    ) -> "EmbedBuilder":
+        """Add a field to the embed"""
+        if "fields" not in self._embed:
+            self._embed["fields"] = []
+        self._embed["fields"].append({
+            "name": name,
+            "value": value,
+            "inline": inline,
+        })
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        return self._embed

loopbot/builders/file.py

@@ -0,0 +1,33 @@
+"""
+File Builder for Discord Components V2
+"""
+
+from typing import Any, Dict
+
+
+class FileBuilder:
+    """Builder for Discord File components (requires IS_COMPONENTS_V2 flag)"""
+
+    def __init__(self, url: str):
+        self._url: str = url
+        self._spoiler: bool = False
+
+    def set_url(self, url: str) -> "FileBuilder":
+        """Set the file URL"""
+        self._url = url
+        return self
+
+    def set_spoiler(self, spoiler: bool = True) -> "FileBuilder":
+        """Set whether file is a spoiler"""
+        self._spoiler = spoiler
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        result: Dict[str, Any] = {
+            "type": 13,
+            "file": {"url": self._url},
+        }
+        if self._spoiler:
+            result["spoiler"] = self._spoiler
+        return result

loopbot/builders/media_gallery.py

@@ -0,0 +1,36 @@
+"""
+Media Gallery Builder for Discord Components V2
+"""
+
+from typing import Any, Dict, List, Optional
+
+
+class MediaGalleryBuilder:
+    """Builder for Discord Media Gallery components (requires IS_COMPONENTS_V2 flag)"""
+
+    def __init__(self):
+        self._items: List[Dict[str, Any]] = []
+
+    def add_item(
+        self,
+        url: str,
+        description: Optional[str] = None,
+        spoiler: bool = False,
+    ) -> "MediaGalleryBuilder":
+        """Add a media item to the gallery"""
+        item: Dict[str, Any] = {
+            "media": {"url": url},
+        }
+        if description:
+            item["description"] = description
+        if spoiler:
+            item["spoiler"] = spoiler
+        self._items.append(item)
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        return {
+            "type": 12,
+            "items": self._items,
+        }

loopbot/builders/modal.py

@@ -0,0 +1,67 @@
+"""
+Modal Builder for Discord modals
+"""
+
+from typing import Any, Dict, List, Literal, Optional
+
+
+class ModalBuilder:
+    """Builder for Discord modals"""
+
+    def __init__(self):
+        self._custom_id: str = ""
+        self._title: str = ""
+        self._components: List[Dict[str, Any]] = []
+
+    def set_custom_id(self, custom_id: str) -> "ModalBuilder":
+        """Set the modal custom ID"""
+        self._custom_id = custom_id
+        return self
+
+    def set_title(self, title: str) -> "ModalBuilder":
+        """Set the modal title"""
+        self._title = title
+        return self
+
+    def add_text_input(
+        self,
+        custom_id: str,
+        label: str,
+        style: Literal["short", "paragraph"] = "short",
+        required: bool = True,
+        min_length: Optional[int] = None,
+        max_length: Optional[int] = None,
+        placeholder: Optional[str] = None,
+        value: Optional[str] = None,
+    ) -> "ModalBuilder":
+        """Add a text input to the modal"""
+        input_data: Dict[str, Any] = {
+            "type": 4,
+            "custom_id": custom_id,
+            "style": 1 if style == "short" else 2,
+            "label": label,
+            "required": required,
+        }
+        if min_length is not None:
+            input_data["min_length"] = min_length
+        if max_length is not None:
+            input_data["max_length"] = max_length
+        if placeholder:
+            input_data["placeholder"] = placeholder
+        if value:
+            input_data["value"] = value
+
+        # Wrap in action row
+        self._components.append({
+            "type": 1,
+            "components": [input_data],
+        })
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        return {
+            "title": self._title,
+            "custom_id": self._custom_id,
+            "components": self._components,
+        }

loopbot/builders/section.py

@@ -0,0 +1,52 @@
+"""
+Section Builder for Discord Components V2
+"""
+
+from typing import Any, Dict, List, Optional, Union
+
+from .button import ButtonBuilder
+
+
+class SectionBuilder:
+    """Builder for Discord Section components (requires IS_COMPONENTS_V2 flag)"""
+
+    def __init__(self):
+        self._components: List[Dict[str, Any]] = []
+        self._accessory: Dict[str, Any] | None = None
+
+    def add_text(self, content: str) -> "SectionBuilder":
+        """Add a text display component"""
+        self._components.append({
+            "type": 10,
+            "content": content,
+        })
+        return self
+
+    def set_button_accessory(self, button: ButtonBuilder) -> "SectionBuilder":
+        """Set a button as the accessory"""
+        self._accessory = button.to_dict()
+        return self
+
+    def set_thumbnail_accessory(
+        self,
+        url: str,
+        description: Optional[str] = None,
+    ) -> "SectionBuilder":
+        """Set a thumbnail as the accessory"""
+        self._accessory = {
+            "type": 11,
+            "media": {"url": url},
+        }
+        if description:
+            self._accessory["description"] = description
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        result: Dict[str, Any] = {
+            "type": 9,
+            "components": self._components,
+        }
+        if self._accessory:
+            result["accessory"] = self._accessory
+        return result

loopbot/builders/select_menu.py

@@ -0,0 +1,63 @@
+"""
+Select Menu Builder for Discord dropdowns
+"""
+
+from typing import Any, Dict, List, Optional
+
+
+class SelectMenuBuilder:
+    """Builder for Discord select menus"""
+
+    def __init__(self):
+        self._select: Dict[str, Any] = {"type": 3, "options": []}
+
+    def set_custom_id(self, custom_id: str) -> "SelectMenuBuilder":
+        """Set the select menu custom ID"""
+        self._select["custom_id"] = custom_id
+        return self
+
+    def set_placeholder(self, placeholder: str) -> "SelectMenuBuilder":
+        """Set the placeholder text"""
+        self._select["placeholder"] = placeholder
+        return self
+
+    def set_min_values(self, min_values: int) -> "SelectMenuBuilder":
+        """Set minimum values to select"""
+        self._select["min_values"] = min_values
+        return self
+
+    def set_max_values(self, max_values: int) -> "SelectMenuBuilder":
+        """Set maximum values to select"""
+        self._select["max_values"] = max_values
+        return self
+
+    def set_disabled(self, disabled: bool = True) -> "SelectMenuBuilder":
+        """Set whether the select is disabled"""
+        self._select["disabled"] = disabled
+        return self
+
+    def add_option(
+        self,
+        label: str,
+        value: str,
+        description: Optional[str] = None,
+        emoji: Optional[Dict[str, str]] = None,
+        default: bool = False,
+    ) -> "SelectMenuBuilder":
+        """Add an option to the select menu"""
+        option: Dict[str, Any] = {
+            "label": label,
+            "value": value,
+        }
+        if description:
+            option["description"] = description
+        if emoji:
+            option["emoji"] = emoji
+        if default:
+            option["default"] = default
+        self._select["options"].append(option)
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        return self._select

loopbot/builders/separator.py

@@ -0,0 +1,31 @@
+"""
+Separator Builder for Discord Components V2
+"""
+
+from typing import Any, Dict, Literal
+
+
+class SeparatorBuilder:
+    """Builder for Discord Separator components (requires IS_COMPONENTS_V2 flag)"""
+
+    def __init__(self):
+        self._divider: bool = True
+        self._spacing: int = 1
+
+    def set_divider(self, divider: bool) -> "SeparatorBuilder":
+        """Set whether to show visual divider"""
+        self._divider = divider
+        return self
+
+    def set_spacing(self, spacing: Literal[1, 2]) -> "SeparatorBuilder":
+        """Set spacing size (1 = small, 2 = large)"""
+        self._spacing = spacing
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        return {
+            "type": 14,
+            "divider": self._divider,
+            "spacing": self._spacing,
+        }

loopbot/builders/text_display.py

@@ -0,0 +1,24 @@
+"""
+Text Display Builder for Discord Components V2
+"""
+
+from typing import Any, Dict
+
+
+class TextDisplayBuilder:
+    """Builder for Discord Text Display components (requires IS_COMPONENTS_V2 flag)"""
+
+    def __init__(self, content: str = ""):
+        self._content: str = content
+
+    def set_content(self, content: str) -> "TextDisplayBuilder":
+        """Set the text content (supports markdown)"""
+        self._content = content
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to Discord API format"""
+        return {
+            "type": 10,
+            "content": self._content,
+        }