Skip to main content

Extend a FastAPI OpenAPI spec to include all possible HTTPException or custom Exception response schemas.

Project description

fastapi-docx

FastAPI

Add HTTPException responses to a FastAPI OpenAPI spec

CI Coverage Package version Supported Python versions


Documentation: https://saran33.github.io/fastapi-docx

Source Code: https://github.com/Saran33/fastapi-docx


FastAPI-docx extends the FastAPI OpenAPI spec to include all possible HTTPException or custom Exception response schemas that may be raised within path operations.

The key features are:

  • Document Exception Responses: Automatically find all possible respones within path operations, whether they originate from a HTTPException raised by the endpoint function directly, in a nested function, class method, or callable class instance, or by the fastAPI dependency-injection system.
  • Include Custom Exceptions: Optionally find and document any custom Exception types if using custom Exception handlers in your FastAPI application.
  • Generate Exception schemas: A default HTTPExceptionSchema will be added to the OpenAPI specification. The default can be modified to use any other Pydantic model. An additional schema for app-specific custom Exceptions can also be included.
Dependencies
  • Pydantic V2: From version 1.0 of fastapi-docx, Pydantic V2 is required. For Pydantic V1 support, use fastapi-docx version 0.2.
License

This project is licensed under the terms of the MIT license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fastapi_docx-1.0.2.tar.gz (8.7 kB view hashes)

Uploaded Source

Built Distribution

fastapi_docx-1.0.2-py3-none-any.whl (8.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page