disagreement 0.0.1__tar.gz → 0.0.2__tar.gz

{disagreement-0.0.1/disagreement.egg-info → disagreement-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: disagreement
-Version: 0.0.1
+Version: 0.0.2
 Summary: A Python library for the Discord API.
 Author-email: Slipstream <me@slipstreamm.dev>
 License: BSD 3-Clause
@@ -60,29 +60,33 @@ Requires Python 3.11 or newer.
 ```python
 import asyncio
 import os
+
 import disagreement
+from disagreement.ext import commands
+
+
+class Basics(commands.Cog):
+    def __init__(self, client: disagreement.Client) -> None:
+        super().__init__(client)
+
+    @commands.command()
+    async def ping(self, ctx: commands.CommandContext) -> None:
+        await ctx.reply("Pong!")
+
+
+token = os.getenv("DISCORD_BOT_TOKEN")
+if not token:
+    raise RuntimeError("DISCORD_BOT_TOKEN environment variable not set")
+
+client = disagreement.Client(token=token, command_prefix="!")
+client.add_cog(Basics(client))
 
-# Ensure DISCORD_BOT_TOKEN is set in your environment
-client = disagreement.Client(token=os.environ.get("DISCORD_BOT_TOKEN"))
-
-@client.on_event('MESSAGE_CREATE')
-async def on_message(message: disagreement.Message):
-    print(f"Received: {message.content} from {message.author.username}")
-    if message.content.lower() == '!ping':
-        await message.reply('Pong!')
-
-async def main():
-    if not client.token:
-        print("Error: DISCORD_BOT_TOKEN environment variable not set.")
-        return
-    try:
-        async with client:
-            await asyncio.Future()  # run until cancelled
-    except KeyboardInterrupt:
-        print("Bot shutting down...")
-    # Add any other specific exception handling from your library, e.g., disagreement.AuthenticationError
-
-if __name__ == '__main__':
+
+async def main() -> None:
+    await client.run()
+
+
+if __name__ == "__main__":
     asyncio.run(main())
 ```
 
@@ -117,21 +121,20 @@ setup_logging(logging.DEBUG, file="bot.log")
 ### Defining Subcommands with `AppCommandGroup`
 
 ```python
-from disagreement.ext.app_commands import AppCommandGroup
+from disagreement.ext.app_commands import AppCommandGroup, slash_command
+from disagreement.ext.app_commands.context import AppCommandContext
 
-settings = AppCommandGroup("settings", "Manage settings")
+settings_group = AppCommandGroup("settings", "Manage settings")
+admin_group = AppCommandGroup("admin", "Admin settings", parent=settings_group)
 
-@settings.command(name="show")
-async def show(ctx):
-    """Displays a setting."""
+
+@slash_command(name="show", description="Display a setting.", parent=settings_group)
+async def show(ctx: AppCommandContext, key: str):
     ...
 
-@settings.group("admin", description="Admin settings")
-def admin_group():
-    pass
 
-@admin_group.command(name="set")
-async def set_setting(ctx, key: str, value: str):
+@slash_command(name="set", description="Update a setting.", parent=admin_group)
+async def set_setting(ctx: AppCommandContext, key: str, value: str):
     ...
 ## Fetching Guilds
 
@@ -161,3 +164,7 @@ Contributions are welcome! Please open an issue or submit a pull request.
 
 See the [docs](docs/) directory for detailed guides on components, slash commands, caching, and voice features.
 
+## License
+
+This project is licensed under the BSD 3-Clause license. See the [LICENSE](LICENSE) file for details.
+

{disagreement-0.0.1 → disagreement-0.0.2}/README.md

@@ -28,29 +28,33 @@ Requires Python 3.11 or newer.
 ```python
 import asyncio
 import os
+
 import disagreement
+from disagreement.ext import commands
+
+
+class Basics(commands.Cog):
+    def __init__(self, client: disagreement.Client) -> None:
+        super().__init__(client)
+
+    @commands.command()
+    async def ping(self, ctx: commands.CommandContext) -> None:
+        await ctx.reply("Pong!")
+
+
+token = os.getenv("DISCORD_BOT_TOKEN")
+if not token:
+    raise RuntimeError("DISCORD_BOT_TOKEN environment variable not set")
+
+client = disagreement.Client(token=token, command_prefix="!")
+client.add_cog(Basics(client))
 
-# Ensure DISCORD_BOT_TOKEN is set in your environment
-client = disagreement.Client(token=os.environ.get("DISCORD_BOT_TOKEN"))
-
-@client.on_event('MESSAGE_CREATE')
-async def on_message(message: disagreement.Message):
-    print(f"Received: {message.content} from {message.author.username}")
-    if message.content.lower() == '!ping':
-        await message.reply('Pong!')
-
-async def main():
-    if not client.token:
-        print("Error: DISCORD_BOT_TOKEN environment variable not set.")
-        return
-    try:
-        async with client:
-            await asyncio.Future()  # run until cancelled
-    except KeyboardInterrupt:
-        print("Bot shutting down...")
-    # Add any other specific exception handling from your library, e.g., disagreement.AuthenticationError
-
-if __name__ == '__main__':
+
+async def main() -> None:
+    await client.run()
+
+
+if __name__ == "__main__":
     asyncio.run(main())
 ```
 
@@ -85,21 +89,20 @@ setup_logging(logging.DEBUG, file="bot.log")
 ### Defining Subcommands with `AppCommandGroup`
 
 ```python
-from disagreement.ext.app_commands import AppCommandGroup
+from disagreement.ext.app_commands import AppCommandGroup, slash_command
+from disagreement.ext.app_commands.context import AppCommandContext
 
-settings = AppCommandGroup("settings", "Manage settings")
+settings_group = AppCommandGroup("settings", "Manage settings")
+admin_group = AppCommandGroup("admin", "Admin settings", parent=settings_group)
 
-@settings.command(name="show")
-async def show(ctx):
-    """Displays a setting."""
+
+@slash_command(name="show", description="Display a setting.", parent=settings_group)
+async def show(ctx: AppCommandContext, key: str):
     ...
 
-@settings.group("admin", description="Admin settings")
-def admin_group():
-    pass
 
-@admin_group.command(name="set")
-async def set_setting(ctx, key: str, value: str):
+@slash_command(name="set", description="Update a setting.", parent=admin_group)
+async def set_setting(ctx: AppCommandContext, key: str, value: str):
     ...
 ## Fetching Guilds
 
@@ -129,3 +132,7 @@ Contributions are welcome! Please open an issue or submit a pull request.
 
 See the [docs](docs/) directory for detailed guides on components, slash commands, caching, and voice features.
 
+## License
+
+This project is licensed under the BSD 3-Clause license. See the [LICENSE](LICENSE) file for details.
+

{disagreement-0.0.1 → disagreement-0.0.2}/disagreement/__init__.py

@@ -14,7 +14,7 @@ __title__ = "disagreement"
 __author__ = "Slipstream"
 __license__ = "BSD 3-Clause License"
 __copyright__ = "Copyright 2025 Slipstream"
-__version__ = "0.0.1"
+__version__ = "0.0.2"
 
 from .client import Client
 from .models import Message, User

disagreement-0.0.2/disagreement/ext/app_commands/__init__.py

@@ -0,0 +1,46 @@
+# disagreement/ext/app_commands/__init__.py
+
+"""
+Application Commands Extension for Disagreement.
+
+This package provides the framework for creating and handling
+Discord Application Commands (slash commands, user commands, message commands).
+"""
+
+from .commands import (
+    AppCommand,
+    SlashCommand,
+    UserCommand,
+    MessageCommand,
+    AppCommandGroup,
+)
+from .decorators import (
+    slash_command,
+    user_command,
+    message_command,
+    hybrid_command,
+    group,
+    subcommand,
+    subcommand_group,
+    OptionMetadata,
+)
+from .context import AppCommandContext
+
+# from .handler import AppCommandHandler # Will be imported when defined
+
+__all__ = [
+    "AppCommand",
+    "SlashCommand",
+    "UserCommand",
+    "MessageCommand",
+    "AppCommandGroup",  # To be defined
+    "slash_command",
+    "user_command",
+    "message_command",
+    "hybrid_command",
+    "group",
+    "subcommand",
+    "subcommand_group",
+    "OptionMetadata",
+    "AppCommandContext",  # To be defined
+]