Skip to main content

didactic-fastapi

PyPI Python License CI Docs

didactic-fastapi adapts dx.Model classes for FastAPI request validation, response validation, and OpenAPI generation. It adds the didactic.fastapi module and uses didactic-pydantic at the framework boundary.

Install

pip install didactic-fastapi

The distribution depends on didactic, didactic-pydantic, and fastapi>=0.115.

Use a Didactic response model

import didactic.api as dx
from didactic.fastapi import as_response, register_validation_handler
from fastapi import FastAPI


class User(dx.Model):
    id: str
    email: str


app = FastAPI()
register_validation_handler(app)


@app.get("/users/{user_id}", response_model=as_response(User))
def get_user(user_id: str) -> User:
    return User(id=user_id, email="ada@example.org")

as_response(User) returns a cached pydantic.BaseModel subclass that mirrors User. FastAPI uses that class for validation and OpenAPI generation.

Adapter behavior

Function Behavior
as_response(model) returns the generated Pydantic class for a response model
as_request(model) returns the same adapter under a request-oriented name
register_validation_handler(app) converts dx.ValidationError raised in a route into a FastAPI-style 422 response

Models with dx.indexed_by fields retain their cross-field validation. Their known index cases also appear as conditional constraints in the generated OpenAPI schema.

Documentation

See the FastAPI guide for request models, response models, error handling, and integration limits.

License

Released under the MIT License.

Metadata

Release files for didactic-fastapi 0.16.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for didactic-fastapi 0.16.0
File Size Uploaded
didactic_fastapi-0.16.0.tar.gz 3.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for didactic-fastapi 0.16.0
File Interpreter ABI Platform
didactic_fastapi-0.16.0-py3-none-any.whl Python 3 none any Details

Total release size: 7.7 kB

Release files / didactic_fastapi-0.16.0.tar.gz

Download URL didactic_fastapi-0.16.0.tar.gz
Size 3.4 kB
Tags Source
SHA-256 checksum
How to use checksums
21ac812099f1003ebc56958d32d9365e9f9444bbe87706505663d0a2690843d3
BLAKE2b-256 checksum
How to use checksums
2481b32405af1268f4e071ec4db1ba2a2d9555410606e1a385ce3fed1affbb08
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.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 Sep 15, 2026.

Transparency log

Release files / didactic_fastapi-0.16.0-py3-none-any.whl

Download URL didactic_fastapi-0.16.0-py3-none-any.whl
Size 4.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1a8d4995068b5346d7fd26e8f3b5080f82e0853a46c06163ffb067ad54347851
BLAKE2b-256 checksum
How to use checksums
c13ddc9d899c76a37be5cb828abc541fd346ea836f14b32a1ba1a09ed285d885
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.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 Sep 15, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page