turboapi 0.4.16__tar.gz → 0.5.2__tar.gz

{turboapi-0.4.16 → turboapi-0.5.2}/.github/workflows/build-and-release.yml

@@ -38,14 +38,10 @@ jobs:
             echo "Version $VERSION already on PyPI, skipping"
           fi
 
-  linux:
+  linux-x86_64:
     runs-on: ubuntu-latest
     needs: [check-version]
     if: needs.check-version.outputs.should_publish == 'true'
-    strategy:
-      matrix:
-        target: [x86_64, aarch64]
-      fail-fast: false
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
@@ -55,13 +51,35 @@ jobs:
       - name: Build wheels
         uses: PyO3/maturin-action@v1
         with:
-          target: ${{ matrix.target }}
+          target: x86_64
+          args: --release --out dist --find-interpreter
+          sccache: 'true'
+          manylinux: auto
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux-x86_64
+          path: dist
+
+  linux-aarch64:
+    runs-on: ubuntu-24.04-arm
+    needs: [check-version]
+    if: needs.check-version.outputs.should_publish == 'true'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: |
+            3.13
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: aarch64
           args: --release --out dist --find-interpreter
           sccache: 'true'
           manylinux: auto
       - uses: actions/upload-artifact@v4
         with:
-          name: wheels-linux-${{ matrix.target }}
+          name: wheels-linux-aarch64
           path: dist
 
   windows:
@@ -132,7 +150,7 @@ jobs:
   publish:
     name: Publish to PyPI
     runs-on: ubuntu-latest
-    needs: [linux, windows, macos, sdist]
+    needs: [linux-x86_64, linux-aarch64, windows, macos, sdist]
     steps:
       - uses: actions/download-artifact@v4
         with:

{turboapi-0.4.16 → turboapi-0.5.2}/.gitignore

@@ -2,6 +2,9 @@
 target/
 Cargo.lock
 
+# Conductor workspace
+.context/
+
 # Python artifacts
 __pycache__/
 *.py[cod]

{turboapi-0.4.16 → turboapi-0.5.2}/CHANGELOG.md

@@ -5,6 +5,56 @@ All notable changes to TurboAPI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - Unreleased
+
+### Added
+
+- **Async Handler Fast Paths** - True async support via Tokio runtime
+  - `SimpleAsyncFast` handler type for GET async handlers
+  - `BodyAsyncFast` handler type for POST/PUT async handlers
+  - `add_route_async_fast()` method for async handler registration
+  - pyo3-async-runtimes integration for Python coroutine conversion
+  - Automatic handler classification for sync vs async detection
+
+- **HTTP/2 Support** - Full HTTP/2 implementation
+  - `Http2Server` class with h2 protocol support
+  - Server push capabilities via `ServerPush`
+  - Stream multiplexing for concurrent requests
+
+- **TLS Support** - Secure HTTPS connections
+  - rustls backend (default, pure Rust)
+  - Optional OpenSSL backend via feature flag
+  - PEM certificate and key loading
+
+- **WebSocket Improvements** - Better message handling
+  - Improved text message routing to Python handlers
+  - Binary message handler support
+  - Clean connection lifecycle management
+
+- **Comprehensive Benchmarks** - Performance testing suite
+  - `python_benchmark.py` - Full framework benchmarks
+  - `async_comparison_bench.py` - Sync vs async comparison
+  - `performance_bench.rs` - Low-level Rust benchmarks
+
+- **Documentation**
+  - `docs/ASYNC_HANDLERS.md` - Async handler guide
+  - `docs/BENCHMARKS.md` - Benchmarking guide
+  - `docs/ARCHITECTURE.md` - Internal architecture
+  - DeepWiki integration for documentation
+
+### Changed
+
+- Handler classification now detects coroutine functions
+- Async handlers route through Tokio instead of Enhanced path
+- Simplified TokioRuntime (removed loop sharding complexity)
+
+### Performance
+
+- Async handlers use Tokio work-stealing scheduler
+- Sequential latency: 1.3-1.4x faster than FastAPI
+- Concurrent latency: 1.2-1.8x faster than FastAPI
+- JSON endpoints show largest improvement (1.8x concurrent)
+
 ## [0.3.0] - 2025-09-30
 
 ### Fixed

{turboapi-0.4.16 → turboapi-0.5.2}/Cargo.lock

@@ -156,6 +156,16 @@ version = "0.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "37b2a672a2cb129a2e41c10b1224bb368f9f37a2b16b612598138befd7b37eb5"
 
+[[package]]
+name = "cc"
+version = "1.2.54"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6354c81bbfd62d9cfa9cb3c773c2b7b2a3a482d569de977fd0e961f6e7c00583"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+
 [[package]]
 name = "cfg-if"
 version = "1.0.3"
@@ -375,6 +385,12 @@ version = "1.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
 
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8591b0bcc8a98a64310a2fae1bb3e9b8564dd10e381e6e28010fde8e8e8568db"
+
 [[package]]
 name = "float-cmp"
 version = "0.10.0"
@@ -390,6 +406,21 @@ version = "1.0.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
 
+[[package]]
+name = "foreign-types"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f6f339eb8adc052cd2ca78910fda869aefa38d22d5cb648e6485e4d3fc06f3b1"
+dependencies = [
+ "foreign-types-shared",
+]
+
+[[package]]
+name = "foreign-types-shared"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "00b0228411908ca8685dba7fc2cdd70ec9990a6e753e89b6ac91a84c40fbaf4b"
+
 [[package]]
 name = "futures"
 version = "0.3.31"
@@ -644,6 +675,21 @@ dependencies = [
  "want",
 ]
 
+[[package]]
+name = "hyper-tungstenite"
+version = "0.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "426356dc8c52c5a18c5a6c12226c03362f98e4723716074f8010051934cb451c"
+dependencies = [
+ "http-body-util",
+ "hyper",
+ "hyper-util",
+ "pin-project-lite",
+ "tokio",
+ "tokio-tungstenite",
+ "tungstenite",
+]
+
 [[package]]
 name = "hyper-util"
 version = "0.1.17"
@@ -851,6 +897,44 @@ version = "11.1.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d6790f58c7ff633d8771f42965289203411a5e5c68388703c06e14f24770b41e"
 
+[[package]]
+name = "openssl"
+version = "0.10.75"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08838db121398ad17ab8531ce9de97b244589089e290a384c900cb9ff7434328"
+dependencies = [
+ "bitflags",
+ "cfg-if",
+ "foreign-types",
+ "libc",
+ "once_cell",
+ "openssl-macros",
+ "openssl-sys",
+]
+
+[[package]]
+name = "openssl-macros"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a948666b637a0f465e8564c73e89d4dde00d72d4d473cc972f390fc3dcee7d9c"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "openssl-sys"
+version = "0.9.111"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "82cab2d520aa75e3c58898289429321eb788c3106963d0dc886ec7a5f4adc321"
+dependencies = [
+ "cc",
+ "libc",
+ "pkg-config",
+ "vcpkg",
+]
+
 [[package]]
 name = "parking_lot"
 version = "0.12.4"
@@ -892,6 +976,12 @@ version = "0.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"
 
+[[package]]
+name = "pkg-config"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7edddbd0b52d732b21ad9a5fab5c704c14cd949e5e9a1ec5929a24fded1b904c"
+
 [[package]]
 name = "plotters"
 version = "0.3.7"
@@ -1135,12 +1225,69 @@ version = "0.8.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "caf4aa5b0f434c91fe5c7f1ecb6a5ece2130b02ad2a590589dda5146df959001"
 
+[[package]]
+name = "ring"
+version = "0.17.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7"
+dependencies = [
+ "cc",
+ "cfg-if",
+ "getrandom",
+ "libc",
+ "untrusted",
+ "windows-sys 0.52.0",
+]
+
 [[package]]
 name = "rustc-demangle"
 version = "0.1.26"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "56f7d92ca342cea22a06f2121d944b4fd82af56988c270852495420f961d4ace"
 
+[[package]]
+name = "rustls"
+version = "0.23.36"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c665f33d38cea657d9614f766881e4d510e0eda4239891eea56b4cadcf01801b"
+dependencies = [
+ "once_cell",
+ "ring",
+ "rustls-pki-types",
+ "rustls-webpki",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "rustls-pemfile"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dce314e5fee3f39953d46bb63bb8a46d40c2f8fb7cc5a3b6cab2bde9721d6e50"
+dependencies = [
+ "rustls-pki-types",
+]
+
+[[package]]
+name = "rustls-pki-types"
+version = "1.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "be040f8b0a225e40375822a563fa9524378b9d63112f53e19ffff34df5d33fdd"
+dependencies = [
+ "zeroize",
+]
+
+[[package]]
+name = "rustls-webpki"
+version = "0.103.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7df23109aa6c1567d1c575b9952556388da57401e4ace1d15f79eedad0d8f53"
+dependencies = [
+ "ring",
+ "rustls-pki-types",
+ "untrusted",
+]
+
 [[package]]
 name = "rustversion"
 version = "1.0.22"
@@ -1231,6 +1378,12 @@ dependencies = [
  "lazy_static",
 ]
 
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
 [[package]]
 name = "signal-hook-registry"
 version = "1.4.6"
@@ -1283,6 +1436,12 @@ dependencies = [
  "windows-sys 0.59.0",
 ]
 
+[[package]]
+name = "subtle"
+version = "2.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
+
 [[package]]
 name = "syn"
 version = "2.0.106"
@@ -1391,6 +1550,27 @@ dependencies = [
  "syn",
 ]
 
+[[package]]
+name = "tokio-openssl"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59df6849caa43bb7567f9a36f863c447d95a11d5903c9cc334ba32576a27eadd"
+dependencies = [
+ "openssl",
+ "openssl-sys",
+ "tokio",
+]
+
+[[package]]
+name = "tokio-rustls"
+version = "0.26.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1729aa945f29d91ba541258c8df89027d5792d85a8841fb65e8bf0f4ede4ef61"
+dependencies = [
+ "rustls",
+ "tokio",
+]
+
 [[package]]
 name = "tokio-stream"
 version = "0.1.17"
@@ -1529,7 +1709,7 @@ dependencies = [
 
 [[package]]
 name = "turbonet"
-version = "0.4.16"
+version = "0.5.2"
 dependencies = [
  "anyhow",
  "bytes",
@@ -1539,19 +1719,25 @@ dependencies = [
  "futures-util",
  "http-body-util",
  "hyper",
+ "hyper-tungstenite",
  "hyper-util",
  "itoa",
  "memchr",
  "num_cpus",
+ "openssl",
  "pin-project-lite",
  "pyo3",
  "pyo3-async-runtimes",
  "rayon",
+ "rustls",
+ "rustls-pemfile",
  "ryu",
  "serde",
  "serde_json",
  "simd-json",
  "tokio",
+ "tokio-openssl",
+ "tokio-rustls",
  "tokio-test",
  "tokio-tungstenite",
  "tracing",
@@ -1576,6 +1762,12 @@ version = "0.2.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
 
+[[package]]
+name = "untrusted"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1"
+
 [[package]]
 name = "utf-8"
 version = "0.7.6"
@@ -1600,6 +1792,12 @@ dependencies = [
  "ryu",
 ]
 
+[[package]]
+name = "vcpkg"
+version = "0.2.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "accd4ea62f7bb7a82fe23066fb0957d48ef677f6eeb8215f372f52e48bb32426"
+
 [[package]]
 name = "version_check"
 version = "0.9.5"
@@ -1860,3 +2058,9 @@ dependencies = [
  "quote",
  "syn",
 ]
+
+[[package]]
+name = "zeroize"
+version = "1.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b97154e67e32c85465826e8bcc1c59429aaaf107c1e4a9e53c8d8ccd5eff88d0"

{turboapi-0.4.16 → turboapi-0.5.2}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "turbonet"
-version = "0.4.16"
+version = "0.5.2"
 edition = "2021"
 authors = ["Rach Pradhan <rach@turboapi.dev>"]
 description = "High-performance Python web framework core - Rust-powered HTTP server with Python 3.14 free-threading support, FastAPI-compatible security and middleware"
@@ -17,8 +17,10 @@ name = "turbonet"
 crate-type = ["cdylib", "rlib"]
 
 [features]
-default = ["python"]
+default = ["python", "tls-rustls"]
 python = ["pyo3"]
+tls-rustls = ["rustls", "tokio-rustls", "rustls-pemfile"]
+tls-openssl = ["openssl", "tokio-openssl"]
 
 [dependencies]
 pyo3 = { version = "0.26.0", features = ["extension-module"], optional = true }
@@ -29,6 +31,7 @@ hyper-util = { version = "0.1.10", features = ["full", "http2"] }
 http-body-util = "0.1.2"
 pin-project-lite = "0.2.15"
 tokio-tungstenite = "0.24"
+hyper-tungstenite = "0.15"
 futures-util = "0.3"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
@@ -45,6 +48,14 @@ simd-json = "0.14"
 itoa = "1.0"
 ryu = "1.0"
 
+# TLS support (rustls with ring backend for cross-compilation compatibility)
+# Using ring instead of aws-lc-rs because aws-lc-rs requires complex cross-compilation setup
+rustls = { version = "0.23", default-features = false, features = ["ring", "std", "tls12"], optional = true }
+tokio-rustls = { version = "0.26", default-features = false, features = ["ring"], optional = true }
+rustls-pemfile = { version = "2.0", optional = true }
+openssl = { version = "0.10", optional = true }
+tokio-openssl = { version = "0.6", optional = true }
+
 [dev-dependencies]
 criterion = { version = "0.5", features = ["html_reports"] }
 tokio-test = "0.4"

turboapi-0.5.2/Makefile

@@ -0,0 +1,53 @@
+.PHONY: help test build install clean benchmark
+
+help:
+	@echo "TurboAPI Development Commands"
+	@echo "=============================="
+	@echo ""
+	@echo "Testing:"
+	@echo "  make test          - Run all tests"
+	@echo ""
+	@echo "Building:"
+	@echo "  make build         - Build wheel"
+	@echo "  make install       - Install in development mode"
+	@echo "  make clean         - Clean build artifacts"
+	@echo ""
+	@echo "Benchmarks:"
+	@echo "  make benchmark     - Run benchmarks and generate charts"
+	@echo ""
+
+# Run tests
+test:
+	@echo "🧪 Running tests..."
+	@python -m pytest tests/ -v --tb=short
+
+# Build wheel
+build:
+	@echo "📦 Building wheel..."
+	@maturin build --release
+
+# Install in development mode
+install:
+	@echo "🔧 Installing in development mode..."
+	@maturin develop --release
+
+# Clean build artifacts
+clean:
+	@echo "🧹 Cleaning build artifacts..."
+	@rm -rf target/
+	@rm -rf dist/
+	@rm -rf build/
+	@rm -rf *.egg-info
+	@find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	@find . -type f -name "*.pyc" -delete
+	@find . -type f -name "*.so" -delete
+	@echo "✅ Clean complete"
+
+# Run benchmarks
+benchmark:
+	@echo "📊 Running benchmarks..."
+	@PYTHON_GIL=0 python benchmarks/run_benchmarks.py
+	@echo ""
+	@echo "📈 Generating charts..."
+	@python benchmarks/generate_charts.py
+	@echo "✅ Benchmarks complete! Charts saved to assets/"