DiscordPYComponents 0.2.2__py3-none-any.whl

discordpycomponents-0.2.2.dist-info/METADATA

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: DiscordPYComponents
+Version: 0.2.2
+Summary: Discord Components V2 for discord.py
+Author: 2gm49
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp
+
+```text
+.----..-.  .-.    .---.  .----. .-.   .-..----.  .----. .-. .-..----..-. .-. .---.  .----.
+| {}  }\ \/ /    /  ___}/  {}  \|  `.'  || {}  }/  {}  \|  `| || {_  |  `| |{_   _}{ {__  
+| .--'  }  {     \     }\      /| |\ /| || .--' \      /| |\  || {__ | |\  |  | |  .-._} }
+`-'     `--'      `---'  `----' `-' ` `-'`-'     `----' `-' `-'`----'`-' `-'  `-'  `----' 
+```
+
+**py-components** is a lightweight Python library that provides helpers for building Discord Components (Buttons, Select Menus, Action Rows) for use with `discord.py`.
+
+It is designed to simplify the creation and handling of Discord UI components while keeping the API clean, minimal, and easy to extend.
+
+---
+
+## Features
+
+- Simple Discord Components V2 wrapper
+- Easy-to-use Button, Select Menu, and Action Row builders
+- Async-friendly design
+- Clean and readable API
+- Built to integrate with `discord.py`
+
+---
+
+## Installation
+
+```bash
+pip install py-components
+````
+
+---
+
+## Requirements
+
+* Python 3.10+
+* discord.py (latest recommended)
+* aiohttp
+
+---
+
+## Quick Start
+
+### Creating a Button
+
+```python
+from py_components import Button, ActionRow
+
+button = Button(
+    label="Click Me",
+    style="primary",
+    custom_id="click_me_button"
+)
+
+row = ActionRow(components=[button])
+```
+
+---
+
+## Handling Interactions
+
+```python
+from py_components import Button
+
+button = Button(
+    label="Hello",
+    style="success",
+    custom_id="hello_button"
+)
+
+async def handle_interaction(interaction):
+    await interaction.response.send_message("You clicked the button!")
+```
+
+---
+
+## Components
+
+### Buttons
+
+Supported styles:
+
+* primary
+* secondary
+* success
+* danger
+
+```python
+Button(
+    label="Delete",
+    style="danger",
+    custom_id="delete_btn"
+)
+```
+
+---
+
+### Select Menus
+
+```python
+from py_components import SelectMenu
+
+menu = SelectMenu(
+    custom_id="menu_example",
+    options=[
+        {"label": "Option 1", "value": "opt1"},
+        {"label": "Option 2", "value": "opt2"}
+    ]
+)
+```
+
+---
+
+### Action Rows
+
+Used to group components together.
+
+```python
+from py_components import ActionRow
+
+row = ActionRow(components=[button, menu])
+```
+
+---
+
+## Example Usage
+
+```python
+from py_components import Button, ActionRow, SelectMenu
+
+button = Button(
+    label="Click Me",
+    style="primary",
+    custom_id="btn_1"
+)
+
+menu = SelectMenu(
+    custom_id="menu_1",
+    options=[
+        {"label": "Red", "value": "red"},
+        {"label": "Blue", "value": "blue"}
+    ]
+)
+
+row = ActionRow(components=[button, menu])
+```
+
+---
+
+## Roadmap
+
+* Modal support
+* Full discord.py integration helpers
+* Prebuilt UI templates
+* Advanced component event handling
+* Stronger typing + validation
+* More Discord component types support
+
+---
+
+## Project Structure
+
+```
+py-components/
+├── py_components/
+│   ├── __init__.py
+│   ├── buttons.py
+│   ├── select.py
+│   └── components.py
+├── README.md
+├── pyproject.toml
+└── LICENSE
+```
+
+---
+
+## License
+
+MIT License
+
+---
+
+## Notes
+
+This library is a helper layer for building Discord UI components more efficiently. It does not replace `discord.py`, but extends it with easier component creation utilities.
+
+```
+```
+--

discordpycomponents-0.2.2.dist-info/RECORD

@@ -0,0 +1,11 @@
+py_components/__init__.py,sha256=COIyqErNNmT9aM3ZroJY37IauhfA3L-8rI2EAuD8PxM,127
+py_components/components.py,sha256=C544NpQdckIupA3NH48d9i9XsTzrGC-juGJEZ4CNw-o,573
+py_components/enums.py,sha256=1Awd_7bV08ip_Jv7TzBbJjWd0N3TM9912ZvCnVUorHw,84
+py_components/http.py,sha256=GWprDj077w9lb3FMxMOn1DgRO31_Xk7eCqOBhmEKlFA,428
+py_components/registry.py,sha256=LPj-6MPezlpSNJTPN2fdTm7NsDyPwjS45BvUhu4_UGo,275
+py_components/ui.py,sha256=IitDYdlAsAxDktXLQ7qpvPVbXMBzavzYq0YeBMcnXOc,736
+py_components/view.py,sha256=pVLge9W07YmfW-qFwYC5tm30b64Y0pCSC5fBqJVu7RA,734
+discordpycomponents-0.2.2.dist-info/METADATA,sha256=3CO1g1qXfZnvDJ35vQ6_ILPc6U-C61J5y-vtTJ510Mk,3377
+discordpycomponents-0.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+discordpycomponents-0.2.2.dist-info/top_level.txt,sha256=Q4JxMCNp7z8AhvKh05KL3isKLp8dycXAvhj74gvjn4w,14
+discordpycomponents-0.2.2.dist-info/RECORD,,

discordpycomponents-0.2.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

discordpycomponents-0.2.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+py_components

py_components/__init__.py

@@ -0,0 +1,4 @@
+from .ui import UI, send_ui
+from .view import View, button
+from .components import Text, Button
+from .enums import ButtonStyle

py_components/components.py

@@ -0,0 +1,26 @@
+from .enums import ButtonStyle
+
+class Text:
+    def __init__(self, content):
+        self.content = content
+
+    def to_dict(self):
+        return {
+            "type": 10,
+            "content": self.content
+        }
+
+
+class Button:
+    def __init__(self, label, custom_id, style=ButtonStyle.primary):
+        self.label = label
+        self.custom_id = custom_id
+        self.style = style
+
+    def to_dict(self):
+        return {
+            "type": 2,
+            "label": self.label,
+            "custom_id": self.custom_id,
+            "style": self.style
+        }

py_components/enums.py

@@ -0,0 +1,5 @@
+class ButtonStyle:
+    primary = 1
+    secondary = 2
+    success = 3
+    danger = 4

py_components/http.py

@@ -0,0 +1,15 @@
+import aiohttp
+
+API = "https://discord.com/api/v10"
+
+async def send_message(channel_id, token, payload):
+    url = f"{API}/channels/{channel_id}/messages"
+
+    headers = {
+        "Authorization": f"Bot {token}",
+        "Content-Type": "application/json"
+    }
+
+    async with aiohttp.ClientSession() as session:
+        async with session.post(url, json=payload, headers=headers) as resp:
+            return await resp.text()

py_components/registry.py

@@ -0,0 +1,10 @@
+class Registry:
+    def __init__(self):
+        self.routes = {}
+
+    def register(self, custom_id, func):
+        self.routes[custom_id] = func
+
+    async def dispatch(self, custom_id, ctx):
+        if custom_id in self.routes:
+            await self.routes[custom_id](ctx)

py_components/ui.py

@@ -0,0 +1,28 @@
+from .http import send_message
+
+class UI:
+    def __init__(self, *components):
+        self.components = list(components)
+
+    def add(self, component):
+        self.components.append(component)
+
+    def to_payload(self):
+        return {
+            "flags": 1 << 15,
+            "components": [
+                {
+                    "type": 17,
+                    "components": [c.to_dict() for c in self.components]
+                }
+            ]
+        }
+
+    async def send(self, ctx):
+        token = ctx.bot.http.token
+        return await send_message(ctx.channel.id, token, self.to_payload())
+
+
+async def send_ui(ctx, ui):
+    token = ctx.bot.http.token
+    return await send_message(ctx.channel.id, token, ui.to_payload())

py_components/view.py

@@ -0,0 +1,33 @@
+from .components import Button
+
+def button(label):
+    def wrapper(func):
+        func._button_label = label
+        return func
+    return wrapper
+
+
+class View:
+    def __init__(self):
+        self.components = []
+        self.registry = {}
+
+    def add_button(self, label, custom_id, callback=None):
+        btn = Button(label, custom_id)
+        self.components.append(btn)
+
+        if callback:
+            self.registry[custom_id] = callback
+
+        return btn
+
+    def to_payload(self):
+        return {
+            "flags": 1 << 15,
+            "components": [
+                {
+                    "type": 17,
+                    "components": [c.to_dict() for c in self.components]
+                }
+            ]
+        }