Titanium-rs

Titanium-rs is a high-performance, concurrent Discord library for Rust, designed for massive scale.

Documentation

Full documentation is available at: https://sh4downotfound.github.io/titanium-rs/

Features

• Titanium Gateway: A robust, zero-copy, highly concurrent WebSocket client for the Discord Gateway.
  • Zero-copy JSON parsing (via simd-json when enabled).
  • Zlib-stream compression support.
  • specialized mimalloc support for high throughput.
• Titanium Voice: A voice client with zero-allocation packet encryption.
• Titanium Model: Comprehensive, zero-copy friendly data models for Discord API entities.
• Titanium Cache: High-performance concurrent cache based on DashMap.

Quick Start

Installation

Add this to your Cargo.toml:

[dependencies]
titanium-rs = "0.1"

Then in your code:

use titanium_rs::prelude::*;

## Examples

Check out the `examples/` directory for full working bots:

- **[Basic Bot](https://github.com/Sh4dowNotFound/titanium-rs/blob/main/titanium/examples/basic_bot.rs)**: Simple ping-pong bot demonstrating event handling.
- **[Slash Commands](https://github.com/Sh4dowNotFound/titanium-rs/blob/main/titanium/examples/slash_commands.rs)**: Handling Application Commands (interactions).
- **[Voice Receive](https://github.com/Sh4dowNotFound/titanium-rs/blob/main/titanium/examples/voice_receive.rs)**: connecting to voice channels (skeleton).

To run an example:
```bash
cargo run --example basic_bot

Optimization

To enable high-performance memory allocation:

[dependencies]
titanium-rs = { version = "0.1", features = ["performance"] }

Safety

This project adheres to strict safety standards:

• #![deny(unsafe_code)] is enforced globally.
• Exceptions are essentially limited to SIMD optimizations and are strictly documented.

License

AGPL-3.0-or-later