turboapi 0.3.23__tar.gz → 0.3.24__tar.gz

{turboapi-0.3.23 → turboapi-0.3.24}/AGENTS.md

@@ -1,15 +1,17 @@
-# TurboAPI v0.3.0+ - AI Agent Guide 🤖
+# TurboAPI v0.3.23 - AI Agent Guide 🤖
 
 **For AI assistants, code generation tools, and automated development systems**
 
 ## 🎯 **What TurboAPI Is**
 
-TurboAPI is a **FastAPI-compatible** Python web framework that delivers **5-10x better performance** through:
+TurboAPI is a **FastAPI-compatible** Python web framework that delivers **9-10x better performance** through:
 - **Rust-powered HTTP core** (zero Python overhead)
-- **Python 3.13 free-threading** support (true parallelism) 
+- **Python 3.13 free-threading** with `Python::attach()` (TRUE parallel execution) 
+- **pyo3-async-runtimes** integration (native tokio async support)
 - **Zero-copy optimizations** and intelligent caching
 - **100% FastAPI syntax compatibility** with automatic body parsing
 - **Satya validation** (faster than Pydantic)
+- **72,000+ req/s** in production benchmarks
 
 ## 🚀 **For AI Agents: Key Facts**
 

{turboapi-0.3.23 → turboapi-0.3.24}/Cargo.lock

@@ -1439,7 +1439,7 @@ dependencies = [
 
 [[package]]
 name = "turbonet"
-version = "0.3.23"
+version = "0.3.24"
 dependencies = [
  "anyhow",
  "bytes",

{turboapi-0.3.23 → turboapi-0.3.24}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "turbonet"
-version = "0.3.23"
+version = "0.3.24"
 edition = "2021"
 authors = ["Rach Pradhan <rach@turboapi.dev>"]
 description = "High-performance Python web framework core - Rust-powered HTTP server with Python 3.13 free-threading support"

{turboapi-0.3.23 → turboapi-0.3.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: turboapi
-Version: 0.3.23
+Version: 0.3.24
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License

{turboapi-0.3.23 → turboapi-0.3.24}/README.md

@@ -1,12 +1,13 @@
 # TurboAPI 🚀
 
-**The Python web framework that gives you FastAPI's beloved developer experience with 5-10x the performance.**
+**The Python web framework that gives you FastAPI's beloved developer experience with 9-10x the performance.**
 
-Built with Rust for revolutionary speed, designed with Python for developer happiness.
+Built with Rust for revolutionary speed, designed with Python for developer happiness. **First framework to leverage Python 3.13 free-threading for true parallel request handling!**
 
 > **⚡ Try it in 30 seconds:** `python live_performance_showcase.py` → Visit `http://127.0.0.1:8080`  
-> **🔥 See the difference:** Same FastAPI syntax, 5-10x faster performance!  
-> **🎯 Zero migration effort:** Change 1 import line, keep all your existing code
+> **🔥 72,000+ requests/sec:** 9-10x faster than FastAPI in real benchmarks!  
+> **🎯 Zero migration effort:** Change 1 import line, keep all your existing code  
+> **🧵 Python 3.13 Free-Threading:** TRUE parallel Python execution - no GIL!
 
 ## 🎨 **100% FastAPI-Compatible Developer Experience**
 
@@ -46,32 +47,31 @@ app.run(host="127.0.0.1", port=8000)
 
 ## 🚀 **Revolutionary Performance**
 
-### **Why TurboAPI is 5-10x Faster**
+### **Why TurboAPI is 9-10x Faster**
 - **🦀 Rust-Powered HTTP Core**: Zero Python overhead for request handling
 - **⚡ Zero Middleware Overhead**: Rust-native middleware pipeline  
-- **🧵 Free-Threading Ready**: True parallelism for Python 3.13+
+- **🧵 Python 3.13 Free-Threading**: TRUE parallel Python execution with `Python::attach()`
 - **💾 Zero-Copy Optimizations**: Direct memory access, no Python copying
-- **🔄 Intelligent Caching**: Response caching with TTL optimization
+- **🔄 pyo3-async-runtimes**: Native tokio integration for async handlers
+- **🎯 Multi-threaded**: 3x CPU cores worker threads for maximum throughput
 
-### **Benchmark Results vs FastAPI** (wrk load testing)
-
-![Benchmark Comparison](benchmark_comparison.png)
+### **Benchmark Results vs FastAPI** (v0.3.23 - wrk, 4 threads, 100 connections)
 
 ```
-🎯 Light Load (50 connections):
-  Root Endpoint:       42,803 req/s (TurboAPI) vs 8,078 req/s (FastAPI) = 5.3x faster
-  Simple Endpoint:     43,375 req/s (TurboAPI) vs 8,536 req/s (FastAPI) = 5.1x faster  
-  JSON Endpoint:       41,696 req/s (TurboAPI) vs 3,208 req/s (FastAPI) = 13.0x faster
+🎯 TurboAPI v0.3.23 (Python 3.13 Free-Threading):
+  Simple GET:          72,903 req/s  |  Latency: ~1.4ms
+  Parameterized:       71,690 req/s  |  Latency: ~1.4ms
+  Async Handlers:      13,417 req/s  |  Latency: ~7.5ms
 
-🎯 Medium Load (200 connections):
-  Root Endpoint:       42,874 req/s (TurboAPI) vs 8,220 req/s (FastAPI) = 5.2x faster
-  Simple Endpoint:     43,592 req/s (TurboAPI) vs 8,542 req/s (FastAPI) = 5.1x faster
-  JSON Endpoint:       41,822 req/s (TurboAPI) vs 3,190 req/s (FastAPI) = 13.1x faster
+🎯 FastAPI (uvicorn):
+  Simple GET:           8,337 req/s  |  Latency: ~12ms
+  Parameterized:        7,413 req/s  |  Latency: ~13ms
+  Async Handlers:       8,337 req/s  |  Latency: ~12ms
 
-🎯 Heavy Load (500 connections):
-  Root Endpoint:       43,057 req/s (TurboAPI) vs 7,897 req/s (FastAPI) = 5.5x faster
-  Simple Endpoint:     43,525 req/s (TurboAPI) vs 8,092 req/s (FastAPI) = 5.4x faster
-  JSON Endpoint:       42,743 req/s (TurboAPI) vs 3,099 req/s (FastAPI) = 13.8x faster
+📊 Performance Comparison:
+  Sync Handlers:    9.0x faster than FastAPI  🚀🚀🚀
+  Async Handlers:   1.6x faster than FastAPI  ✅
+  Latency:          8.5x lower than FastAPI   ⚡
 
 🚀 Summary:
   • Average speedup: 5-13x faster than FastAPI

{turboapi-0.3.23 → turboapi-0.3.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "turboapi"
-version = "0.3.23"
+version = "0.3.24"
 description = "Revolutionary Python web framework with FastAPI syntax and 5-10x performance (Python 3.13+ free-threading required)"
 requires-python = ">=3.13"
 license = {text = "MIT"}

{turboapi-0.3.23 → turboapi-0.3.24}/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "turboapi"
-version = "0.3.23"
+version = "0.3.24"
 description = "Revolutionary Python web framework with FastAPI syntax and 5-10x performance (Python 3.13+ free-threading required)"
 requires-python = ">=3.13"
 license = {text = "MIT"}

{turboapi-0.3.23 → turboapi-0.3.24}/src/server.rs

@@ -468,13 +468,15 @@ fn call_python_handler_fast(
         
         // Handle sync vs async results differently
         if is_coroutine {
-            // Async handler - use pyo3-async-runtimes to convert Python coroutine to Rust future
-            // This integrates with tokio's runtime for true async performance!
+            // Async handler - use pyo3-async-runtimes for tokio integration
+            // NOTE: Still uses block_in_place() - true async requires making handle_request async
+            // Current performance: ~13K RPS (vs 72K for sync)
+            // Future optimization: Make entire request pipeline async (v0.4.0)
             
             // Convert Python coroutine to Rust future using pyo3-async-runtimes
             let rust_future = pyo3_async_runtimes::tokio::into_future(result.clone_ref(py).into_bound(py))?;
             
-            // Await the Rust future in tokio's runtime (blocking this thread)
+            // Await the future (releases Python but blocks tokio thread)
             let awaited_result = py.allow_threads(|| {
                 tokio::task::block_in_place(|| {
                     tokio::runtime::Handle::current().block_on(rust_future)