使用drf-yasg，如何提供图案？

Question

我已经安装了 drf-yasg，它运行良好。我遇到的问题是它是一个大应用程序，并且每种类型的前端客户端都有大量的端点，即/admin/v1、/app/v1、...

所以我认为将每种类型的文档分开是个好主意，即

urlpatterns += [
     url(r'^/admin/swagger/$', admin_schema_view.with_ui('swagger', cache_timeout=0), name='schema-swagger-ui'),
     url(r'^/app/swagger/$', app_schema_view.with_ui('swagger', cache_timeout=0), name='schema-swagger-ui'),
]

所以看起来 drf-yasg 支持这一点，通过将 patterns 提供给 get_scheme_view：

admin_schema_view = get_schema_view(
    openapi.Info(
        title="API",
        default_version='v1',
        description="The set of API endpoints used.",
        terms_of_service="https://www.google.com/policies/terms/",
        contact=openapi.Contact(email="contact@me"),
        license=openapi.License(name="BSD License"),
    ),
    patterns=?????,
    validators=['flex', 'ssv'],
    public=True,
    permission_classes=(permissions.AllowAny,),
)

现在我的猜测是提供一个字符串，与定义urls 时的第一个字符串相同，例如patterns=r'^admin/v1/',，结果为：

File "/usr/local/lib/python3.6/dist- packages/rest_framework/compat.py", line 55, in get_original_route
return urlpattern.regex.pattern
AttributeError: 'str' object has no attribute 'regex'

所以使用drf-yasg docs 的文档：

patterns – 如果给定，将仅枚举这些模式以包含在 API 规范中

这里需要什么类型的对象来处理patterns？我已经尝试在 github 上查看 django-rest-framework 和 Django 源代码，但找不到真正需要的类型，它们都是非常大的项目。

Answer 1

经过一些实验，我发现它所期望的模式是一个 url 模式列表，而不仅仅是一个标准的 Python 正则表达式字符串。它应该与urls.py 中的标准django urlpatterns 完全相同。

因此，假设您已将管理 API url 模式导入为admin_urlpatterns，您只需在模式选项中指定它

admin_schema_view = get_schema_view(
openapi.Info(
    title="API",
    default_version='v1',
    description="The set of API endpoints used.",
    terms_of_service="https://www.google.com/policies/terms/",
    contact=openapi.Contact(email="contact@me"),
    license=openapi.License(name="BSD License"),
),
patterns=admin_urlpatterns,
validators=['flex', 'ssv'],
public=True,
permission_classes=(permissions.AllowAny,),
)

确实很难找到任何示例，他们可能希望在文档中包含一个生动的示例