Add support for serializers.FileField response.

src/drf_yasg/utils.py

@@ -4,6 +4,7 @@ from django.core.validators import RegexValidator
 from django.utils.encoding import force_text
 from rest_framework import serializers
 from rest_framework.mixins import RetrieveModelMixin, DestroyModelMixin, UpdateModelMixin
+from rest_framework.settings import api_settings
 
 from . import openapi
 from .errors import SwaggerGenerationError
@@ -287,7 +288,13 @@ def serializer_field_to_swagger(field, swagger_object_type, definitions=None, **
         # swagger 2.0 does not support specifics about file fields, so ImageFile gets no special treatment
         # OpenAPI 3.0 does support it, so a future implementation could handle this better
         err = SwaggerGenerationError("parameter of type file is supported only in a formData Parameter")
-        if swagger_object_type != openapi.Parameter:
+        if swagger_object_type == openapi.Schema:
+            # FileField.to_representation returns URL or file name
+            if getattr(field, 'use_url', api_settings.UPLOADED_FILES_USE_URL):
+                return SwaggerType(type=openapi.TYPE_STRING, format=openapi.FORMAT_URI)
+            else:
+                return SwaggerType(type=openapi.TYPE_STRING)
+        elif swagger_object_type != openapi.Parameter:
             raise err  # pragma: no cover
         param = SwaggerType(type=openapi.TYPE_FILE)
         if param['in'] != openapi.IN_FORM:

testproj/articles/serializers.py

@@ -12,8 +12,8 @@ class ArticleSerializer(serializers.ModelSerializer):
 
     class Meta:
         model = Article
-        fields = ('title', 'body', 'slug', 'date_created', 'date_modified', 'references', 'uuid')
-        read_only_fields = ('date_created', 'date_modified')
+        fields = ('title', 'body', 'slug', 'date_created', 'date_modified', 'references', 'uuid', 'cover')
+        read_only_fields = ('date_created', 'date_modified', 'cover')
         lookup_field = 'slug'
         extra_kwargs = {'body': {'help_text': 'body serializer help_text'}}
 

tests/reference.yaml

@@ -493,6 +493,10 @@ definitions:
         description: should articles have UUIDs?
         type: string
         format: uuid
+      cover:
+        type: string
+        format: uri
+        readOnly: true
   Project:
     required:
       - project_name