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.17.1

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.17.1
File Size Uploaded
didactic_fastapi-0.17.1.tar.gz 3.4 kB Details

Built distribution (wheel)

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

Total release size: 7.7 kB

Release files / didactic_fastapi-0.17.1.tar.gz

Download URL didactic_fastapi-0.17.1.tar.gz
Size 3.4 kB
Tags Source
SHA-256 checksum
How to use checksums
585b4a7d0ffa8c2ba8cda99c372ea24ac6bb725fa62b8fe98254d6cb170eaffd
BLAKE2b-256 checksum
How to use checksums
caaa4aa94d810eda89056408b0464a04e804bca38b5ff9ff8b8cb6a0649553b6
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 16, 2026.

Transparency log

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

Download URL didactic_fastapi-0.17.1-py3-none-any.whl
Size 4.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c958672a4d94059cb10fdd112fc1ffe4e73ae36b4ceb03fd238bba26ff1ebaf3
BLAKE2b-256 checksum
How to use checksums
18e69908f1d79b203e720157af6e69ab0a30a097fdebf1aad5eb8774036632bc
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 16, 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