Skip to main content

A packed to help generate documentation automatically for flask endpoints.

Project description

flaskdocs is a lightweight wrapper around a flask app which aims to centralize both validation and documentation of an API. Declare the schemas you're accept/return, and flaskdocs will let you generate an openapi.json file, as well as validating incoming requests and returning errors to the client if a request doesn't match the given schema.

Example usage:

Declare a flask app and pass it to a flaskdocs API as follows:

from flask import Flask, jsonify

from flaskdocs import API
from flaskdocs.schema import (

app = Flask(__name__)

api = API(
    description="Here's an example API",

    name="Add Numbers",
    description="Add two numbers together and return the sum",
        # use "Use" here to tell the parser try calling float, rather
        # than doing a type check, because queryParameters always come
        # in as strings
        Literal("x", description="The first number to add"): Use(float),
        Literal("y", description="The second number to add"): Use(float),
    response_schema={200: JsonSchema({
        Literal("sum", description="The sum x + y"): float
def add(x: float, y: float):
    return jsonify({"sum": x + y})


To run a more complete example (found in the example folder) run FLASK_APP=example/ python -m flask run from this directory.

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

flaskdocs-0.0.1.tar.gz (5.3 kB view hashes)

Uploaded source

Built Distribution

flaskdocs-0.0.1-py3-none-any.whl (6.1 kB view hashes)

Uploaded py3

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