包括另一个文件 wagger

在开发过程中，我们经常会写一些重复的代码或者一些可以复用的模块。为了避免这些问题，我们可以使用另一个文件作为模块，然后在需要使用的地方引入。这个文件可以是我们自己写的或者是现成的第三方库。在Python中，我们使用import语句来引入一个模块。

一个神奇的Python模块，能够让我们更加方便得编写RESTful API文档，那就是wagger。

安装

在安装wagger之前，需要先安装pip，可以通过以下命令安装：

$ sudo apt-get install python-pip

然后使用pip来安装wagger：

$ sudo pip install wagger

使用

安装好之后，我们就可以开始使用wagger来编写RESTful API文档了。以下是使用wagger的一个例子：

from flask import Flask
from wagger import wagger

app = Flask(__name__)

# 初始化wagger
api = wagger(app)

# 添加API
@api.route('/test')
def test():
    """
    这是测试API
    ---
    tags:
        - 测试
    responses:
        200:
            description: 成功
    """
    return 'test'

if __name__ == '__main__':
    app.run(debug=True)

在这个例子中，我们创建了一个Flask应用，并初始化了wagger。然后我们使用@api.route()来装饰一个函数，表示这是我们的一个API。注意，这个函数必须有一个docstring，表示这个API的文档信息，wagger会根据这个信息来生成API文档。

额外信息

以上介绍的例子只是wagger的冰山一角。wagger除了支持Flask之外，还支持其他框架，例如Django和Tornado。另外，wagger还支持生成API测试用例和mock数据。

如果你想了解更多wagger的信息，可以查看官方文档。