kroxy 0.1.0__py3-none-any.whl

kroxy-0.1.0.dist-info/METADATA

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: kroxy
+Version: 0.1.0
+Summary: A professional Discord utility library by @kroxy
+Author-email: kroxy <kroxy@example.com>
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/kroxy
+Project-URL: Repository, https://github.com/kroxy/kroxy
+Keywords: discord,bot,antinuke,giveaway,music,utility
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# kroxy
+
+A professional Discord utility library by **@kroxy**.
+
+## Install
+
+```bash
+pip install kroxy
+```
+
+## Modules
+
+### `kroxy.discord`
+
+| Module | Description |
+|---|---|
+| `api` | Async Discord REST API client |
+| `commands` | Slash & prefix command builders |
+| `utils` | Embed builder, mentions, timestamps, permissions |
+| `antinuke` | Anti-nuke protection with rate-limit tracking |
+| `checkers` | Permission & role checks with hierarchy validation |
+| `giveaway` | Full-featured weighted giveaway system |
+| `music` | Queue-based music player state manager |
+
+### `kroxy.website` *(coming soon)*
+
+---
+
+## Quick Examples
+
+### Anti-Nuke
+
+```python
+from kroxy.discord import AntiNuke
+
+antinuke = AntiNuke(whitelist=[OWNER_ID])
+
+async def punish(action, user_id, guild):
+    print(f"NUKE DETECTED: {action} by {user_id}")
+
+antinuke.on_trigger = punish
+antinuke.punishment = "ban"
+
+# In your event handler:
+await antinuke.on_member_ban(user_id=some_user_id, guild=guild)
+```
+
+### Giveaway
+
+```python
+from kroxy.discord.giveaway import GiveawayManager
+
+manager = GiveawayManager()
+
+async def on_giveaway_end(giveaway, winners):
+    print(f"Winners of {giveaway.prize}: {winners}")
+
+manager.on_end = on_giveaway_end
+
+giveaway = await manager.create(
+    prize="Discord Nitro",
+    host_id=123456789,
+    channel_id=987654321,
+    guild_id=111111111,
+    duration=3600,     # 1 hour
+    winner_count=2,
+)
+```
+
+### Embed Builder
+
+```python
+from kroxy.discord import Utils
+
+embed = Utils.build_embed(
+    title="Hello from kroxy!",
+    description="This is a professional embed.",
+    color=0x5865F2,
+    fields=[{"name": "Field", "value": "Value", "inline": True}],
+    footer="kroxy library",
+    timestamp=True,
+)
+```
+
+### Slash Command
+
+```python
+from kroxy.discord.commands import SlashCommand, Option
+
+@SlashCommand.decorator(
+    name="ping",
+    description="Check bot latency",
+)
+async def ping(interaction):
+    await interaction.response.send_message("Pong!")
+```
+
+### Music Player
+
+```python
+from kroxy.discord.music import MusicPlayerManager, Track
+
+manager = MusicPlayerManager()
+player = manager.get_or_create(guild_id=111111111, channel_id=222222222)
+
+track = Track(
+    title="My Song",
+    url="https://youtube.com/...",
+    stream_url="https://...",
+    duration=240,
+    requester_id=123456789,
+)
+player.queue.add(track)
+await player.play_next()
+```
+
+---
+
+## License
+
+MIT © kroxy

kroxy-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+kroxy/__init__.py,sha256=38QdIhF228Lwdq5aVFYapqTNSZM_eYi2cOVSyp_4k8M,221
+kroxy/discord/__init__.py,sha256=dIR8xIWp2cBABAWwmC6iHM2I9UHerocXJSvNPoKL2wo,541
+kroxy/discord/antinuke.py,sha256=1Q7huLfO_sCCMfpqGCOyZlv1a_HPoz_5YrBioxV4Y0I,5224
+kroxy/discord/api.py,sha256=2zwc_YG-MZaGmx6r3PkXu5XNjW6-1lck2JdRdksw-Wg,5277
+kroxy/discord/checkers.py,sha256=faLW4pcN-pY9aIXNc4BRgspCtJrqWwAg4dn-VYenZDI,6721
+kroxy/discord/commands.py,sha256=lxIZwMULLRsUUjVQYVVCoLoQ_OHI9o8wff1eD_Uotow,6144
+kroxy/discord/giveaway.py,sha256=U4rmb3pRf3Aa0xqr-wg0IyOwK3n1jjatVysn5tUQjdQ,7149
+kroxy/discord/music.py,sha256=KA8Dwfp6bHgBNEIuYvd9bM8-p7eOwaHB91IN_5zRJD0,7280
+kroxy/discord/utils.py,sha256=zQuSJDNnlf5jLgprCi0sszvEnu9lSQIH3C60jrQvmxo,6872
+kroxy/website/__init__.py,sha256=msXmOfRoX3n3e7wfuVXBpTmpIxQeEHqFA0dJ1iUt7e8,71
+kroxy-0.1.0.dist-info/licenses/LICENSE,sha256=X1rPvxtO8DUCyBvDRqxWeZuylz2oIF0LW-iDEsiitqg,1062
+kroxy-0.1.0.dist-info/METADATA,sha256=P1q5rBRzpcurwGYCC96O-uV4XllD-WCBPLKQ1bsjxsE,3372
+kroxy-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+kroxy-0.1.0.dist-info/top_level.txt,sha256=qRxK8_vKmSk29ULL149K7OzjOyuiyMEXmWKEUJghmJE,6
+kroxy-0.1.0.dist-info/RECORD,,

kroxy-0.1.0.dist-info/WHEEL

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

kroxy-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kroxy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kroxy-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+kroxy