python - 在评论中添加醒目的描述

我可以通过评论视图集自定义描述吗？
我使用drf-yasg。

我的代码：

class MetricViewSet(viewsets.ReadOnlyModelViewSet):
    """
       retrieve:
       Получить из справочника данные записи о метрике по *uuid*

       list:
       Получить из справочника коллекцию записей о метриках
    """
    lookup_field = 'uuid'
    serializer_class = MetricSerializer
    queryset = Metric.objects.all()
    permission_classes = (ApiPermission,)

我的序列化器

class MetricSerializer(serializers.ModelSerializer):
    """
        Metric serializer.
    """
    uuid = serializers.UUIDField(label='Global UUID', read_only=True)

    class Meta:  # pylint: disable=too-few-public-methods
        """
            Настройки сериализатора
        """
        model = Metric
        fields = ('uuid', 'creation_date', 'modify_date',
                  'name', 'description', 'enabled', 'comment')

我想在这里添加描述：


我该怎么做？

最佳答案

以下内容使您可以实现所要求的部分内容。通过结合使用swagger_auto_schema和Django's method_decorator来更改ViewSet的方法，参数和响应的描述。

检查两个链接以获取更多信息。

from rest_framework import viewsets
from drf_yasg import openapi
from drf_yasg.utils import swagger_auto_schema

@method_decorator(name='retrieve', decorator=swagger_auto_schema(
    operation_description="Method description",
    operation_id="Method ID",
    operation_summary="Method summary",
    manual_parameters=[
        openapi.Parameter('serial', in_=openapi.IN_PATH, type=openapi.TYPE_STRING, description='Parameter description')
    ],
    responses={'200': 'Response description'}
))
class MetricViewSet(viewsets.ReadOnlyModelViewSet):
    """
       retrieve:
       Получить из справочника данные записи о метрике по *uuid*

       list:
       Получить из справочника коллекцию записей о метриках
    """
    lookup_field = 'uuid'
    serializer_class = MetricSerializer
    queryset = Metric.objects.all()
    permission_classes = (ApiPermission,)

更新资料

我发现了一个错误，其中实际上忽略了传递给operation_summary的deprecated和swagger_auto_schema选项，因此我提交了此PR来解决此问题。

关于python - 在评论中添加醒目的描述，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/52092805/