Swagger YAML doc-string

swagger-yaml-doc-string-example.py

class AppLogListAPIView(CommonFilteringListView):
    ...
    def get(self, request, *args, **kwargs):
        """
        ---
        serializer: sa_logs.serializers.AppLogListSerializer
        parameters_strategy: merge
        omit_parameters:
            - path
        parameters:
            - name: datetime_start
              description: filter screenshots from date
              required: false
              type: datetime
            - name: datetime_end
              description: filter screenshots to date
              required: false
              type: datetime
            ...
        responseMessages:
            - code: 400
              message: Wrong input data
            - code: 401
              message: Not authenticated / Invalid signature (token)
            ...
        """
        return super(AppLogListAPIView, self).get(request, *args, **kwargs)