1

几周前我安装了drf-spectacular. 一切正常,直到我在 DRF(Django Rest Framework)中启用版本控制。

我实施AcceptHeaderVersioning并且它工作正常。但后来我意识到 Swagger 没有在 /docs/ 处显示端点,并且显示了这条消息:“规范中没有定义操作!” .

如果我在设置中注释DEFAULT_VERSIONING_CLASSREST_FRAMEWORK,所有端点都会正确显示在 Swagger 文档页面 (/docs/) 中。但是,它破坏了我的版本控制:request.version = None.

我测试了AcceptHeaderVersioning, 以及URLPathVersioningNamespaceVersioning。所有这些结果都相同。

我读到这AcceptHeaderVersioning是一年前实施的。链接到这里的提交。

但我也读到它计划更改modify_for_versioning功能,它可能会影响标头版本控制。链接到管道模块中的功能,这里和对话这里。事实上,去年对模块进行了很多更改,请查看此处

这些是我的 DRF 设置:

REST_FRAMEWORK = {
    # Auth
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'rest_framework.authentication.TokenAuthentication',
    ],

    # Swagger/docs
    'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',

    # Pagination
    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
    'PAGE_SIZE': 5,

    # Testing
    'TEST_REQUEST_DEFAULT_FORMAT': 'json',

    # Versioning
    # https://www.django-rest-framework.org/api-guide/versioning/#configuring-the-versioning-scheme
    'DEFAULT_VERSIONING_CLASS': 'rest_framework.versioning.AcceptHeaderVersioning',
    'DEFAULT_VERSION': None,
    'ALLOWED_VERSIONS': None,
    'VERSION_PARAM': 'version',
}

问题

  1. 知道我做错了什么吗?有什么建议可以让两者一起工作(版本控制和招摇)?有什么建议么?
  2. 顺便说一句(这是次要问题,不是主要问题):是否可以drf-spectacular在我自己的项目中启动测试?

提前致谢!

4

1 回答 1

2

问题 1:版本控制工作得很好。这是一个常见的错误。当使用(via )SpectacularAPIView进行版本控制时,从中获取模式的请求可能不包含版本标头,因此您只会获得未版本控制的端点(在您的情况下没有)。AcceptHeaderVersioningDEFAULT_VERSIONING_CLASSSpectacularAPIView

显式请求版本化模式/api/schema?version=v2或手动设置版本

path('api/schema/', SpectacularAPIView.as_view(api_version='v2'), name='schema'),

常见问题条目

魔法发生的地方以及版本的使用顺序。

问题 2:python 轮子不包括测试。为此,您需要安装源包:https ://pypi.org/project/drf-spectacular/#files

于 2021-11-01T15:06:58.753 回答