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-jsonwhen enabled). - Zlib-stream compression support.
- specialized
mimallocsupport for high throughput.
- Zero-copy JSON parsing (via
- 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:
[]
= "0.1"
Then in your code:
use *;
## 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:
[]
= { = "0.1", = ["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