csrd-versioning
API versioning, dispatch, docs, and actuator for FastAPI.
Package: csrd.versioning · Import: from csrd.versioning import compose_versioned_apps, configure_versioned_api
What's included
- Version dispatch — raw ASGI middleware for version-aware routing (streaming/SSE safe)
- Swagger UI — custom docs with version picker, dark mode, SRI hashes, plugin system
- Actuator — Spring Boot-style management endpoints (health, info, env)
- Exception handlers — structured
APIErrorResponseJSON for HTTP and validation errors - Dependency wiring — auto path-param injection, bearer guard opt-out
Installation
uv pip install "csrd-versioning @ git+ssh://git@github.com/csrd-api/fastapi-common.git#subdirectory=packages/versioning"
Quick start
from enum import Enum
from fastapi import FastAPI
from csrd.versioning import compose_versioned_apps, VersionedApiConfig, VersionedAppComposeConfig
class Versions(Enum):
Unversioned = "Unversioned"
V1 = "2025-06-20"
unv = FastAPI()
v1 = FastAPI()
app = compose_versioned_apps(
{Versions.Unversioned: unv, Versions.V1: v1},
config=VersionedAppComposeConfig(
api=VersionedApiConfig(prefix="api"),
),
)
Security notes
/actuator/env: TheShowValues.ALWAYSsetting exposes environment variable values. UseShowValues.NEVER(default) in production to redact sensitive data.- CORS: Add
CORSMiddlewarebefore callingconfigure_versioned_api. The version dispatch middleware must be the outermost middleware. Example:
app = FastAPI()
app.add_middleware(CORSMiddleware, allow_origins=["https://app.example.com"], ...)
configure_versioned_api(app, version_mapping, ...)
Dependencies
csrd-models,csrd-context(Tier 1 packages —csrd-versioningis Tier 3)- For JWT auth, use
csrd-authalongside this package
1 maintainer
Metadata
1 maintainer
Release files for csrd-versioning 0.5.29
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| csrd_versioning-0.5.29.tar.gz | 72.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| csrd_versioning-0.5.29-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 153.7 kB
Release files / csrd_versioning-0.5.29.tar.gz
| Download URL | csrd_versioning-0.5.29.tar.gz |
|---|---|
| Size | 72.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3b14839b7ae269fb6326b07440121d6fa2732f29902fdfc36700b5096a7107fe
|
|
BLAKE2b-256 checksum How to use checksums |
7b1ca97bf7e7a252a8b9b60a9b5fb272682900be07e85fb86f3b88e5acba32f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 26, 2026.
Transparency logRelease files / csrd_versioning-0.5.29-py3-none-any.whl
| Download URL | csrd_versioning-0.5.29-py3-none-any.whl |
|---|---|
| Size | 81.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ffdaab43a91e9948cabd764429c48d3941130c58620e15dcd8e4025efd3f5f5b
|
|
BLAKE2b-256 checksum How to use checksums |
d882faf00b991b0b9deddc2f2d581946aa7131b40dfc3a1957f997102da56f6b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 26, 2026.
Transparency log
