higuma 0.1.0__tar.gz

higuma-0.1.0/.gitattributes

@@ -0,0 +1,11 @@
+* text=auto
+*.py text eol=lf
+*.rs text eol=lf
+*.toml text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.md text eol=lf
+*.pyd binary
+*.dll binary
+*.so binary
+*.dylib binary

higuma-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,27 @@
+name: Bug report
+description: Report reproducible incorrect behavior
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: textarea
+    attributes:
+      label: Description
+      description: What happened, and what did you expect?
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Reproduction
+      description: Include the smallest runnable example.
+    validations:
+      required: true
+  - type: input
+    attributes:
+      label: higuma version
+    validations:
+      required: true
+  - type: input
+    attributes:
+      label: Python, Rust, and operating system
+    validations:
+      required: true

higuma-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,21 @@
+name: Feature request
+description: Propose a focused improvement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    attributes:
+      label: Use case
+      description: What problem would this solve?
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Proposed API
+      description: Show how you would like to use the feature.
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Alternatives
+      description: Describe workarounds or related frameworks you considered.

higuma-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.12", "3.13"]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - name: Install
+        run: python -m pip install -e ".[dev]"
+      - name: Rust format
+        run: cargo fmt --all -- --check
+      - name: Rust check
+        run: cargo check
+      - name: Rust test
+        run: cargo test
+      - name: Python lint
+        run: python -m ruff check python tests examples
+      - name: Test
+        run: python -m unittest discover -s tests -v

higuma-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,48 @@
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install documentation dependencies
+        run: python -m pip install ".[docs]"
+      - name: Build documentation
+        run: mkdocs build --strict
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

higuma-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,97 @@
+name: Build release wheels
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  wheels:
+    name: Wheel (${{ matrix.platform.name }})
+    strategy:
+      matrix:
+        platform:
+          - name: linux-x86_64
+            runner: ubuntu-22.04
+            target: x86_64
+            manylinux: auto
+          - name: linux-aarch64
+            runner: ubuntu-22.04
+            target: aarch64
+            manylinux: auto
+          - name: musllinux-x86_64
+            runner: ubuntu-22.04
+            target: x86_64
+            manylinux: musllinux_1_2
+          - name: windows-x64
+            runner: windows-latest
+            target: x64
+            manylinux: auto
+          - name: macos-x86_64
+            runner: macos-15-intel
+            target: x86_64
+            manylinux: auto
+          - name: macos-aarch64
+            runner: macos-latest
+            target: aarch64
+            manylinux: auto
+    runs-on: ${{ matrix.platform.runner }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.10"
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          target: ${{ matrix.platform.target }}
+          args: --release --locked --compatibility pypi --out dist
+          manylinux: ${{ matrix.platform.manylinux }}
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-${{ matrix.platform.name }}
+          path: dist/*
+          if-no-files-found: error
+
+  source:
+    name: Source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.10"
+      - uses: dtolnay/rust-toolchain@stable
+      - run: python -m pip install maturin
+      - run: maturin sdist --out dist
+      - uses: actions/upload-artifact@v7
+        with:
+          name: source
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: [wheels, source]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/higuma
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          path: dist
+          merge-multiple: true
+      - name: List distributions
+        run: ls -lh dist
+      - name: Publish distributions
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+          print-hash: true

higuma-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyd
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.venv/
+venv/
+
+# Rust and maturin
+target/
+*.dll
+*.dylib
+*.so
+dist/
+site/
+build/
+*.egg-info/
+
+# Editors and operating systems
+.idea/
+.vscode/
+.DS_Store
+Thumbs.db
+
+# Local configuration
+.env
+.env.*
+!.env.example

higuma-0.1.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to higuma are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the project uses [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+### Planned
+
+- WebSocket support
+- Multipart file uploads
+- Template bytecode caching
+- OpenAPI schema generation
+- Unix multi-process supervisor
+
+## [0.1.0] - 2026-07-27
+
+### Added
+
+- Rust HTTP core based on axum and Tokio
+- Flask-inspired route decorators and dynamic route converters
+- Request and response objects, JSON, redirects, files, and SSR
+- Automatic HEAD and OPTIONS behavior
+- Error handlers, request hooks, middleware, and lifecycle hooks
+- Blueprint route groups and URL generation
+- Static files with ETag, conditional requests, and byte ranges
+- Signed cookie sessions
+- CORS, security header, and trusted host middleware
+- Async Python handler compatibility
+- In-process test client
+- CLI for running applications and listing routes
+- GitHub Actions CI and release wheel workflow
+- PyPI Trusted Publishing with multi-platform wheels

higuma-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,17 @@
+# Code of Conduct
+
+We want higuma to be a respectful, practical, and welcoming project.
+
+Participants are expected to:
+
+- Discuss ideas and code without personal attacks.
+- Assume good intent while remaining precise about technical concerns.
+- Respect privacy and avoid publishing private information.
+- Accept maintainer decisions made to protect users and the project.
+
+Harassment, discrimination, threats, and sustained disruptive behavior are not
+accepted. Maintainers may edit, remove, or reject contributions and may
+temporarily or permanently restrict participation when necessary.
+
+Reports should be made privately through the repository's security or maintainer
+contact channel once the repository is published.

higuma-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contributing to higuma
+
+Thank you for helping improve higuma.
+
+## Development setup
+
+Requirements:
+
+- Python 3.10 or newer
+- Rust stable toolchain
+- A C/C++ linker supported by Rust
+
+```bash
+python -m venv .venv
+.venv/Scripts/activate
+python -m pip install -U pip
+python -m pip install -e ".[dev]"
+```
+
+On macOS or Linux, activate the environment with:
+
+```bash
+source .venv/bin/activate
+```
+
+## Checks
+
+Run all checks before opening a pull request:
+
+```bash
+cargo fmt --all -- --check
+cargo check
+python -m ruff check python tests examples
+python -m unittest discover -s tests -v
+```
+
+## Pull requests
+
+- Keep changes focused and explain the behavior they change.
+- Add tests for bug fixes and new public behavior.
+- Update README.md and CHANGELOG.md when public APIs change.
+- Avoid claiming benchmark improvements without a reproducible command and environment.
+
+## Design principles
+
+- Python APIs should be familiar and explicit.
+- Work that does not require Python should stay in Rust when practical.
+- Security-sensitive defaults should be conservative.
+- Backwards compatibility follows Semantic Versioning after 1.0.