Automated generation of real Swagger/OpenAPI 2.0 schemas from Django REST Framework code.
OTHER License
Bot releases are visible (Hide)
Published by axnsan12 about 6 years ago
DISPLAY_OPERATION_ID
swagger-ui
settingReDoc
to version 2.0.0-alpha.38pattern
will now work on any field with a RegexValidator
(would previously not appear on fields with special formats such as EmailField
)RelatedFieldInspector
handling of nested serializersreverse_lazy
in URL settings (#209)Published by axnsan12 about 6 years ago
SPEC_URL
setting for controlling the download link in swagger-ui
and ReDoc
ReDoc
settings (added NATIVE_SCROLLBARS
and REQUIRED_PROPS_FIRST
)extra_styles
and extra_scripts
blocks to ui templates (#178)swagger-ui
to version 3.18.2ReDoc
to version 2.0.0-alpha.37readOnly
SchemasUSE_SESSION_AUTH=False
operation_summary
and deprecated
(#194, #198)typing
hints (#195)future
(#196)default=None
(#203)request_body=no_body
handling and related tests (#188, #199)Published by axnsan12 about 6 years ago
EXCLUDED_MEDIA_TYPES
setting for controlling produces
MIME type filtering (#158)SerializerMethodField
, via the swagger_serializer_method
decorator for the method field, and support for Python 3.5 style type hinting of the method field return type (#137, #175, #179)drf_yasg.inspectors.SerializerMethodFieldInspector
to your DEFAULT_FIELD_INSPECTORS
array if you changed it from the default valueswagger-ui
to version 3.18.0swagger_schema_fields
will now also work on serializer Field
s (#167)ref_name
collisions will now log a warning message (#156)operation_summary
and deprecated
arguments to swagger_auto_schema
(#149, #173)swagger_auto_schema
work with DRF 3.9 @action
mappings (#177)Published by axnsan12 about 6 years ago
swagger-ui
to version 3.17.6ReDoc
to version 2.0.0-alpha.32--api-version
argument to the generate_swagger
management command (#170)generate_swagger
work for projects without authentication (#161)SafeText
interaction with YAML codec (#159)Published by axnsan12 over 6 years ago
swagger_fake_view
marker to more easily detect mock views in view methods; getattr(self, 'swagger_fake_view', False)
inside a view method like get_serializer_class
will tell you if the view instance is being used for swagger schema introspection (#154)swagger-ui
to version 3.17.1ReDoc
to version 2.0.0-alpha.25None
as a response override (#148)Published by axnsan12 over 6 years ago
Release date: Jun 16, 2018
DEFAULT_GENERATOR_CLASS
setting and --generator-class
argument to the generate_swagger
management command (#140)'count'
response field on CursorPagination
(#141)swagger_extra_fields
would not be handlded (#142)coreapi.Fields
s without a schema
(#143)Published by axnsan12 over 6 years ago
swagger_schema_fields <swagger_schema_fields>
field on serializer Meta
classes forJSONRenderer
instead of throwingreadOnly
schema fields will now no longer be marked as required
(#133)Published by axnsan12 over 6 years ago
Release date: May 14, 2018
swagger-ui
to version 3.14.2ReDoc
to version 2.0.0-alpha.20None
return from get_operation
to avoid empty Path
objects in outputDELETE
endpoints (#118)Published by axnsan12 over 6 years ago
__init__
methods throw exceptions will now be ignored during endpoint enumerationPublished by axnsan12 over 6 years ago
SECURITY_REQUIREMENTS
to match documented behaviourSECURITY_REQUIREMENTS
and SECURITY_DEFINITIONS
is now stablePublished by axnsan12 over 6 years ago
swagger-ui
to version 3.14.1swagger-ui
showCommonExtensions
to True
by default and add SHOW_COMMON_EXTENSIONS
setting keymin_length=1
when allow_blank=False
(#112, thanks to @elnappo)SwaggerDict
extra attributes stablePublished by axnsan12 over 6 years ago
ADDED: added integration with djangorestframework-recursive (#109, #110, thanks to @rsichny)
NOTE: in order for this to work, you will have to add the new drf_yasg.inspectors.RecursiveFieldInspector
to your DEFAULT_FIELD_INSPECTORS
array if you changed it from the default value
FIXED: SchemaRef
now supports cyclical references via the ignore_unresolved
argument
Published by axnsan12 over 6 years ago
swagger-ui
to version 3.13.6ReDoc
to version 2.0.0-alpha.17 (was 1.21.2); fixes #107ChoiceField
of unknown child typePublished by axnsan12 over 6 years ago
SUPPORTED_SUBMIT_METHODS
swagger-ui
settingPublished by axnsan12 over 6 years ago
OAUTH2_REDIRECT_URL
will now default to the built in oauth2-redirect.html
filePublished by axnsan12 over 6 years ago
swagger-ui
to version 3.13.0serializers.OneToOneRel
(#81, thanks to @ko-pp)Published by axnsan12 over 6 years ago
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)
Published by axnsan12 over 6 years ago
Published by axnsan12 over 6 years ago
swagger-ui
to version 3.12.0ReDoc
to version 1.21.2Published by axnsan12 over 6 years ago
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)