turboapi 0.4.15__tar.gz → 0.5.2__tar.gz

turboapi-0.5.2/.github/workflows/build-and-release.yml

@@ -0,0 +1,217 @@
+name: Build & Publish
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  check-version:
+    name: Check if version is new
+    runs-on: ubuntu-latest
+    outputs:
+      should_publish: ${{ steps.check.outputs.should_publish }}
+      version: ${{ steps.check.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check PyPI for existing version
+        id: check
+        run: |
+          VERSION=$(grep -m1 'version = "' Cargo.toml | sed 's/.*"\(.*\)"/\1/')
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          if [[ "$GITHUB_REF" == refs/tags/v* ]]; then
+            echo "should_publish=true" >> $GITHUB_OUTPUT
+            echo "Tag push detected, will publish v$VERSION"
+            exit 0
+          fi
+          HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" "https://pypi.org/pypi/turboapi/$VERSION/json")
+          if [ "$HTTP_STATUS" = "404" ]; then
+            echo "should_publish=true" >> $GITHUB_OUTPUT
+            echo "Version $VERSION not on PyPI, will publish"
+          else
+            echo "should_publish=false" >> $GITHUB_OUTPUT
+            echo "Version $VERSION already on PyPI, skipping"
+          fi
+
+  linux-x86_64:
+    runs-on: ubuntu-latest
+    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: 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-aarch64
+          path: dist
+
+  windows:
+    runs-on: windows-latest
+    needs: [check-version]
+    if: needs.check-version.outputs.should_publish == 'true'
+    strategy:
+      matrix:
+        target: [x64]
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: |
+            3.13
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          args: --release --out dist --find-interpreter
+          sccache: 'true'
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows-${{ matrix.target }}
+          path: dist
+
+  macos:
+    runs-on: macos-latest
+    needs: [check-version]
+    if: needs.check-version.outputs.should_publish == 'true'
+    strategy:
+      matrix:
+        target: [x86_64-apple-darwin, aarch64-apple-darwin]
+      fail-fast: false
+    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: ${{ matrix.target }}
+          args: --release --out dist --find-interpreter
+          sccache: 'true'
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    needs: [check-version]
+    if: needs.check-version.outputs.should_publish == 'true'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [linux-x86_64, linux-aarch64, windows, macos, sdist]
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: '{wheels-*,sdist}'
+          path: dist
+          merge-multiple: true
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true
+
+  release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: [check-version, publish]
+    if: startsWith(github.ref, 'refs/tags/v')
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: '{wheels-*,sdist}'
+          path: dist
+          merge-multiple: true
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+
+  tag-and-release:
+    name: Tag new version
+    runs-on: ubuntu-latest
+    needs: [check-version, publish]
+    if: github.ref == 'refs/heads/main' && needs.check-version.outputs.should_publish == 'true'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Configure git
+        run: |
+          git config user.email "action@github.com"
+          git config user.name "GitHub Action"
+      - name: Create tag
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="${{ needs.check-version.outputs.version }}"
+          git tag "v${VERSION}"
+          git push origin "v${VERSION}"
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: '{wheels-*,sdist}'
+          path: dist
+          merge-multiple: true
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ needs.check-version.outputs.version }}
+          files: dist/*
+          generate_release_notes: true

turboapi-0.5.2/.github/workflows/ci.yml

@@ -0,0 +1,179 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Cache Rust dependencies
+        uses: Swatinem/rust-cache@v2
+
+      - name: Check formatting
+        run: cargo fmt --all -- --check
+
+      - name: Run clippy
+        run: cargo clippy --all-targets -- -W warnings 2>&1 || true
+
+  test-rust:
+    name: Test Rust
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust dependencies
+        uses: Swatinem/rust-cache@v2
+
+      - name: Check Rust compilation
+        run: cargo check --all-targets
+
+  test-python:
+    name: "test (Python ${{ matrix.python-version }})"
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ['3.13']
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust dependencies
+        uses: Swatinem/rust-cache@v2
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install maturin pytest pytest-asyncio requests
+
+      - name: Build and install turboapi
+        run: |
+          maturin build --release -i python --out dist
+          pip install dist/*.whl
+          # dhi is installed as a dependency automatically
+
+      - name: Run tests
+        run: python -m pytest $GITHUB_WORKSPACE/tests/ -v --tb=short
+
+  test-free-threaded:
+    name: "test (${{ matrix.python-version }} free-threaded)"
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ['3.13t']
+      fail-fast: false
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }} (free-threaded)
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust dependencies
+        uses: Swatinem/rust-cache@v2
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install maturin pytest pytest-asyncio requests
+
+      - name: Build and install turboapi (free-threaded)
+        run: |
+          maturin build --release -i python --out dist
+          pip install dist/*.whl
+          # dhi is installed as a dependency automatically
+
+      - name: Run tests (free-threaded)
+        run: python -m pytest $GITHUB_WORKSPACE/tests/ -v --tb=short
+
+      - name: Run thread-safety smoke test
+        run: |
+          python -c "
+          import threading, concurrent.futures
+          from turboapi import TurboAPI, TurboRequest, TurboResponse
+
+          def create_app_and_routes(thread_id):
+              app = TurboAPI(title=f'App {thread_id}')
+              for i in range(100):
+                  @app.get(f'/t{thread_id}/route{i}')
+                  def handler(tid=thread_id, idx=i):
+                      return {'thread': tid, 'route': idx}
+              return thread_id
+
+          with concurrent.futures.ThreadPoolExecutor(max_workers=8) as pool:
+              futures = [pool.submit(create_app_and_routes, t) for t in range(8)]
+              results = [f.result() for f in futures]
+              assert len(results) == 8
+          print('Free-threaded smoke test: 8 threads x 100 routes = OK')
+          "
+
+  build-check:
+    name: "build (${{ matrix.target }})"
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: macos-latest
+            target: aarch64-apple-darwin
+          - os: windows-latest
+            target: x64
+      fail-fast: false
+    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: ${{ matrix.target }}
+          args: --release --out dist --find-interpreter
+          sccache: 'true'
+          manylinux: auto
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
+          path: dist

{turboapi-0.4.15 → turboapi-0.5.2}/.github/workflows/release.yml

@@ -51,32 +51,32 @@ jobs:
         run: |
           # Install bump2version if not available
           pip install bump2version
-          
-          # Extract current version from python/pyproject.toml
-          CURRENT_VERSION=$(grep -Po '(?<=version = ")[^"]*' python/pyproject.toml)
+
+          # Extract current version from pyproject.toml (root)
+          CURRENT_VERSION=$(grep -Po '(?<=version = ")[^"]*' pyproject.toml | head -1)
           echo "Current version: $CURRENT_VERSION"
-          
+
           # Create .bumpversion.cfg for coordinated version bumping
           cat > .bumpversion.cfg << EOF
           [bumpversion]
           current_version = $CURRENT_VERSION
           commit = False
           tag = False
-          
-          [bumpversion:file:python/pyproject.toml]
+
+          [bumpversion:file:pyproject.toml]
           search = version = "{current_version}"
           replace = version = "{new_version}"
-          
+
           [bumpversion:file:Cargo.toml]
           search = version = "{current_version}"
           replace = version = "{new_version}"
           EOF
-          
-          # Bump version in both python/pyproject.toml and Cargo.toml
+
+          # Bump version in both pyproject.toml and Cargo.toml
           bump2version ${{ github.event.inputs.version_bump }} --allow-dirty
-          
+
           # Get new version
-          NEW_VERSION=$(grep -Po '(?<=version = ")[^"]*' python/pyproject.toml)
+          NEW_VERSION=$(grep -Po '(?<=version = ")[^"]*' pyproject.toml | head -1)
           echo "New version: $NEW_VERSION"
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
       
@@ -108,7 +108,7 @@ jobs:
       - name: Commit version bump and create tag
         id: create_tag
         run: |
-          git add python/pyproject.toml Cargo.toml CHANGELOG.md .bumpversion.cfg
+          git add pyproject.toml Cargo.toml CHANGELOG.md .bumpversion.cfg
           git commit -m "Bump version to v${{ steps.bump_version.outputs.new_version }}"
           git tag -a "v${{ steps.bump_version.outputs.new_version }}" -m "Release v${{ steps.bump_version.outputs.new_version }}"
           git push && git push --tags

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

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

{turboapi-0.4.15 → 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