Changelog

1.6.2

Release date: Apr 25, 2018

  • IMPROVED: updated swagger-ui to version 3.13.6
  • IMPROVED: switched ReDoc to version 2.0.0-alpha.17 (was 1.21.2); fixes #107
  • FIXED: made documentation ordering of parameters stable for urls with multiple parameters (#105, #106)
  • FIXED: fixed crash when using a model ChoiceField of unknown child type

1.6.1

Release date: Apr 01, 2018

  • ADDED: added SUPPORTED_SUBMIT_METHODS swagger-ui setting

1.6.0

Release date: Mar 24, 2018

  • IMPROVED: OAUTH2_REDIRECT_URL will now default to the built in oauth2-redirect.html file

1.5.1

Release date: Mar 18, 2018

  • IMPROVED: updated swagger-ui to version 3.13.0
  • FIXED: fixed a crash caused by serializers.OneToOneRel (#81, thanks to @ko-pp)

1.5.0

Release date: Mar 12, 2018

  • IMPROVED: serializers.HiddenField are now hidden (#78, #79, thanks to @therefromhere)

    NOTE: in order for this to work, you will have to add the new drf_yasg.inspectors.HiddenFieldInspector to your DEFAULT_FIELD_INSPECTORS array if you changed it from the default value

  • IMPROVED: type of model field is now detected for serializers.SlugRelatedField with read_only=True (#82, #83, thanks to @therefromhere)

1.4.7

Release date: Mar 05, 2018

  • FIXED: prevent crashes caused by attempting to delete object attributes which do not exist in the first place (#76)

1.4.6

Release date: Mar 05, 2018

  • IMPROVED: updated swagger-ui to version 3.12.0
  • IMPROVED: updated ReDoc to version 1.21.2

1.4.5

Release date: Mar 05, 2018

  • FIXED: fixed an issue with modification of swagger_auto_schema arguments in-place during introspection, which would sometimes cause an incomplete Swagger document to be generated after the first pass (#74, #75)

1.4.4

Release date: Feb 26, 2018

  • IMPROVED: type for ChoiceField generated by a ModelSerializer from a model field with choices=... will now be set according to the associated model field (#69)
  • FIXED: lookup_field and lookup_value_regex on the same ViewSet will no longer trigger an exception (#68)

1.4.3

Release date: Feb 22, 2018

  • FIXED: added a missing assignment that would cause the default argument to openapi.Parameter.__init__ to be ignored

1.4.2

Release date: Feb 22, 2018

  • FIXED: fixed a bug that causes a ModelViewSet generated from models with nested ForeignKey to output models named Nested into the definitions section (#59, #65)
  • FIXED: Response objects without a schema are now properly handled when passed through swagger_auto_schema (#66)

1.4.1

Release date: Feb 21, 2018

  • FIXED: the coerce_to_string is now respected when setting the type, default value and min/max values of DecimalField in the OpenAPI schema (#62)
  • FIXED: error responses from web UI views are now rendered with TemplateHTMLRenderer instead of throwing confusing errors (#58)
  • IMPROVED: updated swagger-ui to version 3.10.0
  • IMPROVED: updated ReDoc to version 1.21.0

1.4.0

Release date: Feb 04, 2018

  • ADDED: added settings for OAuth2 client configuration in swagger-ui (#53)
  • IMPROVED: updated swagger-ui to version 3.9.3

1.3.1

Release date: Jan 24, 2018

  • FIXED: fixed a bug that would sometimes cause endpoints to wrongly be output as form operations (#50)
  • IMPROVED: added generation of produces based on renderer classes
  • IMPROVED: added generation of top-level consumes and produces based on DEFAULT_PARSER_CLASSES and DEFAULT_RENDERER_CLASSES (#48)

1.3.0

Release date: Jan 23, 2018

  • ADDED: security requirements are now correctly set and can be customized; this should fix problems related to authentication in swagger-ui Try it out! (#50, #54)
  • IMPROVED: updated swagger-ui to version 3.9.2
  • IMPROVED: updated ReDoc to version 1.20.0
  • FIXED: fixed an exception caused by a warning in get_path_from_regex (#49, thanks to @blueyed)

1.2.2

Release date: Jan 12, 2018

  • FIXED: djangorestframework>=3.7.7 is now required because of breaking changes (#44, #45, thanks to @h-hirokawa)

1.2.1

Release date: Jan 12, 2018

  • Fixed deployment issues

1.2.0

Release date: Jan 12, 2018 (missing from PyPI due to deployment issues)

  • ADDED: basePath is now generated by taking into account the SCRIPT_NAME variable and the longest common prefix of API urls (#37, #42)
  • IMPROVED: removed inline scripts and styles from bundled HTML templates to increase CSP compatibility
  • IMPROVED: improved validation errors and added more assertion sanity checks (#37, #40)
  • IMPROVED: improved handling of NamespaceVersioning by excluding endpoints of differing versions (i.e. when accesing the schema view for v1, v2 endpoints will not be included in swagger)

1.1.3

Release date: Jan 02, 2018

  • FIXED: schema view cache will now always Vary on the Cookie and Authentication (the Vary header was previously only added if public was set to True) - this fixes issues related to Django authentication in swagger-ui and CurrentUserDefault values in the schema

1.1.2

Release date: Jan 01, 2018

  • IMPROVED: updated swagger-ui to version 3.8.1
  • IMPROVED: removed some unneeded static files

1.1.1

Release date: Dec 27, 2017

1.1.0

Release date: Dec 27, 2017

  • ADDED: added support for APIs versioned with URLPathVersioning or NamespaceVersioning
  • ADDED: added ability to recursively customize schema generation using pluggable inspector classes
  • ADDED: added operation_id parameter to @swagger_auto_schema
  • ADDED: integration with djangorestframework-camel-case (#28)
  • IMPROVED: strings, arrays and integers will now have min/max validation attributes inferred from the field-level validators
  • FIXED: fixed a bug that caused title to never be generated for Schemas; title is now correctly populated from the field’s label property

1.0.6

Release date: Dec 23, 2017

  • FIXED: Swagger UI “Try it out!” should now work with Django login
  • FIXED: callable default values on serializer fields will now be properly called (#24, #25)
  • IMPROVED: updated swagger-ui to version 3.8.0
  • IMPROVED: PrimaryKeyRelatedField and SlugRelatedField will now have appropriate types based on the related model (#26)
  • IMPROVED: mock views will now have a bound request even with public=False (#23)

1.0.5

Release date: Dec 18, 2017

  • FIXED: fixed a crash caused by having read-only Serializers nested by reference
  • FIXED: removed erroneous backslashes in paths when routes are generated using Django 2 path()
  • IMPROVED: updated swagger-ui to version 3.7.0
  • IMPROVED: FileField is now generated as an URL or file name in response Schemas (#21, thanks to @h-hirokawa)

1.0.4

Release date: Dec 16, 2017

1.0.3

Release date: Dec 15, 2017

  • FIXED: fixed bug that caused schema views returned from cache to fail (#14)
  • FIXED: disabled automatic generation of response schemas for form operations to avoid confusing errors caused by attempting to shove file parameters into Schema objects

1.0.2

Release date: Dec 13, 2017

  • First published version