From 3aa1089a6af6774c1e0b12977b85062f837998ca Mon Sep 17 00:00:00 2001 From: Braden MacDonald Date: Tue, 15 Oct 2019 10:47:05 -0400 Subject: [PATCH 01/26] Update serializer docs to use correct param name (#6995) Avoids a pylint warning ".to_representation: Parameters differ from overridden 'to_representation' method" if people copy these examples. --- docs/api-guide/serializers.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/api-guide/serializers.md b/docs/api-guide/serializers.md index d6d4d5e8c..4679b1ed1 100644 --- a/docs/api-guide/serializers.md +++ b/docs/api-guide/serializers.md @@ -887,10 +887,10 @@ To implement a read-only serializer using the `BaseSerializer` class, we just ne It's simple to create a read-only serializer for converting `HighScore` instances into primitive data types. class HighScoreSerializer(serializers.BaseSerializer): - def to_representation(self, obj): + def to_representation(self, instance): return { - 'score': obj.score, - 'player_name': obj.player_name + 'score': instance.score, + 'player_name': instance.player_name } We can now use this class to serialize single `HighScore` instances: @@ -945,10 +945,10 @@ Here's a complete example of our previous `HighScoreSerializer`, that's been upd 'player_name': player_name } - def to_representation(self, obj): + def to_representation(self, instance): return { - 'score': obj.score, - 'player_name': obj.player_name + 'score': instance.score, + 'player_name': instance.player_name } def create(self, validated_data): @@ -965,10 +965,10 @@ The following class is an example of a generic serializer that can handle coerci A read-only serializer that coerces arbitrary complex objects into primitive representations. """ - def to_representation(self, obj): + def to_representation(self, instance): output = {} - for attribute_name in dir(obj): - attribute = getattr(obj, attribute_name) + for attribute_name in dir(instance): + attribute = getattr(instance, attribute_name) if attribute_name.startswith('_'): # Ignore private attributes. pass @@ -1010,7 +1010,7 @@ Some reasons this might be useful include... The signatures for these methods are as follows: -#### `.to_representation(self, obj)` +#### `.to_representation(self, instance)` Takes the object instance that requires serialization, and should return a primitive representation. Typically this means returning a structure of built-in Python datatypes. The exact types that can be handled will depend on the render classes you have configured for your API. From f98b6f35770c6cf7dd964d0fa7b052f6f86d5253 Mon Sep 17 00:00:00 2001 From: zach valenta Date: Thu, 17 Oct 2019 08:58:12 -0400 Subject: [PATCH 02/26] proper Github repo issue already resolved (#6999) per the ticket anyway https://github.com/encode/django-rest-framework/issues/2162 --- docs/community/project-management.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/community/project-management.md b/docs/community/project-management.md index 5d7dab561..293c65e24 100644 --- a/docs/community/project-management.md +++ b/docs/community/project-management.md @@ -195,7 +195,6 @@ If `@tomchristie` ceases to participate in the project then `@j4mie` has respons The following issues still need to be addressed: -* [Consider moving the repo into a proper GitHub organization][github-org]. * Ensure `@jamie` has back-up access to the `django-rest-framework.org` domain setup and admin. * Document ownership of the [live example][sandbox] API. * Document ownership of the [mailing list][mailing-list] and IRC channel. @@ -206,6 +205,5 @@ The following issues still need to be addressed: [transifex-project]: https://www.transifex.com/projects/p/django-rest-framework/ [transifex-client]: https://pypi.org/project/transifex-client/ [translation-memory]: http://docs.transifex.com/guides/tm#let-tm-automatically-populate-translations -[github-org]: https://github.com/encode/django-rest-framework/issues/2162 [sandbox]: https://restframework.herokuapp.com/ [mailing-list]: https://groups.google.com/forum/#!forum/django-rest-framework From a734e58d44b960070ab4f4c826db3738fedb8b82 Mon Sep 17 00:00:00 2001 From: Chris Guo <41265033+chrisguox@users.noreply.github.com> Date: Tue, 22 Oct 2019 06:11:12 +0800 Subject: [PATCH 03/26] Fix docs typos (#7006) --- docs/community/3.10-announcement.md | 2 +- docs/topics/documenting-your-api.md | 2 +- tests/test_relations.py | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/community/3.10-announcement.md b/docs/community/3.10-announcement.md index 065dd3480..578e900dc 100644 --- a/docs/community/3.10-announcement.md +++ b/docs/community/3.10-announcement.md @@ -84,7 +84,7 @@ urlpatterns = [ ### Customization -For customizations that you want to apply across the the entire API, you can subclass `rest_framework.schemas.openapi.SchemaGenerator` and provide it as an argument +For customizations that you want to apply across the entire API, you can subclass `rest_framework.schemas.openapi.SchemaGenerator` and provide it as an argument to the `generateschema` command or `get_schema_view()` helper function. For specific per-view customizations, you can subclass `AutoSchema`, diff --git a/docs/topics/documenting-your-api.md b/docs/topics/documenting-your-api.md index cf3977d90..b4c7dea4d 100644 --- a/docs/topics/documenting-your-api.md +++ b/docs/topics/documenting-your-api.md @@ -221,7 +221,7 @@ If the python `Markdown` library is installed, then [markdown syntax][markdown] [ref]: http://example.com/activating-accounts """ -Note that when using viewsets the basic docstring is used for all generated views. To provide descriptions for each view, such as for the the list and retrieve views, use docstring sections as described in [Schemas as documentation: Examples][schemas-examples]. +Note that when using viewsets the basic docstring is used for all generated views. To provide descriptions for each view, such as for the list and retrieve views, use docstring sections as described in [Schemas as documentation: Examples][schemas-examples]. #### The `OPTIONS` method diff --git a/tests/test_relations.py b/tests/test_relations.py index 3281b7ea2..c89293415 100644 --- a/tests/test_relations.py +++ b/tests/test_relations.py @@ -251,7 +251,7 @@ class TestHyperlinkedIdentityField(APISimpleTestCase): def test_improperly_configured(self): """ If a matching view cannot be reversed with the given instance, - the the user has misconfigured something, as the URL conf and the + the user has misconfigured something, as the URL conf and the hyperlinked field do not match. """ self.field.reverse = fail_reverse From 43397a81aec2b10ece63099f9f89c51d56785c35 Mon Sep 17 00:00:00 2001 From: Sergey Date: Tue, 22 Oct 2019 12:06:37 +0300 Subject: [PATCH 04/26] Fixed decimal snan deserialization (#7002) * Added test case causes exception in DecimalField deserialization * Fixed NaN checking which throws exception with sNaN value --- rest_framework/fields.py | 4 +--- tests/test_fields.py | 1 + 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index c0ceebe3b..ea8f47b2d 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1062,9 +1062,7 @@ class DecimalField(Field): except decimal.DecimalException: self.fail('invalid') - # Check for NaN. It is the only value that isn't equal to itself, - # so we can use this to identify NaN values. - if value != value: + if value.is_nan(): self.fail('invalid') # Check for infinity and negative infinity. diff --git a/tests/test_fields.py b/tests/test_fields.py index 7c495cd63..1d302b730 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -1080,6 +1080,7 @@ class TestDecimalField(FieldValues): invalid_inputs = ( ('abc', ["A valid number is required."]), (Decimal('Nan'), ["A valid number is required."]), + (Decimal('Snan'), ["A valid number is required."]), (Decimal('Inf'), ["A valid number is required."]), ('12.345', ["Ensure that there are no more than 3 digits in total."]), (200000000000.0, ["Ensure that there are no more than 3 digits in total."]), From 65ed7be7540e54b21dbe616cbfe9df0da7caae93 Mon Sep 17 00:00:00 2001 From: nautikos1235 <4201782+nautikos1235@users.noreply.github.com> Date: Tue, 22 Oct 2019 20:10:15 +0200 Subject: [PATCH 05/26] Fix markdown code indent in schemas (#7009) --- docs/api-guide/schemas.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/api-guide/schemas.md b/docs/api-guide/schemas.md index bdbb952dc..76cc0ca4d 100644 --- a/docs/api-guide/schemas.md +++ b/docs/api-guide/schemas.md @@ -90,6 +90,7 @@ The `get_schema_view()` helper takes the following keyword arguments: url='https://www.example.org/api/', urlconf='myproject.urls' ) + * `patterns`: List of url patterns to limit the schema introspection to. If you only want the `myproject.api` urls to be exposed in the schema: From a8c86be660462bfcea6e2397e408c5f29f25a1f9 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Tue, 22 Oct 2019 11:18:51 -0700 Subject: [PATCH 06/26] Update linter requirements (#7010) --- requirements/requirements-codestyle.txt | 8 +++---- rest_framework/schemas/__init__.py | 2 +- setup.cfg | 2 +- tests/schemas/test_coreapi.py | 2 +- tests/test_permissions.py | 32 ++++++++++++------------- 5 files changed, 23 insertions(+), 23 deletions(-) diff --git a/requirements/requirements-codestyle.txt b/requirements/requirements-codestyle.txt index 8cbd41c50..482deac66 100644 --- a/requirements/requirements-codestyle.txt +++ b/requirements/requirements-codestyle.txt @@ -1,7 +1,7 @@ # PEP8 code linting, which we run on all commits. -flake8==3.5.0 -flake8-tidy-imports==1.1.0 -pycodestyle==2.3.1 +flake8==3.7.8 +flake8-tidy-imports==3.0.0 +pycodestyle==2.5.0 # Sort and lint imports -isort==4.3.3 +isort==4.3.21 diff --git a/rest_framework/schemas/__init__.py b/rest_framework/schemas/__init__.py index 588680362..b63cb2353 100644 --- a/rest_framework/schemas/__init__.py +++ b/rest_framework/schemas/__init__.py @@ -23,8 +23,8 @@ Other access should target the submodules directly from rest_framework.settings import api_settings from . import coreapi, openapi -from .inspectors import DefaultSchema # noqa from .coreapi import AutoSchema, ManualSchema, SchemaGenerator # noqa +from .inspectors import DefaultSchema # noqa def get_schema_view( diff --git a/setup.cfg b/setup.cfg index c021fdde0..81da18b1c 100644 --- a/setup.cfg +++ b/setup.cfg @@ -6,7 +6,7 @@ addopts=--tb=short --strict -ra testspath = tests [flake8] -ignore = E501 +ignore = E501,W504 banned-modules = json = use from rest_framework.utils import json! [isort] diff --git a/tests/schemas/test_coreapi.py b/tests/schemas/test_coreapi.py index 66275ade9..a634d6968 100644 --- a/tests/schemas/test_coreapi.py +++ b/tests/schemas/test_coreapi.py @@ -24,8 +24,8 @@ from rest_framework.utils import formatting from rest_framework.views import APIView from rest_framework.viewsets import GenericViewSet, ModelViewSet -from . import views from ..models import BasicModel, ForeignKeySource, ManyToManySource +from . import views factory = APIRequestFactory() diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 03b80aae8..b6178c0bb 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -494,28 +494,28 @@ class CustomPermissionsTests(TestCase): self.custom_message = 'Custom: You cannot access this resource' def test_permission_denied(self): - response = denied_view(self.request, pk=1) - detail = response.data.get('detail') - self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) - self.assertNotEqual(detail, self.custom_message) + response = denied_view(self.request, pk=1) + detail = response.data.get('detail') + self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) + self.assertNotEqual(detail, self.custom_message) def test_permission_denied_with_custom_detail(self): - response = denied_view_with_detail(self.request, pk=1) - detail = response.data.get('detail') - self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) - self.assertEqual(detail, self.custom_message) + response = denied_view_with_detail(self.request, pk=1) + detail = response.data.get('detail') + self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) + self.assertEqual(detail, self.custom_message) def test_permission_denied_for_object(self): - response = denied_object_view(self.request, pk=1) - detail = response.data.get('detail') - self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) - self.assertNotEqual(detail, self.custom_message) + response = denied_object_view(self.request, pk=1) + detail = response.data.get('detail') + self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) + self.assertNotEqual(detail, self.custom_message) def test_permission_denied_for_object_with_custom_detail(self): - response = denied_object_view_with_detail(self.request, pk=1) - detail = response.data.get('detail') - self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) - self.assertEqual(detail, self.custom_message) + response = denied_object_view_with_detail(self.request, pk=1) + detail = response.data.get('detail') + self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) + self.assertEqual(detail, self.custom_message) class PermissionsCompositionTests(TestCase): From 64f567a021cc005c9a8ad5230f0fea1e3b30ad70 Mon Sep 17 00:00:00 2001 From: Bastien Vallet Date: Tue, 22 Oct 2019 23:39:01 +0200 Subject: [PATCH 07/26] Bump CI to Python 3.8 (#7008) --- .travis.yml | 10 ++++++---- setup.py | 1 + tox.ini | 4 +--- 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/.travis.yml b/.travis.yml index a4a4ed8b5..f89e77531 100644 --- a/.travis.yml +++ b/.travis.yml @@ -21,11 +21,13 @@ matrix: - { python: "3.7", env: DJANGO=2.2 } - { python: "3.7", env: DJANGO=master } - - { python: "3.7", env: TOXENV=base } - - { python: "3.7", env: TOXENV=lint } - - { python: "3.7", env: TOXENV=docs } + - { python: "3.8", env: DJANGO=master } - - python: "3.7" + - { python: "3.8", env: TOXENV=base } + - { python: "3.8", env: TOXENV=lint } + - { python: "3.8", env: TOXENV=docs } + + - python: "3.8" env: TOXENV=dist script: - python setup.py bdist_wheel diff --git a/setup.py b/setup.py index 2f8dafd21..c9d6443d5 100755 --- a/setup.py +++ b/setup.py @@ -101,6 +101,7 @@ setup( 'Programming Language :: Python :: 3.5', 'Programming Language :: Python :: 3.6', 'Programming Language :: Python :: 3.7', + 'Programming Language :: Python :: 3.8', 'Programming Language :: Python :: 3 :: Only', 'Topic :: Internet :: WWW/HTTP', ], diff --git a/tox.ini b/tox.ini index 699ca909c..587c469b1 100644 --- a/tox.ini +++ b/tox.ini @@ -4,7 +4,7 @@ envlist = {py35,py36,py37}-django20, {py35,py36,py37}-django21 {py35,py36,py37}-django22 - {py36,py37}-djangomaster, + {py36,py37,py38}-djangomaster, base,dist,lint,docs, [travis:env] @@ -44,14 +44,12 @@ deps = -rrequirements/requirements-optionals.txt [testenv:lint] -basepython = python3.7 commands = ./runtests.py --lintonly deps = -rrequirements/requirements-codestyle.txt -rrequirements/requirements-testing.txt [testenv:docs] -basepython = python3.7 skip_install = true commands = mkdocs build deps = From 4d57cd31f64dcfa71958a77d7adffd7a87e16e9b Mon Sep 17 00:00:00 2001 From: Aaron Yong Date: Thu, 24 Oct 2019 00:54:37 -0600 Subject: [PATCH 08/26] Update method override example in Schemas docs (#6887) (#7013) get_link() was a method in the old CoreAPI-based AutoSchema implementation. The new OpenAPI one defines get_operation() instead: the example code block was overlooked. --- docs/api-guide/schemas.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/api-guide/schemas.md b/docs/api-guide/schemas.md index 76cc0ca4d..de12ba517 100644 --- a/docs/api-guide/schemas.md +++ b/docs/api-guide/schemas.md @@ -115,7 +115,6 @@ The `get_schema_view()` helper takes the following keyword arguments: * `renderer_classes`: May be used to pass the set of renderer classes that can be used to render the API root endpoint. - ## Customizing Schema Generation You may customize schema generation at the level of the schema as a whole, or @@ -155,7 +154,7 @@ Returns a dictionary that represents the OpenAPI schema: The `request` argument is optional, and may be used if you want to apply per-user permissions to the resulting schema generation. -This is a good point to override if you want to customise the generated +This is a good point to override if you want to customize the generated dictionary, for example to add custom [specification extensions][openapi-specification-extensions]. @@ -184,14 +183,13 @@ provide richer path field descriptions. (The key hooks here are the relevant --- -In order to customise the operation generation, you should provide an `AutoSchema` subclass, overriding `get_operation()` as you need: - +In order to customize the operation generation, you should provide an `AutoSchema` subclass, overriding `get_operation()` as you need: from rest_framework.views import APIView from rest_framework.schemas.openapi import AutoSchema class CustomSchema(AutoSchema): - def get_link(...): + def get_operation(...): # Implement custom introspection here (or in other sub-methods) class CustomView(APIView): @@ -219,4 +217,4 @@ project you may adjust `settings.DEFAULT_SCHEMA_CLASS` appropriately. [openapi]: https://github.com/OAI/OpenAPI-Specification [openapi-specification-extensions]: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#specification-extensions -[openapi-operation]: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#operationObject \ No newline at end of file +[openapi-operation]: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#operationObject From c9f06bf73f371c2ae30cc799f4ac3c5f7eca0303 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jeremy=20Lain=C3=A9?= Date: Thu, 24 Oct 2019 10:51:16 +0200 Subject: [PATCH 09/26] Fix a spelling error in openapi AutoSchema method (#7004) Replace "pagninator" by "paginator". --- rest_framework/schemas/openapi.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/rest_framework/schemas/openapi.py b/rest_framework/schemas/openapi.py index 09a5598f5..0fd33cd11 100644 --- a/rest_framework/schemas/openapi.py +++ b/rest_framework/schemas/openapi.py @@ -209,7 +209,7 @@ class AutoSchema(ViewInspector): if not is_list_view(path, method, view): return [] - paginator = self._get_pagninator() + paginator = self._get_paginator() if not paginator: return [] @@ -429,7 +429,7 @@ class AutoSchema(ViewInspector): schema['maximum'] = int(digits * '9') + 1 schema['minimum'] = -schema['maximum'] - def _get_pagninator(self): + def _get_paginator(self): pagination_class = getattr(self.view, 'pagination_class', None) if pagination_class: return pagination_class() @@ -502,7 +502,7 @@ class AutoSchema(ViewInspector): 'type': 'array', 'items': item_schema, } - paginator = self._get_pagninator() + paginator = self._get_paginator() if paginator: response_schema = paginator.get_paginated_response_schema(response_schema) else: From 5ee970c090d76c684c03d494ec167571f40334a4 Mon Sep 17 00:00:00 2001 From: Chris Guo <41265033+chrisguox@users.noreply.github.com> Date: Fri, 25 Oct 2019 02:31:12 +0800 Subject: [PATCH 10/26] Fix docs typos (#7015) --- docs/api-guide/fields.md | 12 ++++++------ docs/api-guide/requests.md | 2 +- docs/api-guide/schemas.md | 2 +- docs/community/release-notes.md | 6 +++--- docs/community/third-party-packages.md | 2 +- docs/coreapi/schemas.md | 2 +- tests/test_serializer.py | 2 +- 7 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/api-guide/fields.md b/docs/api-guide/fields.md index 92c692bf5..29cb5aec9 100644 --- a/docs/api-guide/fields.md +++ b/docs/api-guide/fields.md @@ -713,7 +713,7 @@ the coordinate pair: fields = ['label', 'coordinates'] Note that this example doesn't handle validation. Partly for that reason, in a -real project, the coordinate nesting might be better handled with a nested serialiser +real project, the coordinate nesting might be better handled with a nested serializer using `source='*'`, with two `IntegerField` instances, each with their own `source` pointing to the relevant field. @@ -746,7 +746,7 @@ suitable for updating our target object. With `source='*'`, the return from ('y_coordinate', 4), ('x_coordinate', 3)]) -For completeness lets do the same thing again but with the nested serialiser +For completeness lets do the same thing again but with the nested serializer approach suggested above: class NestedCoordinateSerializer(serializers.Serializer): @@ -768,14 +768,14 @@ declarations. It's our `NestedCoordinateSerializer` that takes `source='*'`. Our new `DataPointSerializer` exhibits the same behaviour as the custom field approach. -Serialising: +Serializing: >>> out_serializer = DataPointSerializer(instance) >>> out_serializer.data ReturnDict([('label', 'testing'), ('coordinates', OrderedDict([('x', 1), ('y', 2)]))]) -Deserialising: +Deserializing: >>> in_serializer = DataPointSerializer(data=data) >>> in_serializer.is_valid() @@ -802,8 +802,8 @@ But we also get the built-in validation for free: {'x': ['A valid integer is required.'], 'y': ['A valid integer is required.']})]) -For this reason, the nested serialiser approach would be the first to try. You -would use the custom field approach when the nested serialiser becomes infeasible +For this reason, the nested serializer approach would be the first to try. You +would use the custom field approach when the nested serializer becomes infeasible or overly complex. diff --git a/docs/api-guide/requests.md b/docs/api-guide/requests.md index 3bc083893..1c336953c 100644 --- a/docs/api-guide/requests.md +++ b/docs/api-guide/requests.md @@ -49,7 +49,7 @@ If a client sends a request with a content-type that cannot be parsed then a `Un # Content negotiation -The request exposes some properties that allow you to determine the result of the content negotiation stage. This allows you to implement behaviour such as selecting a different serialisation schemes for different media types. +The request exposes some properties that allow you to determine the result of the content negotiation stage. This allows you to implement behaviour such as selecting a different serialization schemes for different media types. ## .accepted_renderer diff --git a/docs/api-guide/schemas.md b/docs/api-guide/schemas.md index de12ba517..ec5366d8e 100644 --- a/docs/api-guide/schemas.md +++ b/docs/api-guide/schemas.md @@ -176,7 +176,7 @@ for each view, allowed method, and path. **Note**: For basic `APIView` subclasses, default introspection is essentially limited to the URL kwarg path parameters. For `GenericAPIView` subclasses, which includes all the provided class based views, `AutoSchema` will -attempt to introspect serialiser, pagination and filter fields, as well as +attempt to introspect serializer, pagination and filter fields, as well as provide richer path field descriptions. (The key hooks here are the relevant `GenericAPIView` attributes and methods: `get_serializer`, `pagination_class`, `filter_backends` and so on.) diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index cdaa35044..283dbae67 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -222,11 +222,11 @@ Be sure to upgrade to Python 3 before upgrading to Django REST Framework 3.10. def perform_create(self, serializer): serializer.save(owner=self.request.user) - Alternatively you may override `save()` or `create()` or `update()` on the serialiser as appropriate. + Alternatively you may override `save()` or `create()` or `update()` on the serializer as appropriate. * Correct allow_null behaviour when required=False [#5888][gh5888] - Without an explicit `default`, `allow_null` implies a default of `null` for outgoing serialisation. Previously such + Without an explicit `default`, `allow_null` implies a default of `null` for outgoing serialization. Previously such fields were being skipped when read-only or otherwise not required. **Possible backwards compatibility break** if you were relying on such fields being excluded from the outgoing @@ -464,7 +464,7 @@ Be sure to upgrade to Python 3 before upgrading to Django REST Framework 3.10. * Deprecated `exclude_from_schema` on `APIView` and `api_view` decorator. Set `schema = None` or `@schema(None)` as appropriate. [#5422][gh5422] * Timezone-aware `DateTimeField`s now respect active or default `timezone` during serialization, instead of always using UTC. [#5435][gh5435] - Resolves inconsistency whereby instances were serialised with supplied datetime for `create` but UTC for `retrieve`. [#3732][gh3732] + Resolves inconsistency whereby instances were serialized with supplied datetime for `create` but UTC for `retrieve`. [#3732][gh3732] **Possible backwards compatibility break** if you were relying on datetime strings being UTC. Have client interpret datetimes or [set default or active timezone (docs)][djangodocs-set-timezone] to UTC if needed. diff --git a/docs/community/third-party-packages.md b/docs/community/third-party-packages.md index 9d7d09d9b..10a67840c 100644 --- a/docs/community/third-party-packages.md +++ b/docs/community/third-party-packages.md @@ -254,7 +254,7 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque ### Misc * [cookiecutter-django-rest][cookiecutter-django-rest] - A cookiecutter template that takes care of the setup and configuration so you can focus on making your REST apis awesome. -* [djangorestrelationalhyperlink][djangorestrelationalhyperlink] - A hyperlinked serialiser that can can be used to alter relationships via hyperlinks, but otherwise like a hyperlink model serializer. +* [djangorestrelationalhyperlink][djangorestrelationalhyperlink] - A hyperlinked serializer that can can be used to alter relationships via hyperlinks, but otherwise like a hyperlink model serializer. * [django-rest-swagger][django-rest-swagger] - An API documentation generator for Swagger UI. * [django-rest-framework-proxy][django-rest-framework-proxy] - Proxy to redirect incoming request to another API server. * [gaiarestframework][gaiarestframework] - Utils for django-rest-framework diff --git a/docs/coreapi/schemas.md b/docs/coreapi/schemas.md index 6ee620343..69606f853 100644 --- a/docs/coreapi/schemas.md +++ b/docs/coreapi/schemas.md @@ -191,7 +191,7 @@ each view, allowed method and path.) **Note**: For basic `APIView` subclasses, default introspection is essentially limited to the URL kwarg path parameters. For `GenericAPIView` subclasses, which includes all the provided class based views, `AutoSchema` will -attempt to introspect serialiser, pagination and filter fields, as well as +attempt to introspect serializer, pagination and filter fields, as well as provide richer path field descriptions. (The key hooks here are the relevant `GenericAPIView` attributes and methods: `get_serializer`, `pagination_class`, `filter_backends` and so on.) diff --git a/tests/test_serializer.py b/tests/test_serializer.py index 0d4b50c1d..fab0472b9 100644 --- a/tests/test_serializer.py +++ b/tests/test_serializer.py @@ -555,7 +555,7 @@ class TestDefaultOutput: bar = serializers.CharField(source='foo.bar', allow_null=True) optional = serializers.CharField(required=False, allow_null=True) - # allow_null=True should imply default=None when serialising: + # allow_null=True should imply default=None when serializing: assert Serializer({'foo': None}).data == {'foo': None, 'bar': None, 'optional': None, } From 39bd6cc5cb696d4ba3ab1e7066bda2c4331ff17e Mon Sep 17 00:00:00 2001 From: Erwan Rouchet Date: Mon, 28 Oct 2019 02:13:01 +0100 Subject: [PATCH 11/26] Set the proper JSON schema type for HStoreFields in OpenAPI schemas (#6914) --- rest_framework/schemas/openapi.py | 1 + tests/schemas/test_openapi.py | 16 ++++++++++++++++ tests/schemas/views.py | 1 + 3 files changed, 18 insertions(+) diff --git a/rest_framework/schemas/openapi.py b/rest_framework/schemas/openapi.py index 0fd33cd11..a3970ff7a 100644 --- a/rest_framework/schemas/openapi.py +++ b/rest_framework/schemas/openapi.py @@ -344,6 +344,7 @@ class AutoSchema(ViewInspector): serializers.BooleanField: 'boolean', serializers.JSONField: 'object', serializers.DictField: 'object', + serializers.HStoreField: 'object', } return {'type': FIELD_CLASS_SCHEMA_TYPE.get(field.__class__, 'string')} diff --git a/tests/schemas/test_openapi.py b/tests/schemas/test_openapi.py index e1d29f6fe..78c00d985 100644 --- a/tests/schemas/test_openapi.py +++ b/tests/schemas/test_openapi.py @@ -462,6 +462,22 @@ class TestOperationIntrospection(TestCase): assert properties['date']['format'] == 'date' assert properties['datetime']['format'] == 'date-time' + def test_serializer_hstorefield(self): + path = '/' + method = 'GET' + view = create_view( + views.ExampleGenericAPIView, + method, + create_request(path), + ) + inspector = AutoSchema() + inspector.view = view + + responses = inspector._get_responses(path, method) + response_schema = responses['200']['content']['application/json']['schema'] + properties = response_schema['items']['properties'] + assert properties['hstore']['type'] == 'object' + def test_serializer_validators(self): path = '/' method = 'GET' diff --git a/tests/schemas/views.py b/tests/schemas/views.py index d1fc75eb8..6b83e5bde 100644 --- a/tests/schemas/views.py +++ b/tests/schemas/views.py @@ -33,6 +33,7 @@ class ExampleDetailView(APIView): class ExampleSerializer(serializers.Serializer): date = serializers.DateField() datetime = serializers.DateTimeField() + hstore = serializers.HStoreField() class ExampleGenericAPIView(generics.GenericAPIView): From ab40b80fa64d0448cdfbe9125a77bae39085d3f5 Mon Sep 17 00:00:00 2001 From: Daniel Hnyk Date: Mon, 28 Oct 2019 11:46:44 +0100 Subject: [PATCH 12/26] Remove unmaintained django-rest-framework-bulk from docs (#7021) --- docs/api-guide/generic-views.md | 5 ----- docs/community/third-party-packages.md | 2 -- 2 files changed, 7 deletions(-) diff --git a/docs/api-guide/generic-views.md b/docs/api-guide/generic-views.md index 8d9ead107..a2f19ff2e 100644 --- a/docs/api-guide/generic-views.md +++ b/docs/api-guide/generic-views.md @@ -378,10 +378,6 @@ If you need to generic PUT-as-create behavior you may want to include something The following third party packages provide additional generic view implementations. -## Django REST Framework bulk - -The [django-rest-framework-bulk package][django-rest-framework-bulk] implements generic view mixins as well as some common concrete generic views to allow to apply bulk operations via API requests. - ## Django Rest Multiple Models [Django Rest Multiple Models][django-rest-multiple-models] provides a generic view (and mixin) for sending multiple serialized models and/or querysets via a single API request. @@ -394,5 +390,4 @@ The [django-rest-framework-bulk package][django-rest-framework-bulk] implements [RetrieveModelMixin]: #retrievemodelmixin [UpdateModelMixin]: #updatemodelmixin [DestroyModelMixin]: #destroymodelmixin -[django-rest-framework-bulk]: https://github.com/miki725/django-rest-framework-bulk [django-rest-multiple-models]: https://github.com/MattBroach/DjangoRestMultipleModels diff --git a/docs/community/third-party-packages.md b/docs/community/third-party-packages.md index 10a67840c..ea5d6b854 100644 --- a/docs/community/third-party-packages.md +++ b/docs/community/third-party-packages.md @@ -222,7 +222,6 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque ### Views -* [djangorestframework-bulk][djangorestframework-bulk] - Implements generic view mixins as well as some common concrete generic views to allow to apply bulk operations via API requests. * [django-rest-multiple-models][django-rest-multiple-models] - Provides a generic view (and mixin) for sending multiple serialized models and/or querysets via a single API request. ### Routers @@ -305,7 +304,6 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque [djangorestframework-hstore]: https://github.com/djangonauts/django-rest-framework-hstore [drf-compound-fields]: https://github.com/estebistec/drf-compound-fields [django-extra-fields]: https://github.com/Hipo/drf-extra-fields -[djangorestframework-bulk]: https://github.com/miki725/django-rest-framework-bulk [django-rest-multiple-models]: https://github.com/MattBroach/DjangoRestMultipleModels [drf-nested-routers]: https://github.com/alanjds/drf-nested-routers [wq.db.rest]: https://wq.io/docs/about-rest From 5521eacb024e8b477652a7c81eea88c941e0c322 Mon Sep 17 00:00:00 2001 From: Chris Guo <41265033+chrisguox@users.noreply.github.com> Date: Sat, 2 Nov 2019 01:56:59 +0800 Subject: [PATCH 13/26] Update docs imports (#7030) --- docs/api-guide/caching.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/api-guide/caching.md b/docs/api-guide/caching.md index 502a0a9a9..96517b15e 100644 --- a/docs/api-guide/caching.md +++ b/docs/api-guide/caching.md @@ -17,11 +17,16 @@ other cache decorators such as [`cache_page`][page] and [`vary_on_cookie`][cookie]. ```python +from django.utils.decorators import method_decorator +from django.views.decorators.cache import cache_page +from django.views.decorators.vary import vary_on_cookie + from rest_framework.response import Response from rest_framework.views import APIView from rest_framework import viewsets -class UserViewSet(viewsets.Viewset): + +class UserViewSet(viewsets.ViewSet): # Cache requested url for each user for 2 hours @method_decorator(cache_page(60*60*2)) @@ -32,6 +37,7 @@ class UserViewSet(viewsets.Viewset): } return Response(content) + class PostView(APIView): # Cache page for the requested url From 82f256989559b95a0cd5ba318a95f7c66945436a Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Tue, 5 Nov 2019 16:43:32 +0000 Subject: [PATCH 14/26] Update __init__.py --- rest_framework/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rest_framework/__init__.py b/rest_framework/__init__.py index 4d4225c96..2b96e7336 100644 --- a/rest_framework/__init__.py +++ b/rest_framework/__init__.py @@ -10,7 +10,7 @@ ______ _____ _____ _____ __ __title__ = 'Django REST framework' __version__ = '3.10.3' __author__ = 'Tom Christie' -__license__ = 'BSD 2-Clause' +__license__ = 'BSD 3-Clause' __copyright__ = 'Copyright 2011-2019 Encode OSS Ltd' # Version synonym From 5e8fe6edf0b25506c5bc3ce749c5b9d5cb9e7e7e Mon Sep 17 00:00:00 2001 From: Erwan Rouchet Date: Wed, 6 Nov 2019 18:34:28 +0100 Subject: [PATCH 15/26] Fix link to Django docs (#7040) --- docs/api-guide/responses.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/responses.md b/docs/api-guide/responses.md index 1a56b0101..dbdc8ff2c 100644 --- a/docs/api-guide/responses.md +++ b/docs/api-guide/responses.md @@ -94,5 +94,5 @@ As with any other `TemplateResponse`, this method is called to render the serial You won't typically need to call `.render()` yourself, as it's handled by Django's standard response cycle. -[cite]: https://docs.djangoproject.com/en/stable/stable/template-response/ +[cite]: https://docs.djangoproject.com/en/stable/ref/template-response/ [statuscodes]: status-codes.md From 14d740d08800397015ce89e43aec4ee0bbf29c04 Mon Sep 17 00:00:00 2001 From: Aaron Yong Date: Wed, 6 Nov 2019 13:37:13 -0700 Subject: [PATCH 16/26] Update DEFAULT_SCHEMA_CLASSES default value in Settings docs (#7014) The default value was changed to point to the OpenAPI AutoSchema class. The docs were leading users to believe that rest_framework.schemas.AutoSchema was the default. As of this commit, the root AutoSchema is in fact imported from the coreapi module. --- docs/api-guide/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/settings.md b/docs/api-guide/settings.md index 768e343a7..d42000260 100644 --- a/docs/api-guide/settings.md +++ b/docs/api-guide/settings.md @@ -101,7 +101,7 @@ Default: `'rest_framework.negotiation.DefaultContentNegotiation'` A view inspector class that will be used for schema generation. -Default: `'rest_framework.schemas.AutoSchema'` +Default: `'rest_framework.schemas.openapi.AutoSchema'` --- From 8b06ce72d7414a62bb1a7da0c5aec24ec16e811d Mon Sep 17 00:00:00 2001 From: Dima Knivets Date: Wed, 6 Nov 2019 22:44:51 +0200 Subject: [PATCH 17/26] OpenAPI: Map renderers/parsers for request/response media-types. (#6865) --- rest_framework/schemas/openapi.py | 34 +++++++++++--- tests/schemas/test_openapi.py | 73 +++++++++++++++++++++++++++++++ 2 files changed, 102 insertions(+), 5 deletions(-) diff --git a/rest_framework/schemas/openapi.py b/rest_framework/schemas/openapi.py index a3970ff7a..a67974ed6 100644 --- a/rest_framework/schemas/openapi.py +++ b/rest_framework/schemas/openapi.py @@ -1,4 +1,5 @@ import warnings +from operator import attrgetter from urllib.parse import urljoin from django.core.validators import ( @@ -8,7 +9,7 @@ from django.core.validators import ( from django.db import models from django.utils.encoding import force_str -from rest_framework import exceptions, serializers +from rest_framework import exceptions, renderers, serializers from rest_framework.compat import uritemplate from rest_framework.fields import _UnvalidatedField, empty @@ -78,7 +79,9 @@ class SchemaGenerator(BaseSchemaGenerator): class AutoSchema(ViewInspector): - content_types = ['application/json'] + request_media_types = [] + response_media_types = [] + method_mapping = { 'get': 'Retrieve', 'post': 'Create', @@ -339,6 +342,12 @@ class AutoSchema(ViewInspector): self._map_min_max(field, content) return content + if isinstance(field, serializers.FileField): + return { + 'type': 'string', + 'format': 'binary' + } + # Simplest cases, default to 'string' type: FIELD_CLASS_SCHEMA_TYPE = { serializers.BooleanField: 'boolean', @@ -434,9 +443,20 @@ class AutoSchema(ViewInspector): pagination_class = getattr(self.view, 'pagination_class', None) if pagination_class: return pagination_class() - return None + def map_parsers(self, path, method): + return list(map(attrgetter('media_type'), self.view.parser_classes)) + + def map_renderers(self, path, method): + media_types = [] + for renderer in self.view.renderer_classes: + # BrowsableAPIRenderer not relevant to OpenAPI spec + if renderer == renderers.BrowsableAPIRenderer: + continue + media_types.append(renderer.media_type) + return media_types + def _get_serializer(self, method, path): view = self.view @@ -456,6 +476,8 @@ class AutoSchema(ViewInspector): if method not in ('PUT', 'PATCH', 'POST'): return {} + self.request_media_types = self.map_parsers(path, method) + serializer = self._get_serializer(path, method) if not isinstance(serializer, serializers.Serializer): @@ -473,7 +495,7 @@ class AutoSchema(ViewInspector): return { 'content': { ct: {'schema': content} - for ct in self.content_types + for ct in self.request_media_types } } @@ -486,6 +508,8 @@ class AutoSchema(ViewInspector): } } + self.response_media_types = self.map_renderers(path, method) + item_schema = {} serializer = self._get_serializer(path, method) @@ -513,7 +537,7 @@ class AutoSchema(ViewInspector): '200': { 'content': { ct: {'schema': response_schema} - for ct in self.content_types + for ct in self.response_media_types }, # description is a mandatory property, # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#responseObject diff --git a/tests/schemas/test_openapi.py b/tests/schemas/test_openapi.py index 78c00d985..bbdae0fed 100644 --- a/tests/schemas/test_openapi.py +++ b/tests/schemas/test_openapi.py @@ -5,6 +5,8 @@ from django.utils.translation import gettext_lazy as _ from rest_framework import filters, generics, pagination, routers, serializers from rest_framework.compat import uritemplate +from rest_framework.parsers import JSONParser, MultiPartParser +from rest_framework.renderers import JSONRenderer from rest_framework.request import Request from rest_framework.schemas.openapi import AutoSchema, SchemaGenerator @@ -364,6 +366,77 @@ class TestOperationIntrospection(TestCase): }, } + def test_parser_mapping(self): + """Test that view's parsers are mapped to OA media types""" + path = '/{id}/' + method = 'POST' + + class View(generics.CreateAPIView): + serializer_class = views.ExampleSerializer + parser_classes = [JSONParser, MultiPartParser] + + view = create_view( + View, + method, + create_request(path), + ) + inspector = AutoSchema() + inspector.view = view + + request_body = inspector._get_request_body(path, method) + + assert len(request_body['content'].keys()) == 2 + assert 'multipart/form-data' in request_body['content'] + assert 'application/json' in request_body['content'] + + def test_renderer_mapping(self): + """Test that view's renderers are mapped to OA media types""" + path = '/{id}/' + method = 'GET' + + class View(generics.CreateAPIView): + serializer_class = views.ExampleSerializer + renderer_classes = [JSONRenderer] + + view = create_view( + View, + method, + create_request(path), + ) + inspector = AutoSchema() + inspector.view = view + + responses = inspector._get_responses(path, method) + # TODO this should be changed once the multiple response + # schema support is there + success_response = responses['200'] + + assert len(success_response['content'].keys()) == 1 + assert 'application/json' in success_response['content'] + + def test_serializer_filefield(self): + path = '/{id}/' + method = 'POST' + + class ItemSerializer(serializers.Serializer): + attachment = serializers.FileField() + + class View(generics.CreateAPIView): + serializer_class = ItemSerializer + + view = create_view( + View, + method, + create_request(path), + ) + inspector = AutoSchema() + inspector.view = view + + request_body = inspector._get_request_body(path, method) + mp_media = request_body['content']['multipart/form-data'] + attachment = mp_media['schema']['properties']['attachment'] + assert attachment['format'] == 'binary' + def test_retrieve_response_body_generation(self): """ Test that a list of properties is returned for retrieve item views. From becb96216025a9e030f59f7bbab4e22daa5b0e3f Mon Sep 17 00:00:00 2001 From: Kentalot Date: Wed, 6 Nov 2019 12:46:19 -0800 Subject: [PATCH 18/26] OpenAPI: Use int64 format for large integers. (#7018) --- rest_framework/schemas/openapi.py | 11 +++++++++-- tests/schemas/test_openapi.py | 4 ++++ 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/rest_framework/schemas/openapi.py b/rest_framework/schemas/openapi.py index a67974ed6..0d45e27cf 100644 --- a/rest_framework/schemas/openapi.py +++ b/rest_framework/schemas/openapi.py @@ -268,9 +268,13 @@ class AutoSchema(ViewInspector): 'items': {}, } if not isinstance(field.child, _UnvalidatedField): - mapping['items'] = { - "type": self._map_field(field.child).get('type') + map_field = self._map_field(field.child) + items = { + "type": map_field.get('type') } + if 'format' in map_field: + items['format'] = map_field.get('format') + mapping['items'] = items return mapping # DateField and DateTimeField type is string @@ -340,6 +344,9 @@ class AutoSchema(ViewInspector): 'type': 'integer' } self._map_min_max(field, content) + # 2147483647 is max for int32_size, so we use int64 for format + if int(content.get('maximum', 0)) > 2147483647 or int(content.get('minimum', 0)) > 2147483647: + content['format'] = 'int64' return content if isinstance(field, serializers.FileField): diff --git a/tests/schemas/test_openapi.py b/tests/schemas/test_openapi.py index bbdae0fed..fc22c32ab 100644 --- a/tests/schemas/test_openapi.py +++ b/tests/schemas/test_openapi.py @@ -50,6 +50,10 @@ class TestFieldMapping(TestCase): (serializers.ListField(child=serializers.BooleanField()), {'items': {'type': 'boolean'}, 'type': 'array'}), (serializers.ListField(child=serializers.FloatField()), {'items': {'type': 'number'}, 'type': 'array'}), (serializers.ListField(child=serializers.CharField()), {'items': {'type': 'string'}, 'type': 'array'}), + (serializers.ListField(child=serializers.IntegerField(max_value=4294967295)), + {'items': {'type': 'integer', 'format': 'int64'}, 'type': 'array'}), + (serializers.IntegerField(min_value=2147483648), + {'type': 'integer', 'minimum': 2147483648, 'format': 'int64'}), ] for field, mapping in cases: with self.subTest(field=field): From 7c3477dcdae558b40acfa116ed08eeb5700818eb Mon Sep 17 00:00:00 2001 From: Yann Savary Date: Wed, 6 Nov 2019 21:52:02 +0100 Subject: [PATCH 19/26] OpenAPI: Ported docstring operation description from CoreAPI inspector. (#6898) --- rest_framework/schemas/coreapi.py | 48 +--------------------------- rest_framework/schemas/inspectors.py | 46 ++++++++++++++++++++++++++ rest_framework/schemas/openapi.py | 3 +- tests/schemas/test_openapi.py | 40 ++++++++++++++++------- tests/schemas/views.py | 24 ++++++++++++++ 5 files changed, 100 insertions(+), 61 deletions(-) diff --git a/rest_framework/schemas/coreapi.py b/rest_framework/schemas/coreapi.py index d811da2d8..75ed5671a 100644 --- a/rest_framework/schemas/coreapi.py +++ b/rest_framework/schemas/coreapi.py @@ -1,26 +1,18 @@ -import re import warnings from collections import Counter, OrderedDict from urllib import parse from django.db import models -from django.utils.encoding import force_str, smart_text +from django.utils.encoding import force_str from rest_framework import exceptions, serializers from rest_framework.compat import coreapi, coreschema, uritemplate from rest_framework.settings import api_settings -from rest_framework.utils import formatting from .generators import BaseSchemaGenerator from .inspectors import ViewInspector from .utils import get_pk_description, is_list_view -# Used in _get_description_section() -# TODO: ???: move up to base. -header_regex = re.compile('^[a-zA-Z][0-9A-Za-z_]*:') - -# Generator # - def common_path(paths): split_paths = [path.strip('/').split('/') for path in paths] @@ -397,44 +389,6 @@ class AutoSchema(ViewInspector): description=description ) - def get_description(self, path, method): - """ - Determine a link description. - - This will be based on the method docstring if one exists, - or else the class docstring. - """ - view = self.view - - method_name = getattr(view, 'action', method.lower()) - method_docstring = getattr(view, method_name, None).__doc__ - if method_docstring: - # An explicit docstring on the method or action. - return self._get_description_section(view, method.lower(), formatting.dedent(smart_text(method_docstring))) - else: - return self._get_description_section(view, getattr(view, 'action', method.lower()), view.get_view_description()) - - def _get_description_section(self, view, header, description): - lines = [line for line in description.splitlines()] - current_section = '' - sections = {'': ''} - - for line in lines: - if header_regex.match(line): - current_section, seperator, lead = line.partition(':') - sections[current_section] = lead.strip() - else: - sections[current_section] += '\n' + line - - # TODO: SCHEMA_COERCE_METHOD_NAMES appears here and in `SchemaGenerator.get_keys` - coerce_method_names = api_settings.SCHEMA_COERCE_METHOD_NAMES - if header in sections: - return sections[header].strip() - if header in coerce_method_names: - if coerce_method_names[header] in sections: - return sections[coerce_method_names[header]].strip() - return sections[''].strip() - def get_path_fields(self, path, method): """ Return a list of `coreapi.Field` instances corresponding to any diff --git a/rest_framework/schemas/inspectors.py b/rest_framework/schemas/inspectors.py index 86fcdc435..3b7e7f963 100644 --- a/rest_framework/schemas/inspectors.py +++ b/rest_framework/schemas/inspectors.py @@ -3,9 +3,13 @@ inspectors.py # Per-endpoint view introspection See schemas.__init__.py for package overview. """ +import re from weakref import WeakKeyDictionary +from django.utils.encoding import smart_text + from rest_framework.settings import api_settings +from rest_framework.utils import formatting class ViewInspector: @@ -15,6 +19,9 @@ class ViewInspector: Provide subclass for per-view schema generation """ + # Used in _get_description_section() + header_regex = re.compile('^[a-zA-Z][0-9A-Za-z_]*:') + def __init__(self): self.instance_schemas = WeakKeyDictionary() @@ -62,6 +69,45 @@ class ViewInspector: def view(self): self._view = None + def get_description(self, path, method): + """ + Determine a path description. + + This will be based on the method docstring if one exists, + or else the class docstring. + """ + view = self.view + + method_name = getattr(view, 'action', method.lower()) + method_docstring = getattr(view, method_name, None).__doc__ + if method_docstring: + # An explicit docstring on the method or action. + return self._get_description_section(view, method.lower(), formatting.dedent(smart_text(method_docstring))) + else: + return self._get_description_section(view, getattr(view, 'action', method.lower()), + view.get_view_description()) + + def _get_description_section(self, view, header, description): + lines = [line for line in description.splitlines()] + current_section = '' + sections = {'': ''} + + for line in lines: + if self.header_regex.match(line): + current_section, separator, lead = line.partition(':') + sections[current_section] = lead.strip() + else: + sections[current_section] += '\n' + line + + # TODO: SCHEMA_COERCE_METHOD_NAMES appears here and in `SchemaGenerator.get_keys` + coerce_method_names = api_settings.SCHEMA_COERCE_METHOD_NAMES + if header in sections: + return sections[header].strip() + if header in coerce_method_names: + if coerce_method_names[header] in sections: + return sections[coerce_method_names[header]].strip() + return sections[''].strip() + class DefaultSchema(ViewInspector): """Allows overriding AutoSchema using DEFAULT_SCHEMA_CLASS setting""" diff --git a/rest_framework/schemas/openapi.py b/rest_framework/schemas/openapi.py index 0d45e27cf..e33759e81 100644 --- a/rest_framework/schemas/openapi.py +++ b/rest_framework/schemas/openapi.py @@ -17,8 +17,6 @@ from .generators import BaseSchemaGenerator from .inspectors import ViewInspector from .utils import get_pk_description, is_list_view -# Generator - class SchemaGenerator(BaseSchemaGenerator): @@ -94,6 +92,7 @@ class AutoSchema(ViewInspector): operation = {} operation['operationId'] = self._get_operation_id(path, method) + operation['description'] = self.get_description(path, method) parameters = [] parameters += self._get_path_parameters(path, method) diff --git a/tests/schemas/test_openapi.py b/tests/schemas/test_openapi.py index fc22c32ab..5a56bae87 100644 --- a/tests/schemas/test_openapi.py +++ b/tests/schemas/test_openapi.py @@ -77,7 +77,7 @@ class TestOperationIntrospection(TestCase): method = 'GET' view = create_view( - views.ExampleListView, + views.DocStringExampleListView, method, create_request(path) ) @@ -86,7 +86,8 @@ class TestOperationIntrospection(TestCase): operation = inspector.get_operation(path, method) assert operation == { - 'operationId': 'listExamples', + 'operationId': 'listDocStringExamples', + 'description': 'A description of my GET operation.', 'parameters': [], 'responses': { '200': { @@ -108,23 +109,38 @@ class TestOperationIntrospection(TestCase): method = 'GET' view = create_view( - views.ExampleDetailView, + views.DocStringExampleDetailView, method, create_request(path) ) inspector = AutoSchema() inspector.view = view - parameters = inspector._get_path_parameters(path, method) - assert parameters == [{ - 'description': '', - 'in': 'path', - 'name': 'id', - 'required': True, - 'schema': { - 'type': 'string', + operation = inspector.get_operation(path, method) + assert operation == { + 'operationId': 'RetrieveDocStringExampleDetail', + 'description': 'A description of my GET operation.', + 'parameters': [{ + 'description': '', + 'in': 'path', + 'name': 'id', + 'required': True, + 'schema': { + 'type': 'string', + }, + }], + 'responses': { + '200': { + 'description': '', + 'content': { + 'application/json': { + 'schema': { + }, + }, + }, + }, }, - }] + } def test_request_body(self): path = '/' diff --git a/tests/schemas/views.py b/tests/schemas/views.py index 6b83e5bde..f8d143e71 100644 --- a/tests/schemas/views.py +++ b/tests/schemas/views.py @@ -29,6 +29,30 @@ class ExampleDetailView(APIView): pass +class DocStringExampleListView(APIView): + """ + get: A description of my GET operation. + post: A description of my POST operation. + """ + permission_classes = [permissions.IsAuthenticatedOrReadOnly] + + def get(self, *args, **kwargs): + pass + + def post(self, request, *args, **kwargs): + pass + + +class DocStringExampleDetailView(APIView): + permission_classes = [permissions.IsAuthenticatedOrReadOnly] + + def get(self, *args, **kwargs): + """ + A description of my GET operation. + """ + pass + + # Generics. class ExampleSerializer(serializers.Serializer): date = serializers.DateField() From 0d3d548aa52c92c57bb919c2965b723aee6b903f Mon Sep 17 00:00:00 2001 From: Yann Savary Date: Wed, 6 Nov 2019 21:54:12 +0100 Subject: [PATCH 20/26] OpenAPI: Fixed generation when title or version not provided. (#6912) --- docs/api-guide/schemas.md | 2 +- rest_framework/schemas/generators.py | 2 +- rest_framework/schemas/openapi.py | 5 +++-- tests/schemas/test_openapi.py | 13 +++++++++++++ 4 files changed, 18 insertions(+), 4 deletions(-) diff --git a/docs/api-guide/schemas.md b/docs/api-guide/schemas.md index ec5366d8e..e33a2a611 100644 --- a/docs/api-guide/schemas.md +++ b/docs/api-guide/schemas.md @@ -73,7 +73,7 @@ The `get_schema_view()` helper takes the following keyword arguments: * `title`: May be used to provide a descriptive title for the schema definition. * `description`: Longer descriptive text. -* `version`: The version of the API. Defaults to `0.1.0`. +* `version`: The version of the API. * `url`: May be used to pass a canonical base URL for the schema. schema_view = get_schema_view( diff --git a/rest_framework/schemas/generators.py b/rest_framework/schemas/generators.py index 77e92eeb8..4b6d82a14 100644 --- a/rest_framework/schemas/generators.py +++ b/rest_framework/schemas/generators.py @@ -151,7 +151,7 @@ class BaseSchemaGenerator(object): # Set by 'SCHEMA_COERCE_PATH_PK'. coerce_path_pk = None - def __init__(self, title=None, url=None, description=None, patterns=None, urlconf=None, version=''): + def __init__(self, title=None, url=None, description=None, patterns=None, urlconf=None, version=None): if url and not url.endswith('/'): url += '/' diff --git a/rest_framework/schemas/openapi.py b/rest_framework/schemas/openapi.py index e33759e81..134df5043 100644 --- a/rest_framework/schemas/openapi.py +++ b/rest_framework/schemas/openapi.py @@ -21,9 +21,10 @@ from .utils import get_pk_description, is_list_view class SchemaGenerator(BaseSchemaGenerator): def get_info(self): + # Title and version are required by openapi specification 3.x info = { - 'title': self.title, - 'version': self.version, + 'title': self.title or '', + 'version': self.version or '' } if self.description is not None: diff --git a/tests/schemas/test_openapi.py b/tests/schemas/test_openapi.py index 5a56bae87..622f78cdd 100644 --- a/tests/schemas/test_openapi.py +++ b/tests/schemas/test_openapi.py @@ -704,3 +704,16 @@ class TestGenerator(TestCase): assert schema['info']['title'] == 'My title' assert schema['info']['version'] == '1.2.3' assert schema['info']['description'] == 'My description' + + def test_schema_information_empty(self): + """Construction of the top level dictionary.""" + patterns = [ + url(r'^example/?$', views.ExampleListView.as_view()), + ] + generator = SchemaGenerator(patterns=patterns) + + request = create_request('/') + schema = generator.get_schema(request=request) + + assert schema['info']['title'] == '' + assert schema['info']['version'] == '' From 0d6589cf45940bb67ace74a06b2c5b053f1c31ef Mon Sep 17 00:00:00 2001 From: brantmorton <49286726+brantmorton@users.noreply.github.com> Date: Thu, 7 Nov 2019 06:20:56 -0600 Subject: [PATCH 21/26] Updated url() with re_path() in Versioning docs. (#7043) --- docs/api-guide/versioning.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/api-guide/versioning.md b/docs/api-guide/versioning.md index ad76ced3d..6076b1ed2 100644 --- a/docs/api-guide/versioning.md +++ b/docs/api-guide/versioning.md @@ -132,12 +132,12 @@ This scheme requires the client to specify the version as part of the URL path. Your URL conf must include a pattern that matches the version with a `'version'` keyword argument, so that this information is available to the versioning scheme. urlpatterns = [ - url( + re_path( r'^(?P(v1|v2))/bookings/$', bookings_list, name='bookings-list' ), - url( + re_path( r'^(?P(v1|v2))/bookings/(?P[0-9]+)/$', bookings_detail, name='bookings-detail' @@ -158,14 +158,14 @@ In the following example we're giving a set of views two different possible URL # bookings/urls.py urlpatterns = [ - url(r'^$', bookings_list, name='bookings-list'), - url(r'^(?P[0-9]+)/$', bookings_detail, name='bookings-detail') + re_path(r'^$', bookings_list, name='bookings-list'), + re_path(r'^(?P[0-9]+)/$', bookings_detail, name='bookings-detail') ] # urls.py urlpatterns = [ - url(r'^v1/bookings/', include('bookings.urls', namespace='v1')), - url(r'^v2/bookings/', include('bookings.urls', namespace='v2')) + re_path(r'^v1/bookings/', include('bookings.urls', namespace='v1')), + re_path(r'^v2/bookings/', include('bookings.urls', namespace='v2')) ] Both `URLPathVersioning` and `NamespaceVersioning` are reasonable if you just need a simple versioning scheme. The `URLPathVersioning` approach might be better suitable for small ad-hoc projects, and the `NamespaceVersioning` is probably easier to manage for larger projects. From 8988afa0827a139efeeb72afb21da08670fb4775 Mon Sep 17 00:00:00 2001 From: Maxime Jacques Date: Mon, 11 Nov 2019 16:41:10 -0500 Subject: [PATCH 22/26] Update bootstrap to 3.4.1 (#6923) --- rest_framework/static/rest_framework/js/bootstrap.min.js | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/rest_framework/static/rest_framework/js/bootstrap.min.js b/rest_framework/static/rest_framework/js/bootstrap.min.js index 4cd821990..eb0a8b410 100644 --- a/rest_framework/static/rest_framework/js/bootstrap.min.js +++ b/rest_framework/static/rest_framework/js/bootstrap.min.js @@ -1,6 +1,6 @@ /*! - * Bootstrap v3.4.0 (https://getbootstrap.com/) - * Copyright 2011-2018 Twitter, Inc. + * Bootstrap v3.4.1 (https://getbootstrap.com/) + * Copyright 2011-2019 Twitter, Inc. * Licensed under the MIT license */ -if("undefined"==typeof jQuery)throw new Error("Bootstrap's JavaScript requires jQuery");!function(t){"use strict";var e=jQuery.fn.jquery.split(" ")[0].split(".");if(e[0]<2&&e[1]<9||1==e[0]&&9==e[1]&&e[2]<1||3this.$items.length-1||t<0))return this.sliding?this.$element.one("slid.bs.carousel",function(){e.to(t)}):i==t?this.pause().cycle():this.slide(idocument.documentElement.clientHeight;this.$element.css({paddingLeft:!this.bodyIsOverflowing&&t?this.scrollbarWidth:"",paddingRight:this.bodyIsOverflowing&&!t?this.scrollbarWidth:""})},s.prototype.resetAdjustments=function(){this.$element.css({paddingLeft:"",paddingRight:""})},s.prototype.checkScrollbar=function(){var t=window.innerWidth;if(!t){var e=document.documentElement.getBoundingClientRect();t=e.right-Math.abs(e.left)}this.bodyIsOverflowing=document.body.clientWidth
',trigger:"hover focus",title:"",delay:0,html:!1,container:!1,viewport:{selector:"body",padding:0}},m.prototype.init=function(t,e,i){if(this.enabled=!0,this.type=t,this.$element=g(e),this.options=this.getOptions(i),this.$viewport=this.options.viewport&&g(document).find(g.isFunction(this.options.viewport)?this.options.viewport.call(this,this.$element):this.options.viewport.selector||this.options.viewport),this.inState={click:!1,hover:!1,focus:!1},this.$element[0]instanceof document.constructor&&!this.options.selector)throw new Error("`selector` option must be specified when initializing "+this.type+" on the window.document object!");for(var o=this.options.trigger.split(" "),n=o.length;n--;){var s=o[n];if("click"==s)this.$element.on("click."+this.type,this.options.selector,g.proxy(this.toggle,this));else if("manual"!=s){var a="hover"==s?"mouseenter":"focusin",r="hover"==s?"mouseleave":"focusout";this.$element.on(a+"."+this.type,this.options.selector,g.proxy(this.enter,this)),this.$element.on(r+"."+this.type,this.options.selector,g.proxy(this.leave,this))}}this.options.selector?this._options=g.extend({},this.options,{trigger:"manual",selector:""}):this.fixTitle()},m.prototype.getDefaults=function(){return m.DEFAULTS},m.prototype.getOptions=function(t){return(t=g.extend({},this.getDefaults(),this.$element.data(),t)).delay&&"number"==typeof t.delay&&(t.delay={show:t.delay,hide:t.delay}),t},m.prototype.getDelegateOptions=function(){var i={},o=this.getDefaults();return this._options&&g.each(this._options,function(t,e){o[t]!=e&&(i[t]=e)}),i},m.prototype.enter=function(t){var e=t instanceof this.constructor?t:g(t.currentTarget).data("bs."+this.type);if(e||(e=new this.constructor(t.currentTarget,this.getDelegateOptions()),g(t.currentTarget).data("bs."+this.type,e)),t instanceof g.Event&&(e.inState["focusin"==t.type?"focus":"hover"]=!0),e.tip().hasClass("in")||"in"==e.hoverState)e.hoverState="in";else{if(clearTimeout(e.timeout),e.hoverState="in",!e.options.delay||!e.options.delay.show)return e.show();e.timeout=setTimeout(function(){"in"==e.hoverState&&e.show()},e.options.delay.show)}},m.prototype.isInStateTrue=function(){for(var t in this.inState)if(this.inState[t])return!0;return!1},m.prototype.leave=function(t){var e=t instanceof this.constructor?t:g(t.currentTarget).data("bs."+this.type);if(e||(e=new this.constructor(t.currentTarget,this.getDelegateOptions()),g(t.currentTarget).data("bs."+this.type,e)),t instanceof g.Event&&(e.inState["focusout"==t.type?"focus":"hover"]=!1),!e.isInStateTrue()){if(clearTimeout(e.timeout),e.hoverState="out",!e.options.delay||!e.options.delay.hide)return e.hide();e.timeout=setTimeout(function(){"out"==e.hoverState&&e.hide()},e.options.delay.hide)}},m.prototype.show=function(){var t=g.Event("show.bs."+this.type);if(this.hasContent()&&this.enabled){this.$element.trigger(t);var e=g.contains(this.$element[0].ownerDocument.documentElement,this.$element[0]);if(t.isDefaultPrevented()||!e)return;var i=this,o=this.tip(),n=this.getUID(this.type);this.setContent(),o.attr("id",n),this.$element.attr("aria-describedby",n),this.options.animation&&o.addClass("fade");var s="function"==typeof this.options.placement?this.options.placement.call(this,o[0],this.$element[0]):this.options.placement,a=/\s?auto?\s?/i,r=a.test(s);r&&(s=s.replace(a,"")||"top"),o.detach().css({top:0,left:0,display:"block"}).addClass(s).data("bs."+this.type,this),this.options.container?o.appendTo(g(document).find(this.options.container)):o.insertAfter(this.$element),this.$element.trigger("inserted.bs."+this.type);var l=this.getPosition(),h=o[0].offsetWidth,d=o[0].offsetHeight;if(r){var p=s,c=this.getPosition(this.$viewport);s="bottom"==s&&l.bottom+d>c.bottom?"top":"top"==s&&l.top-dc.width?"left":"left"==s&&l.left-ha.top+a.height&&(n.top=a.top+a.height-l)}else{var h=e.left-s,d=e.left+s+i;ha.right&&(n.left=a.left+a.width-d)}return n},m.prototype.getTitle=function(){var t=this.$element,e=this.options;return t.attr("data-original-title")||("function"==typeof e.title?e.title.call(t[0]):e.title)},m.prototype.getUID=function(t){for(;t+=~~(1e6*Math.random()),document.getElementById(t););return t},m.prototype.tip=function(){if(!this.$tip&&(this.$tip=g(this.options.template),1!=this.$tip.length))throw new Error(this.type+" `template` option must consist of exactly 1 top-level element!");return this.$tip},m.prototype.arrow=function(){return this.$arrow=this.$arrow||this.tip().find(".tooltip-arrow")},m.prototype.enable=function(){this.enabled=!0},m.prototype.disable=function(){this.enabled=!1},m.prototype.toggleEnabled=function(){this.enabled=!this.enabled},m.prototype.toggle=function(t){var e=this;t&&((e=g(t.currentTarget).data("bs."+this.type))||(e=new this.constructor(t.currentTarget,this.getDelegateOptions()),g(t.currentTarget).data("bs."+this.type,e))),t?(e.inState.click=!e.inState.click,e.isInStateTrue()?e.enter(e):e.leave(e)):e.tip().hasClass("in")?e.leave(e):e.enter(e)},m.prototype.destroy=function(){var t=this;clearTimeout(this.timeout),this.hide(function(){t.$element.off("."+t.type).removeData("bs."+t.type),t.$tip&&t.$tip.detach(),t.$tip=null,t.$arrow=null,t.$viewport=null,t.$element=null})};var t=g.fn.tooltip;g.fn.tooltip=function e(o){return this.each(function(){var t=g(this),e=t.data("bs.tooltip"),i="object"==typeof o&&o;!e&&/destroy|hide/.test(o)||(e||t.data("bs.tooltip",e=new m(this,i)),"string"==typeof o&&e[o]())})},g.fn.tooltip.Constructor=m,g.fn.tooltip.noConflict=function(){return g.fn.tooltip=t,this}}(jQuery),function(n){"use strict";var s=function(t,e){this.init("popover",t,e)};if(!n.fn.tooltip)throw new Error("Popover requires tooltip.js");s.VERSION="3.4.0",s.DEFAULTS=n.extend({},n.fn.tooltip.Constructor.DEFAULTS,{placement:"right",trigger:"click",content:"",template:''}),((s.prototype=n.extend({},n.fn.tooltip.Constructor.prototype)).constructor=s).prototype.getDefaults=function(){return s.DEFAULTS},s.prototype.setContent=function(){var t=this.tip(),e=this.getTitle(),i=this.getContent();t.find(".popover-title")[this.options.html?"html":"text"](e),t.find(".popover-content").children().detach().end()[this.options.html?"string"==typeof i?"html":"append":"text"](i),t.removeClass("fade top bottom left right in"),t.find(".popover-title").html()||t.find(".popover-title").hide()},s.prototype.hasContent=function(){return this.getTitle()||this.getContent()},s.prototype.getContent=function(){var t=this.$element,e=this.options;return t.attr("data-content")||("function"==typeof e.content?e.content.call(t[0]):e.content)},s.prototype.arrow=function(){return this.$arrow=this.$arrow||this.tip().find(".arrow")};var t=n.fn.popover;n.fn.popover=function e(o){return this.each(function(){var t=n(this),e=t.data("bs.popover"),i="object"==typeof o&&o;!e&&/destroy|hide/.test(o)||(e||t.data("bs.popover",e=new s(this,i)),"string"==typeof o&&e[o]())})},n.fn.popover.Constructor=s,n.fn.popover.noConflict=function(){return n.fn.popover=t,this}}(jQuery),function(s){"use strict";function n(t,e){this.$body=s(document.body),this.$scrollElement=s(t).is(document.body)?s(window):s(t),this.options=s.extend({},n.DEFAULTS,e),this.selector=(this.options.target||"")+" .nav li > a",this.offsets=[],this.targets=[],this.activeTarget=null,this.scrollHeight=0,this.$scrollElement.on("scroll.bs.scrollspy",s.proxy(this.process,this)),this.refresh(),this.process()}function e(o){return this.each(function(){var t=s(this),e=t.data("bs.scrollspy"),i="object"==typeof o&&o;e||t.data("bs.scrollspy",e=new n(this,i)),"string"==typeof o&&e[o]()})}n.VERSION="3.4.0",n.DEFAULTS={offset:10},n.prototype.getScrollHeight=function(){return this.$scrollElement[0].scrollHeight||Math.max(this.$body[0].scrollHeight,document.documentElement.scrollHeight)},n.prototype.refresh=function(){var t=this,o="offset",n=0;this.offsets=[],this.targets=[],this.scrollHeight=this.getScrollHeight(),s.isWindow(this.$scrollElement[0])||(o="position",n=this.$scrollElement.scrollTop()),this.$body.find(this.selector).map(function(){var t=s(this),e=t.data("target")||t.attr("href"),i=/^#./.test(e)&&s(e);return i&&i.length&&i.is(":visible")&&[[i[o]().top+n,e]]||null}).sort(function(t,e){return t[0]-e[0]}).each(function(){t.offsets.push(this[0]),t.targets.push(this[1])})},n.prototype.process=function(){var t,e=this.$scrollElement.scrollTop()+this.options.offset,i=this.getScrollHeight(),o=this.options.offset+i-this.$scrollElement.height(),n=this.offsets,s=this.targets,a=this.activeTarget;if(this.scrollHeight!=i&&this.refresh(),o<=e)return a!=(t=s[s.length-1])&&this.activate(t);if(a&&e=n[t]&&(n[t+1]===undefined||e .active"),n=i&&r.support.transition&&(o.length&&o.hasClass("fade")||!!e.find("> .fade").length);function s(){o.removeClass("active").find("> .dropdown-menu > .active").removeClass("active").end().find('[data-toggle="tab"]').attr("aria-expanded",!1),t.addClass("active").find('[data-toggle="tab"]').attr("aria-expanded",!0),n?(t[0].offsetWidth,t.addClass("in")):t.removeClass("fade"),t.parent(".dropdown-menu").length&&t.closest("li.dropdown").addClass("active").end().find('[data-toggle="tab"]').attr("aria-expanded",!0),i&&i()}o.length&&n?o.one("bsTransitionEnd",s).emulateTransitionEnd(a.TRANSITION_DURATION):s(),o.removeClass("in")};var t=r.fn.tab;r.fn.tab=e,r.fn.tab.Constructor=a,r.fn.tab.noConflict=function(){return r.fn.tab=t,this};var i=function(t){t.preventDefault(),e.call(r(this),"show")};r(document).on("click.bs.tab.data-api",'[data-toggle="tab"]',i).on("click.bs.tab.data-api",'[data-toggle="pill"]',i)}(jQuery),function(l){"use strict";var h=function(t,e){this.options=l.extend({},h.DEFAULTS,e);var i=this.options.target===h.DEFAULTS.target?l(this.options.target):l(document).find(this.options.target);this.$target=i.on("scroll.bs.affix.data-api",l.proxy(this.checkPosition,this)).on("click.bs.affix.data-api",l.proxy(this.checkPositionWithEventLoop,this)),this.$element=l(t),this.affixed=null,this.unpin=null,this.pinnedOffset=null,this.checkPosition()};function i(o){return this.each(function(){var t=l(this),e=t.data("bs.affix"),i="object"==typeof o&&o;e||t.data("bs.affix",e=new h(this,i)),"string"==typeof o&&e[o]()})}h.VERSION="3.4.0",h.RESET="affix affix-top affix-bottom",h.DEFAULTS={offset:0,target:window},h.prototype.getState=function(t,e,i,o){var n=this.$target.scrollTop(),s=this.$element.offset(),a=this.$target.height();if(null!=i&&"top"==this.affixed)return nthis.$items.length-1||t<0))return this.sliding?this.$element.one("slid.bs.carousel",function(){e.to(t)}):i==t?this.pause().cycle():this.slide(idocument.documentElement.clientHeight;this.$element.css({paddingLeft:!this.bodyIsOverflowing&&t?this.scrollbarWidth:"",paddingRight:this.bodyIsOverflowing&&!t?this.scrollbarWidth:""})},s.prototype.resetAdjustments=function(){this.$element.css({paddingLeft:"",paddingRight:""})},s.prototype.checkScrollbar=function(){var t=window.innerWidth;if(!t){var e=document.documentElement.getBoundingClientRect();t=e.right-Math.abs(e.left)}this.bodyIsOverflowing=document.body.clientWidth
',trigger:"hover focus",title:"",delay:0,html:!1,container:!1,viewport:{selector:"body",padding:0},sanitize:!0,sanitizeFn:null,whiteList:t},m.prototype.init=function(t,e,i){if(this.enabled=!0,this.type=t,this.$element=g(e),this.options=this.getOptions(i),this.$viewport=this.options.viewport&&g(document).find(g.isFunction(this.options.viewport)?this.options.viewport.call(this,this.$element):this.options.viewport.selector||this.options.viewport),this.inState={click:!1,hover:!1,focus:!1},this.$element[0]instanceof document.constructor&&!this.options.selector)throw new Error("`selector` option must be specified when initializing "+this.type+" on the window.document object!");for(var o=this.options.trigger.split(" "),n=o.length;n--;){var s=o[n];if("click"==s)this.$element.on("click."+this.type,this.options.selector,g.proxy(this.toggle,this));else if("manual"!=s){var a="hover"==s?"mouseenter":"focusin",r="hover"==s?"mouseleave":"focusout";this.$element.on(a+"."+this.type,this.options.selector,g.proxy(this.enter,this)),this.$element.on(r+"."+this.type,this.options.selector,g.proxy(this.leave,this))}}this.options.selector?this._options=g.extend({},this.options,{trigger:"manual",selector:""}):this.fixTitle()},m.prototype.getDefaults=function(){return m.DEFAULTS},m.prototype.getOptions=function(t){var e=this.$element.data();for(var i in e)e.hasOwnProperty(i)&&-1!==g.inArray(i,o)&&delete e[i];return(t=g.extend({},this.getDefaults(),e,t)).delay&&"number"==typeof t.delay&&(t.delay={show:t.delay,hide:t.delay}),t.sanitize&&(t.template=n(t.template,t.whiteList,t.sanitizeFn)),t},m.prototype.getDelegateOptions=function(){var i={},o=this.getDefaults();return this._options&&g.each(this._options,function(t,e){o[t]!=e&&(i[t]=e)}),i},m.prototype.enter=function(t){var e=t instanceof this.constructor?t:g(t.currentTarget).data("bs."+this.type);if(e||(e=new this.constructor(t.currentTarget,this.getDelegateOptions()),g(t.currentTarget).data("bs."+this.type,e)),t instanceof g.Event&&(e.inState["focusin"==t.type?"focus":"hover"]=!0),e.tip().hasClass("in")||"in"==e.hoverState)e.hoverState="in";else{if(clearTimeout(e.timeout),e.hoverState="in",!e.options.delay||!e.options.delay.show)return e.show();e.timeout=setTimeout(function(){"in"==e.hoverState&&e.show()},e.options.delay.show)}},m.prototype.isInStateTrue=function(){for(var t in this.inState)if(this.inState[t])return!0;return!1},m.prototype.leave=function(t){var e=t instanceof this.constructor?t:g(t.currentTarget).data("bs."+this.type);if(e||(e=new this.constructor(t.currentTarget,this.getDelegateOptions()),g(t.currentTarget).data("bs."+this.type,e)),t instanceof g.Event&&(e.inState["focusout"==t.type?"focus":"hover"]=!1),!e.isInStateTrue()){if(clearTimeout(e.timeout),e.hoverState="out",!e.options.delay||!e.options.delay.hide)return e.hide();e.timeout=setTimeout(function(){"out"==e.hoverState&&e.hide()},e.options.delay.hide)}},m.prototype.show=function(){var t=g.Event("show.bs."+this.type);if(this.hasContent()&&this.enabled){this.$element.trigger(t);var e=g.contains(this.$element[0].ownerDocument.documentElement,this.$element[0]);if(t.isDefaultPrevented()||!e)return;var i=this,o=this.tip(),n=this.getUID(this.type);this.setContent(),o.attr("id",n),this.$element.attr("aria-describedby",n),this.options.animation&&o.addClass("fade");var s="function"==typeof this.options.placement?this.options.placement.call(this,o[0],this.$element[0]):this.options.placement,a=/\s?auto?\s?/i,r=a.test(s);r&&(s=s.replace(a,"")||"top"),o.detach().css({top:0,left:0,display:"block"}).addClass(s).data("bs."+this.type,this),this.options.container?o.appendTo(g(document).find(this.options.container)):o.insertAfter(this.$element),this.$element.trigger("inserted.bs."+this.type);var l=this.getPosition(),h=o[0].offsetWidth,d=o[0].offsetHeight;if(r){var p=s,c=this.getPosition(this.$viewport);s="bottom"==s&&l.bottom+d>c.bottom?"top":"top"==s&&l.top-dc.width?"left":"left"==s&&l.left-ha.top+a.height&&(n.top=a.top+a.height-l)}else{var h=e.left-s,d=e.left+s+i;ha.right&&(n.left=a.left+a.width-d)}return n},m.prototype.getTitle=function(){var t=this.$element,e=this.options;return t.attr("data-original-title")||("function"==typeof e.title?e.title.call(t[0]):e.title)},m.prototype.getUID=function(t){for(;t+=~~(1e6*Math.random()),document.getElementById(t););return t},m.prototype.tip=function(){if(!this.$tip&&(this.$tip=g(this.options.template),1!=this.$tip.length))throw new Error(this.type+" `template` option must consist of exactly 1 top-level element!");return this.$tip},m.prototype.arrow=function(){return this.$arrow=this.$arrow||this.tip().find(".tooltip-arrow")},m.prototype.enable=function(){this.enabled=!0},m.prototype.disable=function(){this.enabled=!1},m.prototype.toggleEnabled=function(){this.enabled=!this.enabled},m.prototype.toggle=function(t){var e=this;t&&((e=g(t.currentTarget).data("bs."+this.type))||(e=new this.constructor(t.currentTarget,this.getDelegateOptions()),g(t.currentTarget).data("bs."+this.type,e))),t?(e.inState.click=!e.inState.click,e.isInStateTrue()?e.enter(e):e.leave(e)):e.tip().hasClass("in")?e.leave(e):e.enter(e)},m.prototype.destroy=function(){var t=this;clearTimeout(this.timeout),this.hide(function(){t.$element.off("."+t.type).removeData("bs."+t.type),t.$tip&&t.$tip.detach(),t.$tip=null,t.$arrow=null,t.$viewport=null,t.$element=null})},m.prototype.sanitizeHtml=function(t){return n(t,this.options.whiteList,this.options.sanitizeFn)};var e=g.fn.tooltip;g.fn.tooltip=function i(o){return this.each(function(){var t=g(this),e=t.data("bs.tooltip"),i="object"==typeof o&&o;!e&&/destroy|hide/.test(o)||(e||t.data("bs.tooltip",e=new m(this,i)),"string"==typeof o&&e[o]())})},g.fn.tooltip.Constructor=m,g.fn.tooltip.noConflict=function(){return g.fn.tooltip=e,this}}(jQuery),function(n){"use strict";var s=function(t,e){this.init("popover",t,e)};if(!n.fn.tooltip)throw new Error("Popover requires tooltip.js");s.VERSION="3.4.1",s.DEFAULTS=n.extend({},n.fn.tooltip.Constructor.DEFAULTS,{placement:"right",trigger:"click",content:"",template:''}),((s.prototype=n.extend({},n.fn.tooltip.Constructor.prototype)).constructor=s).prototype.getDefaults=function(){return s.DEFAULTS},s.prototype.setContent=function(){var t=this.tip(),e=this.getTitle(),i=this.getContent();if(this.options.html){var o=typeof i;this.options.sanitize&&(e=this.sanitizeHtml(e),"string"===o&&(i=this.sanitizeHtml(i))),t.find(".popover-title").html(e),t.find(".popover-content").children().detach().end()["string"===o?"html":"append"](i)}else t.find(".popover-title").text(e),t.find(".popover-content").children().detach().end().text(i);t.removeClass("fade top bottom left right in"),t.find(".popover-title").html()||t.find(".popover-title").hide()},s.prototype.hasContent=function(){return this.getTitle()||this.getContent()},s.prototype.getContent=function(){var t=this.$element,e=this.options;return t.attr("data-content")||("function"==typeof e.content?e.content.call(t[0]):e.content)},s.prototype.arrow=function(){return this.$arrow=this.$arrow||this.tip().find(".arrow")};var t=n.fn.popover;n.fn.popover=function e(o){return this.each(function(){var t=n(this),e=t.data("bs.popover"),i="object"==typeof o&&o;!e&&/destroy|hide/.test(o)||(e||t.data("bs.popover",e=new s(this,i)),"string"==typeof o&&e[o]())})},n.fn.popover.Constructor=s,n.fn.popover.noConflict=function(){return n.fn.popover=t,this}}(jQuery),function(s){"use strict";function n(t,e){this.$body=s(document.body),this.$scrollElement=s(t).is(document.body)?s(window):s(t),this.options=s.extend({},n.DEFAULTS,e),this.selector=(this.options.target||"")+" .nav li > a",this.offsets=[],this.targets=[],this.activeTarget=null,this.scrollHeight=0,this.$scrollElement.on("scroll.bs.scrollspy",s.proxy(this.process,this)),this.refresh(),this.process()}function e(o){return this.each(function(){var t=s(this),e=t.data("bs.scrollspy"),i="object"==typeof o&&o;e||t.data("bs.scrollspy",e=new n(this,i)),"string"==typeof o&&e[o]()})}n.VERSION="3.4.1",n.DEFAULTS={offset:10},n.prototype.getScrollHeight=function(){return this.$scrollElement[0].scrollHeight||Math.max(this.$body[0].scrollHeight,document.documentElement.scrollHeight)},n.prototype.refresh=function(){var t=this,o="offset",n=0;this.offsets=[],this.targets=[],this.scrollHeight=this.getScrollHeight(),s.isWindow(this.$scrollElement[0])||(o="position",n=this.$scrollElement.scrollTop()),this.$body.find(this.selector).map(function(){var t=s(this),e=t.data("target")||t.attr("href"),i=/^#./.test(e)&&s(e);return i&&i.length&&i.is(":visible")&&[[i[o]().top+n,e]]||null}).sort(function(t,e){return t[0]-e[0]}).each(function(){t.offsets.push(this[0]),t.targets.push(this[1])})},n.prototype.process=function(){var t,e=this.$scrollElement.scrollTop()+this.options.offset,i=this.getScrollHeight(),o=this.options.offset+i-this.$scrollElement.height(),n=this.offsets,s=this.targets,a=this.activeTarget;if(this.scrollHeight!=i&&this.refresh(),o<=e)return a!=(t=s[s.length-1])&&this.activate(t);if(a&&e=n[t]&&(n[t+1]===undefined||e .active"),n=i&&r.support.transition&&(o.length&&o.hasClass("fade")||!!e.find("> .fade").length);function s(){o.removeClass("active").find("> .dropdown-menu > .active").removeClass("active").end().find('[data-toggle="tab"]').attr("aria-expanded",!1),t.addClass("active").find('[data-toggle="tab"]').attr("aria-expanded",!0),n?(t[0].offsetWidth,t.addClass("in")):t.removeClass("fade"),t.parent(".dropdown-menu").length&&t.closest("li.dropdown").addClass("active").end().find('[data-toggle="tab"]').attr("aria-expanded",!0),i&&i()}o.length&&n?o.one("bsTransitionEnd",s).emulateTransitionEnd(a.TRANSITION_DURATION):s(),o.removeClass("in")};var t=r.fn.tab;r.fn.tab=e,r.fn.tab.Constructor=a,r.fn.tab.noConflict=function(){return r.fn.tab=t,this};var i=function(t){t.preventDefault(),e.call(r(this),"show")};r(document).on("click.bs.tab.data-api",'[data-toggle="tab"]',i).on("click.bs.tab.data-api",'[data-toggle="pill"]',i)}(jQuery),function(l){"use strict";var h=function(t,e){this.options=l.extend({},h.DEFAULTS,e);var i=this.options.target===h.DEFAULTS.target?l(this.options.target):l(document).find(this.options.target);this.$target=i.on("scroll.bs.affix.data-api",l.proxy(this.checkPosition,this)).on("click.bs.affix.data-api",l.proxy(this.checkPositionWithEventLoop,this)),this.$element=l(t),this.affixed=null,this.unpin=null,this.pinnedOffset=null,this.checkPosition()};function i(o){return this.each(function(){var t=l(this),e=t.data("bs.affix"),i="object"==typeof o&&o;e||t.data("bs.affix",e=new h(this,i)),"string"==typeof o&&e[o]()})}h.VERSION="3.4.1",h.RESET="affix affix-top affix-bottom",h.DEFAULTS={offset:0,target:window},h.prototype.getState=function(t,e,i,o){var n=this.$target.scrollTop(),s=this.$element.offset(),a=this.$target.height();if(null!=i&&"top"==this.affixed)return n Date: Sat, 16 Nov 2019 03:39:47 +0100 Subject: [PATCH 23/26] Cleanup "Documenting your API" 3rd party recommendations (#7057) --- docs/community/third-party-packages.md | 2 - docs/img/apiary.png | Bin 55554 -> 0 bytes docs/img/django-rest-swagger.png | Bin 76945 -> 0 bytes docs/topics/documenting-your-api.md | 75 ++++--------------------- 4 files changed, 10 insertions(+), 67 deletions(-) delete mode 100644 docs/img/apiary.png delete mode 100644 docs/img/django-rest-swagger.png diff --git a/docs/community/third-party-packages.md b/docs/community/third-party-packages.md index ea5d6b854..c4b567a5f 100644 --- a/docs/community/third-party-packages.md +++ b/docs/community/third-party-packages.md @@ -254,7 +254,6 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque * [cookiecutter-django-rest][cookiecutter-django-rest] - A cookiecutter template that takes care of the setup and configuration so you can focus on making your REST apis awesome. * [djangorestrelationalhyperlink][djangorestrelationalhyperlink] - A hyperlinked serializer that can can be used to alter relationships via hyperlinks, but otherwise like a hyperlink model serializer. -* [django-rest-swagger][django-rest-swagger] - An API documentation generator for Swagger UI. * [django-rest-framework-proxy][django-rest-framework-proxy] - Proxy to redirect incoming request to another API server. * [gaiarestframework][gaiarestframework] - Utils for django-rest-framework * [drf-extensions][drf-extensions] - A collection of custom extensions @@ -315,7 +314,6 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque [djangorestframework-rapidjson]: https://github.com/allisson/django-rest-framework-rapidjson [djangorestframework-chain]: https://github.com/philipn/django-rest-framework-chain [djangorestrelationalhyperlink]: https://github.com/fredkingham/django_rest_model_hyperlink_serializers_project -[django-rest-swagger]: https://github.com/marcgibbons/django-rest-swagger [django-rest-framework-proxy]: https://github.com/eofs/django-rest-framework-proxy [gaiarestframework]: https://github.com/AppsFuel/gaiarestframework [drf-extensions]: https://github.com/chibisov/drf-extensions diff --git a/docs/img/apiary.png b/docs/img/apiary.png deleted file mode 100644 index 923d384ebb66d833b13b9971cda69eb718651c1d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 55554 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 diff --git a/docs/img/django-rest-swagger.png b/docs/img/django-rest-swagger.png deleted file mode 100644 index 96a6b23800d2f7dec53631e0b017e2f383bda659..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 76945 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%0D(6%`>FHckpDt$oGc4=IC`V= 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 diff --git a/docs/topics/documenting-your-api.md b/docs/topics/documenting-your-api.md index b4c7dea4d..5c806ea7e 100644 --- a/docs/topics/documenting-your-api.md +++ b/docs/topics/documenting-your-api.md @@ -140,56 +140,6 @@ This also translates into a very useful interactive documentation viewer in the --- -#### Django REST Swagger - -Marc Gibbons' [Django REST Swagger][django-rest-swagger] integrates REST framework with the [Swagger][swagger] API documentation tool. The package produces well presented API documentation, and includes interactive tools for testing API endpoints. - -Django REST Swagger supports REST framework versions 2.3 and above. - -Mark is also the author of the [REST Framework Docs][rest-framework-docs] package which offers clean, simple autogenerated documentation for your API but is deprecated and has moved to Django REST Swagger. - -This package is fully documented, well supported, and comes highly recommended. - -![Screenshot - Django REST Swagger][image-django-rest-swagger] - ---- - -### DRF AutoDocs - -Oleksander Mashianovs' [DRF Auto Docs][drfautodocs-repo] automated api renderer. - -Collects almost all the code you written into documentation effortlessly. - -Supports: - - * functional view docs - * tree-like structure - * Docstrings: - * markdown - * preserve space & newlines - * formatting with nice syntax - * Fields: - * choices rendering - * help_text (to specify SerializerMethodField output, etc) - * smart read_only/required rendering - * Endpoint properties: - * filter_backends - * authentication_classes - * permission_classes - * extra url params(GET params) - -![whole structure](http://joxi.ru/52aBGNI4k3oyA0.jpg) - ---- - -#### Apiary - -There are various other online tools and services for providing API documentation. One notable service is [Apiary][apiary]. With Apiary, you describe your API using a simple markdown-like syntax. The generated documentation includes API interaction, a mock server for testing & prototyping, and various other tools. - -![Screenshot - Apiary][image-apiary] - ---- - ## Self describing APIs The browsable API that REST framework provides makes it possible for your API to be entirely self describing. The documentation for each API endpoint can be provided simply by visiting the URL in your browser. @@ -253,22 +203,17 @@ In this approach, rather than documenting the available API endpoints up front, To implement a hypermedia API you'll need to decide on an appropriate media type for the API, and implement a custom renderer and parser for that media type. The [REST, Hypermedia & HATEOAS][hypermedia-docs] section of the documentation includes pointers to background reading, as well as links to various hypermedia formats. [cite]: https://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven -[drf-yasg]: https://github.com/axnsan12/drf-yasg/ -[image-drf-yasg]: ../img/drf-yasg.png -[drfautodocs-repo]: https://github.com/iMakedonsky/drf-autodocs -[django-rest-swagger]: https://github.com/marcgibbons/django-rest-swagger -[swagger]: https://swagger.io/ -[open-api]: https://openapis.org/ -[rest-framework-docs]: https://github.com/marcgibbons/django-rest-framework-docs -[apiary]: https://apiary.io/ -[markdown]: https://daringfireball.net/projects/markdown/syntax + [hypermedia-docs]: rest-hypermedia-hateoas.md -[image-django-rest-swagger]: ../img/django-rest-swagger.png -[image-apiary]: ../img/apiary.png -[image-self-describing-api]: ../img/self-describing.png [metadata-docs]: ../api-guide/metadata/ - [schemas-examples]: ../api-guide/schemas/#examples -[swagger-ui]: https://swagger.io/tools/swagger-ui/ -[redoc]: https://github.com/Rebilly/ReDoc +[image-drf-yasg]: ../img/drf-yasg.png +[image-self-describing-api]: ../img/self-describing.png + +[drf-yasg]: https://github.com/axnsan12/drf-yasg/ +[markdown]: https://daringfireball.net/projects/markdown/syntax +[open-api]: https://openapis.org/ +[redoc]: https://github.com/Rebilly/ReDoc +[swagger]: https://swagger.io/ +[swagger-ui]: https://swagger.io/tools/swagger-ui/ From cad1b082602ce1367cae6a3a3668a64436fb4bde Mon Sep 17 00:00:00 2001 From: Chris Guo <41265033+chrisguox@users.noreply.github.com> Date: Mon, 18 Nov 2019 20:30:36 +0800 Subject: [PATCH 24/26] Fix override func style and regular usage (#7050) * style: add space and rm redundant parentheses * refactor: use super to replace inherit class * Prefer explicit tuple syntax --- rest_framework/relations.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/rest_framework/relations.py b/rest_framework/relations.py index 338776884..9bde79b19 100644 --- a/rest_framework/relations.py +++ b/rest_framework/relations.py @@ -47,12 +47,12 @@ class Hyperlink(str): in some contexts, or render as a plain URL in others. """ def __new__(cls, url, obj): - ret = str.__new__(cls, url) + ret = super().__new__(cls, url) ret.obj = obj return ret def __getnewargs__(self): - return(str(self), self.name,) + return (str(self), self.name) @property def name(self): From 6196e9c8cd4b8a785564310304870ab5ad2873be Mon Sep 17 00:00:00 2001 From: CloudCode Hungary <56896763+cloudcode-hungary@users.noreply.github.com> Date: Mon, 18 Nov 2019 13:31:32 +0100 Subject: [PATCH 25/26] add djangorestframework-features to third-party (#7052) --- docs/community/third-party-packages.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/community/third-party-packages.md b/docs/community/third-party-packages.md index c4b567a5f..4d0043252 100644 --- a/docs/community/third-party-packages.md +++ b/docs/community/third-party-packages.md @@ -270,6 +270,7 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque * [django-rest-framework-condition][django-rest-framework-condition] - Decorators for managing HTTP cache headers for Django REST framework (ETag and Last-modified). * [django-rest-witchcraft][django-rest-witchcraft] - Provides DRF integration with SQLAlchemy with SQLAlchemy model serializers/viewsets and a bunch of other goodies * [djangorestframework-mvt][djangorestframework-mvt] - An extension for creating views that serve Postgres data as Map Box Vector Tiles. +* [djangorestframework-features][djangorestframework-features] - Advanced schema generation and more based on named features. [cite]: http://www.software-ecosystems.com/Software_Ecosystems/Ecosystems.html [cookiecutter]: https://github.com/jpadilla/cookiecutter-django-rest-framework @@ -350,3 +351,4 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque [django-restql]: https://github.com/yezyilomo/django-restql [djangorestframework-mvt]: https://github.com/corteva/djangorestframework-mvt [django-rest-framework-guardian]: https://github.com/rpkilby/django-rest-framework-guardian +[djangorestframework-features]: https://github.com/cloudcode-hungary/django-rest-framework-features/ From a73d3c309f0736f46dd46c99e15e1102af26dacb Mon Sep 17 00:00:00 2001 From: Hendrik <30193551+verhoek@users.noreply.github.com> Date: Mon, 18 Nov 2019 13:35:36 +0100 Subject: [PATCH 26/26] Elaborated on nested relationships (#7051) --- docs/api-guide/relations.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/api-guide/relations.md b/docs/api-guide/relations.md index 14f197b21..ef6efec5e 100644 --- a/docs/api-guide/relations.md +++ b/docs/api-guide/relations.md @@ -245,7 +245,9 @@ This field is always read-only. # Nested relationships -Nested relationships can be expressed by using serializers as fields. +As opposed to previously discussed _references_ to another entity, the referred entity can instead also be embedded or _nested_ +in the representation of the object that refers to it. +Such nested relationships can be expressed by using serializers as fields. If the field is used to represent a to-many relationship, you should add the `many=True` flag to the serializer field.