fastapi_swagger2 0.1.0

Swagger2 support for FastAPI framework

fastapi_swagger2

Swagger2 support for FastAPI

---

Reason behind this library:

Few API GW services like Google Cloud API GW still support only Swagger 2.0 spec. Since FastAPI only supports OAS3, it is a challenge. Converting from OAS3 to Swagger 2.0 requires some manual steps which would hinder CI/CD.

---

Requirements

Python 3.8+

0.0.2 - FastAPI >= 0.79.0, <= 0.98.0 0.1.0 - FastAPI >= 0.99.0, <= 0.99.1

Installation

$ pip install fastapi_swagger2

Example

from typing import Union

from fastapi import FastAPI
from fastapi_swagger2 import FastAPISwagger2

app = FastAPI()
FastAPISwagger2(app)


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: Union[str, None] = None):
    return {"item_id": item_id, "q": q}

This adds following endpoints:

• http://localhost:8000/swagger2.json
• http://localhost:8000/swagger2/docs
• http://localhost:8000/swagger2/redoc

Development

$ pip install "/path/to/fastapi_swagger2/repo[test,all]"