Добавить описание чванства в комментариях

1

Могу ли я настроить описание swagger на viewview? Я использую 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')

Я хочу добавить описание здесь: Изображение 174551

Как мне это сделать?

  • 0
    Проверьте обновленный ответ
  • 0
    Теперь вы можете принять и это, если оно ответит на ваш вопрос :)
Теги:
django-rest-framework
drf-yasg

1 ответ

1

Ниже вы можете получить часть того, что вы просили. Это изменяет описания методов, параметров и ответов ViewSet с помощью swagger_auto_schema в сочетании с Django method_decorator.

Проверьте ссылки для получения дополнительной информации.

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, чтобы исправить это.

  • 0
    @Vetos Мне было бы интересно узнать, если вы когда-нибудь нашли способ настроить все остальное.

Ещё вопросы

Сообщество Overcoder
Наверх
Меню