Python Flask自动生成的Swagger/OpenAPI 3.0

Closed. This question does not meet Stack Overflow guidelines。它当前不接受答案。

想要改善这个问题吗？更新问题，以便将其作为on-topic用于堆栈溢出。

在11个月前关闭。

Improve this question

我试图为现有的Flask应用程序生成草率文档，我最初尝试使用Flask-RESTPlus，发现该项目现在非常丰富，并在 fork 的项目flask-restx https://github.com/python-restx/flask-restx中进行了检查，但我仍然认为它们不支持openapi 3.0

我有些困惑，无法选择适合我需要的包裹。我正在寻求解决一个问题，我们不想为我们的API手动创建swagger文档，而是希望使用包自动生成。

import os
import requests
import json, yaml


from flask import Flask, after_this_request, send_file, safe_join, abort
from flask_restx import Resource, Api, fields
from flask_restx.api import Swagger

app = Flask(__name__)
api = Api(app=app, doc='/docs', version='1.0.0-oas3', title='TEST APP API',
          description='TEST APP API')


response_fields = api.model('Resource', {
    'value': fields.String(required=True, min_length=1, max_length=200, description='Book title')
})


@api.route('/compiler/', endpoint='compiler')
# @api.doc(params={'id': 'An ID'})
@api.doc(responses={403: 'Not Authorized'})
@api.doc(responses={402: 'Not Authorized'})
# @api.doc(responses={200: 'Not Authorized'})
class DemoList(Resource):
    @api.expect(response_fields, validate=True)
    @api.marshal_with(response_fields, code=200)
    def post(self):
        """
        returns a list of conferences
        """
        api.payload["value"] = 'Im the response ur waiting for'
        return api.payload


@api.route('/swagger')
class HelloWorld(Resource):
    def get(self):
        data = json.loads(json.dumps(api.__schema__))
        with open('yamldoc.yml', 'w') as yamlf:
            yaml.dump(data, yamlf, allow_unicode=True, default_flow_style=False)
            file = os.path.abspath(os.getcwd())
            try:
                @after_this_request
                def remove_file(resp):
                    try:
                        os.remove(safe_join(file, 'yamldoc.yml'))
                    except Exception as error:
                        log.error("Error removing or closing downloaded file handle", error)
                    return resp

                return send_file(safe_join(file, 'yamldoc.yml'), as_attachment=True, attachment_filename='yamldoc.yml', mimetype='application/x-yaml')
            except FileExistsError:
                abort(404)


# main driver function
if __name__ == '__main__':
    app.run(port=5003, debug=True)

上面的代码是我尝试不同软件包的组合，但是它可以生成swagger 2.0 doc，但是我试图为openapi 3.0生成doc

有人可以建议一个好的软件包，它支持生成swagger yaml或json的openapi 3.0方法。

最佳答案

我找到了一个生成openapi 3.0文档的包
https://apispec.readthedocs.io/en/latest/install.html
这个包装很好地达到了目的。查找以下代码以了解详细用法。

from apispec import APISpec
from apispec.ext.marshmallow import MarshmallowPlugin
from apispec_webframeworks.flask import FlaskPlugin
from marshmallow import Schema, fields
from flask import Flask, abort, request, make_response, jsonify
from pprint import pprint
import json


class DemoParameter(Schema):
    gist_id = fields.Int()


class DemoSchema(Schema):
    id = fields.Int()
    content = fields.Str()


spec = APISpec(
    title="Demo API",
    version="1.0.0",
    openapi_version="3.0.2",
    info=dict(
        description="Demo API",
        version="1.0.0-oas3",
        contact=dict(
            email="admin@donofden.com"
            ), 
        license=dict(
            name="Apache 2.0",
            url='http://www.apache.org/licenses/LICENSE-2.0.html'
            )
        ),
    servers=[
        dict(
            description="Test server",
            url="https://resources.donofden.com"
            )
        ],
    tags=[
        dict(
            name="Demo",
            description="Endpoints related to Demo"
            )
        ],
    plugins=[FlaskPlugin(), MarshmallowPlugin()],
)

spec.components.schema("Demo", schema=DemoSchema)

# spec.components.schema(
#     "Gist",
#     {
#         "properties": {
#             "id": {"type": "integer", "format": "int64"},
#             "name": {"type": "string"},
#         }
#     },
# )
#
# spec.path(
#     path="/gist/{gist_id}",
#     operations=dict(
#         get=dict(
#             responses={"200": {"content": {"application/json": {"schema": "Gist"}}}}
#         )
#     ),
# )
# Extensions initialization
# =========================
app = Flask(__name__)


@app.route("/demo/<gist_id>", methods=["GET"])
def my_route(gist_id):
    """Gist detail view.
    ---
    get:
      parameters:
      - in: path
        schema: DemoParameter
      responses:
        200:
          content:
            application/json:
              schema: DemoSchema
        201:
          content:
            application/json:
              schema: DemoSchema
    """
    # (...)
    return jsonify('foo')


# Since path inspects the view and its route,
# we need to be in a Flask request context
with app.test_request_context():
    spec.path(view=my_route)
# We're good to go! Save this to a file for now.
with open('swagger.json', 'w') as f:
    json.dump(spec.to_dict(), f)

pprint(spec.to_dict())
print(spec.to_yaml())

希望这对某人有帮助!! :)
更新:更多详细文档
Python Flask自动生成的Swagger 3.0/Openapi文档-http://donofden.com/blog/2020/06/14/Python-Flask-automatically-generated-Swagger-3-0-openapi-Document
Python Flask自动生成的Swagger 2.0文档-
http://donofden.com/blog/2020/05/30/Python-Flask-automatically-generated-Swagger-2-0-Document

关于Python Flask自动生成的Swagger/OpenAPI 3.0，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/62066474/

上一篇：google-chrome - 停止 Chrome Tab sleep /休眠 2020

下一篇：Julia 函数返回匿名函数

c++ - 如何使用 swagger-codegen cpprest 客户端库代码？

python - 检查数字是否在两个数字内的更简洁的方法，如果不在则更改它

python - 使用 Flask 和 SQLAlchemy 的显式主-主数据库设置，希望使用 Flask-SQLAlchemy

python - 如何不在 Dash 中显示默认的 dcc.graph 模板？

python - 列表中列表之间的公共(public)列表

amazon-s3 - 如何将上传的文件传递到亚马逊S3？

python - Flask render_template 不渲染任何内容

flask - 如何使用默认文件创建 WTForms FileField？

swagger - 我什么时候应该使用 $ref 与 Open API 中的对象 id