2

我得到 AttributeError: module 'flask_restx.api' has no attribute 'doc' 当它尝试在使用烧瓶 restx 时为 API 添加附加内容时。如何修复此错误。

api.py

from flask import Flask
from flask_restx import Api, Resource
from hello import Hello

app = Flask(__name__)
api = Api(app)

api.add_resource(Hello, '/hello')

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

你好.py

from flask_restx import Resource, api


@api.doc(params={'id': 'An ID'})
class Hello(Resource):
    def get(self):
        return {
            'data': {
                'names': ['one',
                          'two',
                          'three']
            }
        }
4

2 回答 2

0

我不知道您遵循了哪个教程（如果您遵循了任何教程），但是

@api.doc(params={'id': 'An ID'})

需要一个 Api 类的实例，而不是 flask-restx.api

通常，在教程（至少是我找到的那些）中，它们展示了如何在同一个文件中完成所有这些操作。所以如果你的代码是这样写的，你的代码就可以工作：

api.py

from flask import Flask
from flask_restx import Api, Resource
from hello import Hello

app = Flask(__name__)
api = Api(app)

@api.doc(params={'id': 'An ID'})
class Hello(Resource):
    def get(self):
        return {
            'data': {
                'names': ['one',
                          'two',
                          'three']
            }
        }

api.add_resource(Hello, '/hello')

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

现在，这不是您想要实现的目标，因为我猜您想将文件拆分为具有某种结构（我也想这样做）。非常糟糕，我在网上找不到合适的教程，但这是我在项目中所做的（使用您的示例代码）：

api > __init__.py

from flask_restx import Namespace

default_namespace = Namespace("default", ordered=True)

api > hello.py

from flask_restx import Resource
from api import default_namespace as ns


@ns.doc(params={'id': 'An ID'})
class Hello(Resource):
    def get(self):
        return {
            'data': {
                'names': ['one',
                          'two',
                          'three']
            }
        }

app.py（您的 api.py 文件）位于根目录

from flask import Flask
from flask_restx import Api
from hello import Hello
from api import default_namespace

app = Flask(__name__)
api = Api(app)

api.add_resource(Hello, '/hello')
api.add_namespace(default_namespace)

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

包结构在哪里：

.
+-- app.py
+-- api
   +-- __init__.py
   +-- hello.py

通过声明命名空间，您实际上可以在 Swagger 中将资源组合在一起。我将命名空间放在另一个文件（此处__init__.py）中的原因是没有循环导入。并且您可以使用所有带有 ns.doc、ns.route 的装饰器，...就像使用 api 一样。（其中 api 是一个变量；）​​）。顺便说一句， ns 是一个别名，如果你喜欢放别的东西，你可以在 import 语句中更改它。

请注意，这可能不是最好的方法，但它对我和我所拥有的结构来说已经足够干净了。如果有更多经验的人知道如何以不同的方式做到这一点，请回复；）

于 2021-06-09T07:41:52.873 回答
0

这与@Jeremie 的答案几乎相同，但只是想指出官方文档。

flask-restx 中有以下语句。

Flask-RESTX 提供了一种使用几乎与 Flask 蓝图相同的模式的方法。主要思想是将您的应用程序拆分为可重用的命名空间。

并附带一个例子：

# let's say the file name is `cat_controller`.
from flask_restx import Namespace, Resource, fields

api = Namespace('cats', description='Cats related operations')

cat = api.model('Cat', {
    'id': fields.String(required=True, description='The cat identifier'),
    'name': fields.String(required=True, description='The cat name'),
})

CATS = [
    {'id': 'felix', 'name': 'Felix'},
]

@api.route('/')
class CatList(Resource):
    @api.doc('list_cats')
    @api.marshal_list_with(cat)
    def get(self):
        '''List all cats'''
        return CATS

我们需要add_namespace()：

from flask import Flask
from flask_restx import Api
from .cat_controller import api as ns1
from .dog_controller import api as ns2
# ...

app = Flask(__name__)
api = Api(
    app,
    version='1.0',
    title='A title',
    description='A description'
)

api.add_namespace(ns1)
api.add_namespace(ns2)

if __name__ == '__main__':
    app.run(debug=True)
于 2022-01-17T07:32:33.213 回答