astraapi 0.1.0__tar.gz

astraapi-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,121 @@
+name: Build and Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build_wheels:
+    name: Build wheels (${{ matrix.os }}, ${{ matrix.arch }})
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Linux x86_64 — manylinux_2_28 container (GCC 14)
+          - os: linux
+            arch: x86_64
+            runner: ubuntu-latest
+            cibw_archs: x86_64
+
+          # Linux aarch64 — native ARM runner (no Docker/QEMU)
+          - os: linux
+            arch: aarch64
+            runner: ubuntu-24.04-arm
+            cibw_archs: aarch64
+
+          # macOS Apple Silicon (native)
+          - os: macos
+            arch: arm64
+            runner: macos-14
+            cibw_archs: arm64
+
+          # Windows x64
+          - os: windows
+            arch: AMD64
+            runner: windows-latest
+            cibw_archs: AMD64
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install deps (macOS)
+        if: matrix.os == 'macos'
+        run: brew install libdeflate brotli || true
+
+      - name: Install zlib (Windows)
+        if: matrix.os == 'windows'
+        run: vcpkg install zlib:x64-windows
+
+      - name: Install cibuildwheel
+        run: pip install cibuildwheel==2.22.0
+
+      - name: Build wheels
+        run: python -m cibuildwheel --output-dir wheelhouse
+        env:
+          CIBW_BUILD: "cp312-* cp313-* cp314-*"
+          CIBW_SKIP: "*-musllinux* *-win32 *-manylinux_i686"
+          CIBW_ARCHS: ${{ matrix.cibw_archs }}
+
+          # Linux: use manylinux_2_28 (GCC 14, glibc 2.28) — required for C++20 features
+          CIBW_MANYLINUX_X86_64_IMAGE: quay.io/pypa/manylinux_2_28_x86_64
+          CIBW_MANYLINUX_AARCH64_IMAGE: quay.io/pypa/manylinux_2_28_aarch64
+
+          # Linux: install compression libs inside manylinux container
+          CIBW_BEFORE_BUILD_LINUX: dnf install -y libdeflate-devel brotli-devel || true
+
+          # macOS: brew libs on macos-14 runner require deployment target 14.0
+          CIBW_ENVIRONMENT_MACOS: MACOSX_DEPLOYMENT_TARGET=14.0
+
+          # Windows: pass vcpkg toolchain
+          CIBW_CONFIG_SETTINGS_WINDOWS: >
+            cmake.define.CMAKE_TOOLCHAIN_FILE=C:/vcpkg/scripts/buildsystems/vcpkg.cmake
+            cmake.define.VCPKG_TARGET_TRIPLET=x64-windows
+
+          CIBW_BUILD_VERBOSITY: 1
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.arch }}
+          path: wheelhouse/*.whl
+
+  build_sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: pipx run build --sdist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: Install twine
+        run: pip install --upgrade twine
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+        run: twine upload --verbose dist/*
+
+      - name: Attach release notes to GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: release_notes.md

astraapi-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+.idea
+.ipynb_checkpoints
+.mypy_cache
+.vscode
+__pycache__
+.pytest_cache
+htmlcov
+dist
+site
+.coverage*
+coverage.xml
+.netlify
+test.db
+log.txt
+Pipfile.lock
+env3.*
+env
+docs_build
+site_build
+venv
+docs.zip
+archive.zip
+
+# vim temporary files
+*~
+.*.sw?
+.cache
+
+
+# macOS
+.DS_Store
+
+.codspeed
+*.so
+**/build/
+.claude
+target/
+
+tmps/

astraapi-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

astraapi-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,113 @@
+# Contributing to AstraAPI
+
+Thanks for helping improve AstraAPI.
+
+This project combines Python framework ergonomics with a C++ runtime core, so good contributions usually include both correctness and performance awareness.
+
+## Ways to Contribute
+
+- Report bugs and edge cases with a minimal reproduction.
+- Improve docs, examples, and developer guides.
+- Add tests for regressions and behavior coverage.
+- Improve runtime performance in Python or C++ hot paths.
+- Propose API improvements that keep compatibility and clarity.
+
+## Development Setup
+
+1. Fork and clone the repository.
+2. Create a feature branch from `main`.
+3. Install in editable mode:
+
+```bash
+pip install -e .
+pip install -e .[standard]
+```
+
+4. If your change touches native runtime internals, configure and build the C++ core under `cpp_core/`.
+
+## Architecture Areas
+
+When opening PRs, mention which layer you changed:
+
+- Python app/runtime layer:
+	- `astraapi/applications.py`
+	- `astraapi/routing.py`
+	- `astraapi/dependencies/`
+- Native bridge/runtime layer:
+	- `astraapi/_cpp_server.py`
+	- `astraapi/_core_bridge.py`
+	- `astraapi/_multiworker.py`
+- C++ core:
+	- `cpp_core/src/`
+	- `cpp_core/include/`
+
+## Request Lifecycle Awareness
+
+For request-path changes, validate impact across:
+
+1. Parse and route matching behavior.
+2. Middleware ordering and exception handling.
+3. Dependency injection and validation behavior.
+4. Response serialization and transport writes.
+5. Keep-alive and protocol state transitions.
+
+For WebSocket changes, include handshake, frame handling, and close path testing.
+
+## Multi-Worker Awareness
+
+For worker/supervisor changes, test both:
+
+- Linux/Unix dispatch patterns (`SCM_RIGHTS`/fork or reuse-port mode).
+- Windows `socket.share()` and subprocess worker behavior.
+
+Document any platform-specific caveats in the PR description.
+
+## Testing
+
+Run relevant tests before submitting:
+
+```bash
+pytest
+```
+
+Targeted test runs for touched modules are encouraged when the full suite is expensive.
+
+For performance-sensitive contributions, include before/after metrics and methodology.
+
+## Pull Request Guidelines
+
+- Keep PR scope focused.
+- Include tests for new behavior and bug fixes.
+- Update docs when APIs or behavior change.
+- Explain compatibility impact.
+- Include benchmark evidence when claiming speedups.
+
+## Commit and Review Expectations
+
+- Use clear commit messages describing intent.
+- Respond to review comments with code changes or rationale.
+- Keep history understandable; avoid unrelated refactors in the same PR.
+
+## Release Lifecycle
+
+Publishing is tag-driven through GitHub Actions (`.github/workflows/publish.yml`):
+
+1. Tag push matching `v*`.
+2. Wheel builds across Linux, macOS, and Windows.
+3. Source distribution build.
+4. PyPI publish.
+5. GitHub release notes attachment.
+
+If your contribution affects packaging or native builds, ensure it is compatible with the release matrix.
+
+## Code of Conduct
+
+Please be respectful, constructive, and collaborative in all interactions.
+
+## License
+
+By contributing, you agree that your contributions are licensed under the MIT License in `LICENSE`.
+
+## Attribution
+
+This project is inspired by FastAPI and maintained by Lumos-Labs-HQ with community contributors.

astraapi-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Sebastián Ramírez
+Copyright (c) 2026 Lumos-Labs-HQ contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.