cascade-discord 0.1.0__tar.gz

cascade_discord-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cascade Contributors
+
+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.

cascade_discord-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+recursive-include cascade *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]

cascade_discord-0.1.0/PKG-INFO

@@ -0,0 +1,248 @@
+Metadata-Version: 2.4
+Name: cascade-discord
+Version: 0.1.0
+Summary: High-performance Discord selfbot library for Python
+Author: Cascade Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/4f2b/cascade
+Project-URL: Repository, https://github.com/4f2b/cascade
+Project-URL: Issues, https://github.com/4f2b/cascade/issues
+Keywords: discord,api,selfbot,async,websocket
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: websockets>=12.0
+Dynamic: license-file
+
+# Cascade
+
+High-performance Discord selfbot library for Python. Built for speed, stealth, and reliability.
+
+## Features
+
+- **Blazing Fast**: Optimized for maximum performance with async/await
+- **Stealthy**: Mimics official Discord client behavior to avoid detection
+- **Full-Featured**: Complete gateway, REST API, and event system
+- **Smart Caching**: Intelligent caching system for optimal memory usage
+- **Type-Safe**: Full type hints throughout the codebase
+- **Extensible**: Plugin system for custom commands and features
+
+## Quick Start
+
+```python
+import asyncio
+import cascade
+
+async def main():
+    session = cascade.Session('YOUR_TOKEN')
+    
+    @session.event
+    async def on_ready(user):
+        print(f'Logged in as {user.username}')
+    
+    @session.event
+    async def on_message(message):
+        if message.content == '!ping':
+            await session.rest.send_message(message.channel_id, 'Pong!')
+    
+    await session.start()
+
+asyncio.run(main())
+```
+
+## Advanced Usage
+
+### Commands Framework
+
+```python
+from cascade.ext.commands import Bot
+
+bot = Bot(command_prefix='!', self_bot=True)
+
+@bot.command()
+async def ping(ctx):
+    await ctx.send(f'Pong! {bot.session.gateway.latency:.2f}ms')
+
+await bot.start('YOUR_TOKEN')
+```
+
+### Smart Features
+
+```python
+async with cascade.TypingIndicator(session.rest, channel_id):
+    await process_long_task()
+    await session.rest.send_message(channel_id, 'Done!')
+
+results = await session.rest.search_channel_messages(
+    channel_id,
+    query='keyword',
+    author_id=user_id
+)
+
+profile = await session.rest.get_user_profile(user_id)
+connections = await session.rest.get_user_connections()
+settings = await session.rest.get_user_settings()
+```
+
+### Permissions & Safety
+
+```python
+from cascade import Permission, Permissions
+
+perms = Permissions()
+perms.add(Permission.SEND_MESSAGES, Permission.READ_MESSAGE_HISTORY)
+
+if perms.has(Permission.ADMINISTRATOR):
+    print('User has admin')
+```
+
+## Installation
+
+```bash
+pip install cascade
+```
+
+## Performance
+
+- **Gateway**: Sub-millisecond message handling
+- **REST**: Smart rate limiting with automatic retry
+- **Cache**: LRU caching with TTL support
+- **Memory**: Optimized for low memory footprint
+
+## Architecture
+
+```
+cascade/
+├── core/           # Core session, cache, events
+├── gateway/        # WebSocket gateway handling
+├── api/            # REST API client
+├── entities/       # Discord entities (User, Guild, Message, etc.)
+├── types/          # Enums and type definitions
+├── utils/          # Utilities (permissions, formatting, validation)
+└── ext/            # Extensions (commands framework)
+```
+
+## Capabilities
+
+- Full gateway connection with auto-reconnect
+- Complete REST API coverage (100+ endpoints)
+- User account features (notes, relationships, settings)
+- Guild management (roles, channels, members)
+- Message handling (send, edit, delete, search, reactions)
+- Thread support (create, join, manage)
+- Voice state updates
+- Stage instances and scheduled events
+- Webhooks and integrations
+- Rich presence and activities
+- Advanced search and filtering
+- Bulk operations
+- Smart markdown processing
+- Permission calculations
+
+## Examples
+
+Check the `examples/` directory for:
+- `basic.py` - Simple bot setup
+- `commands.py` - Command framework usage  
+- `advanced.py` - Advanced features
+- `moderation.py` - Moderation utilities
+
+## Warning
+
+Selfbots are against Discord's Terms of Service. Use at your own risk.
+
+## License
+
+MIT.
+
+## ⚠️ Warning
+
+**Automating user accounts violates Discord's Terms of Service and can result in account termination.** This library is for educational purposes only. Use at your own risk.
+
+## Features
+
+- Async/await with aiohttp and websockets
+- Full gateway connection with automatic reconnection
+- Event-driven architecture
+- REST API with intelligent rate limiting
+- Built-in caching system
+- Complete entity models (User, Guild, Channel, Message, etc.)
+- Command framework
+- Type hints throughout
+- Zero comments, clean professional code
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+import cascade
+
+client = cascade.Session('your_token_here')
+
+@client.event
+async def on_ready():
+    print(f'Logged in as {client.user.name}')
+
+@client.event
+async def on_message(message):
+    if message.content == '!ping':
+        await message.channel.send('Pong!')
+
+client.run()
+```
+
+## Command Framework
+
+```python
+from cascade.ext.commands import Bot
+
+bot = Bot('your_token_here', command_prefix='!')
+
+@bot.command()
+async def hello(ctx):
+    await ctx.send(f'Hello {ctx.author.name}!')
+
+@bot.command()
+async def say(ctx, *args):
+    await ctx.send(' '.join(args))
+
+bot.run()
+```
+
+## Examples
+
+### Change Presence
+
+```python
+from cascade import Activity, ActivityType
+
+activity = Activity.playing('with Python')
+await client.change_presence(status='dnd', activity=activity)
+```
+
+### Message Formatting
+
+```python
+from cascade.utils.formatting import bold, code, codeblock
+
+await channel.send(bold('Bold text'))
+await channel.send(code('inline code'))
+await channel.send(codeblock('print("hello")', 'python'))
+```
+
+## License
+
+MIT

cascade_discord-0.1.0/README.md

@@ -0,0 +1,224 @@
+# Cascade
+
+High-performance Discord selfbot library for Python. Built for speed, stealth, and reliability.
+
+## Features
+
+- **Blazing Fast**: Optimized for maximum performance with async/await
+- **Stealthy**: Mimics official Discord client behavior to avoid detection
+- **Full-Featured**: Complete gateway, REST API, and event system
+- **Smart Caching**: Intelligent caching system for optimal memory usage
+- **Type-Safe**: Full type hints throughout the codebase
+- **Extensible**: Plugin system for custom commands and features
+
+## Quick Start
+
+```python
+import asyncio
+import cascade
+
+async def main():
+    session = cascade.Session('YOUR_TOKEN')
+    
+    @session.event
+    async def on_ready(user):
+        print(f'Logged in as {user.username}')
+    
+    @session.event
+    async def on_message(message):
+        if message.content == '!ping':
+            await session.rest.send_message(message.channel_id, 'Pong!')
+    
+    await session.start()
+
+asyncio.run(main())
+```
+
+## Advanced Usage
+
+### Commands Framework
+
+```python
+from cascade.ext.commands import Bot
+
+bot = Bot(command_prefix='!', self_bot=True)
+
+@bot.command()
+async def ping(ctx):
+    await ctx.send(f'Pong! {bot.session.gateway.latency:.2f}ms')
+
+await bot.start('YOUR_TOKEN')
+```
+
+### Smart Features
+
+```python
+async with cascade.TypingIndicator(session.rest, channel_id):
+    await process_long_task()
+    await session.rest.send_message(channel_id, 'Done!')
+
+results = await session.rest.search_channel_messages(
+    channel_id,
+    query='keyword',
+    author_id=user_id
+)
+
+profile = await session.rest.get_user_profile(user_id)
+connections = await session.rest.get_user_connections()
+settings = await session.rest.get_user_settings()
+```
+
+### Permissions & Safety
+
+```python
+from cascade import Permission, Permissions
+
+perms = Permissions()
+perms.add(Permission.SEND_MESSAGES, Permission.READ_MESSAGE_HISTORY)
+
+if perms.has(Permission.ADMINISTRATOR):
+    print('User has admin')
+```
+
+## Installation
+
+```bash
+pip install cascade
+```
+
+## Performance
+
+- **Gateway**: Sub-millisecond message handling
+- **REST**: Smart rate limiting with automatic retry
+- **Cache**: LRU caching with TTL support
+- **Memory**: Optimized for low memory footprint
+
+## Architecture
+
+```
+cascade/
+├── core/           # Core session, cache, events
+├── gateway/        # WebSocket gateway handling
+├── api/            # REST API client
+├── entities/       # Discord entities (User, Guild, Message, etc.)
+├── types/          # Enums and type definitions
+├── utils/          # Utilities (permissions, formatting, validation)
+└── ext/            # Extensions (commands framework)
+```
+
+## Capabilities
+
+- Full gateway connection with auto-reconnect
+- Complete REST API coverage (100+ endpoints)
+- User account features (notes, relationships, settings)
+- Guild management (roles, channels, members)
+- Message handling (send, edit, delete, search, reactions)
+- Thread support (create, join, manage)
+- Voice state updates
+- Stage instances and scheduled events
+- Webhooks and integrations
+- Rich presence and activities
+- Advanced search and filtering
+- Bulk operations
+- Smart markdown processing
+- Permission calculations
+
+## Examples
+
+Check the `examples/` directory for:
+- `basic.py` - Simple bot setup
+- `commands.py` - Command framework usage  
+- `advanced.py` - Advanced features
+- `moderation.py` - Moderation utilities
+
+## Warning
+
+Selfbots are against Discord's Terms of Service. Use at your own risk.
+
+## License
+
+MIT.
+
+## ⚠️ Warning
+
+**Automating user accounts violates Discord's Terms of Service and can result in account termination.** This library is for educational purposes only. Use at your own risk.
+
+## Features
+
+- Async/await with aiohttp and websockets
+- Full gateway connection with automatic reconnection
+- Event-driven architecture
+- REST API with intelligent rate limiting
+- Built-in caching system
+- Complete entity models (User, Guild, Channel, Message, etc.)
+- Command framework
+- Type hints throughout
+- Zero comments, clean professional code
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+import cascade
+
+client = cascade.Session('your_token_here')
+
+@client.event
+async def on_ready():
+    print(f'Logged in as {client.user.name}')
+
+@client.event
+async def on_message(message):
+    if message.content == '!ping':
+        await message.channel.send('Pong!')
+
+client.run()
+```
+
+## Command Framework
+
+```python
+from cascade.ext.commands import Bot
+
+bot = Bot('your_token_here', command_prefix='!')
+
+@bot.command()
+async def hello(ctx):
+    await ctx.send(f'Hello {ctx.author.name}!')
+
+@bot.command()
+async def say(ctx, *args):
+    await ctx.send(' '.join(args))
+
+bot.run()
+```
+
+## Examples
+
+### Change Presence
+
+```python
+from cascade import Activity, ActivityType
+
+activity = Activity.playing('with Python')
+await client.change_presence(status='dnd', activity=activity)
+```
+
+### Message Formatting
+
+```python
+from cascade.utils.formatting import bold, code, codeblock
+
+await channel.send(bold('Bold text'))
+await channel.send(code('inline code'))
+await channel.send(codeblock('print("hello")', 'python'))
+```
+
+## License
+
+MIT

cascade_discord-0.1.0/cascade/__init__.py

@@ -0,0 +1,84 @@
+__title__ = 'cascade'
+__version__ = '0.1.0'
+__license__ = 'MIT'
+
+from .core.session import Session
+from .core.cache import Cache
+from .core.events import EventManager
+from .gateway.shard import GatewayShard
+from .api.rest import RestClient
+from .api.typing import TypingIndicator
+from .entities.message import Message
+from .entities.user import User, ClientUser
+from .entities.guild import Guild
+from .entities.channel import Channel, TextChannel, DMChannel, VoiceChannel, GroupChannel
+from .entities.member import Member
+from .entities.role import Role
+from .entities.emoji import Emoji, PartialEmoji
+from .entities.presence import Activity, Presence
+from .entities.webhook import Webhook
+from .entities.connection import Connection
+from .entities.settings import UserSettings
+from .entities.application import Application
+from .types.enums import ChannelType, MessageType, ActivityType, StatusType, WebhookType
+from .utils.formatting import *
+from .utils.snowflake import *
+from .utils.permissions import Permission, Permissions
+from .utils.intents import Intents
+from .utils.color import Color
+from .utils.validator import is_valid_username, extract_invite_code, parse_message_link
+from .utils.markdown import MarkdownProcessor, bold, italic, underline, strikethrough, code, code_block, spoiler
+from .utils.embed import Embed
+from .ext.commands import Bot, Context, command
+
+__all__ = (
+    'Session',
+    'Cache',
+    'EventManager',
+    'GatewayShard',
+    'RestClient',
+    'TypingIndicator',
+    'Message',
+    'User',
+    'ClientUser',
+    'Guild',
+    'Channel',
+    'TextChannel',
+    'DMChannel',
+    'VoiceChannel',
+    'GroupChannel',
+    'Member',
+    'Role',
+    'Emoji',
+    'PartialEmoji',
+    'Activity',
+    'Presence',
+    'Webhook',
+    'Connection',
+    'UserSettings',
+    'Application',
+    'ChannelType',
+    'MessageType',
+    'ActivityType',
+    'StatusType',
+    'WebhookType',
+    'Permission',
+    'Permissions',
+    'Intents',
+    'Color',
+    'is_valid_username',
+    'extract_invite_code',
+    'parse_message_link',
+    'MarkdownProcessor',
+    'bold',
+    'italic',
+    'underline',
+    'strikethrough',
+    'code',
+    'code_block',
+    'spoiler',
+    'Embed',
+    'Bot',
+    'Context',
+    'command',
+)

cascade_discord-0.1.0/cascade/api/ratelimit.py

@@ -0,0 +1,62 @@
+import asyncio
+import time
+from typing import Dict, Optional
+from collections import defaultdict
+
+
+class RateLimitBucket:
+    def __init__(self):
+        self.remaining: int = 1
+        self.limit: int = 1
+        self.reset_after: float = 0.0
+        self.reset: float = 0.0
+        self._lock = asyncio.Lock()
+
+    async def acquire(self) -> None:
+        async with self._lock:
+            now = time.time()
+            
+            if self.remaining == 0:
+                wait_time = self.reset - now
+                if wait_time > 0:
+                    await asyncio.sleep(wait_time)
+                    self.remaining = self.limit
+            
+            self.remaining -= 1
+
+    def update(self, headers: Dict[str, str]) -> None:
+        self.limit = int(headers.get('X-RateLimit-Limit', 1))
+        self.remaining = int(headers.get('X-RateLimit-Remaining', 1))
+        self.reset = float(headers.get('X-RateLimit-Reset', 0))
+        reset_after = headers.get('X-RateLimit-Reset-After')
+        if reset_after:
+            self.reset_after = float(reset_after)
+
+
+class RateLimiter:
+    def __init__(self):
+        self.buckets: Dict[str, RateLimitBucket] = defaultdict(RateLimitBucket)
+        self.global_lock = asyncio.Lock()
+        self.global_reset: float = 0.0
+
+    def get_bucket(self, route: str, method: str) -> RateLimitBucket:
+        key = f'{method}:{route}'
+        return self.buckets[key]
+
+    async def acquire(self, route: str, method: str) -> None:
+        if self.global_reset > 0:
+            now = time.time()
+            if now < self.global_reset:
+                await asyncio.sleep(self.global_reset - now)
+            self.global_reset = 0.0
+
+        bucket = self.get_bucket(route, method)
+        await bucket.acquire()
+
+    def update_bucket(self, route: str, method: str, headers: Dict[str, str]) -> None:
+        bucket = self.get_bucket(route, method)
+        bucket.update(headers)
+
+        if headers.get('X-RateLimit-Global'):
+            retry_after = float(headers.get('Retry-After', 0))
+            self.global_reset = time.time() + retry_after