https://github.com/kython28/leviathan
A lightning-fast Zig-powered event loop for Python's asyncio.
https://github.com/kython28/leviathan
asyncio iouring python zig ziglang
Last synced: about 1 month ago
JSON representation
A lightning-fast Zig-powered event loop for Python's asyncio.
- Host: GitHub
- URL: https://github.com/kython28/leviathan
- Owner: kython28
- License: mit
- Created: 2024-10-08T17:19:06.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-03-23T16:55:38.000Z (about 2 months ago)
- Last Synced: 2025-03-30T18:07:51.897Z (about 1 month ago)
- Topics: asyncio, iouring, python, zig, ziglang
- Language: Zig
- Homepage:
- Size: 1.92 MB
- Stars: 149
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-zig - leviathan🗒️A lightning-fast Zig-powered event loop for Python's asyncio.
README
# Leviathan
From the depths of the sea, where darkness meets vastness, emerges Leviathan: an unyielding force of speed and power. In a world where the arcane and the agile intertwine, a loop forged in Python takes its dance. Leviathan, master of the journey, governs events with a steady hand—an **ultra-fast event loop** that deploys its bastion in **asyncio**, powered by the artistry of Zig. Between promises and futures, its path is clear: to rule swiftly where code is prepared.
## 🚀 Features
- **Ultra-fast speed**: Thanks to low-level optimizations enabled by Zig.
- **Full asyncio compatibility**: A drop-in replacement for the default event loop.
- **Efficient design**: Focused on maximizing performance and minimizing latency.
- **Simplicity**: Easy integration with existing Python projects.
- **Robust Safety**: Carefully engineered for critical systems with advanced error recovery and graceful degradation mechanisms.
## 📜 Requirements
- Python >= 3.13
- Zig >= 0.14.0 (for development or contributions)
- Linux >= 5.11
## 🔧 Installation
To install Leviathan, just execute:
```bash
python setup.py install
```
## 📦 Basic Usage
```python
import leviathan
import asyncio
async def main():
print("Hello from Leviathan!")
await asyncio.sleep(1)
print("Goodbye from Leviathan!")
leviathan.run(main())
```
## 🧪 Benchmarks
Leviathan stands out for its speed and performance. Here is a preliminary chart illustrating its superiority over other event loops:
For more information and additional tests, check the following file: [More benchmarks and details](BENCHMARK.md).
---
⚠️ **Warning**: Leviathan is still under active development. Some integrations, such as full networking support, are pending implementation.