routedef 0.1.0__tar.gz

routedef-0.1.0/.ci/max-loc-baseline.json

@@ -0,0 +1,5 @@
+{
+  "max_lines": 500,
+  "roots": ["src", "tests", "scripts", "docs"],
+  "policy": "no counted project file may exceed max_lines"
+}

routedef-0.1.0/.ci/mutation-baseline.json

@@ -0,0 +1,4 @@
+{
+  "command": "uv run mutmut run && uv run mutmut results",
+  "allowed_survivors": []
+}

routedef-0.1.0/.ci/xenon-baseline.json

@@ -0,0 +1,6 @@
+{
+  "max_absolute": "C",
+  "max_modules": "B",
+  "max_average": "A",
+  "paths": ["src/routedef"]
+}

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

@@ -0,0 +1,120 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "feature/**"]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  UV_FROZEN: "0"
+  UV_LINK_MODE: copy
+
+jobs:
+  quality:
+    name: Quality (${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Check out source
+        uses: actions/checkout@v7
+
+      - name: Prepare git metadata for act
+        if: ${{ env.ACT == 'true' }}
+        run: |
+          rm -rf .git
+          git init
+          git config user.email "act@example.invalid"
+          git config user.name "act"
+          git add .
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+
+      - name: Install Python
+        run: |
+          uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --python ${{ matrix.python-version }} --all-extras --dev
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files
+
+      - name: Run coverage gate
+        run: uv run python scripts/retry_command.py --exit-code 139 -- uv run pytest -q --cov=src/routedef --cov-branch --cov-report=term-missing --cov-fail-under=100
+
+  package:
+    name: Package
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out source
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+
+      - name: Install Python
+        run: |
+          uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --python 3.13 --all-extras --dev
+
+      - name: Build and smoke-test wheel
+        run: uv run python scripts/check_build_install.py
+
+  cloudflare-worker:
+    name: Cloudflare Worker
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out source
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+
+      - name: Install Python
+        run: |
+          uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --python 3.13 --all-extras --dev
+
+      - name: Run Cloudflare Python Worker integration
+        run: uv run python scripts/check_cloudflare_worker.py
+
+  mutation:
+    name: Mutation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out source
+        uses: actions/checkout@v7
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+
+      - name: Install Python
+        run: |
+          uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --python 3.13 --all-extras --dev
+
+      - name: Run mutation gate
+        run: uv run python scripts/mutation_gate.py

routedef-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+.coverage
+.mypy_cache/
+.mutmut-cache/
+mutants/
+.pytest_cache/
+.ruff_cache/
+.venv/
+__pycache__/
+dist/
+htmlcov/
+core
+core.*
+uv.lock
+.worktrees/

routedef-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,127 @@
+repos:
+  - repo: local
+    hooks:
+      - id: detect-secrets
+        name: Detect secrets
+        entry: uv run python scripts/retry_command.py --exit-code 139 -- uv run detect-secrets-hook --baseline .secrets.baseline
+        language: system
+
+      - id: ruff-check
+        name: ruff check
+        entry: uv run ruff check --exit-non-zero-on-fix
+        language: system
+        types: [python]
+
+      - id: ruff-format
+        name: ruff format
+        entry: uv run ruff format --check
+        language: system
+        types: [python]
+
+      - id: codespell
+        name: codespell
+        entry: uv run python scripts/retry_command.py --exit-code 139 -- uv run codespell
+        language: system
+
+      - id: max-loc
+        name: python max loc
+        entry: uv run python scripts/check_max_loc.py --max-lines 500 --roots .
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: spdx-headers
+        name: Provide.io SPDX headers
+        entry: uv run python scripts/check_spdx_headers.py src tests scripts
+        language: system
+        pass_filenames: false
+        always_run: true
+        types: [python]
+
+      - id: licenses
+        name: license compliance
+        entry: uv run python scripts/check_licenses.py
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: mypy
+        name: mypy strict
+        entry: uv run mypy src tests
+        language: system
+        pass_filenames: false
+        always_run: true
+        types: [python]
+
+      - id: ty
+        name: ty check
+        entry: uv run ty check src tests
+        language: system
+        pass_filenames: false
+        always_run: true
+        types: [python]
+
+      - id: bandit
+        name: bandit
+        entry: uv run bandit -r src -ll
+        language: system
+        pass_filenames: false
+        always_run: true
+        types: [python]
+
+      - id: pytest
+        name: pytest
+        entry: uv run pytest -q
+        language: system
+        pass_filenames: false
+        always_run: true
+        types: [python]
+
+      - id: pip-audit
+        name: pip-audit vulnerability scan
+        entry: uv run python -m pip_audit
+        language: system
+        pass_filenames: false
+        always_run: true
+        types: [python]
+
+      - id: xenon
+        name: xenon complexity
+        entry: uv run python scripts/check_xenon.py --max-absolute C --max-modules B --max-average A --paths src/routedef
+        language: system
+        pass_filenames: false
+        always_run: true
+        types: [python]
+
+      - id: vulture
+        name: vulture dead code
+        entry: uv run vulture --min-confidence 80 src tests
+        language: system
+        pass_filenames: false
+        always_run: true
+        types: [python]
+
+      - id: mutation-sweep
+        name: mutmut gate (manual)
+        entry: uv run python scripts/mutation_gate.py
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [manual]
+        types: [python]
+
+      - id: cloudflare-worker-integration
+        name: Cloudflare Python Worker integration (manual)
+        entry: uv run python scripts/check_cloudflare_worker.py
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [manual]
+
+      - id: build-install-smoke
+        name: build and install smoke (manual)
+        entry: uv run python scripts/check_build_install.py
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [manual]

routedef-0.1.0/.secrets.baseline

@@ -0,0 +1,106 @@
+{
+  "version": "1.5.0",
+  "plugins_used": [
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "name": "DiscordBotTokenDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "name": "GitLabTokenDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "name": "KeywordDetector"
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "OpenAIDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "SendGridDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TelegramBotTokenDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "filters_used": [
+    {
+      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
+    },
+    {
+      "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
+      "min_level": 2
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_lock_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_sequential_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_swagger_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    }
+  ],
+  "results": {},
+  "generated_at": "2026-07-03T00:00:00Z"
+}

routedef-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 provide.io llc
+
+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.

routedef-0.1.0/LICENSES/MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 provide.io llc
+
+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.

routedef-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: routedef
+Version: 0.1.0
+Summary: Route definition primitives for Python services.
+Project-URL: Homepage, https://github.com/provide-io/routedef
+Project-URL: Repository, https://github.com/provide-io/routedef
+Project-URL: Documentation, https://github.com/provide-io/routedef/blob/main/docs/architecture.md
+Project-URL: Issues, https://github.com/provide-io/routedef/issues
+Author: provide.io llc
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.116.0; extra == 'fastapi'
+Description-Content-Type: text/markdown
+
+# RouteDef 🧭
+
+Runtime-neutral route definitions for Python services.
+
+`routedef` gives applications one route contract that can be mounted into multiple runtimes. The core package has
+no FastAPI, Cloudflare, ASGI, auth, database, or application dependency. Runtime-specific code lives in adapters.
+
+## What It Provides ✅
+
+- `RouteDef`: method, path template, handler, and metadata.
+- `RouteRequest`: canonical request object for handlers.
+- `RouteResponse`: canonical response object for handlers.
+- `RouteTable`: ordered method/path matching with `{path_param}` extraction.
+- `build_fastapi_router`: FastAPI router integration.
+- `CloudflareDispatcher`: direct Cloudflare Python Workers integration.
+
+## Why Use It 🎯
+
+Use `RouteDef` when you need the same route definitions to work across more than one Python runtime, especially
+when migrating between framework-hosted APIs and Cloudflare Python Workers.
+
+- One handler contract instead of per-runtime handler shapes.
+- App-owned auth and authorization through metadata, auth providers, and enforcers.
+- Dependency-free core package with optional runtime adapters.
+- Testable route behavior without starting a web server.
+- Migration-friendly wrappers for legacy split-argument handlers.
+
+## Why Not 🚧
+
+Do not use `RouteDef` as a full web framework, ORM, dependency injection container, auth library, or request
+validation system. It intentionally does not own app policy, storage, schemas, background jobs, or runtime
+lifecycle. If a service will only ever run in one framework and already has a stable route layer, the adapter
+boundary may not be worth adding.
+
+## Architecture 🏗️
+
+![routedef request flow](https://raw.githubusercontent.com/provide-io/routedef/main/docs/diagrams/routedef-flow.svg)
+
+![routedef package boundaries](https://raw.githubusercontent.com/provide-io/routedef/main/docs/diagrams/runtime-adapters.svg)
+
+See [docs/architecture.md](https://github.com/provide-io/routedef/blob/main/docs/architecture.md) for package
+boundaries and [docs/migration.md](https://github.com/provide-io/routedef/blob/main/docs/migration.md) for migration
+examples covering undef-style roles, admin authorization callbacks, Taybols JWT auth, and uwarp split-argument
+handlers.
+
+## Basic Usage 🚀
+
+```python
+from routedef import RouteDef, RouteRequest, RouteResponse, RouteTable
+
+
+async def get_item(request: RouteRequest[None, dict[str, object]]) -> RouteResponse:
+    return RouteResponse.json({"id": request.path_params["id"]})
+
+
+routes = RouteTable([RouteDef("GET", "/v1/items/{id}", get_item)])
+```
+
+## FastAPI
+
+```python
+from fastapi import FastAPI
+from routedef.adapters.fastapi import build_fastapi_router
+
+app = FastAPI()
+app.include_router(build_fastapi_router(routes))
+```
+
+## Cloudflare Python Workers
+
+```python
+from routedef.adapters.cloudflare import CloudflareDispatcher
+from workers import WorkerEntrypoint
+
+dispatcher = CloudflareDispatcher(routes)
+
+
+class Default(WorkerEntrypoint):
+    async def fetch(self, request):
+        return await dispatcher.dispatch(request)
+```
+
+A real local Cloudflare fixture lives in
+[examples/cloudflare-worker](https://github.com/provide-io/routedef/blob/main/examples/cloudflare-worker). Run it with:
+
+```bash
+uv run python scripts/check_cloudflare_worker.py
+```
+
+The integration script vendors the local `src/routedef` package into a temporary Python Worker project, runs
+`pywrangler sync`, starts `wrangler@latest dev`, and probes routes over HTTP.
+
+## Quality Gates 🧪
+
+```bash
+uv run pre-commit run --all-files
+uv run pytest -q --cov=src/routedef --cov-branch --cov-report=term-missing --cov-fail-under=100
+uv run pre-commit run mutation-sweep --hook-stage manual
+uv run pre-commit run cloudflare-worker-integration --hook-stage manual
+```
+
+The project requires 100% branch coverage, strict typing, security/dead-code/complexity checks, REUSE compliance,
+max-LOC checks, mutation testing, and a Cloudflare Worker runtime integration gate.

routedef-0.1.0/README.md

@@ -0,0 +1,103 @@
+# RouteDef 🧭
+
+Runtime-neutral route definitions for Python services.
+
+`routedef` gives applications one route contract that can be mounted into multiple runtimes. The core package has
+no FastAPI, Cloudflare, ASGI, auth, database, or application dependency. Runtime-specific code lives in adapters.
+
+## What It Provides ✅
+
+- `RouteDef`: method, path template, handler, and metadata.
+- `RouteRequest`: canonical request object for handlers.
+- `RouteResponse`: canonical response object for handlers.
+- `RouteTable`: ordered method/path matching with `{path_param}` extraction.
+- `build_fastapi_router`: FastAPI router integration.
+- `CloudflareDispatcher`: direct Cloudflare Python Workers integration.
+
+## Why Use It 🎯
+
+Use `RouteDef` when you need the same route definitions to work across more than one Python runtime, especially
+when migrating between framework-hosted APIs and Cloudflare Python Workers.
+
+- One handler contract instead of per-runtime handler shapes.
+- App-owned auth and authorization through metadata, auth providers, and enforcers.
+- Dependency-free core package with optional runtime adapters.
+- Testable route behavior without starting a web server.
+- Migration-friendly wrappers for legacy split-argument handlers.
+
+## Why Not 🚧
+
+Do not use `RouteDef` as a full web framework, ORM, dependency injection container, auth library, or request
+validation system. It intentionally does not own app policy, storage, schemas, background jobs, or runtime
+lifecycle. If a service will only ever run in one framework and already has a stable route layer, the adapter
+boundary may not be worth adding.
+
+## Architecture 🏗️
+
+![routedef request flow](https://raw.githubusercontent.com/provide-io/routedef/main/docs/diagrams/routedef-flow.svg)
+
+![routedef package boundaries](https://raw.githubusercontent.com/provide-io/routedef/main/docs/diagrams/runtime-adapters.svg)
+
+See [docs/architecture.md](https://github.com/provide-io/routedef/blob/main/docs/architecture.md) for package
+boundaries and [docs/migration.md](https://github.com/provide-io/routedef/blob/main/docs/migration.md) for migration
+examples covering undef-style roles, admin authorization callbacks, Taybols JWT auth, and uwarp split-argument
+handlers.
+
+## Basic Usage 🚀
+
+```python
+from routedef import RouteDef, RouteRequest, RouteResponse, RouteTable
+
+
+async def get_item(request: RouteRequest[None, dict[str, object]]) -> RouteResponse:
+    return RouteResponse.json({"id": request.path_params["id"]})
+
+
+routes = RouteTable([RouteDef("GET", "/v1/items/{id}", get_item)])
+```
+
+## FastAPI
+
+```python
+from fastapi import FastAPI
+from routedef.adapters.fastapi import build_fastapi_router
+
+app = FastAPI()
+app.include_router(build_fastapi_router(routes))
+```
+
+## Cloudflare Python Workers
+
+```python
+from routedef.adapters.cloudflare import CloudflareDispatcher
+from workers import WorkerEntrypoint
+
+dispatcher = CloudflareDispatcher(routes)
+
+
+class Default(WorkerEntrypoint):
+    async def fetch(self, request):
+        return await dispatcher.dispatch(request)
+```
+
+A real local Cloudflare fixture lives in
+[examples/cloudflare-worker](https://github.com/provide-io/routedef/blob/main/examples/cloudflare-worker). Run it with:
+
+```bash
+uv run python scripts/check_cloudflare_worker.py
+```
+
+The integration script vendors the local `src/routedef` package into a temporary Python Worker project, runs
+`pywrangler sync`, starts `wrangler@latest dev`, and probes routes over HTTP.
+
+## Quality Gates 🧪
+
+```bash
+uv run pre-commit run --all-files
+uv run pytest -q --cov=src/routedef --cov-branch --cov-report=term-missing --cov-fail-under=100
+uv run pre-commit run mutation-sweep --hook-stage manual
+uv run pre-commit run cloudflare-worker-integration --hook-stage manual
+```
+
+The project requires 100% branch coverage, strict typing, security/dead-code/complexity checks, REUSE compliance,
+max-LOC checks, mutation testing, and a Cloudflare Worker runtime integration gate.