FastAPI is awesome, but the documentation pages (Swagger or Redoc) all depend on external CDNs, which is problematic if you want to run on disconnected networks.
This package includes the required files from the CDN and serves them locally. It also provides a super-simple way to get a FastAPI instance configured to use those files.
Under the hood, this simply automates the process described in the official documentation here.
You can install this package from PyPi:
pip install fastapi-offline
Given the example from the FastAPI tutorial:
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
async def root():
return {"message": "Hello World"}
Simply create a fastapi_offline.FastAPIOffline
object instead:
from fastapi_offline import FastAPIOffline
app = FastAPIOffline()
@app.get("/")
async def root():
return {"message": "Hello World"}
Any options passed to FastAPIOffline()
except docs_url
, redoc_url
, and favicon_url
are passed through to FastAPI()
. docs_url
and redoc_url
are handled by fastapi-offline
, and use the same syntax as normal fastapi
library.
By default, the FastAPI favicon.png
is included and used as the shortcut icon on the docs pages. If you want to use a different one, you can specify it with the favicon_url
argument:
app = FastAPIOffline(
favicon_url="http://my.cool.site/favicon.png"
)
- This code is released under the MIT license.
- Parts of Swagger are included in this package. The original license (Apache 2.0) and copyright apply to those files.
- Parts of Redoc are included in this package. The original license (MIT) and copyright apply to those files.
- The FastAPI
favicon.png
file is included in this package. The original license (MIT) and copyright apply to that file.