python swagger配置使用

Swagger是一个API文档工具，它提供了API管理、测试和访问等功能。在Python中，有几个相关的包可以使用Swagger，如connexion、flasgger、flask-swagger和Flask-RESTPlus等。其中，flasgger是一个与Python web服务框架Flask高度集成的工具，它自带前端页面，无需安装其他依赖。

配置Swagger的方式有两种，一种是使用配置文件，另一种是在代码中进行全局配置。在配置文件方式中，你需要将注释放入api_get.yml文件中，并使用装饰器@swag_from来引用该文件。可以通过以下代码来实现：

from flask import Flask
import random
from flasgger import Swagger, swag_from

app = Flask(__name__)
Swagger(app)

@app.route('/api/<string:language>/', methods=['GET'])
@swag_from("api_get.yml")
def index(language):
    # your code here

app.run(debug=True)

而在全局配置方式中，你可以使用Swagger的config参数和template参数来进行配置，如下所示：

from flask import Flask
from flasgger import Swagger

app = Flask(__name__)

swagger_config = {
    "headers": [],
    "specs": [
        {
            "endpoint": 'apispec_2',
            "route": '/apispecification.json',
            "rule_filter": lambda rule: True,
            "model_filter": lambda tag: True,
        }
    ],
    "static_url_path": "/flasgger_static",
    "swagger_ui": True,
    "specs_route": "/doc/"
}

template_config = {
    "info": {
        "title": "Sample API",
        "description": "This is a sample API",
        "version": "1.0.0"
    }
}

Swagger(app, template=template_config, config=swagger_config)

app.run(debug=True)

以上是Python中使用Swagger配置的简要介绍。你可以根据实际需求进行相应的配置和调整。