Metadata-Version: 2.4
Name: auric
Version: 0.0.2
Summary: A modern, powerful, and type-safe Discord API wrapper for Python
Author-email: Auric Team <auric.bot@proton.me>
License: MIT
Project-URL: Homepage, https://github.com/yourusername/auric
Project-URL: Documentation, https://github.com/yourusername/auric/blob/main/docs/INDEX.md
Project-URL: Repository, https://github.com/yourusername/auric
Project-URL: Bug Tracker, https://github.com/yourusername/auric/issues
Project-URL: Changelog, https://github.com/yourusername/auric/blob/main/CHANGELOG.md
Project-URL: Discord, https://discord.gg/auric
Keywords: discord,discord-api,discord-bot,bot,api,wrapper,async,asyncio
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp<4.0.0,>=3.8.0
Requires-Dist: python-dotenv>=0.19.0
Provides-Extra: voice
Requires-Dist: PyNaCl<2.0.0,>=1.5.0; extra == "voice"
Provides-Extra: speed
Requires-Dist: orjson>=3.8.0; extra == "speed"
Requires-Dist: aiodns>=3.0.0; extra == "speed"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: mypy>=1.5.0; extra == "dev"
Requires-Dist: flake8>=6.1.0; extra == "dev"
Dynamic: license-file

<div align="center">

# 🌟 Auric

**A modern, powerful, and type-safe Discord API wrapper for Python**

[![PyPI version](https://img.shields.io/pypi/v/auric.svg)](https://pypi.org/project/auric/)
[![Python Version](https://img.shields.io/pypi/pyversions/auric.svg)](https://pypi.org/project/auric/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Downloads](https://img.shields.io/pypi/dm/auric.svg)](https://pypi.org/project/auric/)

[Installation](#installation) • [Quick Start](#quick-start) • [Documentation](#documentation) • [Examples](#examples) • [Contributing](#contributing)

</div>

---

## 📖 Overview

Auric is a powerful, asynchronous, and fully type-hinted Python library for interacting with the Discord API. Built from the ground up with modern Python features, it provides an intuitive and elegant interface for creating everything from simple bots to complex, production-ready applications.

## ✨ Key Features

### 🚀 **Modern & Performant**
- **Async/Await**: Built with modern Python `async`/`await` patterns for high-performance I/O operations
- **Type-Safe**: 100% type-hinted codebase with full IDE support and autocompletion
- **Optimized**: Uses `aiohttp` for networking and optional `orjson` for ultra-fast JSON processing

### 🎯 **Comprehensive Discord API Support**
- **Slash Commands** - Application commands with full option types support
- **Message Components** - Buttons, select menus, and modals
- **Voice & Audio** - Voice channel connection and audio playback
- **Threads & Forums** - Complete thread and forum channel support
- **Auto-Moderation** - Auto-mod rules and filters
- **Scheduled Events** - Create and manage guild events
- **Stage Channels** - Stage instance management
- **Monetization** - SKUs and subscription support

### 🛠️ **Developer Experience**
- **Fluent Builders** - Chainable builders for embeds, commands, and components
- **Smart Collectors** - Built-in collectors for messages, reactions, and interactions
- **Plugin System** - Organize your bot into reusable, modular plugins
- **Advanced Caching** - Intelligent caching with automatic memory management
- **Auto-Sharding** - Seamless sharding support for scaling to thousands of guilds

## 📦 Installation

**Stable Release (Recommended)**

```bash
pip install -U auric
```

**With Voice Support**

```bash
pip install -U "auric[voice]"
```

**With Performance Optimizations**

```bash
pip install -U "auric[speed]"
```

**Development Version**

```bash
pip install -U git+https://github.com/yourusername/auric.git
```

**Requirements**: Python 3.11 or higher

## 🚀 Quick Start

### Basic Bot Example

```python
import auric

# Create a client with default intents
client = auric.Client(intents=auric.Intents.default())

@client.event
async def on_ready():
    print(f"✅ Logged in as {client.user.username}")
    print(f"📊 Connected to {len(client.guilds)} guilds")

@client.event
async def on_message(message):
    # Don't respond to ourselves
    if message.author.bot:
        return
    
    if message.content.startswith("!ping"):
        await message.reply("🏓 Pong!")

# Run the bot
client.run("YOUR_BOT_TOKEN")
```

### Slash Command Example

```python
import auric
from auric.builders import EmbedBuilder

client = auric.Client(intents=auric.Intents.default())

@client.slash_command(name="hello", description="Greet someone")
async def hello_command(interaction: auric.Interaction, name: str):
    """Say hello to a user"""
    embed = (
        EmbedBuilder()
        .set_title(f"👋 Hello, {name}!")
        .set_description("Welcome to the server!")
        .set_color(0x5865F2)
        .set_footer(text=f"Requested by {interaction.user.username}")
        .build()
    )
    await interaction.reply(embed=embed)

client.run("YOUR_BOT_TOKEN")
```

### Components & Modals Example

```python
import auric
from auric.builders import ButtonBuilder, ActionRowBuilder

client = auric.Client(intents=auric.Intents.default())

@client.slash_command(name="button", description="Show a button")
async def button_command(interaction: auric.Interaction):
    button = ButtonBuilder().set_label("Click me!").set_custom_id("my_button").build()
    row = ActionRowBuilder().add_component(button).build()
    
    await interaction.reply("Click the button below:", components=[row])

@client.event
async def on_interaction(interaction):
    if interaction.type == auric.InteractionType.COMPONENT:
        if interaction.data.custom_id == "my_button":
            await interaction.reply("🎉 Button clicked!")

client.run("YOUR_BOT_TOKEN")
```

## 📚 Examples

Check out more examples in the repository:

- **[Simple Bot](examples/simple_bot.py)** - Basic message handling
- **[Slash Commands](examples/slash_commands.py)** - Application commands
- **[Components](examples/components.py)** - Buttons and select menus
- **[Modals](examples/modals.py)** - Interactive forms
- **[Collectors](examples/collectors.py)** - Message and reaction collectors
- **[Voice Bot](examples/voice_bot.py)** - Voice channel features
- **[Plugin System](examples/plugins.py)** - Modular bot structure

## 📖 Documentation

Coming soon! In the meantime, the codebase is fully type-hinted with comprehensive docstrings.

```python
# Every function has detailed documentation
help(auric.Client)
help(auric.Embed)
help(auric.SlashCommandBuilder)
```

## 🤝 Contributing

We welcome contributions! Here's how you can help:

1. **Fork** the repository
2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
4. **Push** to the branch (`git push origin feature/amazing-feature`)
5. **Open** a Pull Request

Please read our [Contributing Guide](CONTRIBUTING.md) for detailed guidelines.

### Development Setup

```bash
# Clone the repository
git clone https://github.com/yourusername/auric.git
cd auric

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linter
flake8 auric
black auric --check
```

## 🛠️ Roadmap

- [ ] Complete API v10 coverage
- [ ] Comprehensive documentation website
- [ ] More examples and tutorials
- [ ] Performance benchmarks
- [ ] Database integration helpers
- [ ] Advanced plugin templates

## 💬 Support & Community

- **GitHub Issues**: [Report bugs or request features](https://github.com/yourusername/auric/issues)
- **GitHub Discussions**: [Ask questions and discuss ideas](https://github.com/yourusername/auric/discussions)
- **Discord**: Coming soon!

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgements

- Built with ❤️ for the Discord bot development community
- Inspired by discord.py, discord.js, and other great Discord libraries
- Special thanks to all contributors

---

<div align="center">

**If you find Auric useful, please consider giving it a ⭐ on GitHub!**

Made with ❤️ by the Auric Team

</div>
