注釈のないPythonコードからSwagger仕様を生成

Question

Pythonサービスの定義からSwagger仕様（JSONとSwagger-UI）を生成する方法を探しています。私は多くのオプション（通常はFlaskベース）を見つけましたが、それらのすべてが注釈を使用します。注釈はコード内で正しく処理できません。ループ内で異なるルートを持つ10個の等価なサービスを定義します（この例では、ハンドラはそれを取得するための最初の関数呼び出しです）。

アノテーションなしでこれを行う方法はありますか？私は、そのAPIメソッドの実装とドキュメンテーションに対応する値を使って関数（またはメソッド、またはクラスのコンストラクタ）を呼び出すことによって、APIとそのドキュメントでメソッドを生成したいと思います。

Answer 1

apispecを調べることをおすすめします。

apispecは、プラグ可能なAPI仕様ジェネレータです。

現在OpenAPIを2.0仕様（f.k.a.闊歩2.0）

apispec

from apispec import APISpec 

spec = APISpec(
    title='Gisty', 
    version='1.0.0', 
    info=dict(description='A minimal gist API') 
) 

spec.definition('Gist', properties={ 
    'id': {'type': 'integer', 'format': 'int64'}, 
    'content': 'type': 'string'}, 
}) 

spec.add_path(
    path='/gist/{gist_id}', 
    operations=dict(
     get=dict(
      responses={ 
       '200': { 
        'schema': {'$ref': '#/definitions/Gist'} 
       } 
      } 
     ) 
    ) 
)