scurrypy 0.3.0__py3-none-any.whl → 0.3.3__py3-none-any.whl

discord/__init__.py

@@ -1,10 +1,223 @@
 # discord
 
-from .logger import Logger
-from .client import Client
-from .intents import Intents, set_intents
-from .config import BaseConfig
-
-from .events import *
-from .resources import *
-from .parts import *
+import importlib
+from typing import TYPE_CHECKING
+
+__all__ = [
+    # top-level
+    "Logger",
+    "Client",
+    "Intents",
+    "set_intents",
+    "BaseConfig",
+
+    # events
+    "ReadyEvent",
+    "ReactionAddEvent",
+    "ReactionRemoveEvent",
+    "ReactionRemoveEmojiEvent",
+    "ReactionRemoveAllEvent",
+    "GuildCreateEvent",
+    "GuildUpdateEvent",
+    "GuildDeleteEvent",
+    "MessageCreateEvent",
+    "MessageUpdateEvent",
+    "MessageDeleteEvent",
+    "GuildChannelCreateEvent",
+    "GuildChannelUpdateEvent",
+    "GuildChannelDeleteEvent",
+    "ChannelPinsUpdateEvent",
+    "InteractionEvent",
+
+    # models
+    "ApplicationModel",
+    "EmojiModel",
+    "GuildModel",
+    "MemberModel",
+    "UserModel",
+    "RoleModel",
+
+    # parts
+    "GuildChannel",
+    "Role",
+    "MessageBuilder",
+    "ModalBuilder",
+    "EmbedBuilder",
+    "ActionRow",
+    "StringSelect",
+    "UserSelect",
+    "RoleSelect",
+    "ChannelSelect",
+    "MentionableSelect",
+    "SlashCommand",
+    "MessageCommand",
+    "UserCommand",
+    "Container",
+    "Section",
+    "MediaGalleryItem",
+    "Label",
+
+    # resources
+    "Guild",
+    "Channel",
+    "Message",
+    "BotEmojis",
+    "User",
+    "Interaction",
+    "Application",
+]
+
+# For editor support / autocomplete
+if TYPE_CHECKING:
+    from .logger import Logger
+    from .client import Client
+    from .intents import Intents, set_intents
+    from .config import BaseConfig
+
+    # events
+    from .events.ready_event import ReadyEvent
+    from .events.reaction_events import (
+        ReactionAddEvent,
+        ReactionRemoveEvent,
+        ReactionRemoveEmojiEvent,
+        ReactionRemoveAllEvent,
+    )
+    from .events.guild_events import (
+        GuildCreateEvent,
+        GuildUpdateEvent,
+        GuildDeleteEvent,
+    )
+    from .events.message_events import (
+        MessageCreateEvent,
+        MessageUpdateEvent,
+        MessageDeleteEvent,
+    )
+    from .events.channel_events import (
+        GuildChannelCreateEvent,
+        GuildChannelUpdateEvent,
+        GuildChannelDeleteEvent,
+        ChannelPinsUpdateEvent,
+    )
+    from .events.interaction_events import InteractionEvent
+
+    # models
+    from .models.application import ApplicationModel
+    from .models.emoji import EmojiModel
+    from .models.guild import GuildModel
+    from .models.member import MemberModel
+    from .models.user import UserModel
+    from .models.role import RoleModel
+
+    # parts
+    from .parts.channel import GuildChannel
+    from .parts.role import Role
+    from .parts.message import MessageBuilder
+    from .parts.modal import ModalBuilder
+    from .parts.embed import EmbedBuilder
+    from .parts.action_row import (
+        ActionRow, 
+        StringSelect,
+        UserSelect,
+        RoleSelect,
+        ChannelSelect,
+        MentionableSelect
+    )
+
+    from .parts.command import (
+        SlashCommand, 
+        MessageCommand, 
+        UserCommand
+    )
+
+    from .parts.components_v2 import (
+        Container,
+        Section,
+        MediaGalleryItem,
+        Label
+    )
+
+    # resources
+    from .resources.guild import Guild
+    from .resources.channel import Channel
+    from .resources.message import Message
+    from .resources.bot_emojis import BotEmojis
+    from .resources.user import User
+    from .resources.interaction import Interaction
+    from .resources.application import Application
+
+# Lazy loader
+def __getattr__(name: str):
+    if name not in __all__:
+        raise AttributeError(f"module {__name__} has no attribute {name}")
+
+    mapping = {
+        # top-level
+        "Logger": "discord.logger",
+        "Client": "discord.client",
+        "Intents": "discord.intents",
+        "set_intents": "discord.intents",
+        "BaseConfig": "discord.config",
+
+        # events
+        "ReadyEvent": "discord.events.ready_event",
+        "ReactionAddEvent": "discord.events.reaction_events",
+        "ReactionRemoveEvent": "discord.events.reaction_events",
+        "ReactionRemoveEmojiEvent": "discord.events.reaction_events",
+        "ReactionRemoveAllEvent": "discord.events.reaction_events",
+        "GuildCreateEvent": "discord.events.guild_events",
+        "GuildUpdateEvent": "discord.events.guild_events",
+        "GuildDeleteEvent": "discord.events.guild_events",
+        "MessageCreateEvent": "discord.events.message_events",
+        "MessageUpdateEvent": "discord.events.message_events",
+        "MessageDeleteEvent": "discord.events.message_events",
+        "GuildChannelCreateEvent": "discord.events.channel_events",
+        "GuildChannelUpdateEvent": "discord.events.channel_events",
+        "GuildChannelDeleteEvent": "discord.events.channel_events",
+        "ChannelPinsUpdateEvent": "discord.events.channel_events",
+        "InteractionEvent": "discord.events.interaction_events",
+
+        # models
+        'ApplicationModel': "discord.models.application",
+        'EmojiModel': "discord.models.emoji",
+        'GuildModel': "discord.models.guild",
+        'MemberModel': "discord.models.member",
+        'UserModel': "discord.models.user",
+        'RoleModel': "discord.models.role",
+
+        # parts
+        'GuildChannel': "discord.parts.channel",
+        'Role': "discord.parts.role",
+        'MessageBuilder': "discord.parts.message",
+        'ModalBuilder': "discord.parts.modal",
+        'EmbedBuilder': "discord.parts.embed",
+        'ActionRow': "discord.parts.action_row",
+        'StringSelect': "discord.parts.action_row",
+        'UserSelect': "discord.parts.action_row",
+        'RoleSelect': "discord.parts.action_row",
+        'ChannelSelect': "discord.parts.action_row",
+        'MentionableSelect': "discord.parts.action_row",
+        'SlashCommand': "discord.parts.command",
+        'MessageCommand': "discord.parts.command",
+        'UserCommand': "discord.parts.command",
+        'Container': "discord.parts.components_v2",
+        'Section': "discord.parts.components_v2",
+        'MediaGalleryItem': "discord.parts.components_v2",
+        'Label': "discord.parts.components_v2",
+
+        # resources
+        'Guild': "discord.resources.guild",
+        'Channel': "discord.resources.channel",
+        'Message': "discord.resources.message",
+        'BotEmojis': "discord.resources.bot_emojis",
+        'User': "discord.resources.user",
+        'Interaction': "discord.resources.interaction",
+        'Application': "discord.resources.application"
+    }
+
+    module = importlib.import_module(mapping[name])
+    attr = getattr(module, name)
+    globals()[name] = attr  # cache it for future lookups
+    return attr
+
+def __dir__():
+    return sorted(list(globals().keys()) + __all__)

discord/client.py

@@ -1,26 +1,10 @@
-import asyncio
-
-from .logger import Logger
-from .gateway import GatewayClient
-from .http import HTTPClient
+from .config import BaseConfig
 from .intents import Intents
 from .error import DiscordError
-from .config import BaseConfig
 from .client_like import ClientLike
 
-from .resources.guild import Guild
-from .resources.channel import Channel
-from .resources.message import Message
-from .resources.bot_emojis import BotEmojis
-from .resources.user import User
-from .resources.application import Application
-
 from .parts.command import SlashCommand, MessageCommand, UserCommand
 
-from .dispatch.event_dispatcher import EventDispatcher
-from .dispatch.prefix_dispatcher import PrefixDispatcher
-from .dispatch.command_dispatcher import CommandDispatcher
-
 class Client(ClientLike):
     """Main entry point for Discord bots.
         Ties together the moving parts: gateway, HTTP, event dispatching, command handling, and resource managers.
@@ -45,6 +29,14 @@ class Client(ClientLike):
             prefix (str, optional): set message prefix if using command prefixes
             quiet (bool, optional): if INFO, DEBUG, and WARN should be logged
         """
+        from .logger import Logger
+        from .gateway import GatewayClient
+        from .http import HTTPClient
+        from .resources.bot_emojis import BotEmojis
+        from .dispatch.event_dispatcher import EventDispatcher
+        from .dispatch.prefix_dispatcher import PrefixDispatcher
+        from .dispatch.command_dispatcher import CommandDispatcher
+
         self.token = token
         self.application_id = application_id
         self.config = config
@@ -100,13 +92,13 @@ class Client(ClientLike):
         def decorator(func):
             # hash out command type
             if isinstance(command, MessageCommand):
-                self.command_dispatcher.message_command(func)
+                self.command_dispatcher.message_command(command.name, func)
             elif isinstance(command, UserCommand):
-                self.command_dispatcher.user_command(func)
+                self.command_dispatcher.user_command(command.name, func)
             elif isinstance(command, SlashCommand):
-                self.command_dispatcher.command(func)
+                self.command_dispatcher.command(command.name, func)
             else:
-                raise ValueError(f'Command {func.__name__} expected to be of type SlashCommand, UserCommand, MessageCommand; \
+                raise ValueError(f'Command {command.name} expected to be of type SlashCommand, UserCommand, MessageCommand; \
                     got {type(command).__name__}.')
             
             # then hash out if this command should be guild or global level
@@ -154,6 +146,8 @@ class Client(ClientLike):
         Returns:
             (Application): the Application resource
         """
+        from .resources.application import Application
+
         return Application(application_id, self._http)
 
     def guild_from_id(self, guild_id: int):
@@ -165,6 +159,8 @@ class Client(ClientLike):
         Returns:
             (Guild): the Guild resource
         """
+        from .resources.guild import Guild
+
         return Guild(guild_id, self._http)
 
     def channel_from_id(self, channel_id: int):
@@ -176,6 +172,8 @@ class Client(ClientLike):
         Returns:
             (Channel): the Channel resource
         """
+        from .resources.channel import Channel
+
         return Channel(channel_id, self._http)
 
     def message_from_id(self, channel_id: int, message_id: int):
@@ -188,6 +186,8 @@ class Client(ClientLike):
         Returns:
             (Message): the Message resource
         """
+        from .resources.message import Message
+
         return Message(message_id, channel_id, self._http)
     
     def user_from_id(self, user_id: int):
@@ -199,6 +199,8 @@ class Client(ClientLike):
         Returns:
             (User): the User resource
         """
+        from .resources.user import User
+
         return User(user_id, self._http)
     
     async def clear_guild_commands(self, guild_id: int):
@@ -215,6 +217,8 @@ class Client(ClientLike):
 
     async def _listen(self):
         """Main event loop for incoming gateway requests."""
+        import asyncio
+
         while True:
             try:
                 message = await self._ws.receive()
@@ -270,6 +274,8 @@ class Client(ClientLike):
         """Runs the main lifecycle of the bot.
             Handles connection setup, heartbeat management, event loop, and automatic reconnects.
         """
+        import asyncio
+
         while True:
             try:
                 await self._http.start_session()
@@ -338,6 +344,8 @@ class Client(ClientLike):
             Handles starting the session, WS, and heartbeat, reconnection logic,
             setting up emojis and hooks, and then listens for gateway events.
         """
+        import asyncio
+        
         try:
             asyncio.run(self.start())
         except KeyboardInterrupt:

discord/dispatch/command_dispatcher.py

@@ -78,39 +78,42 @@ class CommandDispatcher:
 
         await self._http.request('PUT', f"applications/{self.application_id}/commands", global_commands)
 
-    def command(self, handler):
+    def command(self, name: str, handler):
         """Decorator to register slash commands.
 
         Args:
+            name (str): name of the command to register
             handler (callable): callback handle for command response
         """
-        self._handlers[handler.__name__] = handler
-    
-    def component(self, func, custom_id: str):
-        """Decorator to register component interactions.
-
-        Args:
-            custom_id (str): Identifier of the component 
-                !!! warning "Important"
-                    Must match the `custom_id` set where the component was created.
-        """
-        self._component_handlers[custom_id] = func
+        self._handlers[name] = handler
 
-    def user_command(self, handler):
+    def user_command(self, name: str, handler):
         """Decorator to register user commands.
 
         Args:
+            name (str): name of the command to register
             handler (callable): callback handle for user command response
         """
-        self._user_handlers[handler.__name__] = handler
+        self._user_handlers[name] = handler
 
-    def message_command(self, handler):
+    def message_command(self, name: str, handler):
         """Decorator to register message commands.
 
         Args:
+            name (str): name of the command to register
             handler (callable): callback handle for message command response
         """
-        self._message_handlers[handler.__name__] = handler
+        self._message_handlers[name] = handler
+
+    def component(self, func, custom_id: str):
+        """Decorator to register component interactions.
+
+        Args:
+            custom_id (str): Identifier of the component 
+                !!! warning "Important"
+                    Must match the `custom_id` set where the component was created.
+        """
+        self._component_handlers[custom_id] = func
 
     async def dispatch(self, data: dict):
         """Dispatch a response to an `INTERACTION_CREATE` event

discord/dispatch/event_dispatcher.py

@@ -1,42 +1,19 @@
+from importlib import import_module
 from ..client_like import ClientLike
 
-from ..events.ready_event import *
-from ..events.reaction_events import *
-from ..events.guild_events import *
-from ..events.message_events import *
-from ..events.channel_events import *
-from ..events.interaction_events import *
-
 from ..resources.message import Message
 
 class EventDispatcher:
     """Central hub for handling Discord Gateway events."""
-    RESOURCE_MAP = { # maps discord events to their respective dataclass
-        'READY': ReadyEvent,
-        
-        "MESSAGE_CREATE": MessageCreateEvent,
-        "MESSAGE_UPDATE": MessageUpdateEvent,
-        'MESSAGE_DELETE': MessageDeleteEvent,
-
-        'MESSAGE_REACTION_ADD': ReactionAddEvent,
-        'MESSAGE_REACTION_REMOVE': ReactionRemoveEvent,
-        'MESSAGE_REACTION_REMOVE_ALL': ReactionRemoveAllEvent,
-        'MESSAGE_REACTION_REMOVE_EMOJI': ReactionRemoveEmojiEvent,
-
-        'CHANNEL_CREATE': GuildChannelCreateEvent,
-        'CHANNEL_UPDATE': GuildChannelUpdateEvent,
-        'CHANNEL_DELETE': GuildChannelDeleteEvent,
 
-        'CHANNEL_PINS_UPDATE': ChannelPinsUpdateEvent,
-
-        'GUILD_CREATE': GuildCreateEvent,
-        'GUILD_UPDATE': GuildUpdateEvent,
-        'GUILD_DELETE': GuildDeleteEvent,
-
-        'INTERACTION_CREATE': InteractionEvent
+    RESOURCE_MAP = { # maps discord events to their respective dataclass (lazy loading)
+        'READY': ('discord.events.ready_event', 'ReadyEvent'),
 
+        'MESSAGE_CREATE': ('discord.events.message_events', 'MessageCreateEvent')
+        
         # and other events...
     }
+    
     """Mapping of event names to respective dataclass."""
     
     def __init__(self, client: ClientLike):
@@ -75,9 +52,21 @@ class EventDispatcher:
             event_name (str): name of the event
             data (dict): Discord's raw event payload
         """
-        cls = self.RESOURCE_MAP.get(event_name)
+        module_info = self.RESOURCE_MAP.get(event_name)
+        
+        if not module_info:
+            return
         
+        module_name, class_name = module_info
+
+        module = import_module(module_name)
+        if not module:
+            print(f"Cannot find module '{module_name}'!")
+            return
+
+        cls = getattr(module, class_name)
         if not cls:
+            print(f"Cannot find class '{class_name}'!")
             return
         
         if isinstance(cls, Message) and cls.author.id == self.application_id:

discord/events/__init__.py

@@ -1,33 +1 @@
 # discord/events
-
-from .ready_event import ReadyEvent
-
-from .reaction_events import (
-    ReactionAddEvent,
-    ReactionRemoveEvent,
-    ReactionRemoveEmojiEvent,
-    ReactionRemoveAllEvent
-)
-
-from .guild_events import (
-    GuildCreateEvent,
-    GuildUpdateEvent,
-    GuildDeleteEvent
-)
-
-from .message_events import (
-    MessageCreateEvent,
-    MessageUpdateEvent,
-    MessageDeleteEvent
-)
-
-from .channel_events import (
-    GuildChannelCreateEvent,
-    GuildChannelUpdateEvent,
-    GuildChannelDeleteEvent,
-    ChannelPinsUpdateEvent
-)
-
-from .interaction_events import (
-    InteractionEvent
-)

discord/events/guild_events.py

@@ -1,5 +1,5 @@
 from dataclasses import dataclass
-from ..models import MemberModel
+from ..models.member import MemberModel
 from ..resources.channel import Channel
 
 @dataclass

discord/logger.py

@@ -1,6 +1,3 @@
-from datetime import datetime
-import copy
-
 class Logger:
     """A utility class for logging messages, supporting log levels, color-coded console output, 
         optional file logging, and redaction of sensitive information. 
@@ -51,6 +48,8 @@ class Logger:
         Returns:
             (str): timestamp formatted in YYYY-MM-DD HH:MM:SS
         """
+        from datetime import datetime
+        
         return datetime.now().strftime("%Y-%m-%d %H:%M:%S")
     
     def _log(self, level: str, color: str, message: str):
@@ -140,6 +139,8 @@ class Logger:
                 return [_redact(item) for item in obj]
             return obj
 
+        import copy
+
         return _redact(copy.deepcopy(data))
     
     def close(self):

discord/models/__init__.py

@@ -1,8 +1 @@
 # discord/models
-
-from .application import ApplicationModel
-from .emoji import EmojiModel
-from .guild import GuildModel
-from .member import MemberModel
-from .user import UserModel
-from .role import RoleModel

discord/models/interaction.py

@@ -0,0 +1,26 @@
+from dataclasses import dataclass
+from ..model import DataModel
+
+@dataclass
+class InteractionCallbackDataModel(DataModel):
+    id: int
+    """ID of the interaction."""
+
+    type: int
+    """Type of interaction."""
+
+    activity_instance_id: str
+    """Instance ID of activity if an activity was launched or joined."""
+
+    response_message_id: int
+    """ID of the message created by the interaction."""
+
+    response_message_loading: bool
+    """If the interaction is in a loading state."""
+
+    response_message_ephemeral: bool
+    """If the interaction is ephemeral."""
+
+@dataclass
+class InteractionCallbackModel(DataModel):
+    interaction: InteractionCallbackDataModel

discord/parts/__init__.py

@@ -1,28 +1,2 @@
 # discord/parts
 
-from .channel import GuildChannel
-from .role import Role
-from .message import MessageBuilder
-from .modal import ModalBuilder
-from .embed import EmbedBuilder
-from .action_row import (
-    ActionRow, 
-    StringSelect,
-    UserSelect,
-    RoleSelect,
-    ChannelSelect,
-    MentionableSelect
-)
-
-from .command import (
-    SlashCommand, 
-    MessageCommand, 
-    UserCommand
-)
-
-from .components_v2 import (
-    Container,
-    Section,
-    MediaGalleryItem,
-    Label
-)

discord/parts/message.py

@@ -1,4 +1,3 @@
-import os
 from dataclasses import dataclass, field
 from typing import Optional, TypedDict, Unpack, Literal
 from discord.model import DataModel
@@ -114,6 +113,8 @@ class MessageBuilder(DataModel):
         Returns:
             (MessageBuilder): self
         """
+        import os
+        
         self.attachments.append(
             _Attachment(
                 id=len(self.attachments), 

discord/resources/__init__.py

@@ -1,10 +1 @@
 # discord/resources
-
-from .guild import Guild
-from .channel import Channel
-from .message import Message
-from .bot_emojis import BotEmojis
-from .user import User
-from .interaction import Interaction
-from .application import Application
-from .interaction import Interaction

discord/resources/channel.py

@@ -1,5 +1,5 @@
 from dataclasses import dataclass
-from typing import TypedDict, Unpack, Optional
+from typing import TypedDict, Unpack, Optional, Literal
 
 from ..http import HTTPClient
 from ..model import DataModel
@@ -32,6 +32,15 @@ class PinsFetchParams(TypedDict, total=False):
     limit: int
     """Max number of pinned messages to return. Range 1 - 50. Default 50."""
 
+class ThreadFromMessageParams(TypedDict, total=False):
+    """Params when attaching a thread to a message."""
+
+    rate_limit_per_user: Literal[60, 1440, 4320, 10080]
+    """time (minutes) of inactivity before thread is archived."""
+
+    rate_limit_per_user: int
+    """time (seconds) user waits before sending another message."""
+
 @dataclass
 class PinnedMessage(DataModel):
     """Pinned message data."""
@@ -160,6 +169,26 @@ class Channel(DataModel):
 
         return self
     
+    async def create_thread_from_message(self, message_id: int, name: str, **kwargs: Unpack[ThreadFromMessageParams]):
+        """Create a thread from this message
+
+        Args:
+            message_id: ID of message to attach thread
+            name (str): thread name
+
+        Returns:
+            (Channel): The updated channel object
+        """
+
+        content = {
+            'name': name, 
+            **kwargs
+        }
+
+        data = await self._http.request('POST', f"channels/{self.id}/messages/{message_id}/threads", data=content)
+
+        return Channel.from_dict(data, self._http)
+    
     async def fetch_pins(self, **kwargs: Unpack[PinsFetchParams]):
         """Get this channel's pinned messages.
 

discord/resources/interaction.py

@@ -6,11 +6,10 @@ from ..model import DataModel
 
 from ..parts.modal import ModalBuilder
 from ..parts.message import *
-from ..parts.embed import *
-from ..parts.component_types import *
 
 from ..models.guild import GuildModel
 from ..models.member import MemberModel
+from ..models.interaction import InteractionCallbackModel
 
 from .channel import Channel
 
@@ -98,11 +97,12 @@ class Interaction(DataModel):
     channel: Optional[Channel] = None
     """Partial channel object the interaction was invoked."""
 
-    async def respond(self, message: str | MessageBuilder, **flags: Unpack[MessageFlagParams]):
+    async def respond(self, message: str | MessageBuilder, with_response: bool = False, **flags: Unpack[MessageFlagParams]):
         """Create a message in response to an interaction.
 
         Args:
             message (str | MessageBuilder): content as a string or from MessageBuilder
+            with_response (bool, optional): if the interaction data should be returned. Defaults to False.
         """
         if isinstance(message, str):
             message = MessageBuilder(content=message).set_flags(**flags)
@@ -112,12 +112,18 @@ class Interaction(DataModel):
             'data': message._to_dict()
         }
 
-        await self._http.request(
+        params = {'with_response': with_response}
+
+        data = await self._http.request(
             'POST', 
             f'/interactions/{self.id}/{self.token}/callback', 
             content, 
-            files=[fp.path for fp in message.attachments])
+            files=[fp.path for fp in message.attachments],
+            params=params)
 
+        if with_response:
+            return InteractionCallbackModel.from_dict(data, self._http)
+        
     async def update(self, message: str | MessageBuilder, **flags: Unpack[MessageFlagParams]):
         """Update a message in response to an interaction.
 

scurrypy-0.3.3.dist-info/METADATA

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: scurrypy
+Version: 0.3.3
+Summary: Discord API Wrapper in Python
+Author: Furmissile
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# __Welcome to ScurryPy__
+
+[![PyPI version](https://badge.fury.io/py/scurrypy.svg)](https://badge.fury.io/py/scurrypy)
+
+Yet another Discord API wrapper in Python!  
+
+While this wrapper is mainly used for various squirrel-related shenanigans, it can also be used for more generic bot purposes.
+
+## Features
+* Command and event handling
+* Declarative style using decorators
+* Supports both legacy and new features
+* Respects Discord's rate limits
+
+## Some things to consider...
+* This is an early version — feedback, ideas, and contributions are very welcome! That said, there may be bumps along the way, so expect occasional bugs and quirks.
+* Certain features are not yet supported, while others are intentionally omitted. See the [docs](https://furmissile.github.io/scurrypy) for full details.
+
+## Getting Started
+*Note: This section also appears in the documentation, but here are complete examples ready to use with your bot credentials.*
+
+### Installation
+To install the ScurryPy package, run:
+```bash
+pip install scurrypy
+```
+
+### Minimal Slash Command
+The following demonstrates building and responding to a slash command.
+
+*Note: Adjust `dotenv_path` if your `.env` file is not in the same directory as this script.*
+
+```python
+import discord, os
+from dotenv import load_dotenv
+
+load_dotenv(dotenv_path='./path/to/env')
+
+client = discord.Client(
+    token=os.getenv("DISCORD_TOKEN"),
+    application_id=APPLICATION_ID  # replace with your bot's user ID
+)
+
+@client.command(
+    command=discord.SlashCommand(
+        name='example',
+        description='Demonstrate the minimal slash command!'
+    ),
+    guild_id=GUILD_ID  # must be a guild ID your bot is in
+)
+async def example(bot: discord.Client, event: discord.InteractionEvent):
+    await event.interaction.respond(f'Hello, {event.interaction.member.user.username}!')
+
+client.run()
+```
+
+### Minimal Prefix Command (Legacy)
+The following demonstrates building and responding to a message prefix command.
+
+```python
+import discord, os
+from dotenv import load_dotenv
+
+load_dotenv(dotenv_path='./path/to/env')
+
+client = discord.Client(
+    token=os.getenv("DISCORD_TOKEN"),
+    application_id=APPLICATION_ID,  # replace with your bot's user ID
+    intents=discord.set_intents(message_content=True),
+    prefix='!'  # your custom prefix
+)
+
+@client.prefix_command
+async def ping(bot: discord.Client, event: discord.MessageCreateEvent):
+    # The function name is the name of the command
+    await event.message.send("Pong!")
+
+client.run()
+```
+
+## Like what you see?
+Check out the full [documentation](https://furmissile.github.io/scurrypy) for more examples, guides, and API reference!

{scurrypy-0.3.0.dist-info → scurrypy-0.3.3.dist-info}/RECORD

@@ -1,34 +1,35 @@
-discord/__init__.py,sha256=DPE5laK7mMQPeF2ky8D8QpokCDqsGlq6slHHhbNXmso,217
-discord/client.py,sha256=XJAxnfmwm16vfgKUZ15aFMXYHvK2WGVFQoJJ7vH2zMs,13353
+discord/__init__.py,sha256=cETkxHmm0s9YkSJgn-1daQhnbL96fuD7L9SIg2t5vBg,6823
+discord/client.py,sha256=v-phlPbUe1Rr-zg5Posbw_jyv8GxvwmvNbjgAjCZW1Y,13566
 discord/client_like.py,sha256=JyJq0XBq0vKuPBJ_ZnYf5yAAuX1zz_2B1TZBQE-BYbQ,473
 discord/config.py,sha256=OH1A2mNKhDlGvQYASEsVUx2pNxP1YQ2a7a7z-IM5xFg,200
 discord/error.py,sha256=AlislRTna554cM6KC0KrwKugzYDYtx_9C8_3QFe4XDc,2070
 discord/gateway.py,sha256=H_WaUrpK8rl3rGlT3qNexpru7R6O6Y6GQPkQcDt_KX8,6555
 discord/http.py,sha256=cGFhGEeNebf1sgSUB4Xfnlj00twWLFi9AwO85gAAUDA,10955
 discord/intents.py,sha256=Lf2fogFFDqilZeKJv7tcUgKmMW3D7ykK4bBNi-zDzYA,2866
-discord/logger.py,sha256=GBcvldIrSBnwNSgus-oa1NsYV8hU7f8_4J4VX_GmkxA,4700
+discord/logger.py,sha256=qAmOc3geCcCCqPhdi61SVWzMDewmM8Q_KWhTcjO46j8,4726
 discord/model.py,sha256=CmuxyoWLWokE_UvCQ9M7U9Cr7JH9R7ULMv9KMwzXjDQ,3105
 discord/dispatch/__init__.py,sha256=m7ixrbNhOV9QRORXPw6LSwxofQMAvLmPFBweBZu9ACc,20
-discord/dispatch/command_dispatcher.py,sha256=_91l4oJQ8LhMnxdVPzkdmDSv6AWznekNODtzudCQvrk,5740
-discord/dispatch/event_dispatcher.py,sha256=aPyfstFdIx510P_gKAExeZOICZooRgUdL19Adb19SPY,3085
+discord/dispatch/command_dispatcher.py,sha256=pyJOQaZLZYrHUEs6HEWp8XMKTMZX4SBrwTizGKIeUG8,5904
+discord/dispatch/event_dispatcher.py,sha256=tgU5FXJT2NAluT0aIlMhtMjz6hHcJRN6us1vAG639RU,2612
 discord/dispatch/prefix_dispatcher.py,sha256=4mkn3cuXTjdEChbewkbZQqd_sMKm4jePSFKKOPbt12g,2065
-discord/events/__init__.py,sha256=BcmwAj84-nzMZEkip-V903jD0ZCKqhySzlAx5wDwJoo,630
+discord/events/__init__.py,sha256=xE8YtJ7NKZkm7MLnohDQIbezh3ColmLR-3BMiZabt3k,18
 discord/events/channel_events.py,sha256=NJbu7oXRdtkUQZ68XbX6fBXINaJmavAkNZStFVA3rzs,1318
-discord/events/guild_events.py,sha256=uGGdz6YZpMSXjAZuwJ6zslmUOnIrVcBArVWc8TXnUS8,845
+discord/events/guild_events.py,sha256=HA4-loifH5x3j-zAif3H5sJpKX_HbZz4ORgBFvPMe70,852
 discord/events/hello_event.py,sha256=O8Ketu_N943cnGaFkGsAHfWhgKXFQCYCqSD3EqdsXjA,225
 discord/events/interaction_events.py,sha256=5hlYOsV1ROiRXISAGCKcZo8vfk6oqiZcNzzZjSteiag,4361
 discord/events/message_events.py,sha256=uovC_n73LuERwjqJHsXqW-IktuIzQTfolQSAzYzlzpc,1411
 discord/events/reaction_events.py,sha256=Mwj3sUWDBl5YKIs4URylXqsrLyMhtQk7d-hF1mYhFbo,2568
 discord/events/ready_event.py,sha256=c3Pf4ndNYV2byuliADi8pUxpuvKXa9FLKNz_uzIWGso,794
-discord/models/__init__.py,sha256=T6C5C8RdkEPurA_zQas5riq3nrThMaSWl9Yasha0xXc,216
+discord/models/__init__.py,sha256=ZKhFO5eX4GbTRdvi4CU4z2hO-HQU29WZw2x4DujvARY,18
 discord/models/application.py,sha256=2sXtRysUc2TJ40FjdcrWgosmwMrp_h3ybddubQMixKM,924
 discord/models/emoji.py,sha256=6iz1DhWj_eTUj2KHmwMewjB3AdEBm68EmIZp2WFFCQg,932
 discord/models/guild.py,sha256=aXUByOUUIGt9d2qIGC6_X_vh0Nyib8Iqj5ZElBeNV_I,819
 discord/models/integration.py,sha256=V29RO2925mQbVXPAMt665cML3m8mJACYmdJLWwbbUyE,612
+discord/models/interaction.py,sha256=VPbf49C1RmQpDSODk3e1voW8EnbVsH_w1qpmiq4hVRM,700
 discord/models/member.py,sha256=pkI-NVRMb3hUBkxI26FSYZxzx2mRNGXOeWWCw3BGGsY,705
 discord/models/role.py,sha256=erlERmK-IZz4YzSNY-XLNvCc-Z5PoVlClxPOX67dQJg,1169
 discord/models/user.py,sha256=lgG6GoU_7L68oHt6PGTzTkU1vrbsclRQzGjKzsLBeKA,298
-discord/parts/__init__.py,sha256=dxrdklnWRHYIbPi6KBvUcJTWky8oTHRyMQbh58_2cmA,511
+discord/parts/__init__.py,sha256=yROb-BqEw-FKXqq_-0WbP33U-Arm_9NpJuEamXpvjeA,19
 discord/parts/action_row.py,sha256=PQ24Rr02QR4Sz1mypjM0C2gxYLH4Tsx7GvTorF4wsfQ,8264
 discord/parts/attachment.py,sha256=fhWpb5e0JKfbibcEc0EOiNrzqSSAUEL87NEhRmB1H34,388
 discord/parts/channel.py,sha256=2wmEjmRqUpORzL3CFp2rugMxrpSm_LxxvlcrmWIH4r4,584
@@ -36,19 +37,19 @@ discord/parts/command.py,sha256=CPyPO_T5ULp7j7syF9z2LztP3SF6KyX89sodz2c40Aw,2924
 discord/parts/component_types.py,sha256=qr1R0jzXpE_h9Xv4P5DyYRSuhxS0Qnm9aag-JKrJvBA,131
 discord/parts/components_v2.py,sha256=53cQm4FmxXHAA7PmDcDIO4bergX-BaUB3bZVWej-U9s,8660
 discord/parts/embed.py,sha256=_PV-lEAKn-MiXyyLa2s8JKHEplA8J9dDO80NPdZtmLk,3986
-discord/parts/message.py,sha256=egCWGUxcTqbgzz_-dxZOV1WQZpuzd6tq9uFiZH40s1Y,5499
+discord/parts/message.py,sha256=XSRGYQjmbVyS9YG6VVw19chU1CUUljrFpUy6NY2HRJ0,5517
 discord/parts/modal.py,sha256=EX6J9Mh5dAQBOZqYKzSE7SFsKLfM_B1BhcJamjBNkZw,554
 discord/parts/role.py,sha256=cK96UdgT-kU0gY5C_1LZXPrYg144x2RDmGjT28so57A,920
-discord/resources/__init__.py,sha256=ubRaTXEy4dNJhqO8JXf-xBoJjPt9zKs1GZHY8Um2_mk,282
+discord/resources/__init__.py,sha256=EdzYKftSLqqr3Bpzc0_90kfozJXOtp9jNTIHhCTt_-0,21
 discord/resources/application.py,sha256=vYMTli_FSbC7venMepsJ9bkzdEQVkKYpnxCJ9K2XDho,2765
 discord/resources/bot_emojis.py,sha256=RvGCSOBkjS39P2aab0FzYUOTzBOiHX99RLrJZzAYNiU,1701
-discord/resources/channel.py,sha256=-boYdVYW0v0oaV5X1SIhfdbKn0RDFF_HJo83dreVTm0,5943
+discord/resources/channel.py,sha256=fe2JUp943VnXa-BKyRMtNP-JyNd_Mp516sWBKHKn_GI,6915
 discord/resources/guild.py,sha256=Unld1lWY3XynmRHU2FCi3-LA9VNp2thMI2BlILUTTxk,8183
-discord/resources/interaction.py,sha256=8z91X49KSknaT1syBfLr0SHRgAxaQ-8lbhkb3LU21fg,4911
+discord/resources/interaction.py,sha256=mr4kLecQpl3AtgnNeqnj3eZIwQ73Clutdi-gnoSMWVU,5237
 discord/resources/message.py,sha256=RtvcCRx0lwW-mHPl3aNYoEvGffrvtpLsQ2fVWckywVI,7527
 discord/resources/user.py,sha256=vk89TnCVi-6ZgbDs_TZTCXrx_NfFS5Q9Wi_itYoaoyg,3085
-scurrypy-0.3.0.dist-info/licenses/LICENSE,sha256=NtspfRMAlryd1Eev4BYi9EFbKhvdmlCJJ2-ADUoEBoI,426
-scurrypy-0.3.0.dist-info/METADATA,sha256=v3X0WfX-Z1KetahNjl7PbPL_xvsqFKIdxcRKstJXrDI,2950
-scurrypy-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-scurrypy-0.3.0.dist-info/top_level.txt,sha256=fJkrNbR-_8ubMBUcDEJBcfkpECrvSEmMrNKgvLlQFoM,8
-scurrypy-0.3.0.dist-info/RECORD,,
+scurrypy-0.3.3.dist-info/licenses/LICENSE,sha256=NtspfRMAlryd1Eev4BYi9EFbKhvdmlCJJ2-ADUoEBoI,426
+scurrypy-0.3.3.dist-info/METADATA,sha256=QQHxDvVbl4i51dJwTCr_atvGEXOK9mITtWrK-tdpNZg,2954
+scurrypy-0.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+scurrypy-0.3.3.dist-info/top_level.txt,sha256=fJkrNbR-_8ubMBUcDEJBcfkpECrvSEmMrNKgvLlQFoM,8
+scurrypy-0.3.3.dist-info/RECORD,,

scurrypy-0.3.0.dist-info/METADATA

@@ -1,85 +0,0 @@
-Metadata-Version: 2.4
-Name: scurrypy
-Version: 0.3.0
-Summary: Discord API Wrapper in Python
-Author: Furmissile
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# __Welcome to ScurryPy__
-
-[![PyPI version](https://badge.fury.io/py/scurrypy.svg)](https://badge.fury.io/py/scurrypy)
-
-Yet another Discord API wrapper in Python!
-
-While this wrapper is mainly used for various squirrel-related shenanigans, it can also be used for more generic bot purposes.
-
-## Features
-* Command and event handling
-* Declarative style using decorators
-* Supports both legacy and new features
-* Respects Discord's rate limits
-
-## Something things to consider...
-* This is an early version — feedback, ideas, and contributions are welcome! With that said, there will be bumps in the road so expect bugs and other flaws!
-* Some features are not yet supported, such as sharding and automod, while others, like voice, will never be supported. While this library can handle many of your basic needs, common features such as sharding or auto-mod actions are not yet implemented. See the [license](LICENSE) for details on usage.
-
-
-## Getting Started
-While this tab shows up in the docs, here are some complete examples where all you need to do is pop in your bot's credentials!
-
-## Installation
-To install the ScurryPy package, run:
-```bash
-pip install scurrypy
-```
-
-## Minimal Slash Command
-The following demonstrates building and responding to a slash command.
-```python
-import discord, os
-from dotenv import load_dotenv
-
-load_dotenv(dotenv_path='./path/to/env') # omit argument if your env file is on the same level
-
-bot = discord.Client(
-    token=os.getenv("DISCORD_TOKEN"),
-    application_id=1234567890 # replace with your bot's user ID
-)
-
-@bot.command(
-    command=discord.SlashCommand(name='example', description='Demonstrate the minimal slash command!'),
-    guild_id=GUILD_ID # must be a guild ID your bot is in!
-)
-async def example(event: discord.InteractionEvent):
-    await event.interaction.respond(f'Hello, {event.interaction.member.user.username}!')
-
-bot.run()
-```
-
-## Minimal Prefix Command (Legacy)
-The following demonstrates building and responding to a message prefix command.
-```python
-import discord, os
-from dotenv import load_dotenv
-
-load_dotenv(dotenv_path='./path/to/env') # omit argument if your env file is on the same level
-
-bot = discord.Client(
-    token=os.getenv("DISCORD_TOKEN"),
-    application_id=1234567890, # replace with your bot's user ID
-    intents=discord.set_intents(message_content=True),
-    prefix='!' # your custom prefix
-)
-
-@bot.prefix_command
-async def ping(event: discord.MessageCreateEvent): # the function name is the name of the command!
-    await event.message.send(f"Pong!")
-
-bot.run()
-```
-
-## Like what you see?
-See the [docs](https://furmissile.github.io/scurrypy) for more!