FastAPIで作成したAPIについて、自動作成されるドキュメント(/docsあるいは/redoc)をSphinxで設計ドキュメントとしてそのまま利用したいと考えています。
Pythonスクリプト実行時に/docsはアクセス可能ですが、静的なドキュメントとして出力し、Sphinxで生成するドキュメントに反映する方法はないでしょうか?
以下に/docsページの参考例を貼り付けます。これをそのままドキュメントとして利用したいです。
ソースコードです。
from fastapi import FastAPI
from pydantic import BaseModel
from threading import Thread
import time
from uvicorn import Config, Server
import os
import sys
class ApiResult(BaseModel):
status: str
result: dict
error: dict
app = FastAPI(
title="Test",
description="Test",
version="0.1"
)
@app.get("/")
def read_api_root():
result = ApiResult(
status="SUCCESS",
result={"Message": "Welcome!!"},
error={}
)
return result.dict()
class web_server_thread:
def __init__(
self, web_app, host: str, port: int, reload: bool = False):
self.config = Config(
app=web_app,
host=host,
port=port,
reload=reload,
# log_level="warning",
)
self.server = Server(self.config)
self.server.install_signal_handlers = lambda: None
self.proc = None
def start(self):
self.th = Thread(name="WebServer Thread", target=self.server.run)
self.th.start()
def stop(self):
if self.th:
self.th.join(0.25)
class ApiServer():
def run(self, host: str = '127.0.0.1', port: int = 8008):
self.instThread = web_server_thread(
app, host=host, port=port)
self.instThread.start()
isLoop = True
while(isLoop):
time.sleep(0.2)
return
ApiServer().run()