django - 如何使用 `drf-spectacular` 记录 ViewSet 的各个操作？

Question

使用 DRF 的内置 API 记录方式，我能够编写如下所示的文档字符串，并且每个操作都由其对应的行记录：

"""
list:    The list action returns all available objects.
retrieve:The retrieve action returns a single object selected by `id`.
create:  The create action expects the fields `name`, creates a new object and returns it.
"""

我正在切换到 library drf-spectacular，它允许轻松生成符合 OpenAPI 的方案。但是，现在为每个操作呈现相同的文档字符串，这使得我的文档非常冗长且多余。

有没有办法只为每个操作呈现文档字符串的相关部分？

Answer 1

我刚刚发现该库通过其装饰器提供了非常深入的文档功能。在不覆盖任何 ViewSet 方法的情况下，上面的文档字符串可以写成：

@extend_schema_view(
    list=extend_schema(
        description="The list action returns all available actions."
    ),
    create=extend_schema(
        description="The create action expects the fields `name`, creates a new object and returns it."
    ),
    retrieve=extend_schema(
        description="The retrieve action returns a single object selected by `id`."
    )
)
class MyViewSet(viewsets.ViewSet):
    pass