From 86c72bb2268ad06c503de4fb7caa46c9e495f8d8 Mon Sep 17 00:00:00 2001 From: Kevin Brown Date: Thu, 7 Mar 2019 05:26:03 -0500 Subject: [PATCH 01/69] Fix schema generation of `ManyRelatedField` to detect the child type (#6489) * Introspect ManyRelatedField data type recursively For all `ManyRelatedField` objects, we were assuming that the inner type was always a `String`. While this may be true for the default output, a `ManyRelatedField` is a wrapper for a lot of other classes which includes more than just strings. This should allow us to document lists of things other than strings. * Added test for schemas for many-to-many fields This adds a test that makes sure we generate the schema for a many-to-many field such that it actually has the right type. For some reason we did not previously have any tests for schema generation that included them, so hopefully this will prevent any future issues from popping up. This should serve as a regression test for the `items` field on to-many relationships, which was previously forced to a `String` even though in most cases it is a different inner type within the array. --- rest_framework/schemas/inspectors.py | 4 ++- tests/test_schemas.py | 47 +++++++++++++++++++++++++++- 2 files changed, 49 insertions(+), 2 deletions(-) diff --git a/rest_framework/schemas/inspectors.py b/rest_framework/schemas/inspectors.py index a17a1f1aa..85142edce 100644 --- a/rest_framework/schemas/inspectors.py +++ b/rest_framework/schemas/inspectors.py @@ -51,8 +51,10 @@ def field_to_schema(field): description=description ) elif isinstance(field, serializers.ManyRelatedField): + related_field_schema = field_to_schema(field.child_relation) + return coreschema.Array( - items=coreschema.String(), + items=related_field_schema, title=title, description=description ) diff --git a/tests/test_schemas.py b/tests/test_schemas.py index d3bd43073..3cb9e0cda 100644 --- a/tests/test_schemas.py +++ b/tests/test_schemas.py @@ -24,7 +24,7 @@ from rest_framework.utils import formatting from rest_framework.views import APIView from rest_framework.viewsets import GenericViewSet, ModelViewSet -from .models import BasicModel, ForeignKeySource +from .models import BasicModel, ForeignKeySource, ManyToManySource factory = APIRequestFactory() @@ -701,6 +701,51 @@ class TestSchemaGeneratorWithForeignKey(TestCase): assert schema == expected +class ManyToManySourceSerializer(serializers.ModelSerializer): + class Meta: + model = ManyToManySource + fields = ('id', 'name', 'targets') + + +class ManyToManySourceView(generics.CreateAPIView): + queryset = ManyToManySource.objects.all() + serializer_class = ManyToManySourceSerializer + + +@unittest.skipUnless(coreapi, 'coreapi is not installed') +class TestSchemaGeneratorWithManyToMany(TestCase): + def setUp(self): + self.patterns = [ + url(r'^example/?$', ManyToManySourceView.as_view()), + ] + + def test_schema_for_regular_views(self): + """ + Ensure that AutoField many to many fields are output as Integer. + """ + generator = SchemaGenerator(title='Example API', patterns=self.patterns) + schema = generator.get_schema() + + expected = coreapi.Document( + url='', + title='Example API', + content={ + 'example': { + 'create': coreapi.Link( + url='/example/', + action='post', + encoding='application/json', + fields=[ + coreapi.Field('name', required=True, location='form', schema=coreschema.String(title='Name')), + coreapi.Field('targets', required=True, location='form', schema=coreschema.Array(title='Targets', items=coreschema.Integer())), + ] + ) + } + } + ) + assert schema == expected + + @unittest.skipUnless(coreapi, 'coreapi is not installed') class Test4605Regression(TestCase): def test_4605_regression(self): From bcdfcf7e493663d8738b9f07d59f9426b0cfb5a3 Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Thu, 7 Mar 2019 11:00:50 +0000 Subject: [PATCH 02/69] Sponsor updates (#6495) --- README.md | 10 ++++------ docs/img/premium/auklet-readme.png | Bin 48745 -> 0 bytes docs/img/premium/release-history.png | Bin 0 -> 18009 bytes docs/index.md | 6 ++---- 4 files changed, 6 insertions(+), 10 deletions(-) delete mode 100644 docs/img/premium/auklet-readme.png create mode 100644 docs/img/premium/release-history.png diff --git a/README.md b/README.md index 0309ee2bd..bb05b1d92 100644 --- a/README.md +++ b/README.md @@ -19,17 +19,15 @@ continued development by [signing up for a paid plan][funding]. The initial aim is to provide a single full-time position on REST framework. *Every single sign-up makes a significant impact towards making that possible.* -[![][rover-img]][rover-url] [![][sentry-img]][sentry-url] [![][stream-img]][stream-url] [![][rollbar-img]][rollbar-url] [![][cadre-img]][cadre-url] -[![][load-impact-img]][load-impact-url] [![][kloudless-img]][kloudless-url] -[![][auklet-img]][auklet-url] +[![][release-history-img]][release-history-url] [![][lightson-img]][lightson-url] -Many thanks to all our [wonderful sponsors][sponsors], and in particular to our premium backers, [Rover][rover-url], [Sentry][sentry-url], [Stream][stream-url], [Rollbar][rollbar-url], [Cadre][cadre-url], [Load Impact][load-impact-url], [Kloudless][kloudless-url], [Auklet][auklet-url], and [Lights On Software][lightson-url]. +Many thanks to all our [wonderful sponsors][sponsors], and in particular to our premium backers, [Sentry][sentry-url], [Stream][stream-url], [Rollbar][rollbar-url], [Cadre][cadre-url], [Kloudless][kloudless-url], [Release History][release-history-url], and [Lights On Software][lightson-url]. --- @@ -201,7 +199,7 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [cadre-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/cadre-readme.png [load-impact-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/load-impact-readme.png [kloudless-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/kloudless-readme.png -[auklet-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/auklet-readme.png +[release-history-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/release-history-readme.png [lightson-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/lightson-readme.png [rover-url]: http://jobs.rover.com/ @@ -211,7 +209,7 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [cadre-url]: https://cadre.com/ [load-impact-url]: https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf [kloudless-url]: https://hubs.ly/H0f30Lf0 -[auklet-url]: https://auklet.io/ +[release-history-url]: https://releasehistory.io [lightson-url]: https://lightsonsoftware.com [oauth1-section]: https://www.django-rest-framework.org/api-guide/authentication/#django-rest-framework-oauth diff --git a/docs/img/premium/auklet-readme.png b/docs/img/premium/auklet-readme.png deleted file mode 100644 index f55f7a70ea7e8a5b9ec6a9de62246606c21f1136..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 48745 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 MNn5c&!6xGW08Og_`v3p{ diff --git a/docs/img/premium/release-history.png b/docs/img/premium/release-history.png new file mode 100644 index 0000000000000000000000000000000000000000..b732b1ca23b8ce74f758ce03e90b4e0674ad425a GIT binary patch literal 18009 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 literal 0 HcmV?d00001 diff --git a/docs/index.md b/docs/index.md index c74b2caf0..9f5d3fa15 100644 --- a/docs/index.md +++ b/docs/index.md @@ -66,19 +66,17 @@ continued development by **[signing up for a paid plan][funding]**. *Every single sign-up helps us make REST framework long-term financially sustainable.*
-*Many thanks to all our [wonderful sponsors][sponsors], and in particular to our premium backers, [Rover](http://jobs.rover.com/), [Sentry](https://getsentry.com/welcome/), [Stream](https://getstream.io/?utm_source=drf&utm_medium=banner&utm_campaign=drf), [Auklet](https://auklet.io/), [Rollbar](https://rollbar.com), [Cadre](https://cadre.com), [Load Impact](https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf), [Kloudless](https://hubs.ly/H0f30Lf0), and [Lights On Software](https://lightsonsoftware.com).* +*Many thanks to all our [wonderful sponsors][sponsors], and in particular to our premium backers, [Sentry](https://getsentry.com/welcome/), [Stream](https://getstream.io/?utm_source=drf&utm_medium=banner&utm_campaign=drf), [Release History](https://releasehistory.io), [Rollbar](https://rollbar.com), [Cadre](https://cadre.com), [Kloudless](https://hubs.ly/H0f30Lf0), and [Lights On Software](https://lightsonsoftware.com).* --- From 9bfb58746ef813fefa6c2528f4b26e462a8ffc1f Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Thu, 7 Mar 2019 11:02:43 +0000 Subject: [PATCH 03/69] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bb05b1d92..66079edf0 100644 --- a/README.md +++ b/README.md @@ -199,7 +199,7 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [cadre-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/cadre-readme.png [load-impact-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/load-impact-readme.png [kloudless-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/kloudless-readme.png -[release-history-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/release-history-readme.png +[release-history-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/release-history.png [lightson-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/lightson-readme.png [rover-url]: http://jobs.rover.com/ From 6f24c21cfb1fa072c7bf2f36b54a63b51102f903 Mon Sep 17 00:00:00 2001 From: Matt Hegarty Date: Tue, 12 Mar 2019 11:46:02 +0000 Subject: [PATCH 04/69] Fixed typo: /Janurary/January/ (#6506) --- docs/community/release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index 288bf6d58..0f08342f5 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -62,7 +62,7 @@ You can determine your currently installed version using `pip show`: ### 3.9.1 -**Date**: [16th Janurary 2019][3.9.1-milestone] +**Date**: [16th January 2019][3.9.1-milestone] * Resolve XSS issue in browsable API. [#6330][gh6330] * Upgrade Bootstrap to 3.4.0 to resolve XSS issue. From d2d1888217e8cc5aba995edf522fec903b1f91be Mon Sep 17 00:00:00 2001 From: Ryan Siemens Date: Tue, 12 Mar 2019 21:15:12 -0700 Subject: [PATCH 05/69] Document DateTimeField default_timezone argument (#6469) --- docs/api-guide/fields.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/api-guide/fields.md b/docs/api-guide/fields.md index 74ce2251d..ede4f15ad 100644 --- a/docs/api-guide/fields.md +++ b/docs/api-guide/fields.md @@ -306,10 +306,11 @@ A date and time representation. Corresponds to `django.db.models.fields.DateTimeField`. -**Signature:** `DateTimeField(format=api_settings.DATETIME_FORMAT, input_formats=None)` +**Signature:** `DateTimeField(format=api_settings.DATETIME_FORMAT, input_formats=None, default_timezone=None)` * `format` - A string representing the output format. If not specified, this defaults to the same value as the `DATETIME_FORMAT` settings key, which will be `'iso-8601'` unless set. Setting to a format string indicates that `to_representation` return values should be coerced to string output. Format strings are described below. Setting this value to `None` indicates that Python `datetime` objects should be returned by `to_representation`. In this case the datetime encoding will be determined by the renderer. * `input_formats` - A list of strings representing the input formats which may be used to parse the date. If not specified, the `DATETIME_INPUT_FORMATS` setting will be used, which defaults to `['iso-8601']`. +* `default_timezone` - A `pytz.timezone` representing the timezone. If not specified and the `USE_TZ` setting is enabled, this defaults to the [current timezone][django-current-timezone]. If `USE_TZ` is disabled, then datetime objects will be naive. #### `DateTimeField` format strings. @@ -835,3 +836,4 @@ The [django-rest-framework-hstore][django-rest-framework-hstore] package provide [django-rest-framework-hstore]: https://github.com/djangonauts/django-rest-framework-hstore [django-hstore]: https://github.com/djangonauts/django-hstore [python-decimal-rounding-modes]: https://docs.python.org/3/library/decimal.html#rounding-modes +[django-current-timezone]: https://docs.djangoproject.com/en/stable/topics/i18n/timezones/#default-time-zone-and-current-time-zone From b25d245b893ce0a04c9ed33a12ebf6a6a1ff6b44 Mon Sep 17 00:00:00 2001 From: Patrickcai Date: Fri, 22 Mar 2019 20:29:45 +0800 Subject: [PATCH 06/69] Merge multiple isinstance() calls to one (#6513) * Merge multiple isinstance() calls to one See https://docs.python.org/3/library/functions.html#isinstance * Fix `)` mismatch Fix `)` mismatch --- rest_framework/utils/field_mapping.py | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/rest_framework/utils/field_mapping.py b/rest_framework/utils/field_mapping.py index f11b4b94e..927d08ff2 100644 --- a/rest_framework/utils/field_mapping.py +++ b/rest_framework/utils/field_mapping.py @@ -106,8 +106,7 @@ def get_field_kwargs(field_name, model_field): if model_field.null and not isinstance(model_field, models.NullBooleanField): kwargs['allow_null'] = True - if model_field.blank and (isinstance(model_field, models.CharField) or - isinstance(model_field, models.TextField)): + if model_field.blank and (isinstance(model_field, (models.CharField, models.TextField))): kwargs['allow_blank'] = True if isinstance(model_field, models.FilePathField): @@ -193,9 +192,7 @@ def get_field_kwargs(field_name, model_field): # Ensure that max_length is passed explicitly as a keyword arg, # rather than as a validator. max_length = getattr(model_field, 'max_length', None) - if max_length is not None and (isinstance(model_field, models.CharField) or - isinstance(model_field, models.TextField) or - isinstance(model_field, models.FileField)): + if max_length is not None and (isinstance(model_field, (models.CharField, models.TextField, models.FileField))): kwargs['max_length'] = max_length validator_kwarg = [ validator for validator in validator_kwarg From d784e4220762bd8efa6c99887ef1a1c43b51d52c Mon Sep 17 00:00:00 2001 From: Turfa Auliarachman Date: Tue, 26 Mar 2019 00:42:27 +0700 Subject: [PATCH 07/69] Fix `basename` deprecation warnings in tests (#6529) --- tests/test_renderers.py | 2 +- tests/test_routers.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/tests/test_renderers.py b/tests/test_renderers.py index b4c41b148..60a0c0307 100644 --- a/tests/test_renderers.py +++ b/tests/test_renderers.py @@ -636,7 +636,7 @@ class BrowsableAPIRendererTests(URLPatternsTestCase): raise NotImplementedError router = SimpleRouter() - router.register('examples', ExampleViewSet, base_name='example') + router.register('examples', ExampleViewSet, basename='example') urlpatterns = [url(r'^api/', include(router.urls))] def setUp(self): diff --git a/tests/test_routers.py b/tests/test_routers.py index a3a731f93..cca2ea712 100644 --- a/tests/test_routers.py +++ b/tests/test_routers.py @@ -121,7 +121,7 @@ class BasicViewSet(viewsets.ViewSet): class TestSimpleRouter(URLPatternsTestCase, TestCase): router = SimpleRouter() - router.register('basics', BasicViewSet, base_name='basic') + router.register('basics', BasicViewSet, basename='basic') urlpatterns = [ url(r'^api/', include(router.urls)), From ac19c695396cdd0a72b81dc5fece7a850ae3d1b2 Mon Sep 17 00:00:00 2001 From: Jabi Date: Thu, 28 Mar 2019 11:45:13 +0100 Subject: [PATCH 08/69] Corrected typo in permissions docs. (#6540) --- docs/api-guide/permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/permissions.md b/docs/api-guide/permissions.md index 6a1297e60..901f810c5 100644 --- a/docs/api-guide/permissions.md +++ b/docs/api-guide/permissions.md @@ -51,7 +51,7 @@ For example: --- **Note**: With the exception of `DjangoObjectPermissions`, the provided -permission classes in `rest_framework.permssions` **do not** implement the +permission classes in `rest_framework.permissions` **do not** implement the methods necessary to check object permissions. If you wish to use the provided permission classes in order to check object From 13b9b0fb98b58c867fa3ef625d75b6835b9c3b70 Mon Sep 17 00:00:00 2001 From: Asif Saif Uddin Date: Fri, 29 Mar 2019 02:19:06 +0600 Subject: [PATCH 09/69] Upgraded to Django 2.2rc1 on Tox (#6544) --- tox.ini | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tox.ini b/tox.ini index 4226f1a92..776af3b6e 100644 --- a/tox.ini +++ b/tox.ini @@ -25,7 +25,7 @@ deps = django111: Django>=1.11,<2.0 django20: Django>=2.0,<2.1 django21: Django>=2.1,<2.2 - django22: Django>=2.2b1,<3.0 + django22: Django>=2.2rc1,<3.0 djangomaster: https://github.com/django/django/archive/master.tar.gz -rrequirements/requirements-testing.txt -rrequirements/requirements-optionals.txt From f34a0a4e6a4de5d58c7abd365bd2343c228eb915 Mon Sep 17 00:00:00 2001 From: Matt Hegarty Date: Fri, 29 Mar 2019 06:32:25 +0000 Subject: [PATCH 10/69] Minor documentation fixes (#6543) --- docs/api-guide/schemas.md | 2 +- docs/tutorial/1-serialization.md | 3 +-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/api-guide/schemas.md b/docs/api-guide/schemas.md index 3d07ed621..b09b1606e 100644 --- a/docs/api-guide/schemas.md +++ b/docs/api-guide/schemas.md @@ -20,7 +20,7 @@ can render the schema into the commonly used YAML-based OpenAPI format. ## Quickstart -There are two different ways you can serve a schema description for you API. +There are two different ways you can serve a schema description for your API. ### Generating a schema with the `generateschema` management command diff --git a/docs/tutorial/1-serialization.md b/docs/tutorial/1-serialization.md index 07ee8f208..224ebf25b 100644 --- a/docs/tutorial/1-serialization.md +++ b/docs/tutorial/1-serialization.md @@ -8,7 +8,7 @@ The tutorial is fairly in-depth, so you should probably get a cookie and a cup o --- -**Note**: The code for this tutorial is available in the [tomchristie/rest-framework-tutorial][repo] repository on GitHub. The completed implementation is also online as a sandbox version for testing, [available here][sandbox]. +**Note**: The code for this tutorial is available in the [encode/rest-framework-tutorial][repo] repository on GitHub. The completed implementation is also online as a sandbox version for testing, [available here][sandbox]. --- @@ -218,7 +218,6 @@ Edit the `snippets/views.py` file, and add the following. from django.http import HttpResponse, JsonResponse from django.views.decorators.csrf import csrf_exempt - from rest_framework.renderers import JSONRenderer from rest_framework.parsers import JSONParser from snippets.models import Snippet from snippets.serializers import SnippetSerializer From b1122a441aeab5664b43351378b63e5dd87ab7a5 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Mon, 1 Apr 2019 16:30:26 +0200 Subject: [PATCH 11/69] Update tox to use Django 2.2 final. (#6556) --- tox.ini | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tox.ini b/tox.ini index 776af3b6e..5d7a4987e 100644 --- a/tox.ini +++ b/tox.ini @@ -25,7 +25,7 @@ deps = django111: Django>=1.11,<2.0 django20: Django>=2.0,<2.1 django21: Django>=2.1,<2.2 - django22: Django>=2.2rc1,<3.0 + django22: Django>=2.2,<3.0 djangomaster: https://github.com/django/django/archive/master.tar.gz -rrequirements/requirements-testing.txt -rrequirements/requirements-optionals.txt From cceb416098362a582132c1f9622e85d8775b894e Mon Sep 17 00:00:00 2001 From: jozo Date: Thu, 4 Apr 2019 11:31:08 +0200 Subject: [PATCH 12/69] Link DRF Condition (cache headers) third party package. (#6557) --- 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 0d36b8ee0..ace54f6f7 100644 --- a/docs/community/third-party-packages.md +++ b/docs/community/third-party-packages.md @@ -263,6 +263,7 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque * [django-rest-messaging][django-rest-messaging], [django-rest-messaging-centrifugo][django-rest-messaging-centrifugo] and [django-rest-messaging-js][django-rest-messaging-js] - A real-time pluggable messaging service using DRM. * [djangorest-alchemy][djangorest-alchemy] - SQLAlchemy support for REST framework. * [djangorestframework-datatables][djangorestframework-datatables] - Seamless integration between Django REST framework and [Datatables](https://datatables.net). +* [django-rest-framework-condition][django-rest-framework-condition] - Decorators for managing HTTP cache headers for Django REST framework (ETag and Last-modified). [cite]: http://www.software-ecosystems.com/Software_Ecosystems/Ecosystems.html [cookiecutter]: https://github.com/jpadilla/cookiecutter-django-rest-framework @@ -336,3 +337,4 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque [drfpasswordless]: https://github.com/aaronn/django-rest-framework-passwordless [djangorest-alchemy]: https://github.com/dealertrack/djangorest-alchemy [djangorestframework-datatables]: https://github.com/izimobil/django-rest-framework-datatables +[django-rest-framework-condition]: https://github.com/jozo/django-rest-framework-condition From 29cbe574a384c3bcc09434a3a9c5ff0cb7576b99 Mon Sep 17 00:00:00 2001 From: Asif Saif Uddin Date: Sat, 6 Apr 2019 03:27:07 +0600 Subject: [PATCH 13/69] Fix DeprecationWarning in tests (#6551) --- tests/test_filters.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tests/test_filters.py b/tests/test_filters.py index 088d25436..a53fa192a 100644 --- a/tests/test_filters.py +++ b/tests/test_filters.py @@ -172,11 +172,11 @@ class SearchFilterTests(TestCase): search_fields = ('$title', '$text') view = SearchListView.as_view() - request = factory.get('/', {'search': '^\w{3}$'}) + request = factory.get('/', {'search': r'^\w{3}$'}) response = view(request) assert len(response.data) == 10 - request = factory.get('/', {'search': '^\w{3}$', 'title_only': 'true'}) + request = factory.get('/', {'search': r'^\w{3}$', 'title_only': 'true'}) response = view(request) assert response.data == [ {'id': 3, 'title': 'zzz', 'text': 'cde'} From f8c4e5079ee580c354d75523882be184961c05ac Mon Sep 17 00:00:00 2001 From: Billy Rotich Date: Sat, 13 Apr 2019 15:02:19 +0200 Subject: [PATCH 14/69] Minor documentation fixes (#6581) --- docs/api-guide/serializers.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/api-guide/serializers.md b/docs/api-guide/serializers.md index e25053936..e77e78c15 100644 --- a/docs/api-guide/serializers.md +++ b/docs/api-guide/serializers.md @@ -572,6 +572,8 @@ This option is a dictionary, mapping field names to a dictionary of keyword argu user.save() return user +Please keep in mind that, if the field has already been explicitly declared on the serializer class, then the `extra_kwargs` option will be ignored. + ## Relational fields When serializing model instances, there are a number of different ways you might choose to represent relationships. The default representation for `ModelSerializer` is to use the primary keys of the related instances. From 1ac0f63aa9a6ceed5e4221926929117528af2714 Mon Sep 17 00:00:00 2001 From: Dmitry Alimov Date: Sun, 21 Apr 2019 19:27:13 +0300 Subject: [PATCH 15/69] Fix private attributes ignore in documentation (#6601) --- docs/api-guide/serializers.md | 2 +- docs/community/3.0-announcement.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api-guide/serializers.md b/docs/api-guide/serializers.md index e77e78c15..8c17adbaf 100644 --- a/docs/api-guide/serializers.md +++ b/docs/api-guide/serializers.md @@ -965,7 +965,7 @@ The following class is an example of a generic serializer that can handle coerci def to_representation(self, obj): for attribute_name in dir(obj): attribute = getattr(obj, attribute_name) - if attribute_name('_'): + if attribute_name.startswith('_'): # Ignore private attributes. pass elif hasattr(attribute, '__call__'): diff --git a/docs/community/3.0-announcement.md b/docs/community/3.0-announcement.md index dc118d70c..7a29b5554 100644 --- a/docs/community/3.0-announcement.md +++ b/docs/community/3.0-announcement.md @@ -523,7 +523,7 @@ The following class is an example of a generic serializer that can handle coerci def to_representation(self, obj): for attribute_name in dir(obj): attribute = getattr(obj, attribute_name) - if attribute_name('_'): + if attribute_name.startswith('_'): # Ignore private attributes. pass elif hasattr(attribute, '__call__'): From 95e28b2252b58e7d5d2e33ee5cb705029eb322c5 Mon Sep 17 00:00:00 2001 From: David Sanders Date: Sat, 27 Apr 2019 12:07:49 -0700 Subject: [PATCH 16/69] Fix typo in docs --- docs/api-guide/serializers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/serializers.md b/docs/api-guide/serializers.md index 8c17adbaf..feb5651f7 100644 --- a/docs/api-guide/serializers.md +++ b/docs/api-guide/serializers.md @@ -626,7 +626,7 @@ The default implementation returns a serializer class based on the `serializer_f Called to generate a serializer field that maps to a relational model field. -The default implementation returns a serializer class based on the `serializer_relational_field` attribute. +The default implementation returns a serializer class based on the `serializer_related_field` attribute. The `relation_info` argument is a named tuple, that contains `model_field`, `related_model`, `to_many` and `has_through_model` properties. From bf9859de51b8856014848b3c5eac45ade67b34dd Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Mon, 29 Apr 2019 16:08:39 +0200 Subject: [PATCH 17/69] Adjust django-guardian check for PY2 compatible version. (#6613) --- rest_framework/compat.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 9422e6ad5..d61ca5dbb 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -168,7 +168,12 @@ def is_guardian_installed(): """ django-guardian is optional and only imported if in INSTALLED_APPS. """ - if six.PY2: + try: + import guardian + except ImportError: + guardian = None + + if six.PY2 and (not guardian or guardian.VERSION >= (1, 5)): # Guardian 1.5.0, for Django 2.2 is NOT compatible with Python 2.7. # Remove when dropping PY2. return False From 83d09c7bc53c6c0b79e400fe05e1aff6788c2b2d Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Mon, 29 Apr 2019 16:30:44 +0200 Subject: [PATCH 18/69] Update version and release notes for v3.9.3. --- docs/community/release-notes.md | 13 +++++++++++++ rest_framework/__init__.py | 2 +- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index 0f08342f5..b61c5fb95 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -42,6 +42,16 @@ You can determine your currently installed version using `pip show`: ### 3.9.2 +**Date**: [29th April 2019] + +This is the last Django REST Framework release that will support Python 2. +Be sure to upgrade to Python 3 before upgrading to Django REST Framework 3.10. + +* Adjusted the compat check for django-guardian to allow the last guardian + version (v1.4.9) compatible with Python 2. [#6613][gh6613] + +### 3.9.2 + **Date**: [3rd March 2019][3.9.1-milestone] * Routers: invalidate `_urls` cache on `register()` [#6407][gh6407] @@ -2106,3 +2116,6 @@ For older release notes, [please see the version 2.x documentation][old-release- [gh6340]: https://github.com/encode/django-rest-framework/issues/6340 [gh6416]: https://github.com/encode/django-rest-framework/issues/6416 [gh6407]: https://github.com/encode/django-rest-framework/issues/6407 + + +[gh6613]: https://github.com/encode/django-rest-framework/issues/6613 diff --git a/rest_framework/__init__.py b/rest_framework/__init__.py index 55c06982d..53dc7bd47 100644 --- a/rest_framework/__init__.py +++ b/rest_framework/__init__.py @@ -8,7 +8,7 @@ ______ _____ _____ _____ __ """ __title__ = 'Django REST framework' -__version__ = '3.9.2' +__version__ = '3.9.3' __author__ = 'Tom Christie' __license__ = 'BSD 2-Clause' __copyright__ = 'Copyright 2011-2019 Encode OSS Ltd' From 7f16ed772720509b476e3cc4208c01b3972fa99b Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Mon, 29 Apr 2019 16:33:07 +0200 Subject: [PATCH 19/69] Correct version number in release notes. --- docs/community/release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index b61c5fb95..6fcb5bb6b 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -40,7 +40,7 @@ You can determine your currently installed version using `pip show`: ## 3.9.x series -### 3.9.2 +### 3.9.3 **Date**: [29th April 2019] From 1a0a8dde00187994bd4206e9d74219f148afc1c6 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 01:44:01 -0700 Subject: [PATCH 20/69] Correct misspelled module 'typing' (#6616) https://docs.python.org/3/library/typing.html --- tests/test_fields.py | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/tests/test_fields.py b/tests/test_fields.py index 12c936b22..42adedfed 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -19,9 +19,9 @@ from rest_framework.compat import ProhibitNullCharactersValidator from rest_framework.fields import DjangoImageField, is_simple_callable try: - import typings + import typing except ImportError: - typings = False + typing = False # Tests for helper functions. @@ -93,11 +93,12 @@ class TestIsSimpleCallable: assert is_simple_callable(ChoiceModel().get_choice_field_display) - @unittest.skipUnless(typings, 'requires python 3.5') + @unittest.skipUnless(typing, 'requires python 3.5') def test_type_annotation(self): # The annotation will otherwise raise a syntax error in python < 3.5 - exec("def valid(param: str='value'): pass", locals()) - valid = locals()['valid'] + locals = {} + exec("def valid(param: str='value'): pass", locals) + valid = locals['valid'] assert is_simple_callable(valid) From 908236a5767430ca293c71f4c2cc95a8347b1edb Mon Sep 17 00:00:00 2001 From: Jithesh Eriyakkadan Janardhanan Date: Tue, 30 Apr 2019 18:01:17 +0530 Subject: [PATCH 21/69] Correct misspelled class name --- docs/api-guide/validators.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/validators.md b/docs/api-guide/validators.md index 3b50442cc..ab042ac03 100644 --- a/docs/api-guide/validators.md +++ b/docs/api-guide/validators.md @@ -100,7 +100,7 @@ The validator should be applied to *serializer classes*, like so: --- -**Note**: The `UniqueTogetherValidation` class always imposes an implicit constraint that all the fields it applies to are always treated as required. Fields with `default` values are an exception to this as they always supply a value even when omitted from user input. +**Note**: The `UniqueTogetherValidator` class always imposes an implicit constraint that all the fields it applies to are always treated as required. Fields with `default` values are an exception to this as they always supply a value even when omitted from user input. --- From 0407a0df8a16fdac94bbd08d49143a74a88001cd Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Tue, 30 Apr 2019 17:53:44 +0200 Subject: [PATCH 22/69] Dropped Python 2 compatibility. (#6615) Thanks to Jon Dufresne (@jdufresne) for review. Co-authored-by: Asif Saif Uddin Co-authored-by: Rizwan Mansuri --- .travis.yml | 5 +- README.md | 2 +- docs/api-guide/fields.md | 4 +- rest_framework/authentication.py | 7 +- .../management/commands/drf_create_token.py | 4 +- .../authtoken/migrations/0001_initial.py | 3 - .../migrations/0002_auto_20160226_1747.py | 3 - rest_framework/authtoken/models.py | 4 +- rest_framework/compat.py | 58 +---- rest_framework/decorators.py | 5 +- rest_framework/exceptions.py | 26 +- rest_framework/fields.py | 226 ++++++++---------- rest_framework/filters.py | 11 +- rest_framework/generics.py | 2 - rest_framework/metadata.py | 4 +- rest_framework/mixins.py | 12 +- rest_framework/negotiation.py | 6 +- rest_framework/pagination.py | 20 +- rest_framework/parsers.py | 15 +- rest_framework/permissions.py | 6 +- rest_framework/relations.py | 51 ++-- rest_framework/renderers.py | 17 +- rest_framework/request.py | 13 +- rest_framework/response.py | 14 +- rest_framework/reverse.py | 5 +- rest_framework/routers.py | 15 +- rest_framework/schemas/generators.py | 9 +- rest_framework/schemas/inspectors.py | 15 +- rest_framework/schemas/views.py | 4 +- rest_framework/serializers.py | 33 ++- rest_framework/settings.py | 7 +- rest_framework/status.py | 1 - rest_framework/templatetags/rest_framework.py | 11 +- rest_framework/test.py | 54 ++--- rest_framework/throttling.py | 6 +- rest_framework/urlpatterns.py | 2 - rest_framework/urls.py | 2 - rest_framework/utils/breadcrumbs.py | 2 - rest_framework/utils/encoders.py | 10 +- rest_framework/utils/field_mapping.py | 2 +- rest_framework/utils/formatting.py | 2 - rest_framework/utils/json.py | 3 - rest_framework/utils/mediatypes.py | 6 +- rest_framework/utils/representation.py | 6 +- rest_framework/utils/serializer_helpers.py | 18 +- rest_framework/utils/urls.py | 19 +- rest_framework/validators.py | 21 +- rest_framework/versioning.py | 11 +- rest_framework/views.py | 4 +- rest_framework/viewsets.py | 6 +- runtests.py | 4 +- setup.cfg | 3 - setup.py | 36 ++- .../authentication/migrations/0001_initial.py | 3 - tests/authentication/models.py | 3 - tests/authentication/test_authentication.py | 11 +- tests/browsable_api/auth_urls.py | 2 - tests/browsable_api/no_auth_urls.py | 2 - tests/browsable_api/test_browsable_api.py | 2 - .../test_browsable_nested_api.py | 2 - tests/browsable_api/views.py | 2 - tests/generic_relations/models.py | 6 - .../test_generic_relations.py | 2 - tests/models.py | 2 - tests/test_api_client.py | 2 - tests/test_atomic_requests.py | 4 +- tests/test_authtoken.py | 3 +- tests/test_bound_fields.py | 4 +- tests/test_decorators.py | 2 - tests/test_description.py | 9 +- tests/test_encoders.py | 2 +- tests/test_exceptions.py | 11 +- tests/test_fields.py | 19 +- tests/test_filters.py | 6 +- tests/test_generateschema.py | 6 +- tests/test_generics.py | 13 +- tests/test_htmlrenderer.py | 20 +- tests/test_metadata.py | 2 - tests/test_middleware.py | 4 +- tests/test_model_serializer.py | 69 ++---- tests/test_multitable_inheritance.py | 2 - tests/test_negotiation.py | 4 +- tests/test_one_to_one_with_inheritance.py | 2 - tests/test_pagination.py | 26 +- tests/test_parsers.py | 8 +- tests/test_permissions.py | 9 +- tests/test_relations.py | 2 +- tests/test_relations_hyperlink.py | 2 - tests/test_relations_pk.py | 7 +- tests/test_renderers.py | 10 +- tests/test_request.py | 13 +- tests/test_requests_client.py | 2 - tests/test_response.py | 9 +- tests/test_reverse.py | 4 +- tests/test_routers.py | 2 - tests/test_schemas.py | 6 +- tests/test_serializer.py | 26 +- tests/test_serializer_bulk_update.py | 6 +- tests/test_settings.py | 2 - tests/test_status.py | 2 - tests/test_templatetags.py | 21 +- tests/test_testing.py | 7 +- tests/test_throttling.py | 3 +- tests/test_urlpatterns.py | 2 - tests/test_utils.py | 3 - tests/test_validation.py | 9 +- tests/test_validators.py | 8 +- tests/test_versioning.py | 4 +- tests/test_views.py | 8 +- tests/utils.py | 6 +- tox.ini | 5 +- 111 files changed, 473 insertions(+), 795 deletions(-) diff --git a/.travis.yml b/.travis.yml index 9543cb452..04a5ff99e 100644 --- a/.travis.yml +++ b/.travis.yml @@ -4,7 +4,6 @@ dist: xenial matrix: fast_finish: true include: - - { python: "2.7", env: DJANGO=1.11 } - { python: "3.4", env: DJANGO=1.11 } - { python: "3.4", env: DJANGO=2.0 } @@ -26,8 +25,8 @@ matrix: - { python: "3.7", env: DJANGO=master } - { python: "3.7", env: TOXENV=base } - - { python: "2.7", env: TOXENV=lint } - - { python: "2.7", env: TOXENV=docs } + - { python: "3.7", env: TOXENV=lint } + - { python: "3.7", env: TOXENV=docs } - python: "3.7" env: TOXENV=dist diff --git a/README.md b/README.md index 66079edf0..7d0bdd2ad 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,7 @@ There is a live example API for testing purposes, [available here][sandbox]. # Requirements -* Python (2.7, 3.4, 3.5, 3.6, 3.7) +* Python (3.4, 3.5, 3.6, 3.7) * Django (1.11, 2.0, 2.1, 2.2) We **highly recommend** and only officially support the latest patch release of diff --git a/docs/api-guide/fields.md b/docs/api-guide/fields.md index ede4f15ad..d371bb8fd 100644 --- a/docs/api-guide/fields.md +++ b/docs/api-guide/fields.md @@ -629,7 +629,7 @@ Our `ColorField` class above currently does not perform any data validation. To indicate invalid data, we should raise a `serializers.ValidationError`, like so: def to_internal_value(self, data): - if not isinstance(data, six.text_type): + if not isinstance(data, str): msg = 'Incorrect type. Expected a string, but got %s' raise ValidationError(msg % type(data).__name__) @@ -653,7 +653,7 @@ The `.fail()` method is a shortcut for raising `ValidationError` that takes a me } def to_internal_value(self, data): - if not isinstance(data, six.text_type): + if not isinstance(data, str): self.fail('incorrect_type', input_type=type(data).__name__) if not re.match(r'^rgb\([0-9]+,[0-9]+,[0-9]+\)$', data): diff --git a/rest_framework/authentication.py b/rest_framework/authentication.py index 25150d525..0612563e4 100644 --- a/rest_framework/authentication.py +++ b/rest_framework/authentication.py @@ -1,14 +1,11 @@ """ Provides various authentication policies. """ -from __future__ import unicode_literals - import base64 import binascii from django.contrib.auth import authenticate, get_user_model from django.middleware.csrf import CsrfViewMiddleware -from django.utils.six import text_type from django.utils.translation import ugettext_lazy as _ from rest_framework import HTTP_HEADER_ENCODING, exceptions @@ -21,7 +18,7 @@ def get_authorization_header(request): Hide some test client ickyness where the header can be unicode. """ auth = request.META.get('HTTP_AUTHORIZATION', b'') - if isinstance(auth, text_type): + if isinstance(auth, str): # Work around django test client oddness auth = auth.encode(HTTP_HEADER_ENCODING) return auth @@ -33,7 +30,7 @@ class CSRFCheck(CsrfViewMiddleware): return reason -class BaseAuthentication(object): +class BaseAuthentication: """ All authentication classes should extend BaseAuthentication. """ diff --git a/rest_framework/authtoken/management/commands/drf_create_token.py b/rest_framework/authtoken/management/commands/drf_create_token.py index 8e06812db..3d6539244 100644 --- a/rest_framework/authtoken/management/commands/drf_create_token.py +++ b/rest_framework/authtoken/management/commands/drf_create_token.py @@ -38,8 +38,8 @@ class Command(BaseCommand): token = self.create_user_token(username, reset_token) except UserModel.DoesNotExist: raise CommandError( - 'Cannot create the Token: user {0} does not exist'.format( + 'Cannot create the Token: user {} does not exist'.format( username) ) self.stdout.write( - 'Generated token {0} for user {1}'.format(token.key, username)) + 'Generated token {} for user {}'.format(token.key, username)) diff --git a/rest_framework/authtoken/migrations/0001_initial.py b/rest_framework/authtoken/migrations/0001_initial.py index 75780fedf..6a46ccfff 100644 --- a/rest_framework/authtoken/migrations/0001_initial.py +++ b/rest_framework/authtoken/migrations/0001_initial.py @@ -1,6 +1,3 @@ -# -*- coding: utf-8 -*- -from __future__ import unicode_literals - from django.conf import settings from django.db import migrations, models diff --git a/rest_framework/authtoken/migrations/0002_auto_20160226_1747.py b/rest_framework/authtoken/migrations/0002_auto_20160226_1747.py index 9f7e58e22..43119099a 100644 --- a/rest_framework/authtoken/migrations/0002_auto_20160226_1747.py +++ b/rest_framework/authtoken/migrations/0002_auto_20160226_1747.py @@ -1,6 +1,3 @@ -# -*- coding: utf-8 -*- -from __future__ import unicode_literals - from django.conf import settings from django.db import migrations, models diff --git a/rest_framework/authtoken/models.py b/rest_framework/authtoken/models.py index 7e96eff93..0ed02c415 100644 --- a/rest_framework/authtoken/models.py +++ b/rest_framework/authtoken/models.py @@ -3,11 +3,9 @@ import os from django.conf import settings from django.db import models -from django.utils.encoding import python_2_unicode_compatible from django.utils.translation import ugettext_lazy as _ -@python_2_unicode_compatible class Token(models.Model): """ The default authorization token model. @@ -32,7 +30,7 @@ class Token(models.Model): def save(self, *args, **kwargs): if not self.key: self.key = self.generate_key() - return super(Token, self).save(*args, **kwargs) + return super().save(*args, **kwargs) def generate_key(self): return binascii.hexlify(os.urandom(20)).decode() diff --git a/rest_framework/compat.py b/rest_framework/compat.py index d61ca5dbb..aad44e342 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -2,23 +2,13 @@ The `compat` module provides support for backwards compatibility with older versions of Django/Python, and compatibility wrappers around optional packages. """ - -from __future__ import unicode_literals - import sys +from collections.abc import Mapping, MutableMapping # noqa from django.conf import settings from django.core import validators -from django.utils import six from django.views.generic import View -try: - # Python 3 - from collections.abc import Mapping, MutableMapping # noqa -except ImportError: - # Python 2.7 - from collections import Mapping, MutableMapping # noqa - try: from django.urls import ( # noqa URLPattern, @@ -36,11 +26,6 @@ try: except ImportError: ProhibitNullCharactersValidator = None -try: - from unittest import mock -except ImportError: - mock = None - def get_original_route(urlpattern): """ @@ -89,23 +74,6 @@ def make_url_resolver(regex, urlpatterns): return URLResolver(regex, urlpatterns) -def unicode_repr(instance): - # Get the repr of an instance, but ensure it is a unicode string - # on both python 3 (already the case) and 2 (not the case). - if six.PY2: - return repr(instance).decode('utf-8') - return repr(instance) - - -def unicode_to_repr(value): - # Coerce a unicode string to the correct repr return type, depending on - # the Python version. We wrap all our `__repr__` implementations with - # this and then use unicode throughout internally. - if six.PY2: - return value.encode('utf-8') - return value - - def unicode_http_header(value): # Coerce HTTP header value to unicode. if isinstance(value, bytes): @@ -168,15 +136,6 @@ def is_guardian_installed(): """ django-guardian is optional and only imported if in INSTALLED_APPS. """ - try: - import guardian - except ImportError: - guardian = None - - if six.PY2 and (not guardian or guardian.VERSION >= (1, 5)): - # Guardian 1.5.0, for Django 2.2 is NOT compatible with Python 2.7. - # Remove when dropping PY2. - return False return 'guardian' in settings.INSTALLED_APPS @@ -289,17 +248,12 @@ except ImportError: # `separators` argument to `json.dumps()` differs between 2.x and 3.x # See: https://bugs.python.org/issue22767 -if six.PY3: - SHORT_SEPARATORS = (',', ':') - LONG_SEPARATORS = (', ', ': ') - INDENT_SEPARATORS = (',', ': ') -else: - SHORT_SEPARATORS = (b',', b':') - LONG_SEPARATORS = (b', ', b': ') - INDENT_SEPARATORS = (b',', b': ') +SHORT_SEPARATORS = (',', ':') +LONG_SEPARATORS = (', ', ': ') +INDENT_SEPARATORS = (',', ': ') -class CustomValidatorMessage(object): +class CustomValidatorMessage: """ We need to avoid evaluation of `lazy` translated `message` in `django.core.validators.BaseValidator.__init__`. https://github.com/django/django/blob/75ed5900321d170debef4ac452b8b3cf8a1c2384/django/core/validators.py#L297 @@ -309,7 +263,7 @@ class CustomValidatorMessage(object): def __init__(self, *args, **kwargs): self.message = kwargs.pop('message', self.message) - super(CustomValidatorMessage, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) class MinValueValidator(CustomValidatorMessage, validators.MinValueValidator): diff --git a/rest_framework/decorators.py b/rest_framework/decorators.py index 30bfcc4e5..5d7bd14a3 100644 --- a/rest_framework/decorators.py +++ b/rest_framework/decorators.py @@ -6,13 +6,10 @@ There are also various decorators for setting the API policies on function based views, as well as the `@detail_route` and `@list_route` decorators, which are used to annotate methods on viewsets that should be included by routers. """ -from __future__ import unicode_literals - import types import warnings from django.forms.utils import pretty_name -from django.utils import six from rest_framework import RemovedInDRF310Warning from rest_framework.views import APIView @@ -28,7 +25,7 @@ def api_view(http_method_names=None): def decorator(func): WrappedAPIView = type( - six.PY3 and 'WrappedAPIView' or b'WrappedAPIView', + 'WrappedAPIView', (APIView,), {'__doc__': func.__doc__} ) diff --git a/rest_framework/exceptions.py b/rest_framework/exceptions.py index f79b16129..8fbdfcd08 100644 --- a/rest_framework/exceptions.py +++ b/rest_framework/exceptions.py @@ -4,18 +4,14 @@ Handled exceptions raised by REST framework. In addition Django's built in 403 and 404 exceptions are handled. (`django.http.Http404` and `django.core.exceptions.PermissionDenied`) """ -from __future__ import unicode_literals - import math from django.http import JsonResponse -from django.utils import six from django.utils.encoding import force_text from django.utils.translation import ugettext_lazy as _ from django.utils.translation import ungettext from rest_framework import status -from rest_framework.compat import unicode_to_repr from rest_framework.utils.serializer_helpers import ReturnDict, ReturnList @@ -64,19 +60,19 @@ def _get_full_details(detail): } -class ErrorDetail(six.text_type): +class ErrorDetail(str): """ A string-like object that can additionally have a code. """ code = None def __new__(cls, string, code=None): - self = super(ErrorDetail, cls).__new__(cls, string) + self = super().__new__(cls, string) self.code = code return self def __eq__(self, other): - r = super(ErrorDetail, self).__eq__(other) + r = super().__eq__(other) try: return r and self.code == other.code except AttributeError: @@ -86,10 +82,10 @@ class ErrorDetail(six.text_type): return not self.__eq__(other) def __repr__(self): - return unicode_to_repr('ErrorDetail(string=%r, code=%r)' % ( - six.text_type(self), + return 'ErrorDetail(string=%r, code=%r)' % ( + str(self), self.code, - )) + ) def __hash__(self): return hash(str(self)) @@ -113,7 +109,7 @@ class APIException(Exception): self.detail = _get_error_details(detail, code) def __str__(self): - return six.text_type(self.detail) + return str(self.detail) def get_codes(self): """ @@ -196,7 +192,7 @@ class MethodNotAllowed(APIException): def __init__(self, method, detail=None, code=None): if detail is None: detail = force_text(self.default_detail).format(method=method) - super(MethodNotAllowed, self).__init__(detail, code) + super().__init__(detail, code) class NotAcceptable(APIException): @@ -206,7 +202,7 @@ class NotAcceptable(APIException): def __init__(self, detail=None, code=None, available_renderers=None): self.available_renderers = available_renderers - super(NotAcceptable, self).__init__(detail, code) + super().__init__(detail, code) class UnsupportedMediaType(APIException): @@ -217,7 +213,7 @@ class UnsupportedMediaType(APIException): def __init__(self, media_type, detail=None, code=None): if detail is None: detail = force_text(self.default_detail).format(media_type=media_type) - super(UnsupportedMediaType, self).__init__(detail, code) + super().__init__(detail, code) class Throttled(APIException): @@ -238,7 +234,7 @@ class Throttled(APIException): self.extra_detail_plural.format(wait=wait), wait)))) self.wait = wait - super(Throttled, self).__init__(detail, code) + super().__init__(detail, code) def server_error(request, *args, **kwargs): diff --git a/rest_framework/fields.py b/rest_framework/fields.py index c8f65db0e..ad9611e05 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import copy import datetime import decimal @@ -17,7 +15,7 @@ from django.core.validators import ( ) from django.forms import FilePathField as DjangoFilePathField from django.forms import ImageField as DjangoImageField -from django.utils import six, timezone +from django.utils import timezone from django.utils.dateparse import ( parse_date, parse_datetime, parse_duration, parse_time ) @@ -33,8 +31,7 @@ from pytz.exceptions import InvalidTimeError from rest_framework import ISO_8601 from rest_framework.compat import ( Mapping, MaxLengthValidator, MaxValueValidator, MinLengthValidator, - MinValueValidator, ProhibitNullCharactersValidator, unicode_repr, - unicode_to_repr + MinValueValidator, ProhibitNullCharactersValidator ) from rest_framework.exceptions import ErrorDetail, ValidationError from rest_framework.settings import api_settings @@ -51,39 +48,21 @@ class empty: pass -if six.PY3: - def is_simple_callable(obj): - """ - True if the object is a callable that takes no arguments. - """ - if not (inspect.isfunction(obj) or inspect.ismethod(obj) or isinstance(obj, functools.partial)): - return False +def is_simple_callable(obj): + """ + True if the object is a callable that takes no arguments. + """ + if not (inspect.isfunction(obj) or inspect.ismethod(obj) or isinstance(obj, functools.partial)): + return False - sig = inspect.signature(obj) - params = sig.parameters.values() - return all( - param.kind == param.VAR_POSITIONAL or - param.kind == param.VAR_KEYWORD or - param.default != param.empty - for param in params - ) - -else: - def is_simple_callable(obj): - function = inspect.isfunction(obj) - method = inspect.ismethod(obj) - - if not (function or method): - return False - - if method: - is_unbound = obj.im_self is None - - args, _, _, defaults = inspect.getargspec(obj) - - len_args = len(args) if function or is_unbound else len(args) - 1 - len_defaults = len(defaults) if defaults else 0 - return len_args <= len_defaults + sig = inspect.signature(obj) + params = sig.parameters.values() + return all( + param.kind == param.VAR_POSITIONAL or + param.kind == param.VAR_KEYWORD or + param.default != param.empty + for param in params + ) def get_attribute(instance, attrs): @@ -108,7 +87,7 @@ def get_attribute(instance, attrs): # If we raised an Attribute or KeyError here it'd get treated # as an omitted field in `Field.get_attribute()`. Instead we # raise a ValueError to ensure the exception is not masked. - raise ValueError('Exception raised in callable attribute "{0}"; original exception was: {1}'.format(attr, exc)) + raise ValueError('Exception raised in callable attribute "{}"; original exception was: {}'.format(attr, exc)) return instance @@ -185,18 +164,18 @@ def iter_options(grouped_choices, cutoff=None, cutoff_text=None): """ Helper function for options and option groups in templates. """ - class StartOptionGroup(object): + class StartOptionGroup: start_option_group = True end_option_group = False def __init__(self, label): self.label = label - class EndOptionGroup(object): + class EndOptionGroup: start_option_group = False end_option_group = True - class Option(object): + class Option: start_option_group = False end_option_group = False @@ -251,7 +230,7 @@ def get_error_detail(exc_info): } -class CreateOnlyDefault(object): +class CreateOnlyDefault: """ This class may be used to provide default values that are only used for create operations, but that do not return any value for update @@ -273,12 +252,10 @@ class CreateOnlyDefault(object): return self.default def __repr__(self): - return unicode_to_repr( - '%s(%s)' % (self.__class__.__name__, unicode_repr(self.default)) - ) + return '%s(%s)' % (self.__class__.__name__, repr(self.default)) -class CurrentUserDefault(object): +class CurrentUserDefault: def set_context(self, serializer_field): self.user = serializer_field.context['request'].user @@ -286,7 +263,7 @@ class CurrentUserDefault(object): return self.user def __repr__(self): - return unicode_to_repr('%s()' % self.__class__.__name__) + return '%s()' % self.__class__.__name__ class SkipField(Exception): @@ -305,7 +282,7 @@ MISSING_ERROR_MESSAGE = ( ) -class Field(object): +class Field: _creation_counter = 0 default_error_messages = { @@ -618,7 +595,7 @@ class Field(object): When a field is instantiated, we store the arguments that were used, so that we can present a helpful representation of the object. """ - instance = super(Field, cls).__new__(cls) + instance = super().__new__(cls) instance._args = args instance._kwargs = kwargs return instance @@ -647,7 +624,7 @@ class Field(object): This allows us to create descriptive representations for serializer instances that show all the declared fields on the serializer. """ - return unicode_to_repr(representation.field_repr(self)) + return representation.field_repr(self) # Boolean types... @@ -724,7 +701,7 @@ class NullBooleanField(Field): def __init__(self, **kwargs): assert 'allow_null' not in kwargs, '`allow_null` is not a valid option.' kwargs['allow_null'] = True - super(NullBooleanField, self).__init__(**kwargs) + super().__init__(**kwargs) def to_internal_value(self, data): try: @@ -764,17 +741,14 @@ class CharField(Field): self.trim_whitespace = kwargs.pop('trim_whitespace', True) self.max_length = kwargs.pop('max_length', None) self.min_length = kwargs.pop('min_length', None) - super(CharField, self).__init__(**kwargs) + super().__init__(**kwargs) if self.max_length is not None: - message = lazy( - self.error_messages['max_length'].format, - six.text_type)(max_length=self.max_length) + message = lazy(self.error_messages['max_length'].format, str)(max_length=self.max_length) self.validators.append( MaxLengthValidator(self.max_length, message=message)) if self.min_length is not None: message = lazy( - self.error_messages['min_length'].format, - six.text_type)(min_length=self.min_length) + self.error_messages['min_length'].format, str)(min_length=self.min_length) self.validators.append( MinLengthValidator(self.min_length, message=message)) @@ -786,23 +760,23 @@ class CharField(Field): # Test for the empty string here so that it does not get validated, # and so that subclasses do not need to handle it explicitly # inside the `to_internal_value()` method. - if data == '' or (self.trim_whitespace and six.text_type(data).strip() == ''): + if data == '' or (self.trim_whitespace and str(data).strip() == ''): if not self.allow_blank: self.fail('blank') return '' - return super(CharField, self).run_validation(data) + return super().run_validation(data) def to_internal_value(self, data): # We're lenient with allowing basic numerics to be coerced into strings, # but other types should fail. Eg. unclear if booleans should represent as `true` or `True`, # and composites such as lists are likely user error. - if isinstance(data, bool) or not isinstance(data, six.string_types + six.integer_types + (float,)): + if isinstance(data, bool) or not isinstance(data, (str, int, float,)): self.fail('invalid') - value = six.text_type(data) + value = str(data) return value.strip() if self.trim_whitespace else value def to_representation(self, value): - return six.text_type(value) + return str(value) class EmailField(CharField): @@ -811,7 +785,7 @@ class EmailField(CharField): } def __init__(self, **kwargs): - super(EmailField, self).__init__(**kwargs) + super().__init__(**kwargs) validator = EmailValidator(message=self.error_messages['invalid']) self.validators.append(validator) @@ -822,7 +796,7 @@ class RegexField(CharField): } def __init__(self, regex, **kwargs): - super(RegexField, self).__init__(**kwargs) + super().__init__(**kwargs) validator = RegexValidator(regex, message=self.error_messages['invalid']) self.validators.append(validator) @@ -834,7 +808,7 @@ class SlugField(CharField): } def __init__(self, allow_unicode=False, **kwargs): - super(SlugField, self).__init__(**kwargs) + super().__init__(**kwargs) self.allow_unicode = allow_unicode if self.allow_unicode: validator = RegexValidator(re.compile(r'^[-\w]+\Z', re.UNICODE), message=self.error_messages['invalid_unicode']) @@ -849,7 +823,7 @@ class URLField(CharField): } def __init__(self, **kwargs): - super(URLField, self).__init__(**kwargs) + super().__init__(**kwargs) validator = URLValidator(message=self.error_messages['invalid']) self.validators.append(validator) @@ -866,16 +840,16 @@ class UUIDField(Field): if self.uuid_format not in self.valid_formats: raise ValueError( 'Invalid format for uuid representation. ' - 'Must be one of "{0}"'.format('", "'.join(self.valid_formats)) + 'Must be one of "{}"'.format('", "'.join(self.valid_formats)) ) - super(UUIDField, self).__init__(**kwargs) + super().__init__(**kwargs) def to_internal_value(self, data): if not isinstance(data, uuid.UUID): try: - if isinstance(data, six.integer_types): + if isinstance(data, int): return uuid.UUID(int=data) - elif isinstance(data, six.string_types): + elif isinstance(data, str): return uuid.UUID(hex=data) else: self.fail('invalid', value=data) @@ -900,12 +874,12 @@ class IPAddressField(CharField): def __init__(self, protocol='both', **kwargs): self.protocol = protocol.lower() self.unpack_ipv4 = (self.protocol == 'both') - super(IPAddressField, self).__init__(**kwargs) + super().__init__(**kwargs) validators, error_message = ip_address_validators(protocol, self.unpack_ipv4) self.validators.extend(validators) def to_internal_value(self, data): - if not isinstance(data, six.string_types): + if not isinstance(data, str): self.fail('invalid', value=data) if ':' in data: @@ -915,7 +889,7 @@ class IPAddressField(CharField): except DjangoValidationError: self.fail('invalid', value=data) - return super(IPAddressField, self).to_internal_value(data) + return super().to_internal_value(data) # Number types... @@ -933,22 +907,20 @@ class IntegerField(Field): def __init__(self, **kwargs): self.max_value = kwargs.pop('max_value', None) self.min_value = kwargs.pop('min_value', None) - super(IntegerField, self).__init__(**kwargs) + super().__init__(**kwargs) if self.max_value is not None: message = lazy( - self.error_messages['max_value'].format, - six.text_type)(max_value=self.max_value) + self.error_messages['max_value'].format, str)(max_value=self.max_value) self.validators.append( MaxValueValidator(self.max_value, message=message)) if self.min_value is not None: message = lazy( - self.error_messages['min_value'].format, - six.text_type)(min_value=self.min_value) + self.error_messages['min_value'].format, str)(min_value=self.min_value) self.validators.append( MinValueValidator(self.min_value, message=message)) def to_internal_value(self, data): - if isinstance(data, six.text_type) and len(data) > self.MAX_STRING_LENGTH: + if isinstance(data, str) and len(data) > self.MAX_STRING_LENGTH: self.fail('max_string_length') try: @@ -973,23 +945,23 @@ class FloatField(Field): def __init__(self, **kwargs): self.max_value = kwargs.pop('max_value', None) self.min_value = kwargs.pop('min_value', None) - super(FloatField, self).__init__(**kwargs) + super().__init__(**kwargs) if self.max_value is not None: message = lazy( self.error_messages['max_value'].format, - six.text_type)(max_value=self.max_value) + str)(max_value=self.max_value) self.validators.append( MaxValueValidator(self.max_value, message=message)) if self.min_value is not None: message = lazy( self.error_messages['min_value'].format, - six.text_type)(min_value=self.min_value) + str)(min_value=self.min_value) self.validators.append( MinValueValidator(self.min_value, message=message)) def to_internal_value(self, data): - if isinstance(data, six.text_type) and len(data) > self.MAX_STRING_LENGTH: + if isinstance(data, str) and len(data) > self.MAX_STRING_LENGTH: self.fail('max_string_length') try: @@ -1031,18 +1003,17 @@ class DecimalField(Field): else: self.max_whole_digits = None - super(DecimalField, self).__init__(**kwargs) + super().__init__(**kwargs) if self.max_value is not None: message = lazy( self.error_messages['max_value'].format, - six.text_type)(max_value=self.max_value) + str)(max_value=self.max_value) self.validators.append( MaxValueValidator(self.max_value, message=message)) if self.min_value is not None: message = lazy( - self.error_messages['min_value'].format, - six.text_type)(min_value=self.min_value) + self.error_messages['min_value'].format, str)(min_value=self.min_value) self.validators.append( MinValueValidator(self.min_value, message=message)) @@ -1121,7 +1092,7 @@ class DecimalField(Field): coerce_to_string = getattr(self, 'coerce_to_string', api_settings.COERCE_DECIMAL_TO_STRING) if not isinstance(value, decimal.Decimal): - value = decimal.Decimal(six.text_type(value).strip()) + value = decimal.Decimal(str(value).strip()) quantized = self.quantize(value) @@ -1130,7 +1101,7 @@ class DecimalField(Field): if self.localize: return localize_input(quantized) - return '{0:f}'.format(quantized) + return '{:f}'.format(quantized) def quantize(self, value): """ @@ -1167,7 +1138,7 @@ class DateTimeField(Field): self.input_formats = input_formats if default_timezone is not None: self.timezone = default_timezone - super(DateTimeField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def enforce_timezone(self, value): """ @@ -1226,7 +1197,7 @@ class DateTimeField(Field): output_format = getattr(self, 'format', api_settings.DATETIME_FORMAT) - if output_format is None or isinstance(value, six.string_types): + if output_format is None or isinstance(value, str): return value value = self.enforce_timezone(value) @@ -1251,7 +1222,7 @@ class DateField(Field): self.format = format if input_formats is not None: self.input_formats = input_formats - super(DateField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def to_internal_value(self, value): input_formats = getattr(self, 'input_formats', api_settings.DATE_INPUT_FORMATS) @@ -1288,7 +1259,7 @@ class DateField(Field): output_format = getattr(self, 'format', api_settings.DATE_FORMAT) - if output_format is None or isinstance(value, six.string_types): + if output_format is None or isinstance(value, str): return value # Applying a `DateField` to a datetime value is almost always @@ -1317,7 +1288,7 @@ class TimeField(Field): self.format = format if input_formats is not None: self.input_formats = input_formats - super(TimeField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def to_internal_value(self, value): input_formats = getattr(self, 'input_formats', api_settings.TIME_INPUT_FORMATS) @@ -1351,7 +1322,7 @@ class TimeField(Field): output_format = getattr(self, 'format', api_settings.TIME_FORMAT) - if output_format is None or isinstance(value, six.string_types): + if output_format is None or isinstance(value, str): return value # Applying a `TimeField` to a datetime value is almost always @@ -1378,24 +1349,24 @@ class DurationField(Field): def __init__(self, **kwargs): self.max_value = kwargs.pop('max_value', None) self.min_value = kwargs.pop('min_value', None) - super(DurationField, self).__init__(**kwargs) + super().__init__(**kwargs) if self.max_value is not None: message = lazy( self.error_messages['max_value'].format, - six.text_type)(max_value=self.max_value) + str)(max_value=self.max_value) self.validators.append( MaxValueValidator(self.max_value, message=message)) if self.min_value is not None: message = lazy( self.error_messages['min_value'].format, - six.text_type)(min_value=self.min_value) + str)(min_value=self.min_value) self.validators.append( MinValueValidator(self.min_value, message=message)) def to_internal_value(self, value): if isinstance(value, datetime.timedelta): return value - parsed = parse_duration(six.text_type(value)) + parsed = parse_duration(str(value)) if parsed is not None: return parsed self.fail('invalid', format='[DD] [HH:[MM:]]ss[.uuuuuu]') @@ -1420,21 +1391,21 @@ class ChoiceField(Field): self.allow_blank = kwargs.pop('allow_blank', False) - super(ChoiceField, self).__init__(**kwargs) + super().__init__(**kwargs) def to_internal_value(self, data): if data == '' and self.allow_blank: return '' try: - return self.choice_strings_to_values[six.text_type(data)] + return self.choice_strings_to_values[str(data)] except KeyError: self.fail('invalid_choice', input=data) def to_representation(self, value): if value in ('', None): return value - return self.choice_strings_to_values.get(six.text_type(value), value) + return self.choice_strings_to_values.get(str(value), value) def iter_options(self): """ @@ -1457,7 +1428,7 @@ class ChoiceField(Field): # Allows us to deal with eg. integer choices while supporting either # integer or string input, but still get the correct datatype out. self.choice_strings_to_values = { - six.text_type(key): key for key in self.choices + str(key): key for key in self.choices } choices = property(_get_choices, _set_choices) @@ -1473,7 +1444,7 @@ class MultipleChoiceField(ChoiceField): def __init__(self, *args, **kwargs): self.allow_empty = kwargs.pop('allow_empty', True) - super(MultipleChoiceField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def get_value(self, dictionary): if self.field_name not in dictionary: @@ -1486,7 +1457,7 @@ class MultipleChoiceField(ChoiceField): return dictionary.get(self.field_name, empty) def to_internal_value(self, data): - if isinstance(data, six.text_type) or not hasattr(data, '__iter__'): + if isinstance(data, str) or not hasattr(data, '__iter__'): self.fail('not_a_list', input_type=type(data).__name__) if not self.allow_empty and len(data) == 0: self.fail('empty') @@ -1498,7 +1469,7 @@ class MultipleChoiceField(ChoiceField): def to_representation(self, value): return { - self.choice_strings_to_values.get(six.text_type(item), item) for item in value + self.choice_strings_to_values.get(str(item), item) for item in value } @@ -1516,7 +1487,7 @@ class FilePathField(ChoiceField): allow_folders=allow_folders, required=required ) kwargs['choices'] = field.choices - super(FilePathField, self).__init__(**kwargs) + super().__init__(**kwargs) # File types... @@ -1535,7 +1506,7 @@ class FileField(Field): self.allow_empty_file = kwargs.pop('allow_empty_file', False) if 'use_url' in kwargs: self.use_url = kwargs.pop('use_url') - super(FileField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def to_internal_value(self, data): try: @@ -1581,13 +1552,13 @@ class ImageField(FileField): def __init__(self, *args, **kwargs): self._DjangoImageField = kwargs.pop('_DjangoImageField', DjangoImageField) - super(ImageField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def to_internal_value(self, data): # Image validation is a bit grungy, so we'll just outright # defer to Django's implementation so we don't need to # consider it, or treat PIL as a test dependency. - file_object = super(ImageField, self).to_internal_value(data) + file_object = super().to_internal_value(data) django_field = self._DjangoImageField() django_field.error_messages = self.error_messages return django_field.clean(file_object) @@ -1597,7 +1568,7 @@ class ImageField(FileField): class _UnvalidatedField(Field): def __init__(self, *args, **kwargs): - super(_UnvalidatedField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) self.allow_blank = True self.allow_null = True @@ -1630,7 +1601,7 @@ class ListField(Field): "Remove `source=` from the field declaration." ) - super(ListField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) self.child.bind(field_name='', parent=self) if self.max_length is not None: message = self.error_messages['max_length'].format(max_length=self.max_length) @@ -1660,7 +1631,7 @@ class ListField(Field): """ if html.is_html_input(data): data = html.parse_html_list(data, default=[]) - if isinstance(data, (six.text_type, Mapping)) or not hasattr(data, '__iter__'): + if isinstance(data, (str, Mapping)) or not hasattr(data, '__iter__'): self.fail('not_a_list', input_type=type(data).__name__) if not self.allow_empty and len(data) == 0: self.fail('empty') @@ -1703,7 +1674,7 @@ class DictField(Field): "Remove `source=` from the field declaration." ) - super(DictField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) self.child.bind(field_name='', parent=self) def get_value(self, dictionary): @@ -1725,7 +1696,7 @@ class DictField(Field): def to_representation(self, value): return { - six.text_type(key): self.child.to_representation(val) if val is not None else None + str(key): self.child.to_representation(val) if val is not None else None for key, val in value.items() } @@ -1734,7 +1705,7 @@ class DictField(Field): errors = OrderedDict() for key, value in data.items(): - key = six.text_type(key) + key = str(key) try: result[key] = self.child.run_validation(value) @@ -1750,7 +1721,7 @@ class HStoreField(DictField): child = CharField(allow_blank=True, allow_null=True) def __init__(self, *args, **kwargs): - super(HStoreField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) assert isinstance(self.child, CharField), ( "The `child` argument must be an instance of `CharField`, " "as the hstore extension stores values as strings." @@ -1764,15 +1735,15 @@ class JSONField(Field): def __init__(self, *args, **kwargs): self.binary = kwargs.pop('binary', False) - super(JSONField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def get_value(self, dictionary): if html.is_html_input(dictionary) and self.field_name in dictionary: # When HTML form input is used, mark up the input # as being a JSON string, rather than a JSON primitive. - class JSONString(six.text_type): + class JSONString(str): def __new__(self, value): - ret = six.text_type.__new__(self, value) + ret = str.__new__(self, value) ret.is_json_string = True return ret return JSONString(dictionary[self.field_name]) @@ -1795,7 +1766,7 @@ class JSONField(Field): value = json.dumps(value) # On python 2.x the return type for json.dumps() is underspecified. # On python 3.x json.dumps() returns unicode strings. - if isinstance(value, six.text_type): + if isinstance(value, str): value = bytes(value.encode('utf-8')) return value @@ -1817,7 +1788,7 @@ class ReadOnlyField(Field): def __init__(self, **kwargs): kwargs['read_only'] = True - super(ReadOnlyField, self).__init__(**kwargs) + super().__init__(**kwargs) def to_representation(self, value): return value @@ -1834,7 +1805,7 @@ class HiddenField(Field): def __init__(self, **kwargs): assert 'default' in kwargs, 'default is a required argument.' kwargs['write_only'] = True - super(HiddenField, self).__init__(**kwargs) + super().__init__(**kwargs) def get_value(self, dictionary): # We always use the default value for `HiddenField`. @@ -1864,7 +1835,7 @@ class SerializerMethodField(Field): self.method_name = method_name kwargs['source'] = '*' kwargs['read_only'] = True - super(SerializerMethodField, self).__init__(**kwargs) + super().__init__(**kwargs) def bind(self, field_name, parent): # In order to enforce a consistent style, we error if a redundant @@ -1882,7 +1853,7 @@ class SerializerMethodField(Field): if self.method_name is None: self.method_name = default_method_name - super(SerializerMethodField, self).bind(field_name, parent) + super().bind(field_name, parent) def to_representation(self, value): method = getattr(self.parent, self.method_name) @@ -1905,11 +1876,10 @@ class ModelField(Field): # The `max_length` option is supported by Django's base `Field` class, # so we'd better support it here. max_length = kwargs.pop('max_length', None) - super(ModelField, self).__init__(**kwargs) + super().__init__(**kwargs) if max_length is not None: message = lazy( - self.error_messages['max_length'].format, - six.text_type)(max_length=self.max_length) + self.error_messages['max_length'].format, str)(max_length=self.max_length) self.validators.append( MaxLengthValidator(self.max_length, message=message)) diff --git a/rest_framework/filters.py b/rest_framework/filters.py index bb1b86586..b77069ddc 100644 --- a/rest_framework/filters.py +++ b/rest_framework/filters.py @@ -2,8 +2,6 @@ Provides generic filtering backends that can be used to filter the results returned by list views. """ -from __future__ import unicode_literals - import operator import warnings from functools import reduce @@ -13,7 +11,6 @@ from django.db import models from django.db.models.constants import LOOKUP_SEP from django.db.models.sql.constants import ORDER_PATTERN from django.template import loader -from django.utils import six from django.utils.encoding import force_text from django.utils.translation import ugettext_lazy as _ @@ -24,7 +21,7 @@ from rest_framework.compat import ( from rest_framework.settings import api_settings -class BaseFilterBackend(object): +class BaseFilterBackend: """ A base class from which all filter backend classes should inherit. """ @@ -109,7 +106,7 @@ class SearchFilter(BaseFilterBackend): return queryset orm_lookups = [ - self.construct_search(six.text_type(search_field)) + self.construct_search(str(search_field)) for search_field in search_fields ] @@ -188,7 +185,7 @@ class OrderingFilter(BaseFilterBackend): def get_default_ordering(self, view): ordering = getattr(view, 'ordering', None) - if isinstance(ordering, six.string_types): + if isinstance(ordering, str): return (ordering,) return ordering @@ -237,7 +234,7 @@ class OrderingFilter(BaseFilterBackend): ] else: valid_fields = [ - (item, item) if isinstance(item, six.string_types) else item + (item, item) if isinstance(item, str) else item for item in valid_fields ] diff --git a/rest_framework/generics.py b/rest_framework/generics.py index 8d0bf284a..c39b02ab7 100644 --- a/rest_framework/generics.py +++ b/rest_framework/generics.py @@ -1,8 +1,6 @@ """ Generic views that provide commonly needed behaviour. """ -from __future__ import unicode_literals - from django.core.exceptions import ValidationError from django.db.models.query import QuerySet from django.http import Http404 diff --git a/rest_framework/metadata.py b/rest_framework/metadata.py index 9f9324469..42442f91c 100644 --- a/rest_framework/metadata.py +++ b/rest_framework/metadata.py @@ -6,8 +6,6 @@ some fairly ad-hoc information about the view. Future implementations might use JSON schema or other definitions in order to return this information in a more standardized way. """ -from __future__ import unicode_literals - from collections import OrderedDict from django.core.exceptions import PermissionDenied @@ -19,7 +17,7 @@ from rest_framework.request import clone_request from rest_framework.utils.field_mapping import ClassLookupDict -class BaseMetadata(object): +class BaseMetadata: def determine_metadata(self, request, view): """ Return a dictionary of metadata about the view. diff --git a/rest_framework/mixins.py b/rest_framework/mixins.py index de10d6930..7fa8947cb 100644 --- a/rest_framework/mixins.py +++ b/rest_framework/mixins.py @@ -4,14 +4,12 @@ Basic building blocks for generic class based views. We don't bind behaviour to http method handlers yet, which allows mixin classes to be composed in interesting ways. """ -from __future__ import unicode_literals - from rest_framework import status from rest_framework.response import Response from rest_framework.settings import api_settings -class CreateModelMixin(object): +class CreateModelMixin: """ Create a model instance. """ @@ -32,7 +30,7 @@ class CreateModelMixin(object): return {} -class ListModelMixin(object): +class ListModelMixin: """ List a queryset. """ @@ -48,7 +46,7 @@ class ListModelMixin(object): return Response(serializer.data) -class RetrieveModelMixin(object): +class RetrieveModelMixin: """ Retrieve a model instance. """ @@ -58,7 +56,7 @@ class RetrieveModelMixin(object): return Response(serializer.data) -class UpdateModelMixin(object): +class UpdateModelMixin: """ Update a model instance. """ @@ -84,7 +82,7 @@ class UpdateModelMixin(object): return self.update(request, *args, **kwargs) -class DestroyModelMixin(object): +class DestroyModelMixin: """ Destroy a model instance. """ diff --git a/rest_framework/negotiation.py b/rest_framework/negotiation.py index ca1b59f12..76113a827 100644 --- a/rest_framework/negotiation.py +++ b/rest_framework/negotiation.py @@ -2,8 +2,6 @@ Content negotiation deals with selecting an appropriate renderer given the incoming request. Typically this will be based on the request's Accept header. """ -from __future__ import unicode_literals - from django.http import Http404 from rest_framework import HTTP_HEADER_ENCODING, exceptions @@ -13,7 +11,7 @@ from rest_framework.utils.mediatypes import ( ) -class BaseContentNegotiation(object): +class BaseContentNegotiation: def select_parser(self, request, parsers): raise NotImplementedError('.select_parser() must be implemented') @@ -66,7 +64,7 @@ class DefaultContentNegotiation(BaseContentNegotiation): # Accepted media type is 'application/json' full_media_type = ';'.join( (renderer.media_type,) + - tuple('{0}={1}'.format( + tuple('{}={}'.format( key, value.decode(HTTP_HEADER_ENCODING)) for key, value in media_type_wrapper.params.items())) return renderer, full_media_type diff --git a/rest_framework/pagination.py b/rest_framework/pagination.py index b11d7cdf3..fcc78da43 100644 --- a/rest_framework/pagination.py +++ b/rest_framework/pagination.py @@ -1,19 +1,15 @@ -# coding: utf-8 """ Pagination serializers determine the structure of the output that should be used for paginated responses. """ -from __future__ import unicode_literals - from base64 import b64decode, b64encode from collections import OrderedDict, namedtuple +from urllib import parse from django.core.paginator import InvalidPage from django.core.paginator import Paginator as DjangoPaginator from django.template import loader -from django.utils import six from django.utils.encoding import force_text -from django.utils.six.moves.urllib import parse as urlparse from django.utils.translation import ugettext_lazy as _ from rest_framework.compat import coreapi, coreschema @@ -133,7 +129,7 @@ PageLink = namedtuple('PageLink', ['url', 'number', 'is_active', 'is_break']) PAGE_BREAK = PageLink(url=None, number=None, is_active=False, is_break=True) -class BasePagination(object): +class BasePagination: display_page_controls = False def paginate_queryset(self, queryset, request, view=None): # pragma: no cover @@ -204,7 +200,7 @@ class PageNumberPagination(BasePagination): self.page = paginator.page(page_number) except InvalidPage as exc: msg = self.invalid_page_message.format( - page_number=page_number, message=six.text_type(exc) + page_number=page_number, message=str(exc) ) raise NotFound(msg) @@ -716,13 +712,13 @@ class CursorPagination(BasePagination): 'nearly-unique field on the model, such as "-created" or "pk".' ) - assert isinstance(ordering, (six.string_types, list, tuple)), ( + assert isinstance(ordering, (str, list, tuple)), ( 'Invalid ordering. Expected string or tuple, but got {type}'.format( type=type(ordering).__name__ ) ) - if isinstance(ordering, six.string_types): + if isinstance(ordering, str): return (ordering,) return tuple(ordering) @@ -737,7 +733,7 @@ class CursorPagination(BasePagination): try: querystring = b64decode(encoded.encode('ascii')).decode('ascii') - tokens = urlparse.parse_qs(querystring, keep_blank_values=True) + tokens = parse.parse_qs(querystring, keep_blank_values=True) offset = tokens.get('o', ['0'])[0] offset = _positive_int(offset, cutoff=self.offset_cutoff) @@ -763,7 +759,7 @@ class CursorPagination(BasePagination): if cursor.position is not None: tokens['p'] = cursor.position - querystring = urlparse.urlencode(tokens, doseq=True) + querystring = parse.urlencode(tokens, doseq=True) encoded = b64encode(querystring.encode('ascii')).decode('ascii') return replace_query_param(self.base_url, self.cursor_query_param, encoded) @@ -773,7 +769,7 @@ class CursorPagination(BasePagination): attr = instance[field_name] else: attr = getattr(instance, field_name) - return six.text_type(attr) + return str(attr) def get_paginated_response(self, data): return Response(OrderedDict([ diff --git a/rest_framework/parsers.py b/rest_framework/parsers.py index 35d0d1aa7..5b5e3f158 100644 --- a/rest_framework/parsers.py +++ b/rest_framework/parsers.py @@ -4,9 +4,8 @@ Parsers are used to parse the content of incoming HTTP requests. They give us a generic way of being able to handle various media types on the request, such as form content or json encoded data. """ -from __future__ import unicode_literals - import codecs +from urllib import parse from django.conf import settings from django.core.files.uploadhandler import StopFutureHandlers @@ -15,9 +14,7 @@ from django.http.multipartparser import ChunkIter from django.http.multipartparser import \ MultiPartParser as DjangoMultiPartParser from django.http.multipartparser import MultiPartParserError, parse_header -from django.utils import six from django.utils.encoding import force_text -from django.utils.six.moves.urllib import parse as urlparse from rest_framework import renderers from rest_framework.exceptions import ParseError @@ -25,13 +22,13 @@ from rest_framework.settings import api_settings from rest_framework.utils import json -class DataAndFiles(object): +class DataAndFiles: def __init__(self, data, files): self.data = data self.files = files -class BaseParser(object): +class BaseParser: """ All parsers should extend `BaseParser`, specifying a `media_type` attribute, and overriding the `.parse()` method. @@ -67,7 +64,7 @@ class JSONParser(BaseParser): parse_constant = json.strict_constant if self.strict else None return json.load(decoded_stream, parse_constant=parse_constant) except ValueError as exc: - raise ParseError('JSON parse error - %s' % six.text_type(exc)) + raise ParseError('JSON parse error - %s' % str(exc)) class FormParser(BaseParser): @@ -113,7 +110,7 @@ class MultiPartParser(BaseParser): data, files = parser.parse() return DataAndFiles(data, files) except MultiPartParserError as exc: - raise ParseError('Multipart form parse error - %s' % six.text_type(exc)) + raise ParseError('Multipart form parse error - %s' % str(exc)) class FileUploadParser(BaseParser): @@ -221,7 +218,7 @@ class FileUploadParser(BaseParser): encoded_filename = force_text(filename_parm['filename*']) try: charset, lang, filename = encoded_filename.split('\'', 2) - filename = urlparse.unquote(filename) + filename = parse.unquote(filename) except (ValueError, LookupError): filename = force_text(filename_parm['filename']) return filename diff --git a/rest_framework/permissions.py b/rest_framework/permissions.py index 5d75f54ba..3a8c58064 100644 --- a/rest_framework/permissions.py +++ b/rest_framework/permissions.py @@ -1,10 +1,7 @@ """ Provides a set of pluggable permission policies. """ -from __future__ import unicode_literals - from django.http import Http404 -from django.utils import six from rest_framework import exceptions @@ -101,8 +98,7 @@ class BasePermissionMetaclass(OperationHolderMixin, type): pass -@six.add_metaclass(BasePermissionMetaclass) -class BasePermission(object): +class BasePermission(metaclass=BasePermissionMetaclass): """ A base class from which all permission classes should inherit. """ diff --git a/rest_framework/relations.py b/rest_framework/relations.py index 31c1e7561..76c4d7008 100644 --- a/rest_framework/relations.py +++ b/rest_framework/relations.py @@ -1,18 +1,12 @@ -# coding: utf-8 -from __future__ import unicode_literals - import sys from collections import OrderedDict +from urllib import parse from django.core.exceptions import ImproperlyConfigured, ObjectDoesNotExist from django.db.models import Manager from django.db.models.query import QuerySet from django.urls import NoReverseMatch, Resolver404, get_script_prefix, resolve -from django.utils import six -from django.utils.encoding import ( - python_2_unicode_compatible, smart_text, uri_to_iri -) -from django.utils.six.moves.urllib import parse as urlparse +from django.utils.encoding import smart_text, uri_to_iri from django.utils.translation import ugettext_lazy as _ from rest_framework.fields import ( @@ -46,14 +40,14 @@ class ObjectTypeError(TypeError): """ -class Hyperlink(six.text_type): +class Hyperlink(str): """ A string like object that additionally has an associated name. We use this for hyperlinked URLs that may render as a named link in some contexts, or render as a plain URL in others. """ def __new__(self, url, obj): - ret = six.text_type.__new__(self, url) + ret = str.__new__(self, url) ret.obj = obj return ret @@ -65,13 +59,12 @@ class Hyperlink(six.text_type): # This ensures that we only called `__str__` lazily, # as in some cases calling __str__ on a model instances *might* # involve a database lookup. - return six.text_type(self.obj) + return str(self.obj) is_hyperlink = True -@python_2_unicode_compatible -class PKOnlyObject(object): +class PKOnlyObject: """ This is a mock object, used for when we only need the pk of the object instance, but still want to return an object with a .pk attribute, @@ -121,14 +114,14 @@ class RelatedField(Field): ) kwargs.pop('many', None) kwargs.pop('allow_empty', None) - super(RelatedField, self).__init__(**kwargs) + super().__init__(**kwargs) def __new__(cls, *args, **kwargs): # We override this method in order to automagically create # `ManyRelatedField` classes instead when `many=True` is set. if kwargs.pop('many', False): return cls.many_init(*args, **kwargs) - return super(RelatedField, cls).__new__(cls, *args, **kwargs) + return super().__new__(cls, *args, **kwargs) @classmethod def many_init(cls, *args, **kwargs): @@ -157,7 +150,7 @@ class RelatedField(Field): # We force empty strings to None values for relational fields. if data == '': data = None - return super(RelatedField, self).run_validation(data) + return super().run_validation(data) def get_queryset(self): queryset = self.queryset @@ -189,7 +182,7 @@ class RelatedField(Field): pass # Standard case, return the object instance. - return super(RelatedField, self).get_attribute(instance) + return super().get_attribute(instance) def get_choices(self, cutoff=None): queryset = self.get_queryset() @@ -225,7 +218,7 @@ class RelatedField(Field): ) def display_value(self, instance): - return six.text_type(instance) + return str(instance) class StringRelatedField(RelatedField): @@ -236,10 +229,10 @@ class StringRelatedField(RelatedField): def __init__(self, **kwargs): kwargs['read_only'] = True - super(StringRelatedField, self).__init__(**kwargs) + super().__init__(**kwargs) def to_representation(self, value): - return six.text_type(value) + return str(value) class PrimaryKeyRelatedField(RelatedField): @@ -251,7 +244,7 @@ class PrimaryKeyRelatedField(RelatedField): def __init__(self, **kwargs): self.pk_field = kwargs.pop('pk_field', None) - super(PrimaryKeyRelatedField, self).__init__(**kwargs) + super().__init__(**kwargs) def use_pk_only_optimization(self): return True @@ -297,7 +290,7 @@ class HyperlinkedRelatedField(RelatedField): # implicit `self` argument to be passed. self.reverse = reverse - super(HyperlinkedRelatedField, self).__init__(**kwargs) + super().__init__(**kwargs) def use_pk_only_optimization(self): return self.lookup_field == 'pk' @@ -317,10 +310,10 @@ class HyperlinkedRelatedField(RelatedField): return queryset.get(**lookup_kwargs) except ValueError: exc = ObjectValueError(str(sys.exc_info()[1])) - six.reraise(type(exc), exc, sys.exc_info()[2]) + raise exc.with_traceback(sys.exc_info()[2]) except TypeError: exc = ObjectTypeError(str(sys.exc_info()[1])) - six.reraise(type(exc), exc, sys.exc_info()[2]) + raise exc.with_traceback(sys.exc_info()[2]) def get_url(self, obj, view_name, request, format): """ @@ -346,7 +339,7 @@ class HyperlinkedRelatedField(RelatedField): if http_prefix: # If needed convert absolute URLs to relative path - data = urlparse.urlparse(data).path + data = parse.urlparse(data).path prefix = get_script_prefix() if data.startswith(prefix): data = '/' + data[len(prefix):] @@ -432,7 +425,7 @@ class HyperlinkedIdentityField(HyperlinkedRelatedField): assert view_name is not None, 'The `view_name` argument is required.' kwargs['read_only'] = True kwargs['source'] = '*' - super(HyperlinkedIdentityField, self).__init__(view_name, **kwargs) + super().__init__(view_name, **kwargs) def use_pk_only_optimization(self): # We have the complete object instance already. We don't need @@ -453,7 +446,7 @@ class SlugRelatedField(RelatedField): def __init__(self, slug_field=None, **kwargs): assert slug_field is not None, 'The `slug_field` argument is required.' self.slug_field = slug_field - super(SlugRelatedField, self).__init__(**kwargs) + super().__init__(**kwargs) def to_internal_value(self, data): try: @@ -502,7 +495,7 @@ class ManyRelatedField(Field): self.html_cutoff_text or _(api_settings.HTML_SELECT_CUTOFF_TEXT) ) assert child_relation is not None, '`child_relation` is a required argument.' - super(ManyRelatedField, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) self.child_relation.bind(field_name='', parent=self) def get_value(self, dictionary): @@ -518,7 +511,7 @@ class ManyRelatedField(Field): return dictionary.get(self.field_name, empty) def to_internal_value(self, data): - if isinstance(data, six.text_type) or not hasattr(data, '__iter__'): + if isinstance(data, str) or not hasattr(data, '__iter__'): self.fail('not_a_list', input_type=type(data).__name__) if not self.allow_empty and len(data) == 0: self.fail('empty') diff --git a/rest_framework/renderers.py b/rest_framework/renderers.py index f043e6327..eb5da008b 100644 --- a/rest_framework/renderers.py +++ b/rest_framework/renderers.py @@ -6,10 +6,9 @@ on the response, such as JSON encoded data or HTML output. REST framework also provides an HTML renderer that renders the browsable API. """ -from __future__ import unicode_literals - import base64 from collections import OrderedDict +from urllib import parse from django import forms from django.conf import settings @@ -19,9 +18,7 @@ from django.http.multipartparser import parse_header from django.template import engines, loader from django.test.client import encode_multipart from django.urls import NoReverseMatch -from django.utils import six from django.utils.html import mark_safe -from django.utils.six.moves.urllib import parse as urlparse from rest_framework import VERSION, exceptions, serializers, status from rest_framework.compat import ( @@ -40,7 +37,7 @@ def zero_as_none(value): return None if value == 0 else value -class BaseRenderer(object): +class BaseRenderer: """ All renderers should extend this class, setting the `media_type` and `format` attributes, and override the `.render()` method. @@ -111,7 +108,7 @@ class JSONRenderer(BaseRenderer): # but if ensure_ascii=False, the return type is underspecified, # and may (or may not) be unicode. # On python 3.x json.dumps() returns unicode strings. - if isinstance(ret, six.text_type): + if isinstance(ret, str): # We always fully escape \u2028 and \u2029 to ensure we output JSON # that is a strict javascript subset. If bytes were returned # by json.dumps() then we don't have these characters in any case. @@ -349,7 +346,7 @@ class HTMLFormRenderer(BaseRenderer): # Get a clone of the field with text-only value representation. field = field.as_form_field() - if style.get('input_type') == 'datetime-local' and isinstance(field.value, six.text_type): + if style.get('input_type') == 'datetime-local' and isinstance(field.value, str): field.value = field.value.rstrip('Z') if 'template' in style: @@ -791,7 +788,7 @@ class AdminRenderer(BrowsableAPIRenderer): """ Render the HTML for the browsable API representation. """ - context = super(AdminRenderer, self).get_context( + context = super().get_context( data, accepted_media_type, renderer_context ) @@ -995,14 +992,14 @@ class _BaseOpenAPIRenderer: tag = None for name, link in document.links.items(): - path = urlparse.urlparse(link.url).path + path = parse.urlparse(link.url).path method = link.action.lower() paths.setdefault(path, {}) paths[path][method] = self.get_operation(link, name, tag=tag) for tag, section in document.data.items(): for name, link in section.links.items(): - path = urlparse.urlparse(link.url).path + path = parse.urlparse(link.url).path method = link.action.lower() paths.setdefault(path, {}) paths[path][method] = self.get_operation(link, name, tag=tag) diff --git a/rest_framework/request.py b/rest_framework/request.py index a6d92e2bd..ec4b749c2 100644 --- a/rest_framework/request.py +++ b/rest_framework/request.py @@ -8,8 +8,6 @@ The wrapped request then offers a richer API, in particular : - full support of PUT method, including support for file uploads - form overloading of HTTP method, content type and content """ -from __future__ import unicode_literals - import io import sys from contextlib import contextmanager @@ -18,7 +16,6 @@ from django.conf import settings from django.http import HttpRequest, QueryDict from django.http.multipartparser import parse_header from django.http.request import RawPostDataException -from django.utils import six from django.utils.datastructures import MultiValueDict from rest_framework import HTTP_HEADER_ENCODING, exceptions @@ -34,7 +31,7 @@ def is_form_media_type(media_type): base_media_type == 'multipart/form-data') -class override_method(object): +class override_method: """ A context manager that temporarily overrides the method on a request, additionally setting the `view.request` attribute. @@ -78,10 +75,10 @@ def wrap_attributeerrors(): except AttributeError: info = sys.exc_info() exc = WrappedAttributeError(str(info[1])) - six.reraise(type(exc), exc, info[2]) + raise exc.with_traceback(info[2]) -class Empty(object): +class Empty: """ Placeholder for unset attributes. Cannot use `None`, as that may be a valid value. @@ -126,7 +123,7 @@ def clone_request(request, method): return ret -class ForcedAuthentication(object): +class ForcedAuthentication: """ This authentication class is used if the test client or request factory forcibly authenticated the request. @@ -140,7 +137,7 @@ class ForcedAuthentication(object): return (self.force_user, self.force_token) -class Request(object): +class Request: """ Wrapper allowing to enhance a standard `HttpRequest` instance. diff --git a/rest_framework/response.py b/rest_framework/response.py index bf0663255..db7977770 100644 --- a/rest_framework/response.py +++ b/rest_framework/response.py @@ -4,11 +4,9 @@ it is initialized with unrendered data, instead of a pre-rendered string. The appropriate renderer is called during Django's template response rendering. """ -from __future__ import unicode_literals +from http.client import responses from django.template.response import SimpleTemplateResponse -from django.utils import six -from django.utils.six.moves.http_client import responses from rest_framework.serializers import Serializer @@ -29,7 +27,7 @@ class Response(SimpleTemplateResponse): Setting 'renderer' and 'media_type' will typically be deferred, For example being set automatically by the `APIView`. """ - super(Response, self).__init__(None, status=status) + super().__init__(None, status=status) if isinstance(data, Serializer): msg = ( @@ -45,7 +43,7 @@ class Response(SimpleTemplateResponse): self.content_type = content_type if headers: - for name, value in six.iteritems(headers): + for name, value in headers.items(): self[name] = value @property @@ -64,13 +62,13 @@ class Response(SimpleTemplateResponse): content_type = self.content_type if content_type is None and charset is not None: - content_type = "{0}; charset={1}".format(media_type, charset) + content_type = "{}; charset={}".format(media_type, charset) elif content_type is None: content_type = media_type self['Content-Type'] = content_type ret = renderer.render(self.data, accepted_media_type, context) - if isinstance(ret, six.text_type): + if isinstance(ret, str): assert charset, ( 'renderer returned unicode, and did not specify ' 'a charset value.' @@ -94,7 +92,7 @@ class Response(SimpleTemplateResponse): """ Remove attributes from the response that shouldn't be cached. """ - state = super(Response, self).__getstate__() + state = super().__getstate__() for key in ( 'accepted_renderer', 'renderer_context', 'resolver_match', 'client', 'request', 'json', 'wsgi_request' diff --git a/rest_framework/reverse.py b/rest_framework/reverse.py index e9cf737f1..55bf74af1 100644 --- a/rest_framework/reverse.py +++ b/rest_framework/reverse.py @@ -1,11 +1,8 @@ """ Provide urlresolver functions that return fully qualified URLs or view names """ -from __future__ import unicode_literals - from django.urls import NoReverseMatch from django.urls import reverse as django_reverse -from django.utils import six from django.utils.functional import lazy from rest_framework.settings import api_settings @@ -66,4 +63,4 @@ def _reverse(viewname, args=None, kwargs=None, request=None, format=None, **extr return url -reverse_lazy = lazy(reverse, six.text_type) +reverse_lazy = lazy(reverse, str) diff --git a/rest_framework/routers.py b/rest_framework/routers.py index 1cacea181..9334706f8 100644 --- a/rest_framework/routers.py +++ b/rest_framework/routers.py @@ -13,8 +13,6 @@ For example, you might have a `urls.py` that looks something like this: urlpatterns = router.urls """ -from __future__ import unicode_literals - import itertools import warnings from collections import OrderedDict, namedtuple @@ -22,7 +20,6 @@ from collections import OrderedDict, namedtuple from django.conf.urls import url from django.core.exceptions import ImproperlyConfigured from django.urls import NoReverseMatch -from django.utils import six from django.utils.deprecation import RenameMethodsBase from rest_framework import ( @@ -39,7 +36,7 @@ Route = namedtuple('Route', ['url', 'mapping', 'name', 'detail', 'initkwargs']) DynamicRoute = namedtuple('DynamicRoute', ['url', 'name', 'detail', 'initkwargs']) -class DynamicDetailRoute(object): +class DynamicDetailRoute: def __new__(cls, url, name, initkwargs): warnings.warn( "`DynamicDetailRoute` is deprecated and will be removed in 3.10 " @@ -50,7 +47,7 @@ class DynamicDetailRoute(object): return DynamicRoute(url, name, True, initkwargs) -class DynamicListRoute(object): +class DynamicListRoute: def __new__(cls, url, name, initkwargs): warnings.warn( "`DynamicListRoute` is deprecated and will be removed in 3.10 in " @@ -83,7 +80,7 @@ class RenameRouterMethods(RenameMethodsBase): ) -class BaseRouter(six.with_metaclass(RenameRouterMethods)): +class BaseRouter(metaclass=RenameRouterMethods): def __init__(self): self.registry = [] @@ -173,7 +170,7 @@ class SimpleRouter(BaseRouter): def __init__(self, trailing_slash=True): self.trailing_slash = '/' if trailing_slash else '' - super(SimpleRouter, self).__init__() + super().__init__() def get_default_basename(self, viewset): """ @@ -365,7 +362,7 @@ class DefaultRouter(SimpleRouter): self.root_renderers = kwargs.pop('root_renderers') else: self.root_renderers = list(api_settings.DEFAULT_RENDERER_CLASSES) - super(DefaultRouter, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def get_api_root_view(self, api_urls=None): """ @@ -383,7 +380,7 @@ class DefaultRouter(SimpleRouter): Generate the list of URL patterns, including a default root view for the API, and appending `.json` style format suffixes. """ - urls = super(DefaultRouter, self).get_urls() + urls = super().get_urls() if self.include_root_view: view = self.get_api_root_view(api_urls=urls) diff --git a/rest_framework/schemas/generators.py b/rest_framework/schemas/generators.py index db226a6c1..b8da446f7 100644 --- a/rest_framework/schemas/generators.py +++ b/rest_framework/schemas/generators.py @@ -11,7 +11,6 @@ from django.conf import settings from django.contrib.admindocs.views import simplify_regex from django.core.exceptions import PermissionDenied from django.http import Http404 -from django.utils import six from rest_framework import exceptions from rest_framework.compat import ( @@ -68,7 +67,7 @@ class LinkNode(OrderedDict): def __init__(self): self.links = [] self.methods_counter = Counter() - super(LinkNode, self).__init__() + super().__init__() def get_available_key(self, preferred_key): if preferred_key not in self: @@ -140,7 +139,7 @@ _PATH_PARAMETER_COMPONENT_RE = re.compile( ) -class EndpointEnumerator(object): +class EndpointEnumerator: """ A class to determine the available API endpoints that a project exposes. """ @@ -151,7 +150,7 @@ class EndpointEnumerator(object): urlconf = settings.ROOT_URLCONF # Load the given URLconf module - if isinstance(urlconf, six.string_types): + if isinstance(urlconf, str): urls = import_module(urlconf) else: urls = urlconf @@ -232,7 +231,7 @@ class EndpointEnumerator(object): return [method for method in methods if method not in ('OPTIONS', 'HEAD')] -class SchemaGenerator(object): +class SchemaGenerator: # Map HTTP methods onto actions. default_mapping = { 'get': 'retrieve', diff --git a/rest_framework/schemas/inspectors.py b/rest_framework/schemas/inspectors.py index 85142edce..91d8405eb 100644 --- a/rest_framework/schemas/inspectors.py +++ b/rest_framework/schemas/inspectors.py @@ -1,4 +1,3 @@ -# -*- coding: utf-8 -*- """ inspectors.py # Per-endpoint view introspection @@ -7,11 +6,11 @@ See schemas.__init__.py for package overview. import re import warnings from collections import OrderedDict +from urllib import parse from weakref import WeakKeyDictionary from django.db import models from django.utils.encoding import force_text, smart_text -from django.utils.six.moves.urllib import parse as urlparse from django.utils.translation import ugettext_lazy as _ from rest_framework import exceptions, serializers @@ -125,7 +124,7 @@ def get_pk_description(model, model_field): ) -class ViewInspector(object): +class ViewInspector: """ Descriptor class on APIView. @@ -207,7 +206,7 @@ class AutoSchema(ViewInspector): * `manual_fields`: list of `coreapi.Field` instances that will be added to auto-generated fields, overwriting on `Field.name` """ - super(AutoSchema, self).__init__() + super().__init__() if manual_fields is None: manual_fields = [] self._manual_fields = manual_fields @@ -232,7 +231,7 @@ class AutoSchema(ViewInspector): path = path[1:] return coreapi.Link( - url=urlparse.urljoin(base_url, path), + url=parse.urljoin(base_url, path), action=method.lower(), encoding=encoding, fields=fields, @@ -475,7 +474,7 @@ class ManualSchema(ViewInspector): * `fields`: list of `coreapi.Field` instances. * `description`: String description for view. Optional. """ - super(ManualSchema, self).__init__() + super().__init__() assert all(isinstance(f, coreapi.Field) for f in fields), "`fields` must be a list of coreapi.Field instances" self._fields = fields self._description = description @@ -487,7 +486,7 @@ class ManualSchema(ViewInspector): path = path[1:] return coreapi.Link( - url=urlparse.urljoin(base_url, path), + url=parse.urljoin(base_url, path), action=method.lower(), encoding=self._encoding, fields=self._fields, @@ -498,7 +497,7 @@ class ManualSchema(ViewInspector): class DefaultSchema(ViewInspector): """Allows overriding AutoSchema using DEFAULT_SCHEMA_CLASS setting""" def __get__(self, instance, owner): - result = super(DefaultSchema, self).__get__(instance, owner) + result = super().__get__(instance, owner) if not isinstance(result, DefaultSchema): return result diff --git a/rest_framework/schemas/views.py b/rest_framework/schemas/views.py index f5e327a94..fa5cdbdc7 100644 --- a/rest_framework/schemas/views.py +++ b/rest_framework/schemas/views.py @@ -17,7 +17,7 @@ class SchemaView(APIView): public = False def __init__(self, *args, **kwargs): - super(SchemaView, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) if self.renderer_classes is None: self.renderer_classes = [ renderers.OpenAPIRenderer, @@ -38,4 +38,4 @@ class SchemaView(APIView): self.renderer_classes = api_settings.DEFAULT_RENDERER_CLASSES neg = self.perform_content_negotiation(self.request, force=True) self.request.accepted_renderer, self.request.accepted_media_type = neg - return super(SchemaView, self).handle_exception(exc) + return super().handle_exception(exc) diff --git a/rest_framework/serializers.py b/rest_framework/serializers.py index 9830edb3f..90b31e068 100644 --- a/rest_framework/serializers.py +++ b/rest_framework/serializers.py @@ -10,8 +10,6 @@ python primitives. 2. The process of marshalling between python primitives and request and response content is handled by parsers and renderers. """ -from __future__ import unicode_literals - import copy import inspect import traceback @@ -23,11 +21,11 @@ from django.db import models from django.db.models import DurationField as ModelDurationField from django.db.models.fields import Field as DjangoModelField from django.db.models.fields import FieldDoesNotExist -from django.utils import six, timezone +from django.utils import timezone from django.utils.functional import cached_property from django.utils.translation import ugettext_lazy as _ -from rest_framework.compat import Mapping, postgres_fields, unicode_to_repr +from rest_framework.compat import Mapping, postgres_fields from rest_framework.exceptions import ErrorDetail, ValidationError from rest_framework.fields import get_error_detail, set_value from rest_framework.settings import api_settings @@ -115,14 +113,14 @@ class BaseSerializer(Field): self.partial = kwargs.pop('partial', False) self._context = kwargs.pop('context', {}) kwargs.pop('many', None) - super(BaseSerializer, self).__init__(**kwargs) + super().__init__(**kwargs) def __new__(cls, *args, **kwargs): # We override this method in order to automagically create # `ListSerializer` classes instead when `many=True` is set. if kwargs.pop('many', False): return cls.many_init(*args, **kwargs) - return super(BaseSerializer, cls).__new__(cls, *args, **kwargs) + return super().__new__(cls, *args, **kwargs) @classmethod def many_init(cls, *args, **kwargs): @@ -315,7 +313,7 @@ class SerializerMetaclass(type): def __new__(cls, name, bases, attrs): attrs['_declared_fields'] = cls._get_declared_fields(bases, attrs) - return super(SerializerMetaclass, cls).__new__(cls, name, bases, attrs) + return super().__new__(cls, name, bases, attrs) def as_serializer_error(exc): @@ -344,8 +342,7 @@ def as_serializer_error(exc): } -@six.add_metaclass(SerializerMetaclass) -class Serializer(BaseSerializer): +class Serializer(BaseSerializer, metaclass=SerializerMetaclass): default_error_messages = { 'invalid': _('Invalid data. Expected a dictionary, but got {datatype}.') } @@ -466,7 +463,7 @@ class Serializer(BaseSerializer): to_validate.update(value) else: to_validate = value - super(Serializer, self).run_validators(to_validate) + super().run_validators(to_validate) def to_internal_value(self, data): """ @@ -535,7 +532,7 @@ class Serializer(BaseSerializer): return attrs def __repr__(self): - return unicode_to_repr(representation.serializer_repr(self, indent=1)) + return representation.serializer_repr(self, indent=1) # The following are used for accessing `BoundField` instances on the # serializer, for the purposes of presenting a form-like API onto the @@ -560,12 +557,12 @@ class Serializer(BaseSerializer): @property def data(self): - ret = super(Serializer, self).data + ret = super().data return ReturnDict(ret, serializer=self) @property def errors(self): - ret = super(Serializer, self).errors + ret = super().errors if isinstance(ret, list) and len(ret) == 1 and getattr(ret[0], 'code', None) == 'null': # Edge case. Provide a more descriptive error than # "this field may not be null", when no data is passed. @@ -591,11 +588,11 @@ class ListSerializer(BaseSerializer): self.allow_empty = kwargs.pop('allow_empty', True) assert self.child is not None, '`child` is a required argument.' assert not inspect.isclass(self.child), '`child` has not been instantiated.' - super(ListSerializer, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) self.child.bind(field_name='', parent=self) def bind(self, field_name, parent): - super(ListSerializer, self).bind(field_name, parent) + super().bind(field_name, parent) self.partial = self.parent.partial def get_initial(self): @@ -758,19 +755,19 @@ class ListSerializer(BaseSerializer): return not bool(self._errors) def __repr__(self): - return unicode_to_repr(representation.list_repr(self, indent=1)) + return representation.list_repr(self, indent=1) # Include a backlink to the serializer class on return objects. # Allows renderers such as HTMLFormRenderer to get the full field info. @property def data(self): - ret = super(ListSerializer, self).data + ret = super().data return ReturnList(ret, serializer=self) @property def errors(self): - ret = super(ListSerializer, self).errors + ret = super().errors if isinstance(ret, list) and len(ret) == 1 and getattr(ret[0], 'code', None) == 'null': # Edge case. Provide a more descriptive error than # "this field may not be null", when no data is passed. diff --git a/rest_framework/settings.py b/rest_framework/settings.py index 8db9c81ed..5d92d0cb4 100644 --- a/rest_framework/settings.py +++ b/rest_framework/settings.py @@ -18,13 +18,10 @@ This module provides the `api_setting` object, that is used to access REST framework settings, checking for user settings first, then falling back to the defaults. """ -from __future__ import unicode_literals - from importlib import import_module from django.conf import settings from django.test.signals import setting_changed -from django.utils import six from rest_framework import ISO_8601 @@ -166,7 +163,7 @@ def perform_import(val, setting_name): """ if val is None: return None - elif isinstance(val, six.string_types): + elif isinstance(val, str): return import_from_string(val, setting_name) elif isinstance(val, (list, tuple)): return [import_from_string(item, setting_name) for item in val] @@ -187,7 +184,7 @@ def import_from_string(val, setting_name): raise ImportError(msg) -class APISettings(object): +class APISettings: """ A settings object, that allows API settings to be accessed as properties. For example: diff --git a/rest_framework/status.py b/rest_framework/status.py index 4b4561cfc..1489b440c 100644 --- a/rest_framework/status.py +++ b/rest_framework/status.py @@ -5,7 +5,6 @@ See RFC 2616 - https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html And RFC 6585 - https://tools.ietf.org/html/rfc6585 And RFC 4918 - https://tools.ietf.org/html/rfc4918 """ -from __future__ import unicode_literals def is_informational(code): diff --git a/rest_framework/templatetags/rest_framework.py b/rest_framework/templatetags/rest_framework.py index f48675d5e..56e2994ea 100644 --- a/rest_framework/templatetags/rest_framework.py +++ b/rest_framework/templatetags/rest_framework.py @@ -1,12 +1,9 @@ -from __future__ import absolute_import, unicode_literals - import re from collections import OrderedDict from django import template from django.template import loader from django.urls import NoReverseMatch, reverse -from django.utils import six from django.utils.encoding import force_text, iri_to_uri from django.utils.html import escape, format_html, smart_urlquote from django.utils.safestring import SafeData, mark_safe @@ -187,7 +184,7 @@ def add_class(value, css_class): In the case of REST Framework, the filter is used to add Bootstrap-specific classes to the forms. """ - html = six.text_type(value) + html = str(value) match = class_re.search(html) if match: m = re.search(r'^%s$|^%s\s|\s%s\s|\s%s$' % (css_class, css_class, @@ -204,7 +201,7 @@ def add_class(value, css_class): @register.filter def format_value(value): if getattr(value, 'is_hyperlink', False): - name = six.text_type(value.obj) + name = str(value.obj) return mark_safe('%s' % (value, escape(name))) if value is None or isinstance(value, bool): return mark_safe('%s' % {True: 'true', False: 'false', None: 'null'}[value]) @@ -219,7 +216,7 @@ def format_value(value): template = loader.get_template('rest_framework/admin/dict_value.html') context = {'value': value} return template.render(context) - elif isinstance(value, six.string_types): + elif isinstance(value, str): if ( (value.startswith('http:') or value.startswith('https:')) and not re.search(r'\s', value) @@ -229,7 +226,7 @@ def format_value(value): return mark_safe('{value}'.format(value=escape(value))) elif '\n' in value: return mark_safe('
%s
' % escape(value)) - return six.text_type(value) + return str(value) @register.filter diff --git a/rest_framework/test.py b/rest_framework/test.py index edacf0066..852d4919e 100644 --- a/rest_framework/test.py +++ b/rest_framework/test.py @@ -1,9 +1,5 @@ -# -- coding: utf-8 -- - # Note that we import as `DjangoRequestFactory` and `DjangoClient` in order # to make it harder for the user to import the wrong thing without realizing. -from __future__ import unicode_literals - import io from importlib import import_module @@ -14,7 +10,6 @@ from django.test import override_settings, testcases from django.test.client import Client as DjangoClient from django.test.client import ClientHandler from django.test.client import RequestFactory as DjangoRequestFactory -from django.utils import six from django.utils.encoding import force_bytes from django.utils.http import urlencode @@ -32,7 +27,7 @@ if requests is not None: def get_all(self, key, default): return self.getheaders(key) - class MockOriginalResponse(object): + class MockOriginalResponse: def __init__(self, headers): self.msg = HeaderDict(headers) self.closed = False @@ -109,7 +104,7 @@ if requests is not None: class RequestsClient(requests.Session): def __init__(self, *args, **kwargs): - super(RequestsClient, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) adapter = DjangoTestAdapter() self.mount('http://', adapter) self.mount('https://', adapter) @@ -117,7 +112,7 @@ if requests is not None: def request(self, method, url, *args, **kwargs): if not url.startswith('http'): raise ValueError('Missing "http:" or "https:". Use a fully qualified URL, eg "http://testserver%s"' % url) - return super(RequestsClient, self).request(method, url, *args, **kwargs) + return super().request(method, url, *args, **kwargs) else: def RequestsClient(*args, **kwargs): @@ -129,7 +124,7 @@ if coreapi is not None: def __init__(self, *args, **kwargs): self._session = RequestsClient() kwargs['transports'] = [coreapi.transports.HTTPTransport(session=self.session)] - return super(CoreAPIClient, self).__init__(*args, **kwargs) + return super().__init__(*args, **kwargs) @property def session(self): @@ -149,7 +144,7 @@ class APIRequestFactory(DjangoRequestFactory): self.renderer_classes = {} for cls in self.renderer_classes_list: self.renderer_classes[cls.format] = cls - super(APIRequestFactory, self).__init__(**defaults) + super().__init__(**defaults) def _encode_data(self, data, format=None, content_type=None): """ @@ -171,7 +166,7 @@ class APIRequestFactory(DjangoRequestFactory): format = format or self.default_format assert format in self.renderer_classes, ( - "Invalid format '{0}'. Available formats are {1}. " + "Invalid format '{}'. Available formats are {}. " "Set TEST_REQUEST_RENDERER_CLASSES to enable " "extra request formats.".format( format, @@ -184,12 +179,12 @@ class APIRequestFactory(DjangoRequestFactory): ret = renderer.render(data) # Determine the content-type header from the renderer - content_type = "{0}; charset={1}".format( + content_type = "{}; charset={}".format( renderer.media_type, renderer.charset ) # Coerce text to bytes if required. - if isinstance(ret, six.text_type): + if isinstance(ret, str): ret = bytes(ret.encode(renderer.charset)) return ret, content_type @@ -202,8 +197,7 @@ class APIRequestFactory(DjangoRequestFactory): # Fix to support old behavior where you have the arguments in the # url. See #1461. query_string = force_bytes(path.split('?')[1]) - if six.PY3: - query_string = query_string.decode('iso-8859-1') + query_string = query_string.decode('iso-8859-1') r['QUERY_STRING'] = query_string r.update(extra) return self.generic('GET', path, **r) @@ -234,11 +228,11 @@ class APIRequestFactory(DjangoRequestFactory): if content_type is not None: extra['CONTENT_TYPE'] = str(content_type) - return super(APIRequestFactory, self).generic( + return super().generic( method, path, data, content_type, secure, **extra) def request(self, **kwargs): - request = super(APIRequestFactory, self).request(**kwargs) + request = super().request(**kwargs) request._dont_enforce_csrf_checks = not self.enforce_csrf_checks return request @@ -252,18 +246,18 @@ class ForceAuthClientHandler(ClientHandler): def __init__(self, *args, **kwargs): self._force_user = None self._force_token = None - super(ForceAuthClientHandler, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def get_response(self, request): # This is the simplest place we can hook into to patch the # request object. force_authenticate(request, self._force_user, self._force_token) - return super(ForceAuthClientHandler, self).get_response(request) + return super().get_response(request) class APIClient(APIRequestFactory, DjangoClient): def __init__(self, enforce_csrf_checks=False, **defaults): - super(APIClient, self).__init__(**defaults) + super().__init__(**defaults) self.handler = ForceAuthClientHandler(enforce_csrf_checks) self._credentials = {} @@ -286,17 +280,17 @@ class APIClient(APIRequestFactory, DjangoClient): def request(self, **kwargs): # Ensure that any credentials set get added to every request. kwargs.update(self._credentials) - return super(APIClient, self).request(**kwargs) + return super().request(**kwargs) def get(self, path, data=None, follow=False, **extra): - response = super(APIClient, self).get(path, data=data, **extra) + response = super().get(path, data=data, **extra) if follow: response = self._handle_redirects(response, **extra) return response def post(self, path, data=None, format=None, content_type=None, follow=False, **extra): - response = super(APIClient, self).post( + response = super().post( path, data=data, format=format, content_type=content_type, **extra) if follow: response = self._handle_redirects(response, **extra) @@ -304,7 +298,7 @@ class APIClient(APIRequestFactory, DjangoClient): def put(self, path, data=None, format=None, content_type=None, follow=False, **extra): - response = super(APIClient, self).put( + response = super().put( path, data=data, format=format, content_type=content_type, **extra) if follow: response = self._handle_redirects(response, **extra) @@ -312,7 +306,7 @@ class APIClient(APIRequestFactory, DjangoClient): def patch(self, path, data=None, format=None, content_type=None, follow=False, **extra): - response = super(APIClient, self).patch( + response = super().patch( path, data=data, format=format, content_type=content_type, **extra) if follow: response = self._handle_redirects(response, **extra) @@ -320,7 +314,7 @@ class APIClient(APIRequestFactory, DjangoClient): def delete(self, path, data=None, format=None, content_type=None, follow=False, **extra): - response = super(APIClient, self).delete( + response = super().delete( path, data=data, format=format, content_type=content_type, **extra) if follow: response = self._handle_redirects(response, **extra) @@ -328,7 +322,7 @@ class APIClient(APIRequestFactory, DjangoClient): def options(self, path, data=None, format=None, content_type=None, follow=False, **extra): - response = super(APIClient, self).options( + response = super().options( path, data=data, format=format, content_type=content_type, **extra) if follow: response = self._handle_redirects(response, **extra) @@ -342,7 +336,7 @@ class APIClient(APIRequestFactory, DjangoClient): self.handler._force_token = None if self.session: - super(APIClient, self).logout() + super().logout() class APITransactionTestCase(testcases.TransactionTestCase): @@ -389,11 +383,11 @@ class URLPatternsTestCase(testcases.SimpleTestCase): cls._module.urlpatterns = cls.urlpatterns cls._override.enable() - super(URLPatternsTestCase, cls).setUpClass() + super().setUpClass() @classmethod def tearDownClass(cls): - super(URLPatternsTestCase, cls).tearDownClass() + super().tearDownClass() cls._override.disable() if hasattr(cls, '_module_urlpatterns'): diff --git a/rest_framework/throttling.py b/rest_framework/throttling.py index 834ced148..0ba2ba66b 100644 --- a/rest_framework/throttling.py +++ b/rest_framework/throttling.py @@ -1,8 +1,6 @@ """ Provides various throttling policies. """ -from __future__ import unicode_literals - import time from django.core.cache import cache as default_cache @@ -11,7 +9,7 @@ from django.core.exceptions import ImproperlyConfigured from rest_framework.settings import api_settings -class BaseThrottle(object): +class BaseThrottle: """ Rate throttling of requests. """ @@ -232,7 +230,7 @@ class ScopedRateThrottle(SimpleRateThrottle): self.num_requests, self.duration = self.parse_rate(self.rate) # We can now proceed as normal. - return super(ScopedRateThrottle, self).allow_request(request, view) + return super().allow_request(request, view) def get_cache_key(self, request, view): """ diff --git a/rest_framework/urlpatterns.py b/rest_framework/urlpatterns.py index ab3a74978..831d344dd 100644 --- a/rest_framework/urlpatterns.py +++ b/rest_framework/urlpatterns.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.conf.urls import include, url from rest_framework.compat import ( diff --git a/rest_framework/urls.py b/rest_framework/urls.py index 0e4c2661b..482a0a364 100644 --- a/rest_framework/urls.py +++ b/rest_framework/urls.py @@ -11,8 +11,6 @@ your API requires authentication: You should make sure your authentication settings include `SessionAuthentication`. """ -from __future__ import unicode_literals - from django.conf.urls import url from django.contrib.auth import views diff --git a/rest_framework/utils/breadcrumbs.py b/rest_framework/utils/breadcrumbs.py index e0374ffd0..54990e9f6 100644 --- a/rest_framework/utils/breadcrumbs.py +++ b/rest_framework/utils/breadcrumbs.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.urls import get_script_prefix, resolve diff --git a/rest_framework/utils/encoders.py b/rest_framework/utils/encoders.py index d8f4aeb4e..dee2f942e 100644 --- a/rest_framework/utils/encoders.py +++ b/rest_framework/utils/encoders.py @@ -1,15 +1,13 @@ """ Helper classes for parsers. """ -from __future__ import absolute_import, unicode_literals - import datetime import decimal import json # noqa import uuid from django.db.models.query import QuerySet -from django.utils import six, timezone +from django.utils import timezone from django.utils.encoding import force_text from django.utils.functional import Promise @@ -39,12 +37,12 @@ class JSONEncoder(json.JSONEncoder): representation = obj.isoformat() return representation elif isinstance(obj, datetime.timedelta): - return six.text_type(obj.total_seconds()) + return str(obj.total_seconds()) elif isinstance(obj, decimal.Decimal): # Serializers will coerce decimals to strings by default. return float(obj) elif isinstance(obj, uuid.UUID): - return six.text_type(obj) + return str(obj) elif isinstance(obj, QuerySet): return tuple(obj) elif isinstance(obj, bytes): @@ -65,4 +63,4 @@ class JSONEncoder(json.JSONEncoder): pass elif hasattr(obj, '__iter__'): return tuple(item for item in obj) - return super(JSONEncoder, self).default(obj) + return super().default(obj) diff --git a/rest_framework/utils/field_mapping.py b/rest_framework/utils/field_mapping.py index 927d08ff2..1281ee167 100644 --- a/rest_framework/utils/field_mapping.py +++ b/rest_framework/utils/field_mapping.py @@ -16,7 +16,7 @@ NUMERIC_FIELD_TYPES = ( ) -class ClassLookupDict(object): +class ClassLookupDict: """ Takes a dictionary with classes as keys. Lookups against this object will traverses the object's inheritance diff --git a/rest_framework/utils/formatting.py b/rest_framework/utils/formatting.py index aa805f14e..4e003f614 100644 --- a/rest_framework/utils/formatting.py +++ b/rest_framework/utils/formatting.py @@ -1,8 +1,6 @@ """ Utility functions to return a formatted name and description for a given view. """ -from __future__ import unicode_literals - import re from django.utils.encoding import force_text diff --git a/rest_framework/utils/json.py b/rest_framework/utils/json.py index cb5572380..1c1e69bf1 100644 --- a/rest_framework/utils/json.py +++ b/rest_framework/utils/json.py @@ -5,9 +5,6 @@ REST framework should always import this wrapper module in order to maintain spec-compliant encoding/decoding. Support for non-standard features should be handled by users at the renderer and parser layer. """ - -from __future__ import absolute_import - import functools import json # noqa diff --git a/rest_framework/utils/mediatypes.py b/rest_framework/utils/mediatypes.py index f4acf4807..40bdf2615 100644 --- a/rest_framework/utils/mediatypes.py +++ b/rest_framework/utils/mediatypes.py @@ -3,10 +3,7 @@ Handling of media types, as found in HTTP Content-Type and Accept headers. See https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.7 """ -from __future__ import unicode_literals - from django.http.multipartparser import parse_header -from django.utils.encoding import python_2_unicode_compatible from rest_framework import HTTP_HEADER_ENCODING @@ -46,8 +43,7 @@ def order_by_precedence(media_type_lst): return [media_types for media_types in ret if media_types] -@python_2_unicode_compatible -class _MediaType(object): +class _MediaType: def __init__(self, media_type_str): self.orig = '' if (media_type_str is None) else media_type_str self.full_type, self.params = parse_header(self.orig.encode(HTTP_HEADER_ENCODING)) diff --git a/rest_framework/utils/representation.py b/rest_framework/utils/representation.py index deeaf1f63..ebead5d75 100644 --- a/rest_framework/utils/representation.py +++ b/rest_framework/utils/representation.py @@ -2,16 +2,12 @@ Helper functions for creating user-friendly representations of serializer classes and serializer fields. """ -from __future__ import unicode_literals - import re from django.db import models from django.utils.encoding import force_text from django.utils.functional import Promise -from rest_framework.compat import unicode_repr - def manager_repr(value): model = value.model @@ -34,7 +30,7 @@ def smart_repr(value): if isinstance(value, Promise) and value._delegate_text: value = force_text(value) - value = unicode_repr(value) + value = repr(value) # Representations like u'help text' # should simply be presented as 'help text' diff --git a/rest_framework/utils/serializer_helpers.py b/rest_framework/utils/serializer_helpers.py index c24e51d09..8709352f1 100644 --- a/rest_framework/utils/serializer_helpers.py +++ b/rest_framework/utils/serializer_helpers.py @@ -1,10 +1,8 @@ -from __future__ import unicode_literals - from collections import OrderedDict from django.utils.encoding import force_text -from rest_framework.compat import MutableMapping, unicode_to_repr +from rest_framework.compat import MutableMapping from rest_framework.utils import json @@ -17,7 +15,7 @@ class ReturnDict(OrderedDict): def __init__(self, *args, **kwargs): self.serializer = kwargs.pop('serializer') - super(ReturnDict, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def copy(self): return ReturnDict(self, serializer=self.serializer) @@ -40,7 +38,7 @@ class ReturnList(list): def __init__(self, *args, **kwargs): self.serializer = kwargs.pop('serializer') - super(ReturnList, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) def __repr__(self): return list.__repr__(self) @@ -51,7 +49,7 @@ class ReturnList(list): return (list, (list(self),)) -class BoundField(object): +class BoundField: """ A field object that also includes `.value` and `.error` properties. Returned when iterating over a serializer instance, @@ -73,9 +71,9 @@ class BoundField(object): return self._field.__class__ def __repr__(self): - return unicode_to_repr('<%s value=%s errors=%s>' % ( + return '<%s value=%s errors=%s>' % ( self.__class__.__name__, self.value, self.errors - )) + ) def as_form_field(self): value = '' if (self.value is None or self.value is False) else self.value @@ -103,9 +101,9 @@ class NestedBoundField(BoundField): """ def __init__(self, field, value, errors, prefix=''): - if value is None or value is '': + if value is None or value == '': value = {} - super(NestedBoundField, self).__init__(field, value, errors, prefix) + super().__init__(field, value, errors, prefix) def __iter__(self): for field in self.fields.values(): diff --git a/rest_framework/utils/urls.py b/rest_framework/utils/urls.py index 3766928d4..3534e5f49 100644 --- a/rest_framework/utils/urls.py +++ b/rest_framework/utils/urls.py @@ -1,5 +1,6 @@ +from urllib import parse + from django.utils.encoding import force_str -from django.utils.six.moves.urllib import parse as urlparse def replace_query_param(url, key, val): @@ -7,11 +8,11 @@ def replace_query_param(url, key, val): Given a URL and a key/val pair, set or replace an item in the query parameters of the URL, and return the new URL. """ - (scheme, netloc, path, query, fragment) = urlparse.urlsplit(force_str(url)) - query_dict = urlparse.parse_qs(query, keep_blank_values=True) + (scheme, netloc, path, query, fragment) = parse.urlsplit(force_str(url)) + query_dict = parse.parse_qs(query, keep_blank_values=True) query_dict[force_str(key)] = [force_str(val)] - query = urlparse.urlencode(sorted(list(query_dict.items())), doseq=True) - return urlparse.urlunsplit((scheme, netloc, path, query, fragment)) + query = parse.urlencode(sorted(list(query_dict.items())), doseq=True) + return parse.urlunsplit((scheme, netloc, path, query, fragment)) def remove_query_param(url, key): @@ -19,8 +20,8 @@ def remove_query_param(url, key): Given a URL and a key/val pair, remove an item in the query parameters of the URL, and return the new URL. """ - (scheme, netloc, path, query, fragment) = urlparse.urlsplit(force_str(url)) - query_dict = urlparse.parse_qs(query, keep_blank_values=True) + (scheme, netloc, path, query, fragment) = parse.urlsplit(force_str(url)) + query_dict = parse.parse_qs(query, keep_blank_values=True) query_dict.pop(key, None) - query = urlparse.urlencode(sorted(list(query_dict.items())), doseq=True) - return urlparse.urlunsplit((scheme, netloc, path, query, fragment)) + query = parse.urlencode(sorted(list(query_dict.items())), doseq=True) + return parse.urlunsplit((scheme, netloc, path, query, fragment)) diff --git a/rest_framework/validators.py b/rest_framework/validators.py index 2ea3e5ac1..a5222fbc6 100644 --- a/rest_framework/validators.py +++ b/rest_framework/validators.py @@ -6,12 +6,9 @@ This gives us better separation of concerns, allows us to use single-step object creation, and makes it possible to switch between using the implicit `ModelSerializer` class and an equivalent explicit `Serializer` class. """ -from __future__ import unicode_literals - from django.db import DataError from django.utils.translation import ugettext_lazy as _ -from rest_framework.compat import unicode_to_repr from rest_framework.exceptions import ValidationError from rest_framework.utils.representation import smart_repr @@ -33,7 +30,7 @@ def qs_filter(queryset, **kwargs): return queryset.none() -class UniqueValidator(object): +class UniqueValidator: """ Validator that corresponds to `unique=True` on a model field. @@ -82,13 +79,13 @@ class UniqueValidator(object): raise ValidationError(self.message, code='unique') def __repr__(self): - return unicode_to_repr('<%s(queryset=%s)>' % ( + return '<%s(queryset=%s)>' % ( self.__class__.__name__, smart_repr(self.queryset) - )) + ) -class UniqueTogetherValidator(object): +class UniqueTogetherValidator: """ Validator that corresponds to `unique_together = (...)` on a model class. @@ -170,14 +167,14 @@ class UniqueTogetherValidator(object): raise ValidationError(message, code='unique') def __repr__(self): - return unicode_to_repr('<%s(queryset=%s, fields=%s)>' % ( + return '<%s(queryset=%s, fields=%s)>' % ( self.__class__.__name__, smart_repr(self.queryset), smart_repr(self.fields) - )) + ) -class BaseUniqueForValidator(object): +class BaseUniqueForValidator: message = None missing_message = _('This field is required.') @@ -236,12 +233,12 @@ class BaseUniqueForValidator(object): }, code='unique') def __repr__(self): - return unicode_to_repr('<%s(queryset=%s, field=%s, date_field=%s)>' % ( + return '<%s(queryset=%s, field=%s, date_field=%s)>' % ( self.__class__.__name__, smart_repr(self.queryset), smart_repr(self.field), smart_repr(self.date_field) - )) + ) class UniqueForDateValidator(BaseUniqueForValidator): diff --git a/rest_framework/versioning.py b/rest_framework/versioning.py index 206ff6c2e..0631a75c9 100644 --- a/rest_framework/versioning.py +++ b/rest_framework/versioning.py @@ -1,6 +1,3 @@ -# coding: utf-8 -from __future__ import unicode_literals - import re from django.utils.translation import ugettext_lazy as _ @@ -13,7 +10,7 @@ from rest_framework.templatetags.rest_framework import replace_query_param from rest_framework.utils.mediatypes import _MediaType -class BaseVersioning(object): +class BaseVersioning: default_version = api_settings.DEFAULT_VERSION allowed_versions = api_settings.ALLOWED_VERSIONS version_param = api_settings.VERSION_PARAM @@ -87,7 +84,7 @@ class URLPathVersioning(BaseVersioning): kwargs = {} if (kwargs is None) else kwargs kwargs[self.version_param] = request.version - return super(URLPathVersioning, self).reverse( + return super().reverse( viewname, args, kwargs, request, format, **extra ) @@ -133,7 +130,7 @@ class NamespaceVersioning(BaseVersioning): def reverse(self, viewname, args=None, kwargs=None, request=None, format=None, **extra): if request.version is not None: viewname = self.get_versioned_viewname(viewname, request) - return super(NamespaceVersioning, self).reverse( + return super().reverse( viewname, args, kwargs, request, format, **extra ) @@ -179,7 +176,7 @@ class QueryParameterVersioning(BaseVersioning): return version def reverse(self, viewname, args=None, kwargs=None, request=None, format=None, **extra): - url = super(QueryParameterVersioning, self).reverse( + url = super().reverse( viewname, args, kwargs, request, format, **extra ) if request.version is not None: diff --git a/rest_framework/views.py b/rest_framework/views.py index 9d5d959e9..6ef7021d4 100644 --- a/rest_framework/views.py +++ b/rest_framework/views.py @@ -1,8 +1,6 @@ """ Provides an APIView class that is the base of all views in REST framework. """ -from __future__ import unicode_literals - from django.conf import settings from django.core.exceptions import PermissionDenied from django.db import connection, models, transaction @@ -137,7 +135,7 @@ class APIView(View): ) cls.queryset._fetch_all = force_evaluation - view = super(APIView, cls).as_view(**initkwargs) + view = super().as_view(**initkwargs) view.cls = cls view.initkwargs = initkwargs diff --git a/rest_framework/viewsets.py b/rest_framework/viewsets.py index 7146828d2..ad5633854 100644 --- a/rest_framework/viewsets.py +++ b/rest_framework/viewsets.py @@ -16,8 +16,6 @@ automatically. router.register(r'users', UserViewSet, 'user') urlpatterns = router.urls """ -from __future__ import unicode_literals - from collections import OrderedDict from functools import update_wrapper from inspect import getmembers @@ -34,7 +32,7 @@ def _is_extra_action(attr): return hasattr(attr, 'mapping') -class ViewSetMixin(object): +class ViewSetMixin: """ This is the magic. @@ -134,7 +132,7 @@ class ViewSetMixin(object): """ Set the `.action` attribute on the view, depending on the request method. """ - request = super(ViewSetMixin, self).initialize_request(request, *args, **kwargs) + request = super().initialize_request(request, *args, **kwargs) method = request.method.lower() if method == 'options': # This is a special case as we always provide handling for the diff --git a/runtests.py b/runtests.py index 16b47ce2a..a32dde96c 100755 --- a/runtests.py +++ b/runtests.py @@ -1,6 +1,4 @@ -#! /usr/bin/env python -from __future__ import print_function - +#! /usr/bin/env python3 import subprocess import sys diff --git a/setup.cfg b/setup.cfg index c95134600..b4dee6804 100644 --- a/setup.cfg +++ b/setup.cfg @@ -1,6 +1,3 @@ -[bdist_wheel] -universal = 1 - [metadata] license_file = LICENSE.md diff --git a/setup.py b/setup.py index cb850a3ae..632c7dfd3 100755 --- a/setup.py +++ b/setup.py @@ -1,5 +1,4 @@ -#!/usr/bin/env python -# -*- coding: utf-8 -*- +#!/usr/bin/env python3 import os import re import shutil @@ -8,6 +7,34 @@ from io import open from setuptools import find_packages, setup +CURRENT_PYTHON = sys.version_info[:2] +REQUIRED_PYTHON = (3, 4) + +# This check and everything above must remain compatible with Python 2.7. +if CURRENT_PYTHON < REQUIRED_PYTHON: + sys.stderr.write(""" +========================== +Unsupported Python version +========================== + +This version of Django REST Framework requires Python {}.{}, but you're trying +to install it on Python {}.{}. + +This may be because you are using a version of pip that doesn't +understand the python_requires classifier. Make sure you +have pip >= 9.0 and setuptools >= 24.2, then try again: + + $ python -m pip install --upgrade pip setuptools + $ python -m pip install djangorestframework + +This will install the latest version of Django REST Framework which works on +your version of Python. If you can't upgrade your pip (or Python), request +an older version of Django REST Framework: + + $ python -m pip install "django<3.10" +""".format(*(REQUIRED_PYTHON + CURRENT_PYTHON))) + sys.exit(1) + def read(f): return open(f, 'r', encoding='utf-8').read() @@ -52,7 +79,7 @@ setup( packages=find_packages(exclude=['tests*']), include_package_data=True, install_requires=[], - python_requires=">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*", + python_requires=">=3.4", zip_safe=False, classifiers=[ 'Development Status :: 5 - Production/Stable', @@ -66,13 +93,12 @@ setup( 'License :: OSI Approved :: BSD License', 'Operating System :: OS Independent', 'Programming Language :: Python', - 'Programming Language :: Python :: 2', - 'Programming Language :: Python :: 2.7', 'Programming Language :: Python :: 3', 'Programming Language :: Python :: 3.4', 'Programming Language :: Python :: 3.5', 'Programming Language :: Python :: 3.6', 'Programming Language :: Python :: 3.7', + 'Programming Language :: Python :: 3 :: Only', 'Topic :: Internet :: WWW/HTTP', ] ) diff --git a/tests/authentication/migrations/0001_initial.py b/tests/authentication/migrations/0001_initial.py index cfc887240..548b3576b 100644 --- a/tests/authentication/migrations/0001_initial.py +++ b/tests/authentication/migrations/0001_initial.py @@ -1,6 +1,3 @@ -# -*- coding: utf-8 -*- -from __future__ import unicode_literals - from django.conf import settings from django.db import migrations, models diff --git a/tests/authentication/models.py b/tests/authentication/models.py index b8d1fd5a6..1a721de4d 100644 --- a/tests/authentication/models.py +++ b/tests/authentication/models.py @@ -1,6 +1,3 @@ -# coding: utf-8 -from __future__ import unicode_literals - from django.conf import settings from django.db import models diff --git a/tests/authentication/test_authentication.py b/tests/authentication/test_authentication.py index 793773542..f7e9fcf18 100644 --- a/tests/authentication/test_authentication.py +++ b/tests/authentication/test_authentication.py @@ -1,7 +1,3 @@ -# coding: utf-8 - -from __future__ import unicode_literals - import base64 import pytest @@ -10,7 +6,6 @@ from django.conf.urls import include, url from django.contrib.auth.models import User from django.http import HttpResponse from django.test import TestCase, override_settings -from django.utils import six from rest_framework import ( HTTP_HEADER_ENCODING, exceptions, permissions, renderers, status @@ -253,7 +248,7 @@ class SessionAuthTests(TestCase): assert response.status_code == status.HTTP_403_FORBIDDEN -class BaseTokenAuthTests(object): +class BaseTokenAuthTests: """Token authentication""" model = None path = None @@ -381,7 +376,7 @@ class TokenAuthTests(BaseTokenAuthTests, TestCase): """Ensure generate_key returns a string""" token = self.model() key = token.generate_key() - assert isinstance(key, six.string_types) + assert isinstance(key, str) def test_token_login_json(self): """Ensure token login view using JSON POST works.""" @@ -534,7 +529,7 @@ class BasicAuthenticationUnitTests(TestCase): def test_basic_authentication_raises_error_if_user_not_active(self): from rest_framework import authentication - class MockUser(object): + class MockUser: is_active = False old_authenticate = authentication.authenticate authentication.authenticate = lambda **kwargs: MockUser() diff --git a/tests/browsable_api/auth_urls.py b/tests/browsable_api/auth_urls.py index 0e9379717..7530c5e40 100644 --- a/tests/browsable_api/auth_urls.py +++ b/tests/browsable_api/auth_urls.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.conf.urls import include, url from .views import MockView diff --git a/tests/browsable_api/no_auth_urls.py b/tests/browsable_api/no_auth_urls.py index 5fc95c727..348bfe1c0 100644 --- a/tests/browsable_api/no_auth_urls.py +++ b/tests/browsable_api/no_auth_urls.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.conf.urls import url from .views import MockView diff --git a/tests/browsable_api/test_browsable_api.py b/tests/browsable_api/test_browsable_api.py index 684d7ae14..81090e223 100644 --- a/tests/browsable_api/test_browsable_api.py +++ b/tests/browsable_api/test_browsable_api.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.contrib.auth.models import User from django.test import TestCase, override_settings diff --git a/tests/browsable_api/test_browsable_nested_api.py b/tests/browsable_api/test_browsable_nested_api.py index 8f38b3c4e..3fef74023 100644 --- a/tests/browsable_api/test_browsable_nested_api.py +++ b/tests/browsable_api/test_browsable_nested_api.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.conf.urls import url from django.test import TestCase from django.test.utils import override_settings diff --git a/tests/browsable_api/views.py b/tests/browsable_api/views.py index 03758f10b..e1cf13a1e 100644 --- a/tests/browsable_api/views.py +++ b/tests/browsable_api/views.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from rest_framework import authentication, renderers from rest_framework.response import Response from rest_framework.views import APIView diff --git a/tests/generic_relations/models.py b/tests/generic_relations/models.py index 55bc243cb..20df3e4a2 100644 --- a/tests/generic_relations/models.py +++ b/tests/generic_relations/models.py @@ -1,14 +1,10 @@ -from __future__ import unicode_literals - from django.contrib.contenttypes.fields import ( GenericForeignKey, GenericRelation ) from django.contrib.contenttypes.models import ContentType from django.db import models -from django.utils.encoding import python_2_unicode_compatible -@python_2_unicode_compatible class Tag(models.Model): """ Tags have a descriptive slug, and are attached to an arbitrary object. @@ -22,7 +18,6 @@ class Tag(models.Model): return self.tag -@python_2_unicode_compatible class Bookmark(models.Model): """ A URL bookmark that may have multiple tags attached. @@ -34,7 +29,6 @@ class Bookmark(models.Model): return 'Bookmark: %s' % self.url -@python_2_unicode_compatible class Note(models.Model): """ A textual note that may have multiple tags attached. diff --git a/tests/generic_relations/test_generic_relations.py b/tests/generic_relations/test_generic_relations.py index c8de332e1..33f8ea1d0 100644 --- a/tests/generic_relations/test_generic_relations.py +++ b/tests/generic_relations/test_generic_relations.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.test import TestCase from rest_framework import serializers diff --git a/tests/models.py b/tests/models.py index 17bf23cda..f389a51a9 100644 --- a/tests/models.py +++ b/tests/models.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import uuid from django.db import models diff --git a/tests/test_api_client.py b/tests/test_api_client.py index e4354ec60..74a3579e2 100644 --- a/tests/test_api_client.py +++ b/tests/test_api_client.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import os import tempfile import unittest diff --git a/tests/test_atomic_requests.py b/tests/test_atomic_requests.py index bddd480a5..de04d2c06 100644 --- a/tests/test_atomic_requests.py +++ b/tests/test_atomic_requests.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import unittest from django.conf.urls import url @@ -38,7 +36,7 @@ class APIExceptionView(APIView): class NonAtomicAPIExceptionView(APIView): @transaction.non_atomic_requests def dispatch(self, *args, **kwargs): - return super(NonAtomicAPIExceptionView, self).dispatch(*args, **kwargs) + return super().dispatch(*args, **kwargs) def get(self, request, *args, **kwargs): BasicModel.objects.all() diff --git a/tests/test_authtoken.py b/tests/test_authtoken.py index c8957f978..036e317ef 100644 --- a/tests/test_authtoken.py +++ b/tests/test_authtoken.py @@ -1,9 +1,10 @@ +from io import StringIO + import pytest from django.contrib.admin import site from django.contrib.auth.models import User from django.core.management import CommandError, call_command from django.test import TestCase -from django.utils.six import StringIO from rest_framework.authtoken.admin import TokenAdmin from rest_framework.authtoken.management.commands.drf_create_token import \ diff --git a/tests/test_bound_fields.py b/tests/test_bound_fields.py index e588ae623..dc5ab542f 100644 --- a/tests/test_bound_fields.py +++ b/tests/test_bound_fields.py @@ -28,7 +28,7 @@ class TestSimpleBoundField: assert serializer['text'].value == 'abc' assert serializer['text'].errors is None assert serializer['text'].name == 'text' - assert serializer['amount'].value is 123 + assert serializer['amount'].value == 123 assert serializer['amount'].errors is None assert serializer['amount'].name == 'amount' @@ -43,7 +43,7 @@ class TestSimpleBoundField: assert serializer['text'].value == 'x' * 1000 assert serializer['text'].errors == ['Ensure this field has no more than 100 characters.'] assert serializer['text'].name == 'text' - assert serializer['amount'].value is 123 + assert serializer['amount'].value == 123 assert serializer['amount'].errors is None assert serializer['amount'].name == 'amount' diff --git a/tests/test_decorators.py b/tests/test_decorators.py index 13dd41ff3..3f24e7ef0 100644 --- a/tests/test_decorators.py +++ b/tests/test_decorators.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import pytest from django.test import TestCase diff --git a/tests/test_description.py b/tests/test_description.py index 702e56332..ae00fe4a9 100644 --- a/tests/test_description.py +++ b/tests/test_description.py @@ -1,9 +1,4 @@ -# -- coding: utf-8 -- - -from __future__ import unicode_literals - from django.test import TestCase -from django.utils.encoding import python_2_unicode_compatible from rest_framework.compat import apply_markdown from rest_framework.utils.formatting import dedent @@ -157,8 +152,8 @@ class TestViewNamesAndDescriptions(TestCase): """ # use a mock object instead of gettext_lazy to ensure that we can't end # up with a test case string in our l10n catalog - @python_2_unicode_compatible - class MockLazyStr(object): + + class MockLazyStr: def __init__(self, string): self.s = string diff --git a/tests/test_encoders.py b/tests/test_encoders.py index 12eca8105..c66954b80 100644 --- a/tests/test_encoders.py +++ b/tests/test_encoders.py @@ -10,7 +10,7 @@ from rest_framework.compat import coreapi from rest_framework.utils.encoders import JSONEncoder -class MockList(object): +class MockList: def tolist(self): return [1, 2, 3] diff --git a/tests/test_exceptions.py b/tests/test_exceptions.py index ce0ed8514..13b1b4757 100644 --- a/tests/test_exceptions.py +++ b/tests/test_exceptions.py @@ -1,8 +1,5 @@ -# -*- coding: utf-8 -*- -from __future__ import unicode_literals - from django.test import RequestFactory, TestCase -from django.utils import six, translation +from django.utils import translation from django.utils.translation import ugettext_lazy as _ from rest_framework.exceptions import ( @@ -46,12 +43,12 @@ class ExceptionTestCase(TestCase): exception = Throttled(wait=2) assert exception.get_full_details() == { - 'message': 'Request was throttled. Expected available in {} seconds.'.format(2 if six.PY3 else 2.), + 'message': 'Request was throttled. Expected available in {} seconds.'.format(2), 'code': 'throttled'} exception = Throttled(wait=2, detail='Slow down!') assert exception.get_full_details() == { - 'message': 'Slow down! Expected available in {} seconds.'.format(2 if six.PY3 else 2.), + 'message': 'Slow down! Expected available in {} seconds.'.format(2), 'code': 'throttled'} @@ -92,7 +89,7 @@ class TranslationTests(TestCase): def test_message(self): # this test largely acts as a sanity test to ensure the translation files are present. self.assertEqual(_('A server error occurred.'), 'Une erreur du serveur est survenue.') - self.assertEqual(six.text_type(APIException()), 'Une erreur du serveur est survenue.') + self.assertEqual(str(APIException()), 'Une erreur du serveur est survenue.') def test_server_error(): diff --git a/tests/test_fields.py b/tests/test_fields.py index 42adedfed..e0833564b 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -10,7 +10,6 @@ import pytz from django.core.exceptions import ValidationError as DjangoValidationError from django.http import QueryDict from django.test import TestCase, override_settings -from django.utils import six from django.utils.timezone import activate, deactivate, override, utc import rest_framework @@ -167,7 +166,7 @@ class TestEmpty: """ field = serializers.IntegerField(default=123) output = field.run_validation() - assert output is 123 + assert output == 123 class TestSource: @@ -193,7 +192,7 @@ class TestSource: class ExampleSerializer(serializers.Serializer): example_field = serializers.CharField(source='example_callable') - class ExampleInstance(object): + class ExampleInstance: def example_callable(self): return 'example callable value' @@ -204,7 +203,7 @@ class TestSource: class ExampleSerializer(serializers.Serializer): example_field = serializers.CharField(source='example_callable', read_only=True) - class ExampleInstance(object): + class ExampleInstance: def example_callable(self): raise AttributeError('method call failed') @@ -754,7 +753,7 @@ class TestCharField(FieldValues): def raise_exception(value): raise exceptions.ValidationError('Raised error') - for validators in ([raise_exception], (raise_exception,), set([raise_exception])): + for validators in ([raise_exception], (raise_exception,), {raise_exception}): field = serializers.CharField(validators=validators) with pytest.raises(serializers.ValidationError) as exc_info: field.run_validation(value) @@ -822,7 +821,7 @@ class TestSlugField(FieldValues): validation_error = False try: - field.run_validation(u'slug-99-\u0420') + field.run_validation('slug-99-\u0420') except serializers.ValidationError: validation_error = True @@ -1148,7 +1147,7 @@ class TestLocalizedDecimalField(TestCase): def test_localize_forces_coerce_to_string(self): field = serializers.DecimalField(max_digits=2, decimal_places=1, coerce_to_string=False, localize=True) - assert isinstance(field.to_representation(Decimal('1.1')), six.string_types) + assert isinstance(field.to_representation(Decimal('1.1')), str) class TestQuantizedValueForDecimal(TestCase): @@ -1219,7 +1218,7 @@ class TestDateField(FieldValues): outputs = { datetime.date(2001, 1, 1): '2001-01-01', '2001-01-01': '2001-01-01', - six.text_type('2016-01-10'): '2016-01-10', + str('2016-01-10'): '2016-01-10', None: None, '': None, } @@ -1286,7 +1285,7 @@ class TestDateTimeField(FieldValues): datetime.datetime(2001, 1, 1, 13, 00): '2001-01-01T13:00:00Z', datetime.datetime(2001, 1, 1, 13, 00, tzinfo=utc): '2001-01-01T13:00:00Z', '2001-01-01T00:00:00': '2001-01-01T00:00:00', - six.text_type('2016-01-10T00:00:00'): '2016-01-10T00:00:00', + str('2016-01-10T00:00:00'): '2016-01-10T00:00:00', None: None, '': None, } @@ -1628,7 +1627,7 @@ class TestChoiceField(FieldValues): ] ) field.choices = [1] - assert field.run_validation(1) is 1 + assert field.run_validation(1) == 1 with pytest.raises(serializers.ValidationError) as exc_info: field.run_validation(2) assert exc_info.value.detail == ['"2" is not a valid choice.'] diff --git a/tests/test_filters.py b/tests/test_filters.py index a53fa192a..a52f40103 100644 --- a/tests/test_filters.py +++ b/tests/test_filters.py @@ -1,6 +1,5 @@ -from __future__ import unicode_literals - import datetime +from importlib import reload as reload_module import pytest from django.core.exceptions import ImproperlyConfigured @@ -8,7 +7,6 @@ from django.db import models from django.db.models.functions import Concat, Upper from django.test import TestCase from django.test.utils import override_settings -from django.utils.six.moves import reload_module from rest_framework import filters, generics, serializers from rest_framework.compat import coreschema @@ -163,7 +161,7 @@ class SearchFilterTests(TestCase): def get_search_fields(self, view, request): if request.query_params.get('title_only'): return ('$title',) - return super(CustomSearchFilter, self).get_search_fields(view, request) + return super().get_search_fields(view, request) class SearchListView(generics.ListAPIView): queryset = SearchFilterModel.objects.all() diff --git a/tests/test_generateschema.py b/tests/test_generateschema.py index 915c6ea05..a6a1f2bed 100644 --- a/tests/test_generateschema.py +++ b/tests/test_generateschema.py @@ -1,11 +1,10 @@ -from __future__ import unicode_literals +import io import pytest from django.conf.urls import url from django.core.management import call_command from django.test import TestCase from django.test.utils import override_settings -from django.utils import six from rest_framework.compat import coreapi from rest_framework.utils import formatting, json @@ -28,9 +27,8 @@ class GenerateSchemaTests(TestCase): """Tests for management command generateschema.""" def setUp(self): - self.out = six.StringIO() + self.out = io.StringIO() - @pytest.mark.skipif(six.PY2, reason='PyYAML unicode output is malformed on PY2.') def test_renders_default_schema_with_custom_title_url_and_description(self): expected_out = """info: description: Sample description diff --git a/tests/test_generics.py b/tests/test_generics.py index c0ff1c5c4..f41ebe6da 100644 --- a/tests/test_generics.py +++ b/tests/test_generics.py @@ -1,11 +1,8 @@ -from __future__ import unicode_literals - import pytest from django.db import models from django.http import Http404 from django.shortcuts import get_object_or_404 from django.test import TestCase -from django.utils import six from rest_framework import generics, renderers, serializers, status from rest_framework.response import Response @@ -245,7 +242,7 @@ class TestInstanceView(TestCase): with self.assertNumQueries(2): response = self.view(request, pk=1).render() assert response.status_code == status.HTTP_204_NO_CONTENT - assert response.content == six.b('') + assert response.content == b'' ids = [obj.id for obj in self.objects.all()] assert ids == [2, 3] @@ -291,7 +288,7 @@ class TestInstanceView(TestCase): """ data = {'text': 'foo'} filtered_out_pk = BasicModel.objects.filter(text='filtered out')[0].pk - request = factory.put('/{0}'.format(filtered_out_pk), data, format='json') + request = factory.put('/{}'.format(filtered_out_pk), data, format='json') response = self.view(request, pk=filtered_out_pk).render() assert response.status_code == status.HTTP_404_NOT_FOUND @@ -446,12 +443,12 @@ class TestM2MBrowsableAPI(TestCase): assert response.status_code == status.HTTP_200_OK -class InclusiveFilterBackend(object): +class InclusiveFilterBackend: def filter_queryset(self, request, queryset, view): return queryset.filter(text='foo') -class ExclusiveFilterBackend(object): +class ExclusiveFilterBackend: def filter_queryset(self, request, queryset, view): return queryset.filter(text='other') @@ -653,7 +650,7 @@ class ApiViewsTests(TestCase): class GetObjectOr404Tests(TestCase): def setUp(self): - super(GetObjectOr404Tests, self).setUp() + super().setUp() self.uuid_object = UUIDForeignKeyTarget.objects.create(name='bar') def test_get_object_or_404_with_valid_uuid(self): diff --git a/tests/test_htmlrenderer.py b/tests/test_htmlrenderer.py index decd25a3f..e31a9ced5 100644 --- a/tests/test_htmlrenderer.py +++ b/tests/test_htmlrenderer.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import django.template.loader import pytest from django.conf.urls import url @@ -7,7 +5,6 @@ from django.core.exceptions import ImproperlyConfigured, PermissionDenied from django.http import Http404 from django.template import TemplateDoesNotExist, engines from django.test import TestCase, override_settings -from django.utils import six from rest_framework import status from rest_framework.decorators import api_view, renderer_classes @@ -47,7 +44,7 @@ urlpatterns = [ @override_settings(ROOT_URLCONF='tests.test_htmlrenderer') class TemplateHTMLRendererTests(TestCase): def setUp(self): - class MockResponse(object): + class MockResponse: template_name = None self.mock_response = MockResponse() self._monkey_patch_get_template() @@ -85,13 +82,13 @@ class TemplateHTMLRendererTests(TestCase): def test_not_found_html_view(self): response = self.client.get('/not_found') self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND) - self.assertEqual(response.content, six.b("404 Not Found")) + self.assertEqual(response.content, b"404 Not Found") self.assertEqual(response['Content-Type'], 'text/html; charset=utf-8') def test_permission_denied_html_view(self): response = self.client.get('/permission_denied') self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) - self.assertEqual(response.content, six.b("403 Forbidden")) + self.assertEqual(response.content, b"403 Forbidden") self.assertEqual(response['Content-Type'], 'text/html; charset=utf-8') # 2 tests below are based on order of if statements in corresponding method @@ -105,14 +102,14 @@ class TemplateHTMLRendererTests(TestCase): def test_get_template_names_returns_view_template_name(self): renderer = TemplateHTMLRenderer() - class MockResponse(object): + class MockResponse: template_name = None - class MockView(object): + class MockView: def get_template_names(self): return ['template from get_template_names method'] - class MockView2(object): + class MockView2: template_name = 'template from template_name attribute' template_name = renderer.get_template_names(self.mock_response, @@ -156,12 +153,11 @@ class TemplateHTMLRendererExceptionTests(TestCase): response = self.client.get('/not_found') self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND) self.assertTrue(response.content in ( - six.b("404: Not found"), six.b("404 Not Found"))) + b"404: Not found", b"404 Not Found")) self.assertEqual(response['Content-Type'], 'text/html; charset=utf-8') def test_permission_denied_html_view_with_template(self): response = self.client.get('/permission_denied') self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) - self.assertTrue(response.content in ( - six.b("403: Permission denied"), six.b("403 Forbidden"))) + self.assertTrue(response.content in (b"403: Permission denied", b"403 Forbidden")) self.assertEqual(response['Content-Type'], 'text/html; charset=utf-8') diff --git a/tests/test_metadata.py b/tests/test_metadata.py index fe4ea4b42..e1a1fd352 100644 --- a/tests/test_metadata.py +++ b/tests/test_metadata.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import pytest from django.core.validators import MaxValueValidator, MinValueValidator from django.db import models diff --git a/tests/test_middleware.py b/tests/test_middleware.py index 9df7d8e3e..28a5e558a 100644 --- a/tests/test_middleware.py +++ b/tests/test_middleware.py @@ -22,7 +22,7 @@ urlpatterns = [ ] -class RequestUserMiddleware(object): +class RequestUserMiddleware: def __init__(self, get_response): self.get_response = get_response @@ -34,7 +34,7 @@ class RequestUserMiddleware(object): return response -class RequestPOSTMiddleware(object): +class RequestPOSTMiddleware: def __init__(self, get_response): self.get_response = get_response diff --git a/tests/test_model_serializer.py b/tests/test_model_serializer.py index 898c859a4..413d7885d 100644 --- a/tests/test_model_serializer.py +++ b/tests/test_model_serializer.py @@ -5,8 +5,6 @@ shortcuts for automatically creating serializers based on a given model class. These tests deal with ensuring that we correctly map the model fields onto an appropriate set of serializer fields for each case. """ -from __future__ import unicode_literals - import datetime import decimal import sys @@ -20,10 +18,9 @@ from django.core.validators import ( ) from django.db import models from django.test import TestCase -from django.utils import six from rest_framework import serializers -from rest_framework.compat import postgres_fields, unicode_repr +from rest_framework.compat import postgres_fields from .models import NestedForeignKeySource @@ -193,7 +190,7 @@ class TestRegularFieldMappings(TestCase): file_path_field = FilePathField(path='/tmp/') """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_field_options(self): class TestSerializer(serializers.ModelSerializer): @@ -212,14 +209,7 @@ class TestRegularFieldMappings(TestCase): descriptive_field = IntegerField(help_text='Some help text', label='A label') choices_field = ChoiceField(choices=(('red', 'Red'), ('blue', 'Blue'), ('green', 'Green'))) """) - if six.PY2: - # This particular case is too awkward to resolve fully across - # both py2 and py3. - expected = expected.replace( - "('red', 'Red'), ('blue', 'Blue'), ('green', 'Green')", - "(u'red', u'Red'), (u'blue', u'Blue'), (u'green', u'Green')" - ) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) # merge this into test_regular_fields / RegularFieldsModel when # Django 2.1 is the minimum supported version @@ -238,7 +228,7 @@ class TestRegularFieldMappings(TestCase): field = BooleanField(allow_null=True, required=False) """) - self.assertEqual(unicode_repr(NullableBooleanSerializer()), expected) + self.assertEqual(repr(NullableBooleanSerializer()), expected) def test_method_field(self): """ @@ -382,7 +372,7 @@ class TestDurationFieldMapping(TestCase): id = IntegerField(label='ID', read_only=True) duration_field = DurationField() """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_duration_field_with_validators(self): class ValidatedDurationFieldModel(models.Model): @@ -407,7 +397,7 @@ class TestDurationFieldMapping(TestCase): id = IntegerField(label='ID', read_only=True) duration_field = DurationField(max_value=datetime.timedelta(days=3), min_value=datetime.timedelta(days=1)) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) class TestGenericIPAddressFieldValidation(TestCase): @@ -424,7 +414,7 @@ class TestGenericIPAddressFieldValidation(TestCase): self.assertFalse(s.is_valid()) self.assertEqual(1, len(s.errors['address']), 'Unexpected number of validation errors: ' - '{0}'.format(s.errors)) + '{}'.format(s.errors)) @pytest.mark.skipif('not postgres_fields') @@ -442,7 +432,7 @@ class TestPosgresFieldsMapping(TestCase): TestSerializer(): hstore_field = HStoreField() """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_array_field(self): class ArrayFieldModel(models.Model): @@ -457,7 +447,7 @@ class TestPosgresFieldsMapping(TestCase): TestSerializer(): array_field = ListField(child=CharField(label='Array field', validators=[])) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_json_field(self): class JSONFieldModel(models.Model): @@ -472,7 +462,7 @@ class TestPosgresFieldsMapping(TestCase): TestSerializer(): json_field = JSONField(style={'base_template': 'textarea.html'}) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) # Tests for relational field mappings. @@ -530,7 +520,7 @@ class TestRelationalFieldMappings(TestCase): many_to_many = PrimaryKeyRelatedField(allow_empty=False, many=True, queryset=ManyToManyTargetModel.objects.all()) through = PrimaryKeyRelatedField(many=True, read_only=True) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_nested_relations(self): class TestSerializer(serializers.ModelSerializer): @@ -555,7 +545,7 @@ class TestRelationalFieldMappings(TestCase): id = IntegerField(label='ID', read_only=True) name = CharField(max_length=100) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_hyperlinked_relations(self): class TestSerializer(serializers.HyperlinkedModelSerializer): @@ -571,7 +561,7 @@ class TestRelationalFieldMappings(TestCase): many_to_many = HyperlinkedRelatedField(allow_empty=False, many=True, queryset=ManyToManyTargetModel.objects.all(), view_name='manytomanytargetmodel-detail') through = HyperlinkedRelatedField(many=True, read_only=True, view_name='throughtargetmodel-detail') """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_nested_hyperlinked_relations(self): class TestSerializer(serializers.HyperlinkedModelSerializer): @@ -596,7 +586,7 @@ class TestRelationalFieldMappings(TestCase): url = HyperlinkedIdentityField(view_name='throughtargetmodel-detail') name = CharField(max_length=100) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_nested_hyperlinked_relations_starred_source(self): class TestSerializer(serializers.HyperlinkedModelSerializer): @@ -627,7 +617,7 @@ class TestRelationalFieldMappings(TestCase): name = CharField(max_length=100) """) self.maxDiff = None - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_nested_unique_together_relations(self): class TestSerializer(serializers.HyperlinkedModelSerializer): @@ -646,14 +636,7 @@ class TestRelationalFieldMappings(TestCase): url = HyperlinkedIdentityField(view_name='onetoonetargetmodel-detail') name = CharField(max_length=100) """) - if six.PY2: - # This case is also too awkward to resolve fully across both py2 - # and py3. (See above) - expected = expected.replace( - "('foreign_key', 'one_to_one')", - "(u'foreign_key', u'one_to_one')" - ) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_pk_reverse_foreign_key(self): class TestSerializer(serializers.ModelSerializer): @@ -667,7 +650,7 @@ class TestRelationalFieldMappings(TestCase): name = CharField(max_length=100) reverse_foreign_key = PrimaryKeyRelatedField(many=True, queryset=RelationalModel.objects.all()) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_pk_reverse_one_to_one(self): class TestSerializer(serializers.ModelSerializer): @@ -681,7 +664,7 @@ class TestRelationalFieldMappings(TestCase): name = CharField(max_length=100) reverse_one_to_one = PrimaryKeyRelatedField(queryset=RelationalModel.objects.all()) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_pk_reverse_many_to_many(self): class TestSerializer(serializers.ModelSerializer): @@ -695,7 +678,7 @@ class TestRelationalFieldMappings(TestCase): name = CharField(max_length=100) reverse_many_to_many = PrimaryKeyRelatedField(many=True, queryset=RelationalModel.objects.all()) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) def test_pk_reverse_through(self): class TestSerializer(serializers.ModelSerializer): @@ -709,7 +692,7 @@ class TestRelationalFieldMappings(TestCase): name = CharField(max_length=100) reverse_through = PrimaryKeyRelatedField(many=True, read_only=True) """) - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) class DisplayValueTargetModel(models.Model): @@ -1078,9 +1061,9 @@ class TestMetaInheritance(TestCase): char_field = CharField(max_length=100) non_model_field = CharField() """) - self.assertEqual(unicode_repr(ChildSerializer()), child_expected) - self.assertEqual(unicode_repr(TestSerializer()), test_expected) - self.assertEqual(unicode_repr(ChildSerializer()), child_expected) + self.assertEqual(repr(ChildSerializer()), child_expected) + self.assertEqual(repr(TestSerializer()), test_expected) + self.assertEqual(repr(ChildSerializer()), child_expected) class OneToOneTargetTestModel(models.Model): @@ -1149,14 +1132,14 @@ class Issue3674Test(TestCase): title = CharField(max_length=64) children = PrimaryKeyRelatedField(many=True, queryset=TestChildModel.objects.all()) """) - self.assertEqual(unicode_repr(TestParentModelSerializer()), parent_expected) + self.assertEqual(repr(TestParentModelSerializer()), parent_expected) child_expected = dedent(""" TestChildModelSerializer(): value = CharField(max_length=64, validators=[]) parent = PrimaryKeyRelatedField(queryset=TestParentModel.objects.all()) """) - self.assertEqual(unicode_repr(TestChildModelSerializer()), child_expected) + self.assertEqual(repr(TestChildModelSerializer()), child_expected) def test_nonID_PK_foreignkey_model_serializer(self): @@ -1248,7 +1231,7 @@ class TestFieldSource(TestCase): number_field = IntegerField(source='integer_field') """) self.maxDiff = None - self.assertEqual(unicode_repr(TestSerializer()), expected) + self.assertEqual(repr(TestSerializer()), expected) class Issue6110TestModel(models.Model): diff --git a/tests/test_multitable_inheritance.py b/tests/test_multitable_inheritance.py index 2ddd37ebb..1e8ab3448 100644 --- a/tests/test_multitable_inheritance.py +++ b/tests/test_multitable_inheritance.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.db import models from django.test import TestCase diff --git a/tests/test_negotiation.py b/tests/test_negotiation.py index 7ce3f92a9..089a86c62 100644 --- a/tests/test_negotiation.py +++ b/tests/test_negotiation.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import pytest from django.http import Http404 from django.test import TestCase @@ -80,7 +78,7 @@ class TestAcceptedMediaType(TestCase): assert str(mediatype) == 'test/*; foo=bar' def test_raise_error_if_no_suitable_renderers_found(self): - class MockRenderer(object): + class MockRenderer: format = 'xml' renderers = [MockRenderer()] with pytest.raises(Http404): diff --git a/tests/test_one_to_one_with_inheritance.py b/tests/test_one_to_one_with_inheritance.py index 789c7fcb9..40793d7ca 100644 --- a/tests/test_one_to_one_with_inheritance.py +++ b/tests/test_one_to_one_with_inheritance.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.db import models from django.test import TestCase diff --git a/tests/test_pagination.py b/tests/test_pagination.py index 6d940fe2b..3c581ddfb 100644 --- a/tests/test_pagination.py +++ b/tests/test_pagination.py @@ -1,11 +1,7 @@ -# coding: utf-8 -from __future__ import unicode_literals - import pytest from django.core.paginator import Paginator as DjangoPaginator from django.db import models from django.test import TestCase -from django.utils import six from rest_framework import ( exceptions, filters, generics, pagination, serializers, status @@ -208,7 +204,7 @@ class TestPageNumberPagination: ] } assert self.pagination.display_page_controls - assert isinstance(self.pagination.to_html(), six.text_type) + assert isinstance(self.pagination.to_html(), str) def test_second_page(self): request = Request(factory.get('/', {'page': 2})) @@ -314,7 +310,7 @@ class TestPageNumberPaginationOverride: ] } assert not self.pagination.display_page_controls - assert isinstance(self.pagination.to_html(), six.text_type) + assert isinstance(self.pagination.to_html(), str) def test_invalid_page(self): request = Request(factory.get('/', {'page': 'invalid'})) @@ -369,7 +365,7 @@ class TestLimitOffset: ] } assert self.pagination.display_page_controls - assert isinstance(self.pagination.to_html(), six.text_type) + assert isinstance(self.pagination.to_html(), str) def test_pagination_not_applied_if_limit_or_default_limit_not_set(self): class MockPagination(pagination.LimitOffsetPagination): @@ -503,7 +499,7 @@ class TestLimitOffset: content = self.get_paginated_content(queryset) next_limit = self.pagination.default_limit next_offset = self.pagination.default_limit - next_url = 'http://testserver/?limit={0}&offset={1}'.format(next_limit, next_offset) + next_url = 'http://testserver/?limit={}&offset={}'.format(next_limit, next_offset) assert queryset == [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] assert content.get('next') == next_url @@ -516,7 +512,7 @@ class TestLimitOffset: content = self.get_paginated_content(queryset) next_limit = self.pagination.default_limit next_offset = self.pagination.default_limit - next_url = 'http://testserver/?limit={0}&offset={1}'.format(next_limit, next_offset) + next_url = 'http://testserver/?limit={}&offset={}'.format(next_limit, next_offset) assert queryset == [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] assert content.get('next') == next_url @@ -532,9 +528,9 @@ class TestLimitOffset: max_limit = self.pagination.max_limit next_offset = offset + max_limit prev_offset = offset - max_limit - base_url = 'http://testserver/?limit={0}'.format(max_limit) - next_url = base_url + '&offset={0}'.format(next_offset) - prev_url = base_url + '&offset={0}'.format(prev_offset) + base_url = 'http://testserver/?limit={}'.format(max_limit) + next_url = base_url + '&offset={}'.format(next_offset) + prev_url = base_url + '&offset={}'.format(prev_offset) assert queryset == list(range(51, 66)) assert content.get('next') == next_url assert content.get('previous') == prev_url @@ -632,7 +628,7 @@ class CursorPaginationTestsMixin: assert current == [1, 1, 1, 1, 1] assert next == [1, 2, 3, 4, 4] - assert isinstance(self.pagination.to_html(), six.text_type) + assert isinstance(self.pagination.to_html(), str) def test_cursor_pagination_with_page_size(self): (previous, current, next, previous_url, next_url) = self.get_pages('/?page_size=20') @@ -799,11 +795,11 @@ class TestCursorPagination(CursorPaginationTestsMixin): """ def setup(self): - class MockObject(object): + class MockObject: def __init__(self, idx): self.created = idx - class MockQuerySet(object): + class MockQuerySet: def __init__(self, items): self.items = items diff --git a/tests/test_parsers.py b/tests/test_parsers.py index e793948e3..7cf0c938a 100644 --- a/tests/test_parsers.py +++ b/tests/test_parsers.py @@ -1,6 +1,3 @@ -# -*- coding: utf-8 -*- -from __future__ import unicode_literals - import io import math @@ -11,7 +8,6 @@ from django.core.files.uploadhandler import ( ) from django.http.request import RawPostDataException from django.test import TestCase -from django.utils.six import StringIO from rest_framework.exceptions import ParseError from rest_framework.parsers import ( @@ -34,7 +30,7 @@ class TestFormParser(TestCase): """ Make sure the `QueryDict` works OK """ parser = FormParser() - stream = StringIO(self.string) + stream = io.StringIO(self.string) data = parser.parse(stream) assert Form(data).is_valid() is True @@ -42,7 +38,7 @@ class TestFormParser(TestCase): class TestFileUploadParser(TestCase): def setUp(self): - class MockRequest(object): + class MockRequest: pass self.stream = io.BytesIO( "Test text file".encode('utf-8') diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 2fabdfa05..9c9300694 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -1,8 +1,7 @@ -from __future__ import unicode_literals - import base64 import unittest import warnings +from unittest import mock import django import pytest @@ -15,7 +14,7 @@ from rest_framework import ( HTTP_HEADER_ENCODING, RemovedInDRF310Warning, authentication, generics, permissions, serializers, status, views ) -from rest_framework.compat import PY36, is_guardian_installed, mock +from rest_framework.compat import PY36, is_guardian_installed from rest_framework.filters import DjangoObjectPermissionsFilter from rest_framework.routers import DefaultRouter from rest_framework.test import APIRequestFactory @@ -331,14 +330,14 @@ class ObjectPermissionsIntegrationTests(TestCase): everyone = Group.objects.create(name='everyone') model_name = BasicPermModel._meta.model_name app_label = BasicPermModel._meta.app_label - f = '{0}_{1}'.format + f = '{}_{}'.format perms = { 'view': f('view', model_name), 'change': f('change', model_name), 'delete': f('delete', model_name) } for perm in perms.values(): - perm = '{0}.{1}'.format(app_label, perm) + perm = '{}.{}'.format(app_label, perm) assign_perm(perm, everyone) everyone.user_set.add(*users.values()) diff --git a/tests/test_relations.py b/tests/test_relations.py index 3c4b7d90b..3281b7ea2 100644 --- a/tests/test_relations.py +++ b/tests/test_relations.py @@ -26,7 +26,7 @@ class TestStringRelatedField(APISimpleTestCase): assert representation == '' -class MockApiSettings(object): +class MockApiSettings: def __init__(self, cutoff, cutoff_text): self.HTML_SELECT_CUTOFF = cutoff self.HTML_SELECT_CUTOFF_TEXT = cutoff_text diff --git a/tests/test_relations_hyperlink.py b/tests/test_relations_hyperlink.py index 887a6f423..5ad0e31ff 100644 --- a/tests/test_relations_hyperlink.py +++ b/tests/test_relations_hyperlink.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.conf.urls import url from django.test import TestCase, override_settings diff --git a/tests/test_relations_pk.py b/tests/test_relations_pk.py index 2cffb62e6..0da9da890 100644 --- a/tests/test_relations_pk.py +++ b/tests/test_relations_pk.py @@ -1,7 +1,4 @@ -from __future__ import unicode_literals - from django.test import TestCase -from django.utils import six from rest_framework import serializers from tests.models import ( @@ -263,7 +260,7 @@ class PKForeignKeyTests(TestCase): instance = ForeignKeySource.objects.get(pk=1) serializer = ForeignKeySourceSerializer(instance, data=data) assert not serializer.is_valid() - assert serializer.errors == {'target': ['Incorrect type. Expected pk value, received %s.' % six.text_type.__name__]} + assert serializer.errors == {'target': ['Incorrect type. Expected pk value, received str.']} def test_reverse_foreign_key_update(self): data = {'id': 2, 'name': 'target-2', 'sources': [1, 3]} @@ -562,7 +559,7 @@ class OneToOnePrimaryKeyTests(TestCase): # When: Trying to create a second object second_source = OneToOnePKSourceSerializer(data=data) self.assertFalse(second_source.is_valid()) - expected = {'target': [u'one to one pk source with this target already exists.']} + expected = {'target': ['one to one pk source with this target already exists.']} self.assertDictEqual(second_source.errors, expected) def test_one_to_one_when_primary_key_does_not_exist(self): diff --git a/tests/test_renderers.py b/tests/test_renderers.py index 60a0c0307..54d1cb231 100644 --- a/tests/test_renderers.py +++ b/tests/test_renderers.py @@ -1,6 +1,3 @@ -# -*- coding: utf-8 -*- -from __future__ import unicode_literals - import re from collections import OrderedDict @@ -11,7 +8,6 @@ from django.db import models from django.http.request import HttpRequest from django.template import loader from django.test import TestCase, override_settings -from django.utils import six from django.utils.safestring import SafeText from django.utils.translation import ugettext_lazy as _ @@ -175,7 +171,7 @@ class RendererEndToEndTests(TestCase): resp = self.client.head('/') self.assertEqual(resp.status_code, DUMMYSTATUS) self.assertEqual(resp['Content-Type'], RendererA.media_type + '; charset=utf-8') - self.assertEqual(resp.content, six.b('')) + self.assertEqual(resp.content, b'') def test_default_renderer_serializes_content_on_accept_any(self): """If the Accept header is set to */* the default renderer should serialize the response.""" @@ -348,7 +344,7 @@ class JSONRendererTests(TestCase): self.assertEqual(data, {'key': 'string value', '2': 3}) def test_render_obj_with_getitem(self): - class DictLike(object): + class DictLike: def __init__(self): self._dict = {} @@ -647,7 +643,7 @@ class BrowsableAPIRendererTests(URLPatternsTestCase): assert self.renderer.get_description({}, status_code=403) == '' def test_get_filter_form_returns_none_if_data_is_not_list_instance(self): - class DummyView(object): + class DummyView: get_queryset = None filter_backends = None diff --git a/tests/test_request.py b/tests/test_request.py index 83d295a12..0f682deb0 100644 --- a/tests/test_request.py +++ b/tests/test_request.py @@ -1,8 +1,6 @@ """ Tests for content parsing, and form-overloaded content parsing. """ -from __future__ import unicode_literals - import os.path import tempfile @@ -15,7 +13,6 @@ from django.contrib.sessions.middleware import SessionMiddleware from django.core.files.uploadedfile import SimpleUploadedFile from django.http.request import RawPostDataException from django.test import TestCase, override_settings -from django.utils import six from rest_framework import status from rest_framework.authentication import SessionAuthentication @@ -82,7 +79,7 @@ class TestContentParsing(TestCase): Ensure request.data returns content for POST request with non-form content. """ - content = six.b('qwerty') + content = b'qwerty' content_type = 'text/plain' request = Request(factory.post('/', content, content_type=content_type)) request.parsers = (PlainTextParser(),) @@ -121,7 +118,7 @@ class TestContentParsing(TestCase): Ensure request.data returns content for PUT request with non-form content. """ - content = six.b('qwerty') + content = b'qwerty' content_type = 'text/plain' request = Request(factory.put('/', content, content_type=content_type)) request.parsers = (PlainTextParser(), ) @@ -235,7 +232,7 @@ class TestUserSetter(TestCase): This proves that when an AttributeError is raised inside of the request.user property, that we can handle this and report the true, underlying error. """ - class AuthRaisesAttributeError(object): + class AuthRaisesAttributeError: def authenticate(self, request): self.MISSPELLED_NAME_THAT_DOESNT_EXIST @@ -249,10 +246,6 @@ class TestUserSetter(TestCase): with pytest.raises(WrappedAttributeError, match=expected): request.user - # python 2 hasattr fails for *any* exception, not just AttributeError - if six.PY2: - return - with pytest.raises(WrappedAttributeError, match=expected): hasattr(request, 'user') diff --git a/tests/test_requests_client.py b/tests/test_requests_client.py index 161429f73..59b388c5a 100644 --- a/tests/test_requests_client.py +++ b/tests/test_requests_client.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import unittest from django.conf.urls import url diff --git a/tests/test_response.py b/tests/test_response.py index e92bf54c1..d3a56d01b 100644 --- a/tests/test_response.py +++ b/tests/test_response.py @@ -1,8 +1,5 @@ -from __future__ import unicode_literals - from django.conf.urls import include, url from django.test import TestCase, override_settings -from django.utils import six from rest_framework import generics, routers, serializers, status, viewsets from rest_framework.parsers import JSONParser @@ -150,7 +147,7 @@ class RendererIntegrationTests(TestCase): resp = self.client.head('/') self.assertEqual(resp.status_code, DUMMYSTATUS) self.assertEqual(resp['Content-Type'], RendererA.media_type + '; charset=utf-8') - self.assertEqual(resp.content, six.b('')) + self.assertEqual(resp.content, b'') def test_default_renderer_serializes_content_on_accept_any(self): """If the Accept header is set to */* the default renderer should serialize the response.""" @@ -260,7 +257,7 @@ class Issue807Tests(TestCase): """ headers = {"HTTP_ACCEPT": RendererA.media_type} resp = self.client.get('/', **headers) - expected = "{0}; charset={1}".format(RendererA.media_type, 'utf-8') + expected = "{}; charset={}".format(RendererA.media_type, 'utf-8') self.assertEqual(expected, resp['Content-Type']) def test_if_there_is_charset_specified_on_renderer_it_gets_appended(self): @@ -270,7 +267,7 @@ class Issue807Tests(TestCase): """ headers = {"HTTP_ACCEPT": RendererC.media_type} resp = self.client.get('/', **headers) - expected = "{0}; charset={1}".format(RendererC.media_type, RendererC.charset) + expected = "{}; charset={}".format(RendererC.media_type, RendererC.charset) self.assertEqual(expected, resp['Content-Type']) def test_content_type_set_explicitly_on_response(self): diff --git a/tests/test_reverse.py b/tests/test_reverse.py index 145b1a54f..9ab1667c5 100644 --- a/tests/test_reverse.py +++ b/tests/test_reverse.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.conf.urls import url from django.test import TestCase, override_settings from django.urls import NoReverseMatch @@ -19,7 +17,7 @@ urlpatterns = [ ] -class MockVersioningScheme(object): +class MockVersioningScheme: def __init__(self, raise_error=False): self.raise_error = raise_error diff --git a/tests/test_routers.py b/tests/test_routers.py index cca2ea712..adcec8bd6 100644 --- a/tests/test_routers.py +++ b/tests/test_routers.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import warnings from collections import namedtuple diff --git a/tests/test_schemas.py b/tests/test_schemas.py index 3cb9e0cda..1aad5d1de 100644 --- a/tests/test_schemas.py +++ b/tests/test_schemas.py @@ -29,7 +29,7 @@ from .models import BasicModel, ForeignKeySource, ManyToManySource factory = APIRequestFactory() -class MockUser(object): +class MockUser: def is_authenticated(self): return True @@ -112,7 +112,7 @@ class ExampleViewSet(ModelViewSet): def get_serializer(self, *args, **kwargs): assert self.request assert self.action - return super(ExampleViewSet, self).get_serializer(*args, **kwargs) + return super().get_serializer(*args, **kwargs) @action(methods=['get', 'post'], detail=False) def documented_custom_action(self, request): @@ -1303,7 +1303,7 @@ def test_head_and_options_methods_are_excluded(): @pytest.mark.skipif(not coreapi, reason='coreapi is not installed') -class TestAutoSchemaAllowsFilters(object): +class TestAutoSchemaAllowsFilters: class MockAPIView(APIView): filter_backends = [filters.OrderingFilter] diff --git a/tests/test_serializer.py b/tests/test_serializer.py index 0f1e81965..8f4d9bf63 100644 --- a/tests/test_serializer.py +++ b/tests/test_serializer.py @@ -1,16 +1,13 @@ -# coding: utf-8 -from __future__ import unicode_literals - import inspect import pickle import re -import unittest +from collections import ChainMap import pytest from django.db import models from rest_framework import exceptions, fields, relations, serializers -from rest_framework.compat import Mapping, unicode_repr +from rest_framework.compat import Mapping from rest_framework.fields import Field from .models import ( @@ -18,15 +15,9 @@ from .models import ( ) from .utils import MockObject -try: - from collections import ChainMap -except ImportError: - ChainMap = False - # Test serializer fields imports. # ------------------------------- - class TestFieldImports: def is_field(self, name, value): return ( @@ -130,7 +121,6 @@ class TestSerializer: assert not serializer.is_valid() assert serializer.errors == {'non_field_errors': ['No data provided']} - @unittest.skipUnless(ChainMap, 'requires python 3.3') def test_serialize_chainmap(self): data = ChainMap({'char': 'abc'}, {'integer': 123}) serializer = self.Serializer(data=data) @@ -160,7 +150,7 @@ class TestSerializer: to_internal_value() is expected to return a dict, but subclasses may return application specific type. """ - class Point(object): + class Point: def __init__(self, srid, x, y): self.srid = srid self.coords = (x, y) @@ -171,7 +161,7 @@ class TestSerializer: latitude = serializers.FloatField(source='y') def to_internal_value(self, data): - kwargs = super(NestedPointSerializer, self).to_internal_value(data) + kwargs = super().to_internal_value(data) return Point(srid=4326, **kwargs) serializer = NestedPointSerializer(data={'longitude': 6.958307, 'latitude': 50.941357}) @@ -201,7 +191,7 @@ class TestSerializer: def raise_exception(value): raise exceptions.ValidationError('Raised error') - for validators in ([raise_exception], (raise_exception,), set([raise_exception])): + for validators in ([raise_exception], (raise_exception,), {raise_exception}): class ExampleSerializer(serializers.Serializer): char = serializers.CharField(validators=validators) integer = serializers.IntegerField() @@ -397,7 +387,7 @@ class TestIncorrectlyConfigured: class TestUnicodeRepr: - def test_unicode_repr(self): + def test_repr(self): class ExampleSerializer(serializers.Serializer): example = serializers.CharField() @@ -406,7 +396,7 @@ class TestUnicodeRepr: self.example = '한국' def __repr__(self): - return unicode_repr(self.example) + return repr(self.example) instance = ExampleObject() serializer = ExampleSerializer(instance) @@ -609,7 +599,7 @@ class Test2555Regression: def test_serializer_context(self): class NestedSerializer(serializers.Serializer): def __init__(self, *args, **kwargs): - super(NestedSerializer, self).__init__(*args, **kwargs) + super().__init__(*args, **kwargs) # .context should not cache self.context diff --git a/tests/test_serializer_bulk_update.py b/tests/test_serializer_bulk_update.py index d9e5d7978..0465578bb 100644 --- a/tests/test_serializer_bulk_update.py +++ b/tests/test_serializer_bulk_update.py @@ -1,10 +1,7 @@ """ Tests to cover bulk create and update using serializers. """ -from __future__ import unicode_literals - from django.test import TestCase -from django.utils import six from rest_framework import serializers @@ -87,8 +84,7 @@ class BulkCreateSerializerTests(TestCase): serializer = self.BookSerializer(data=data, many=True) assert serializer.is_valid() is False - text_type_string = six.text_type.__name__ - message = 'Invalid data. Expected a dictionary, but got %s.' % text_type_string + message = 'Invalid data. Expected a dictionary, but got str.' expected_errors = [ {'non_field_errors': [message]}, {'non_field_errors': [message]}, diff --git a/tests/test_settings.py b/tests/test_settings.py index 51e9751b2..b78125ff9 100644 --- a/tests/test_settings.py +++ b/tests/test_settings.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.test import TestCase, override_settings from rest_framework.settings import APISettings, api_settings diff --git a/tests/test_status.py b/tests/test_status.py index 1cd6e229e..07d893bee 100644 --- a/tests/test_status.py +++ b/tests/test_status.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - from django.test import TestCase from rest_framework.status import ( diff --git a/tests/test_templatetags.py b/tests/test_templatetags.py index 45bfd4aeb..128160888 100644 --- a/tests/test_templatetags.py +++ b/tests/test_templatetags.py @@ -1,6 +1,3 @@ -# encoding: utf-8 -from __future__ import unicode_literals - import unittest from django.template import Context, Template @@ -225,7 +222,7 @@ class TemplateTagTests(TestCase): assert result == '' def test_get_pagination_html(self): - class MockPager(object): + class MockPager: def __init__(self): self.called = False @@ -340,7 +337,7 @@ class SchemaLinksTests(TestCase): ) section = schema['users'] flat_links = schema_links(section) - assert len(flat_links) is 0 + assert len(flat_links) == 0 def test_single_action(self): schema = coreapi.Document( @@ -358,7 +355,7 @@ class SchemaLinksTests(TestCase): ) section = schema['users'] flat_links = schema_links(section) - assert len(flat_links) is 1 + assert len(flat_links) == 1 assert 'list' in flat_links def test_default_actions(self): @@ -396,7 +393,7 @@ class SchemaLinksTests(TestCase): ) section = schema['users'] flat_links = schema_links(section) - assert len(flat_links) is 4 + assert len(flat_links) == 4 assert 'list' in flat_links assert 'create' in flat_links assert 'read' in flat_links @@ -444,7 +441,7 @@ class SchemaLinksTests(TestCase): ) section = schema['users'] flat_links = schema_links(section) - assert len(flat_links) is 5 + assert len(flat_links) == 5 assert 'list' in flat_links assert 'create' in flat_links assert 'read' in flat_links @@ -502,7 +499,7 @@ class SchemaLinksTests(TestCase): ) section = schema['users'] flat_links = schema_links(section) - assert len(flat_links) is 6 + assert len(flat_links) == 6 assert 'list' in flat_links assert 'create' in flat_links assert 'read' in flat_links @@ -553,7 +550,7 @@ class SchemaLinksTests(TestCase): ) section = schema['animals'] flat_links = schema_links(section) - assert len(flat_links) is 4 + assert len(flat_links) == 4 assert 'cat > create' in flat_links assert 'cat > list' in flat_links assert 'dog > read' in flat_links @@ -622,7 +619,7 @@ class SchemaLinksTests(TestCase): ) section = schema['animals'] flat_links = schema_links(section) - assert len(flat_links) is 4 + assert len(flat_links) == 4 assert 'cat > create' in flat_links assert 'cat > list' in flat_links assert 'dog > read' in flat_links @@ -630,6 +627,6 @@ class SchemaLinksTests(TestCase): section = schema['farmers'] flat_links = schema_links(section) - assert len(flat_links) is 2 + assert len(flat_links) == 2 assert 'silo > list' in flat_links assert 'silo > soy > list' in flat_links diff --git a/tests/test_testing.py b/tests/test_testing.py index 7868f724c..8094bfd8d 100644 --- a/tests/test_testing.py +++ b/tests/test_testing.py @@ -1,6 +1,3 @@ -# encoding: utf-8 -from __future__ import unicode_literals - from io import BytesIO from django.conf.urls import url @@ -293,13 +290,13 @@ class TestUrlPatternTestCase(URLPatternsTestCase): @classmethod def setUpClass(cls): assert urlpatterns is not cls.urlpatterns - super(TestUrlPatternTestCase, cls).setUpClass() + super().setUpClass() assert urlpatterns is cls.urlpatterns @classmethod def tearDownClass(cls): assert urlpatterns is cls.urlpatterns - super(TestUrlPatternTestCase, cls).tearDownClass() + super().tearDownClass() assert urlpatterns is not cls.urlpatterns def test_urlpatterns(self): diff --git a/tests/test_throttling.py b/tests/test_throttling.py index b220a33a6..b20b6a809 100644 --- a/tests/test_throttling.py +++ b/tests/test_throttling.py @@ -1,7 +1,6 @@ """ Tests for the throttling implementations in the permissions module. """ -from __future__ import unicode_literals import pytest from django.contrib.auth.models import User @@ -296,7 +295,7 @@ class ScopedRateThrottleTests(TestCase): assert response.status_code == 200 def test_get_cache_key_returns_correct_key_if_user_is_authenticated(self): - class DummyView(object): + class DummyView: throttle_scope = 'user' request = Request(HttpRequest()) diff --git a/tests/test_urlpatterns.py b/tests/test_urlpatterns.py index 59ba395d2..25cc0032e 100644 --- a/tests/test_urlpatterns.py +++ b/tests/test_urlpatterns.py @@ -1,5 +1,3 @@ -from __future__ import unicode_literals - import unittest from collections import namedtuple diff --git a/tests/test_utils.py b/tests/test_utils.py index 28b06b173..a6f8b9d16 100644 --- a/tests/test_utils.py +++ b/tests/test_utils.py @@ -1,6 +1,3 @@ -# -*- coding: utf-8 -*- -from __future__ import unicode_literals - from django.conf.urls import url from django.test import TestCase, override_settings diff --git a/tests/test_validation.py b/tests/test_validation.py index 4132a7b00..6e00b48c2 100644 --- a/tests/test_validation.py +++ b/tests/test_validation.py @@ -1,11 +1,8 @@ -from __future__ import unicode_literals - import re from django.core.validators import MaxValueValidator, RegexValidator from django.db import models from django.test import TestCase -from django.utils import six from rest_framework import generics, serializers, status from rest_framework.test import APIRequestFactory @@ -112,7 +109,7 @@ class TestAvoidValidation(TestCase): assert not serializer.is_valid() assert serializer.errors == { 'non_field_errors': [ - 'Invalid data. Expected a dictionary, but got %s.' % six.text_type.__name__ + 'Invalid data. Expected a dictionary, but got str.', ] } @@ -151,14 +148,14 @@ class TestMaxValueValidatorValidation(TestCase): def test_max_value_validation_success(self): obj = ValidationMaxValueValidatorModel.objects.create(number_value=100) - request = factory.patch('/{0}'.format(obj.pk), {'number_value': 98}, format='json') + request = factory.patch('/{}'.format(obj.pk), {'number_value': 98}, format='json') view = UpdateMaxValueValidationModel().as_view() response = view(request, pk=obj.pk).render() assert response.status_code == status.HTTP_200_OK def test_max_value_validation_fail(self): obj = ValidationMaxValueValidatorModel.objects.create(number_value=100) - request = factory.patch('/{0}'.format(obj.pk), {'number_value': 101}, format='json') + request = factory.patch('/{}'.format(obj.pk), {'number_value': 101}, format='json') view = UpdateMaxValueValidationModel().as_view() response = view(request, pk=obj.pk).render() assert response.content == b'{"number_value":["Ensure this value is less than or equal to 100."]}' diff --git a/tests/test_validators.py b/tests/test_validators.py index 4bbddb64b..fe31ba235 100644 --- a/tests/test_validators.py +++ b/tests/test_validators.py @@ -353,7 +353,7 @@ class TestUniquenessTogetherValidation(TestCase): filter_queryset should add value from existing instance attribute if it is not provided in attributes dict """ - class MockQueryset(object): + class MockQueryset: def filter(self, **kwargs): self.called_with = kwargs @@ -558,19 +558,19 @@ class TestHiddenFieldUniquenessForDateValidation(TestCase): class ValidatorsTests(TestCase): def test_qs_exists_handles_type_error(self): - class TypeErrorQueryset(object): + class TypeErrorQueryset: def exists(self): raise TypeError assert qs_exists(TypeErrorQueryset()) is False def test_qs_exists_handles_value_error(self): - class ValueErrorQueryset(object): + class ValueErrorQueryset: def exists(self): raise ValueError assert qs_exists(ValueErrorQueryset()) is False def test_qs_exists_handles_data_error(self): - class DataErrorQueryset(object): + class DataErrorQueryset: def exists(self): raise DataError assert qs_exists(DataErrorQueryset()) is False diff --git a/tests/test_versioning.py b/tests/test_versioning.py index 7e650e275..d4e269df3 100644 --- a/tests/test_versioning.py +++ b/tests/test_versioning.py @@ -319,9 +319,9 @@ class TestHyperlinkedRelatedField(URLPatternsTestCase, APITestCase): ] def setUp(self): - super(TestHyperlinkedRelatedField, self).setUp() + super().setUp() - class MockQueryset(object): + class MockQueryset: def get(self, pk): return 'object %s' % pk diff --git a/tests/test_views.py b/tests/test_views.py index f0919e846..2648c9fb3 100644 --- a/tests/test_views.py +++ b/tests/test_views.py @@ -1,7 +1,4 @@ -from __future__ import unicode_literals - import copy -import sys from django.test import TestCase @@ -14,10 +11,7 @@ from rest_framework.views import APIView factory = APIRequestFactory() -if sys.version_info[:2] >= (3, 4): - JSON_ERROR = 'JSON parse error - Expecting value:' -else: - JSON_ERROR = 'JSON parse error - No JSON object could be decoded' +JSON_ERROR = 'JSON parse error - Expecting value:' class BasicView(APIView): diff --git a/tests/utils.py b/tests/utils.py index 509e6a102..06e5b9abe 100644 --- a/tests/utils.py +++ b/tests/utils.py @@ -2,7 +2,7 @@ from django.core.exceptions import ObjectDoesNotExist from django.urls import NoReverseMatch -class MockObject(object): +class MockObject: def __init__(self, **kwargs): self._kwargs = kwargs for key, val in kwargs.items(): @@ -16,7 +16,7 @@ class MockObject(object): return '' % kwargs_str -class MockQueryset(object): +class MockQueryset: def __init__(self, iterable): self.items = iterable @@ -33,7 +33,7 @@ class MockQueryset(object): raise ObjectDoesNotExist() -class BadType(object): +class BadType: """ When used as a lookup with a `MockQueryset`, these objects will raise a `TypeError`, as occurs in Django when making diff --git a/tox.ini b/tox.ini index 5d7a4987e..fcd32f88a 100644 --- a/tox.ini +++ b/tox.ini @@ -1,6 +1,6 @@ [tox] envlist = - {py27,py34,py35,py36}-django111, + {py34,py35,py36}-django111, {py34,py35,py36,py37}-django20, {py35,py36,py37}-django21 {py35,py36,py37}-django22 @@ -44,7 +44,7 @@ deps = -rrequirements/requirements-optionals.txt [testenv:lint] -basepython = python2.7 +basepython = python3.7 commands = ./runtests.py --lintonly deps = -rrequirements/requirements-codestyle.txt @@ -52,6 +52,7 @@ deps = [testenv:docs] basepython = python2.7 +skip_install = true commands = mkdocs build deps = -rrequirements/requirements-testing.txt From ff86f09f74a0f60b657576abc8cf805c308a3974 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:44:33 -0700 Subject: [PATCH 23/69] Remove unnecessary compatibility shims from rest_framework/compat.py (#6631) For Python 3, collections.abc.Mapping and collections.abc.MutableMapping are always available from the stdlib. --- rest_framework/compat.py | 1 - rest_framework/fields.py | 3 ++- rest_framework/serializers.py | 3 ++- rest_framework/utils/serializer_helpers.py | 2 +- tests/test_renderers.py | 3 ++- tests/test_serializer.py | 2 +- 6 files changed, 8 insertions(+), 6 deletions(-) diff --git a/rest_framework/compat.py b/rest_framework/compat.py index aad44e342..3068665a8 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -3,7 +3,6 @@ The `compat` module provides support for backwards compatibility with older versions of Django/Python, and compatibility wrappers around optional packages. """ import sys -from collections.abc import Mapping, MutableMapping # noqa from django.conf import settings from django.core import validators diff --git a/rest_framework/fields.py b/rest_framework/fields.py index ad9611e05..1cffdcc2d 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -6,6 +6,7 @@ import inspect import re import uuid from collections import OrderedDict +from collections.abc import Mapping from django.conf import settings from django.core.exceptions import ObjectDoesNotExist @@ -30,7 +31,7 @@ from pytz.exceptions import InvalidTimeError from rest_framework import ISO_8601 from rest_framework.compat import ( - Mapping, MaxLengthValidator, MaxValueValidator, MinLengthValidator, + MaxLengthValidator, MaxValueValidator, MinLengthValidator, MinValueValidator, ProhibitNullCharactersValidator ) from rest_framework.exceptions import ErrorDetail, ValidationError diff --git a/rest_framework/serializers.py b/rest_framework/serializers.py index 90b31e068..651ca81cf 100644 --- a/rest_framework/serializers.py +++ b/rest_framework/serializers.py @@ -14,6 +14,7 @@ import copy import inspect import traceback from collections import OrderedDict +from collections.abc import Mapping from django.core.exceptions import ImproperlyConfigured from django.core.exceptions import ValidationError as DjangoValidationError @@ -25,7 +26,7 @@ from django.utils import timezone from django.utils.functional import cached_property from django.utils.translation import ugettext_lazy as _ -from rest_framework.compat import Mapping, postgres_fields +from rest_framework.compat import postgres_fields from rest_framework.exceptions import ErrorDetail, ValidationError from rest_framework.fields import get_error_detail, set_value from rest_framework.settings import api_settings diff --git a/rest_framework/utils/serializer_helpers.py b/rest_framework/utils/serializer_helpers.py index 8709352f1..80aea27d3 100644 --- a/rest_framework/utils/serializer_helpers.py +++ b/rest_framework/utils/serializer_helpers.py @@ -1,8 +1,8 @@ from collections import OrderedDict +from collections.abc import MutableMapping from django.utils.encoding import force_text -from rest_framework.compat import MutableMapping from rest_framework.utils import json diff --git a/tests/test_renderers.py b/tests/test_renderers.py index 54d1cb231..bc775547d 100644 --- a/tests/test_renderers.py +++ b/tests/test_renderers.py @@ -1,5 +1,6 @@ import re from collections import OrderedDict +from collections.abc import MutableMapping import pytest from django.conf.urls import include, url @@ -12,7 +13,7 @@ from django.utils.safestring import SafeText from django.utils.translation import ugettext_lazy as _ from rest_framework import permissions, serializers, status -from rest_framework.compat import MutableMapping, coreapi +from rest_framework.compat import coreapi from rest_framework.decorators import action from rest_framework.renderers import ( AdminRenderer, BaseRenderer, BrowsableAPIRenderer, DocumentationRenderer, diff --git a/tests/test_serializer.py b/tests/test_serializer.py index 8f4d9bf63..33cc0b60c 100644 --- a/tests/test_serializer.py +++ b/tests/test_serializer.py @@ -2,12 +2,12 @@ import inspect import pickle import re from collections import ChainMap +from collections.abc import Mapping import pytest from django.db import models from rest_framework import exceptions, fields, relations, serializers -from rest_framework.compat import Mapping from rest_framework.fields import Field from .models import ( From b4e80ac721958f8cc2931b0e2b4d022946f6ad88 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:45:16 -0700 Subject: [PATCH 24/69] Remove unnecessary coerce to str() in test_decorators.py (#6637) Was added only for Python 2 compatibility. --- tests/test_decorators.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/tests/test_decorators.py b/tests/test_decorators.py index 3f24e7ef0..bd30449e5 100644 --- a/tests/test_decorators.py +++ b/tests/test_decorators.py @@ -202,8 +202,7 @@ class ActionDecoratorTestCase(TestCase): def method(): raise NotImplementedError - # Python 2.x compatibility - cast __name__ to str - method.__name__ = str(name) + method.__name__ = name getattr(test_action.mapping, name)(method) # ensure the mapping returns the correct method name From 734ca7ca8c2ba6f0ca83ede015652720b2a7246d Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:46:30 -0700 Subject: [PATCH 25/69] Remove unneeded repo() test (#6632) --- tests/test_serializer.py | 17 ----------------- 1 file changed, 17 deletions(-) diff --git a/tests/test_serializer.py b/tests/test_serializer.py index 33cc0b60c..e0acf368b 100644 --- a/tests/test_serializer.py +++ b/tests/test_serializer.py @@ -386,23 +386,6 @@ class TestIncorrectlyConfigured: ) -class TestUnicodeRepr: - def test_repr(self): - class ExampleSerializer(serializers.Serializer): - example = serializers.CharField() - - class ExampleObject: - def __init__(self): - self.example = '한국' - - def __repr__(self): - return repr(self.example) - - instance = ExampleObject() - serializer = ExampleSerializer(instance) - repr(serializer) # Should not error. - - class TestNotRequiredOutput: def test_not_required_output_for_dict(self): """ From 513a49d63b6332e373c89fb0737a0745c1f0a734 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:49:17 -0700 Subject: [PATCH 26/69] Drop default 'utf-8' to .encode()/.decode() (#6633) A Python 3 cleanup that allows for less noise in the code. https://docs.python.org/3/library/stdtypes.html#bytes.decode https://docs.python.org/3/library/stdtypes.html#str.encode --- rest_framework/fields.py | 7 ++---- .../management/commands/generateschema.py | 2 +- rest_framework/parsers.py | 2 +- rest_framework/renderers.py | 23 +++++++------------ rest_framework/utils/encoders.py | 2 +- tests/authentication/test_authentication.py | 2 +- tests/browsable_api/test_browsable_api.py | 12 +++++----- .../test_browsable_nested_api.py | 2 +- tests/test_generics.py | 6 ++--- tests/test_parsers.py | 6 ++--- tests/test_renderers.py | 22 +++++++++--------- tests/test_routers.py | 10 ++++---- tests/test_templates.py | 4 ++-- 13 files changed, 44 insertions(+), 56 deletions(-) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 1cffdcc2d..a41934ac1 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1754,7 +1754,7 @@ class JSONField(Field): try: if self.binary or getattr(data, 'is_json_string', False): if isinstance(data, bytes): - data = data.decode('utf-8') + data = data.decode() return json.loads(data) else: json.dumps(data) @@ -1765,10 +1765,7 @@ class JSONField(Field): def to_representation(self, value): if self.binary: value = json.dumps(value) - # On python 2.x the return type for json.dumps() is underspecified. - # On python 3.x json.dumps() returns unicode strings. - if isinstance(value, str): - value = bytes(value.encode('utf-8')) + value = value.encode() return value diff --git a/rest_framework/management/commands/generateschema.py b/rest_framework/management/commands/generateschema.py index 591073ba0..40909bd04 100644 --- a/rest_framework/management/commands/generateschema.py +++ b/rest_framework/management/commands/generateschema.py @@ -29,7 +29,7 @@ class Command(BaseCommand): renderer = self.get_renderer(options['format']) output = renderer.render(schema, renderer_context={}) - self.stdout.write(output.decode('utf-8')) + self.stdout.write(output.decode()) def get_renderer(self, format): renderer_cls = { diff --git a/rest_framework/parsers.py b/rest_framework/parsers.py index 5b5e3f158..a48c31631 100644 --- a/rest_framework/parsers.py +++ b/rest_framework/parsers.py @@ -202,7 +202,7 @@ class FileUploadParser(BaseParser): try: meta = parser_context['request'].META - disposition = parse_header(meta['HTTP_CONTENT_DISPOSITION'].encode('utf-8')) + disposition = parse_header(meta['HTTP_CONTENT_DISPOSITION'].encode()) filename_parm = disposition[1] if 'filename*' in filename_parm: return self.get_encoded_filename(filename_parm) diff --git a/rest_framework/renderers.py b/rest_framework/renderers.py index eb5da008b..623702966 100644 --- a/rest_framework/renderers.py +++ b/rest_framework/renderers.py @@ -104,18 +104,11 @@ class JSONRenderer(BaseRenderer): allow_nan=not self.strict, separators=separators ) - # On python 2.x json.dumps() returns bytestrings if ensure_ascii=True, - # but if ensure_ascii=False, the return type is underspecified, - # and may (or may not) be unicode. - # On python 3.x json.dumps() returns unicode strings. - if isinstance(ret, str): - # We always fully escape \u2028 and \u2029 to ensure we output JSON - # that is a strict javascript subset. If bytes were returned - # by json.dumps() then we don't have these characters in any case. - # See: http://timelessrepo.com/json-isnt-a-javascript-subset - ret = ret.replace('\u2028', '\\u2028').replace('\u2029', '\\u2029') - return bytes(ret.encode('utf-8')) - return ret + # We always fully escape \u2028 and \u2029 to ensure we output JSON + # that is a strict javascript subset. + # See: http://timelessrepo.com/json-isnt-a-javascript-subset + ret = ret.replace('\u2028', '\\u2028').replace('\u2029', '\\u2029') + return ret.encode() class TemplateHTMLRenderer(BaseRenderer): @@ -574,7 +567,7 @@ class BrowsableAPIRenderer(BaseRenderer): data.pop(name, None) content = renderer.render(data, accepted, context) # Renders returns bytes, but CharField expects a str. - content = content.decode('utf-8') + content = content.decode() else: content = None @@ -1032,7 +1025,7 @@ class OpenAPIRenderer(_BaseOpenAPIRenderer): def render(self, data, media_type=None, renderer_context=None): structure = self.get_structure(data) - return yaml.dump(structure, default_flow_style=False).encode('utf-8') + return yaml.dump(structure, default_flow_style=False).encode() class JSONOpenAPIRenderer(_BaseOpenAPIRenderer): @@ -1045,4 +1038,4 @@ class JSONOpenAPIRenderer(_BaseOpenAPIRenderer): def render(self, data, media_type=None, renderer_context=None): structure = self.get_structure(data) - return json.dumps(structure, indent=4).encode('utf-8') + return json.dumps(structure, indent=4).encode() diff --git a/rest_framework/utils/encoders.py b/rest_framework/utils/encoders.py index dee2f942e..a7875a868 100644 --- a/rest_framework/utils/encoders.py +++ b/rest_framework/utils/encoders.py @@ -47,7 +47,7 @@ class JSONEncoder(json.JSONEncoder): return tuple(obj) elif isinstance(obj, bytes): # Best-effort for binary blobs. See #4187. - return obj.decode('utf-8') + return obj.decode() elif hasattr(obj, 'tolist'): # Numpy arrays and array scalars. return obj.tolist() diff --git a/tests/authentication/test_authentication.py b/tests/authentication/test_authentication.py index f7e9fcf18..927989028 100644 --- a/tests/authentication/test_authentication.py +++ b/tests/authentication/test_authentication.py @@ -183,7 +183,7 @@ class SessionAuthTests(TestCase): cf. [#1810](https://github.com/encode/django-rest-framework/pull/1810) """ response = self.csrf_client.get('/auth/login/') - content = response.content.decode('utf8') + content = response.content.decode() assert '' in content def test_post_form_session_auth_failing_csrf(self): diff --git a/tests/browsable_api/test_browsable_api.py b/tests/browsable_api/test_browsable_api.py index 81090e223..17644c2ac 100644 --- a/tests/browsable_api/test_browsable_api.py +++ b/tests/browsable_api/test_browsable_api.py @@ -24,18 +24,18 @@ class DropdownWithAuthTests(TestCase): def test_name_shown_when_logged_in(self): self.client.login(username=self.username, password=self.password) response = self.client.get('/') - content = response.content.decode('utf8') + content = response.content.decode() assert 'john' in content def test_logout_shown_when_logged_in(self): self.client.login(username=self.username, password=self.password) response = self.client.get('/') - content = response.content.decode('utf8') + content = response.content.decode() assert '>Log out<' in content def test_login_shown_when_logged_out(self): response = self.client.get('/') - content = response.content.decode('utf8') + content = response.content.decode() assert '>Log in<' in content @@ -59,16 +59,16 @@ class NoDropdownWithoutAuthTests(TestCase): def test_name_shown_when_logged_in(self): self.client.login(username=self.username, password=self.password) response = self.client.get('/') - content = response.content.decode('utf8') + content = response.content.decode() assert 'john' in content def test_dropdown_not_shown_when_logged_in(self): self.client.login(username=self.username, password=self.password) response = self.client.get('/') - content = response.content.decode('utf8') + content = response.content.decode() assert '
  • ' not in content def test_dropdown_not_shown_when_logged_out(self): response = self.client.get('/') - content = response.content.decode('utf8') + content = response.content.decode() assert '
  • ' not in content diff --git a/tests/browsable_api/test_browsable_nested_api.py b/tests/browsable_api/test_browsable_nested_api.py index 3fef74023..f945d2a43 100644 --- a/tests/browsable_api/test_browsable_nested_api.py +++ b/tests/browsable_api/test_browsable_nested_api.py @@ -34,7 +34,7 @@ class DropdownWithAuthTests(TestCase): def test_login(self): response = self.client.get('/api/') assert 200 == response.status_code - content = response.content.decode('utf-8') + content = response.content.decode() assert 'form action="/api/"' in content assert 'input name="nested.one"' in content assert 'input name="nested.two"' in content diff --git a/tests/test_generics.py b/tests/test_generics.py index f41ebe6da..0b91e3465 100644 --- a/tests/test_generics.py +++ b/tests/test_generics.py @@ -164,7 +164,7 @@ class TestRootView(TestCase): request = factory.post('/', data, HTTP_ACCEPT='text/html') response = self.view(request).render() expected_error = 'Ensure this field has no more than 100 characters.' - assert expected_error in response.rendered_content.decode('utf-8') + assert expected_error in response.rendered_content.decode() EXPECTED_QUERIES_FOR_PUT = 2 @@ -311,7 +311,7 @@ class TestInstanceView(TestCase): request = factory.put('/', data, HTTP_ACCEPT='text/html') response = self.view(request, pk=1).render() expected_error = 'Ensure this field has no more than 100 characters.' - assert expected_error in response.rendered_content.decode('utf-8') + assert expected_error in response.rendered_content.decode() class TestFKInstanceView(TestCase): @@ -538,7 +538,7 @@ class TestFilterBackendAppliedToViews(TestCase): view = DynamicSerializerView.as_view() request = factory.get('/') response = view(request).render() - content = response.content.decode('utf8') + content = response.content.decode() assert 'field_b' in content assert 'field_a' not in content diff --git a/tests/test_parsers.py b/tests/test_parsers.py index 7cf0c938a..dcd62fac9 100644 --- a/tests/test_parsers.py +++ b/tests/test_parsers.py @@ -40,9 +40,7 @@ class TestFileUploadParser(TestCase): def setUp(self): class MockRequest: pass - self.stream = io.BytesIO( - "Test text file".encode('utf-8') - ) + self.stream = io.BytesIO(b"Test text file") request = MockRequest() request.upload_handlers = (MemoryFileUploadHandler(),) request.META = { @@ -128,7 +126,7 @@ class TestFileUploadParser(TestCase): class TestJSONParser(TestCase): def bytes(self, value): - return io.BytesIO(value.encode('utf-8')) + return io.BytesIO(value.encode()) def test_float_strictness(self): parser = JSONParser() diff --git a/tests/test_renderers.py b/tests/test_renderers.py index bc775547d..f374fc344 100644 --- a/tests/test_renderers.py +++ b/tests/test_renderers.py @@ -304,14 +304,14 @@ class JSONRendererTests(TestCase): o = DummyTestModel.objects.create(name='dummy') qs = DummyTestModel.objects.values('id', 'name') ret = JSONRenderer().render(qs) - data = json.loads(ret.decode('utf-8')) + data = json.loads(ret.decode()) self.assertEqual(data, [{'id': o.id, 'name': o.name}]) def test_render_queryset_values_list(self): o = DummyTestModel.objects.create(name='dummy') qs = DummyTestModel.objects.values_list('id', 'name') ret = JSONRenderer().render(qs) - data = json.loads(ret.decode('utf-8')) + data = json.loads(ret.decode()) self.assertEqual(data, [[o.id, o.name]]) def test_render_dict_abc_obj(self): @@ -341,7 +341,7 @@ class JSONRendererTests(TestCase): x['key'] = 'string value' x[2] = 3 ret = JSONRenderer().render(x) - data = json.loads(ret.decode('utf-8')) + data = json.loads(ret.decode()) self.assertEqual(data, {'key': 'string value', '2': 3}) def test_render_obj_with_getitem(self): @@ -381,7 +381,7 @@ class JSONRendererTests(TestCase): renderer = JSONRenderer() content = renderer.render(obj, 'application/json') # Fix failing test case which depends on version of JSON library. - self.assertEqual(content.decode('utf-8'), _flat_repr) + self.assertEqual(content.decode(), _flat_repr) def test_with_content_type_args(self): """ @@ -390,7 +390,7 @@ class JSONRendererTests(TestCase): obj = {'foo': ['bar', 'baz']} renderer = JSONRenderer() content = renderer.render(obj, 'application/json; indent=2') - self.assertEqual(strip_trailing_whitespace(content.decode('utf-8')), _indented_repr) + self.assertEqual(strip_trailing_whitespace(content.decode()), _indented_repr) class UnicodeJSONRendererTests(TestCase): @@ -401,7 +401,7 @@ class UnicodeJSONRendererTests(TestCase): obj = {'countries': ['United Kingdom', 'France', 'España']} renderer = JSONRenderer() content = renderer.render(obj, 'application/json') - self.assertEqual(content, '{"countries":["United Kingdom","France","España"]}'.encode('utf-8')) + self.assertEqual(content, '{"countries":["United Kingdom","France","España"]}'.encode()) def test_u2028_u2029(self): # The \u2028 and \u2029 characters should be escaped, @@ -410,7 +410,7 @@ class UnicodeJSONRendererTests(TestCase): obj = {'should_escape': '\u2028\u2029'} renderer = JSONRenderer() content = renderer.render(obj, 'application/json') - self.assertEqual(content, '{"should_escape":"\\u2028\\u2029"}'.encode('utf-8')) + self.assertEqual(content, '{"should_escape":"\\u2028\\u2029"}'.encode()) class AsciiJSONRendererTests(TestCase): @@ -423,7 +423,7 @@ class AsciiJSONRendererTests(TestCase): obj = {'countries': ['United Kingdom', 'France', 'España']} renderer = AsciiJSONRenderer() content = renderer.render(obj, 'application/json') - self.assertEqual(content, '{"countries":["United Kingdom","France","Espa\\u00f1a"]}'.encode('utf-8')) + self.assertEqual(content, '{"countries":["United Kingdom","France","Espa\\u00f1a"]}'.encode()) # Tests for caching issue, #346 @@ -654,9 +654,9 @@ class BrowsableAPIRendererTests(URLPatternsTestCase): def test_extra_actions_dropdown(self): resp = self.client.get('/api/examples/', HTTP_ACCEPT='text/html') - assert 'id="extra-actions-menu"' in resp.content.decode('utf-8') - assert '/api/examples/list_action/' in resp.content.decode('utf-8') - assert '>Extra list action<' in resp.content.decode('utf-8') + assert 'id="extra-actions-menu"' in resp.content.decode() + assert '/api/examples/list_action/' in resp.content.decode() + assert '>Extra list action<' in resp.content.decode() class AdminRendererTests(TestCase): diff --git a/tests/test_routers.py b/tests/test_routers.py index adcec8bd6..0f428e2a5 100644 --- a/tests/test_routers.py +++ b/tests/test_routers.py @@ -438,13 +438,13 @@ class TestEmptyPrefix(URLPatternsTestCase, TestCase): def test_empty_prefix_list(self): response = self.client.get('/empty-prefix/') assert response.status_code == 200 - assert json.loads(response.content.decode('utf-8')) == [{'uuid': '111', 'text': 'First'}, - {'uuid': '222', 'text': 'Second'}] + assert json.loads(response.content.decode()) == [{'uuid': '111', 'text': 'First'}, + {'uuid': '222', 'text': 'Second'}] def test_empty_prefix_detail(self): response = self.client.get('/empty-prefix/1/') assert response.status_code == 200 - assert json.loads(response.content.decode('utf-8')) == {'uuid': '111', 'text': 'First'} + assert json.loads(response.content.decode()) == {'uuid': '111', 'text': 'First'} class TestRegexUrlPath(URLPatternsTestCase, TestCase): @@ -456,14 +456,14 @@ class TestRegexUrlPath(URLPatternsTestCase, TestCase): kwarg = '1234' response = self.client.get('/regex/list/{}/'.format(kwarg)) assert response.status_code == 200 - assert json.loads(response.content.decode('utf-8')) == {'kwarg': kwarg} + assert json.loads(response.content.decode()) == {'kwarg': kwarg} def test_regex_url_path_detail(self): pk = '1' kwarg = '1234' response = self.client.get('/regex/{}/detail/{}/'.format(pk, kwarg)) assert response.status_code == 200 - assert json.loads(response.content.decode('utf-8')) == {'pk': pk, 'kwarg': kwarg} + assert json.loads(response.content.decode()) == {'pk': pk, 'kwarg': kwarg} class TestViewInitkwargs(URLPatternsTestCase, TestCase): diff --git a/tests/test_templates.py b/tests/test_templates.py index 19f511b96..0dba78ea2 100644 --- a/tests/test_templates.py +++ b/tests/test_templates.py @@ -6,7 +6,7 @@ from django.shortcuts import render def test_base_template_with_context(): context = {'request': True, 'csrf_token': 'TOKEN'} result = render({}, 'rest_framework/base.html', context=context) - assert re.search(r'\bcsrfToken: "TOKEN"', result.content.decode('utf-8')) + assert re.search(r'\bcsrfToken: "TOKEN"', result.content.decode()) def test_base_template_with_no_context(): @@ -14,4 +14,4 @@ def test_base_template_with_no_context(): # so it can be easily extended. result = render({}, 'rest_framework/base.html') # note that this response will not include a valid CSRF token - assert re.search(r'\bcsrfToken: ""', result.content.decode('utf-8')) + assert re.search(r'\bcsrfToken: ""', result.content.decode()) From 3f19e66d9f2569895af6e91455e5cf53b8ce5640 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:49:54 -0700 Subject: [PATCH 27/69] Replace all usage ugettext functions with the non-u versions (#6634) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit On Python 3, the ugettext functions are a simple aliases of their non-u counterparts (the 'u' represents Python 2 unicode type). Starting with Django 3.0, the u versions will be deprecated. https://docs.djangoproject.com/en/dev/releases/3.0/#id2 > django.utils.translation.ugettext(), ugettext_lazy(), ugettext_noop(), > ungettext(), and ungettext_lazy() are deprecated in favor of the > functions that they’re aliases for: > django.utils.translation.gettext(), gettext_lazy(), gettext_noop(), > ngettext(), and ngettext_lazy(). --- rest_framework/authentication.py | 2 +- rest_framework/authtoken/apps.py | 2 +- rest_framework/authtoken/models.py | 2 +- rest_framework/authtoken/serializers.py | 2 +- rest_framework/exceptions.py | 10 +++++----- rest_framework/fields.py | 2 +- rest_framework/filters.py | 2 +- rest_framework/pagination.py | 2 +- rest_framework/relations.py | 2 +- rest_framework/schemas/inspectors.py | 2 +- rest_framework/serializers.py | 2 +- rest_framework/validators.py | 2 +- rest_framework/versioning.py | 2 +- tests/models.py | 2 +- tests/test_exceptions.py | 2 +- tests/test_renderers.py | 2 +- 16 files changed, 20 insertions(+), 20 deletions(-) diff --git a/rest_framework/authentication.py b/rest_framework/authentication.py index 0612563e4..1e30728d3 100644 --- a/rest_framework/authentication.py +++ b/rest_framework/authentication.py @@ -6,7 +6,7 @@ import binascii from django.contrib.auth import authenticate, get_user_model from django.middleware.csrf import CsrfViewMiddleware -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework import HTTP_HEADER_ENCODING, exceptions diff --git a/rest_framework/authtoken/apps.py b/rest_framework/authtoken/apps.py index ad01cb404..f90fe961e 100644 --- a/rest_framework/authtoken/apps.py +++ b/rest_framework/authtoken/apps.py @@ -1,5 +1,5 @@ from django.apps import AppConfig -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ class AuthTokenConfig(AppConfig): diff --git a/rest_framework/authtoken/models.py b/rest_framework/authtoken/models.py index 0ed02c415..bff42d3de 100644 --- a/rest_framework/authtoken/models.py +++ b/rest_framework/authtoken/models.py @@ -3,7 +3,7 @@ import os from django.conf import settings from django.db import models -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ class Token(models.Model): diff --git a/rest_framework/authtoken/serializers.py b/rest_framework/authtoken/serializers.py index e5f46dd66..bb552f3e5 100644 --- a/rest_framework/authtoken/serializers.py +++ b/rest_framework/authtoken/serializers.py @@ -1,5 +1,5 @@ from django.contrib.auth import authenticate -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework import serializers diff --git a/rest_framework/exceptions.py b/rest_framework/exceptions.py index 8fbdfcd08..a91138026 100644 --- a/rest_framework/exceptions.py +++ b/rest_framework/exceptions.py @@ -8,8 +8,8 @@ import math from django.http import JsonResponse from django.utils.encoding import force_text -from django.utils.translation import ugettext_lazy as _ -from django.utils.translation import ungettext +from django.utils.translation import gettext_lazy as _ +from django.utils.translation import ngettext from rest_framework import status from rest_framework.utils.serializer_helpers import ReturnDict, ReturnList @@ -230,9 +230,9 @@ class Throttled(APIException): wait = math.ceil(wait) detail = ' '.join(( detail, - force_text(ungettext(self.extra_detail_singular.format(wait=wait), - self.extra_detail_plural.format(wait=wait), - wait)))) + force_text(ngettext(self.extra_detail_singular.format(wait=wait), + self.extra_detail_plural.format(wait=wait), + wait)))) self.wait = wait super().__init__(detail, code) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index a41934ac1..5e3132074 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -26,7 +26,7 @@ from django.utils.formats import localize_input, sanitize_separators from django.utils.functional import lazy from django.utils.ipv6 import clean_ipv6_address from django.utils.timezone import utc -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from pytz.exceptions import InvalidTimeError from rest_framework import ISO_8601 diff --git a/rest_framework/filters.py b/rest_framework/filters.py index b77069ddc..d5fe36964 100644 --- a/rest_framework/filters.py +++ b/rest_framework/filters.py @@ -12,7 +12,7 @@ from django.db.models.constants import LOOKUP_SEP from django.db.models.sql.constants import ORDER_PATTERN from django.template import loader from django.utils.encoding import force_text -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework import RemovedInDRF310Warning from rest_framework.compat import ( diff --git a/rest_framework/pagination.py b/rest_framework/pagination.py index fcc78da43..0b2877a45 100644 --- a/rest_framework/pagination.py +++ b/rest_framework/pagination.py @@ -10,7 +10,7 @@ from django.core.paginator import InvalidPage from django.core.paginator import Paginator as DjangoPaginator from django.template import loader from django.utils.encoding import force_text -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework.compat import coreapi, coreschema from rest_framework.exceptions import NotFound diff --git a/rest_framework/relations.py b/rest_framework/relations.py index 76c4d7008..3c2132c5b 100644 --- a/rest_framework/relations.py +++ b/rest_framework/relations.py @@ -7,7 +7,7 @@ from django.db.models import Manager from django.db.models.query import QuerySet from django.urls import NoReverseMatch, Resolver404, get_script_prefix, resolve from django.utils.encoding import smart_text, uri_to_iri -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework.fields import ( Field, empty, get_attribute, is_simple_callable, iter_options diff --git a/rest_framework/schemas/inspectors.py b/rest_framework/schemas/inspectors.py index 91d8405eb..66f71a93e 100644 --- a/rest_framework/schemas/inspectors.py +++ b/rest_framework/schemas/inspectors.py @@ -11,7 +11,7 @@ from weakref import WeakKeyDictionary from django.db import models from django.utils.encoding import force_text, smart_text -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework import exceptions, serializers from rest_framework.compat import coreapi, coreschema, uritemplate diff --git a/rest_framework/serializers.py b/rest_framework/serializers.py index 651ca81cf..742fa6577 100644 --- a/rest_framework/serializers.py +++ b/rest_framework/serializers.py @@ -24,7 +24,7 @@ from django.db.models.fields import Field as DjangoModelField from django.db.models.fields import FieldDoesNotExist from django.utils import timezone from django.utils.functional import cached_property -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework.compat import postgres_fields from rest_framework.exceptions import ErrorDetail, ValidationError diff --git a/rest_framework/validators.py b/rest_framework/validators.py index a5222fbc6..1cbe31b5e 100644 --- a/rest_framework/validators.py +++ b/rest_framework/validators.py @@ -7,7 +7,7 @@ object creation, and makes it possible to switch between using the implicit `ModelSerializer` class and an equivalent explicit `Serializer` class. """ from django.db import DataError -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework.exceptions import ValidationError from rest_framework.utils.representation import smart_repr diff --git a/rest_framework/versioning.py b/rest_framework/versioning.py index 0631a75c9..8c35a1a58 100644 --- a/rest_framework/versioning.py +++ b/rest_framework/versioning.py @@ -1,6 +1,6 @@ import re -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework import exceptions from rest_framework.compat import unicode_http_header diff --git a/tests/models.py b/tests/models.py index f389a51a9..2c340a3e6 100644 --- a/tests/models.py +++ b/tests/models.py @@ -1,7 +1,7 @@ import uuid from django.db import models -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ class RESTFrameworkModel(models.Model): diff --git a/tests/test_exceptions.py b/tests/test_exceptions.py index 13b1b4757..9516bfec9 100644 --- a/tests/test_exceptions.py +++ b/tests/test_exceptions.py @@ -1,6 +1,6 @@ from django.test import RequestFactory, TestCase from django.utils import translation -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework.exceptions import ( APIException, ErrorDetail, Throttled, _get_error_details, bad_request, diff --git a/tests/test_renderers.py b/tests/test_renderers.py index f374fc344..0a0271f45 100644 --- a/tests/test_renderers.py +++ b/tests/test_renderers.py @@ -10,7 +10,7 @@ from django.http.request import HttpRequest from django.template import loader from django.test import TestCase, override_settings from django.utils.safestring import SafeText -from django.utils.translation import ugettext_lazy as _ +from django.utils.translation import gettext_lazy as _ from rest_framework import permissions, serializers, status from rest_framework.compat import coreapi From 8687f6135fc374c8d7977939ff3d8b2514c00e51 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:50:29 -0700 Subject: [PATCH 28/69] Remove references to Python 2 from the docs (#6635) --- CONTRIBUTING.md | 2 +- docs/community/contributing.md | 2 +- docs/index.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c947a7b8c..be814571f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -115,7 +115,7 @@ It's also useful to remember that if you have an outstanding pull request then p GitHub's documentation for working on pull requests is [available here][pull-requests]. -Always run the tests before submitting pull requests, and ideally run `tox` in order to check that your modifications are compatible with both Python 2 and Python 3, and that they run properly on all supported versions of Django. +Always run the tests before submitting pull requests, and ideally run `tox` in order to check that your modifications are compatible on all supported versions of Python and Django. Once you've made a pull request take a look at the Travis build status in the GitHub interface and make sure the tests are running as you'd expect. diff --git a/docs/community/contributing.md b/docs/community/contributing.md index 9cc6ccee0..9c8603199 100644 --- a/docs/community/contributing.md +++ b/docs/community/contributing.md @@ -121,7 +121,7 @@ It's also useful to remember that if you have an outstanding pull request then p GitHub's documentation for working on pull requests is [available here][pull-requests]. -Always run the tests before submitting pull requests, and ideally run `tox` in order to check that your modifications are compatible with both Python 2 and Python 3, and that they run properly on all supported versions of Django. +Always run the tests before submitting pull requests, and ideally run `tox` in order to check that your modifications are compatible on all supported versions of Python and Django. Once you've made a pull request take a look at the Travis build status in the GitHub interface and make sure the tests are running as you'd expect. diff --git a/docs/index.md b/docs/index.md index 9f5d3fa15..7adc52dfb 100644 --- a/docs/index.md +++ b/docs/index.md @@ -84,7 +84,7 @@ continued development by **[signing up for a paid plan][funding]**. REST framework requires the following: -* Python (2.7, 3.4, 3.5, 3.6, 3.7) +* Python (3.4, 3.5, 3.6, 3.7) * Django (1.11, 2.0, 2.1, 2.2) We **highly recommend** and only officially support the latest patch release of From 565794bedc0bf585b1f9cccef8004dda10af732e Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:51:02 -0700 Subject: [PATCH 29/69] Replace virtualenv references with venv in the docs (#6636) On Python 3, creating virtual environments is available through the stdlib module venv. https://docs.python.org/3/library/venv.html --- CONTRIBUTING.md | 2 +- docs/community/contributing.md | 2 +- docs/tutorial/1-serialization.md | 10 +++++----- docs/tutorial/quickstart.md | 6 +++--- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index be814571f..2f1aad08f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -59,7 +59,7 @@ Changes should broadly follow the [PEP 8][pep-8] style conventions, and we recom To run the tests, clone the repository, and then: # Setup the virtual environment - virtualenv env + python3 -m venv env source env/bin/activate pip install django pip install -r requirements.txt diff --git a/docs/community/contributing.md b/docs/community/contributing.md index 9c8603199..cb67100d2 100644 --- a/docs/community/contributing.md +++ b/docs/community/contributing.md @@ -65,7 +65,7 @@ Changes should broadly follow the [PEP 8][pep-8] style conventions, and we recom To run the tests, clone the repository, and then: # Setup the virtual environment - virtualenv env + python3 -m venv env source env/bin/activate pip install django pip install -r requirements.txt diff --git a/docs/tutorial/1-serialization.md b/docs/tutorial/1-serialization.md index 224ebf25b..22fe49e39 100644 --- a/docs/tutorial/1-serialization.md +++ b/docs/tutorial/1-serialization.md @@ -14,18 +14,18 @@ The tutorial is fairly in-depth, so you should probably get a cookie and a cup o ## Setting up a new environment -Before we do anything else we'll create a new virtual environment, using [virtualenv]. This will make sure our package configuration is kept nicely isolated from any other projects we're working on. +Before we do anything else we'll create a new virtual environment, using [venv]. This will make sure our package configuration is kept nicely isolated from any other projects we're working on. - virtualenv env + python3 -m venv env source env/bin/activate -Now that we're inside a virtualenv environment, we can install our package requirements. +Now that we're inside a virtual environment, we can install our package requirements. pip install django pip install djangorestframework pip install pygments # We'll be using this for the code highlighting -**Note:** To exit the virtualenv environment at any time, just type `deactivate`. For more information see the [virtualenv documentation][virtualenv]. +**Note:** To exit the virtual environment at any time, just type `deactivate`. For more information see the [venv documentation][venv]. ## Getting started @@ -372,7 +372,7 @@ We'll see how we can start to improve things in [part 2 of the tutorial][tut-2]. [quickstart]: quickstart.md [repo]: https://github.com/encode/rest-framework-tutorial [sandbox]: https://restframework.herokuapp.com/ -[virtualenv]: http://www.virtualenv.org/en/latest/index.html +[venv]: https://docs.python.org/3/library/venv.html [tut-2]: 2-requests-and-responses.md [httpie]: https://github.com/jakubroztocil/httpie#installation [curl]: https://curl.haxx.se/ diff --git a/docs/tutorial/quickstart.md b/docs/tutorial/quickstart.md index cbec2501b..8b02b888e 100644 --- a/docs/tutorial/quickstart.md +++ b/docs/tutorial/quickstart.md @@ -10,11 +10,11 @@ Create a new Django project named `tutorial`, then start a new app called `quick mkdir tutorial cd tutorial - # Create a virtualenv to isolate our package dependencies locally - virtualenv env + # Create a virtual environment to isolate our package dependencies locally + python3 -m venv env source env/bin/activate # On Windows use `env\Scripts\activate` - # Install Django and Django REST framework into the virtualenv + # Install Django and Django REST framework into the virtual environment pip install django pip install djangorestframework From 5e1619bc9ef6725ed5d317bc100ad26d2b9106e0 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:51:54 -0700 Subject: [PATCH 30/69] Remove unnecessary assignments immediately before a return statement (#6619) Cleans up the pattern: ... myvar = return myvar To: ... return --- rest_framework/parsers.py | 3 +-- rest_framework/renderers.py | 3 +-- rest_framework/schemas/generators.py | 7 ++----- rest_framework/schemas/inspectors.py | 3 +-- rest_framework/utils/representation.py | 4 +--- tests/test_renderers.py | 3 +-- 6 files changed, 7 insertions(+), 16 deletions(-) diff --git a/rest_framework/parsers.py b/rest_framework/parsers.py index a48c31631..978576a71 100644 --- a/rest_framework/parsers.py +++ b/rest_framework/parsers.py @@ -80,8 +80,7 @@ class FormParser(BaseParser): """ parser_context = parser_context or {} encoding = parser_context.get('encoding', settings.DEFAULT_CHARSET) - data = QueryDict(stream.read(), encoding=encoding) - return data + return QueryDict(stream.read(), encoding=encoding) class MultiPartParser(BaseParser): diff --git a/rest_framework/renderers.py b/rest_framework/renderers.py index 623702966..143d1b7e7 100644 --- a/rest_framework/renderers.py +++ b/rest_framework/renderers.py @@ -674,7 +674,7 @@ class BrowsableAPIRenderer(BaseRenderer): csrf_header_name = csrf_header_name[5:] csrf_header_name = csrf_header_name.replace('_', '-') - context = { + return { 'content': self.get_content(renderer, data, accepted_media_type, renderer_context), 'code_style': pygments_css(self.code_style), 'view': view, @@ -710,7 +710,6 @@ class BrowsableAPIRenderer(BaseRenderer): 'csrf_cookie_name': csrf_cookie_name, 'csrf_header_name': csrf_header_name } - return context def render(self, data, accepted_media_type=None, renderer_context=None): """ diff --git a/rest_framework/schemas/generators.py b/rest_framework/schemas/generators.py index b8da446f7..66afcca94 100644 --- a/rest_framework/schemas/generators.py +++ b/rest_framework/schemas/generators.py @@ -184,9 +184,7 @@ class EndpointEnumerator: ) api_endpoints.extend(nested_endpoints) - api_endpoints = sorted(api_endpoints, key=endpoint_ordering) - - return api_endpoints + return sorted(api_endpoints, key=endpoint_ordering) def get_path_from_regex(self, path_regex): """ @@ -195,8 +193,7 @@ class EndpointEnumerator: path = simplify_regex(path_regex) # Strip Django 2.0 convertors as they are incompatible with uritemplate format - path = re.sub(_PATH_PARAMETER_COMPONENT_RE, r'{\g}', path) - return path + return re.sub(_PATH_PARAMETER_COMPONENT_RE, r'{\g}', path) def should_include_endpoint(self, path, callback): """ diff --git a/rest_framework/schemas/inspectors.py b/rest_framework/schemas/inspectors.py index 66f71a93e..2858c8c5b 100644 --- a/rest_framework/schemas/inspectors.py +++ b/rest_framework/schemas/inspectors.py @@ -435,8 +435,7 @@ class AutoSchema(ViewInspector): by_name = OrderedDict((f.name, f) for f in fields) for f in update_with: by_name[f.name] = f - fields = list(by_name.values()) - return fields + return list(by_name.values()) def get_encoding(self, path, method): """ diff --git a/rest_framework/utils/representation.py b/rest_framework/utils/representation.py index ebead5d75..3916eb686 100644 --- a/rest_framework/utils/representation.py +++ b/rest_framework/utils/representation.py @@ -41,9 +41,7 @@ def smart_repr(value): # # Should be presented as # - value = re.sub(' at 0x[0-9A-Fa-f]{4,32}>', '>', value) - - return value + return re.sub(' at 0x[0-9A-Fa-f]{4,32}>', '>', value) def field_repr(field, force_many=False): diff --git a/tests/test_renderers.py b/tests/test_renderers.py index 0a0271f45..d63dbcb9c 100644 --- a/tests/test_renderers.py +++ b/tests/test_renderers.py @@ -76,8 +76,7 @@ class MockView(APIView): renderer_classes = (RendererA, RendererB) def get(self, request, **kwargs): - response = Response(DUMMYCONTENT, status=DUMMYSTATUS) - return response + return Response(DUMMYCONTENT, status=DUMMYSTATUS) class MockGETView(APIView): From 059947028bd9e741a06ef40b3d9f0bd9cecae090 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 30 Apr 2019 22:52:26 -0700 Subject: [PATCH 31/69] Update docs on django-oauth-toolkit (#6618) Since django-oauth-toolkit 1.2.0 (2018-06-03), the package requires Python 3.4+. https://github.com/jazzband/django-oauth-toolkit/blob/master/CHANGELOG.md#120-2018-06-03 --- docs/api-guide/authentication.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/authentication.md b/docs/api-guide/authentication.md index 5b8a9844f..52650299f 100644 --- a/docs/api-guide/authentication.md +++ b/docs/api-guide/authentication.md @@ -354,7 +354,7 @@ The following third party packages are also available. ## Django OAuth Toolkit -The [Django OAuth Toolkit][django-oauth-toolkit] package provides OAuth 2.0 support, and works with Python 2.7 and Python 3.3+. The package is maintained by [Evonove][evonove] and uses the excellent [OAuthLib][oauthlib]. The package is well documented, and well supported and is currently our **recommended package for OAuth 2.0 support**. +The [Django OAuth Toolkit][django-oauth-toolkit] package provides OAuth 2.0 support and works with Python 3.4+. The package is maintained by [Evonove][evonove] and uses the excellent [OAuthLib][oauthlib]. The package is well documented, and well supported and is currently our **recommended package for OAuth 2.0 support**. #### Installation & configuration From 1c976f2ac8313551d4910e9f55290c5d362f3dfa Mon Sep 17 00:00:00 2001 From: vu3jej Date: Thu, 2 May 2019 03:54:38 +0530 Subject: [PATCH 32/69] Fix typo in docs (#6628) --- docs/api-guide/validators.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/validators.md b/docs/api-guide/validators.md index ab042ac03..9b2fc82ed 100644 --- a/docs/api-guide/validators.md +++ b/docs/api-guide/validators.md @@ -159,7 +159,7 @@ If you want the date field to be entirely hidden from the user, then use `Hidden --- -**Note**: The `UniqueForValidation` classes impose an implicit constraint that the fields they are applied to are always treated as required. Fields with `default` values are an exception to this as they always supply a value even when omitted from user input. +**Note**: The `UniqueForValidator` classes impose an implicit constraint that the fields they are applied to are always treated as required. Fields with `default` values are an exception to this as they always supply a value even when omitted from user input. --- From e16273a6584f9657c1e5c388558e9c5c92e7ba38 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Wed, 1 May 2019 15:32:28 -0700 Subject: [PATCH 33/69] Simplify import_from_string() with Django's import_string() (#6617) --- rest_framework/settings.py | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/rest_framework/settings.py b/rest_framework/settings.py index 5d92d0cb4..1d5dc036f 100644 --- a/rest_framework/settings.py +++ b/rest_framework/settings.py @@ -18,10 +18,9 @@ This module provides the `api_setting` object, that is used to access REST framework settings, checking for user settings first, then falling back to the defaults. """ -from importlib import import_module - from django.conf import settings from django.test.signals import setting_changed +from django.utils.module_loading import import_string from rest_framework import ISO_8601 @@ -175,11 +174,8 @@ def import_from_string(val, setting_name): Attempt to import a class from a string representation. """ try: - # Nod to tastypie's use of importlib. - module_path, class_name = val.rsplit('.', 1) - module = import_module(module_path) - return getattr(module, class_name) - except (ImportError, AttributeError) as e: + return import_string(val) + except ImportError as e: msg = "Could not import '%s' for API setting '%s'. %s: %s." % (val, setting_name, e.__class__.__name__, e) raise ImportError(msg) From f669395dd80786d40d73c70341502013540f97a0 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Wed, 1 May 2019 16:47:01 -0700 Subject: [PATCH 34/69] Fix BytesWarning in test_schemas.py (#6638) --- tests/test_schemas.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/test_schemas.py b/tests/test_schemas.py index 1aad5d1de..230f8f012 100644 --- a/tests/test_schemas.py +++ b/tests/test_schemas.py @@ -1358,4 +1358,4 @@ def test_schema_handles_exception(): response = schema_view(request) response.render() assert response.status_code == 403 - assert "You do not have permission to perform this action." in str(response.content) + assert b"You do not have permission to perform this action." in response.content From 67d2eabd6c611631c7610276c38abd3cece26ee7 Mon Sep 17 00:00:00 2001 From: Afnarel Date: Thu, 2 May 2019 02:23:23 +0200 Subject: [PATCH 35/69] Fix username in template for custom user models (#6612) --- rest_framework/templates/rest_framework/docs/auth/session.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rest_framework/templates/rest_framework/docs/auth/session.html b/rest_framework/templates/rest_framework/docs/auth/session.html index d09d3f2aa..59430d95e 100644 --- a/rest_framework/templates/rest_framework/docs/auth/session.html +++ b/rest_framework/templates/rest_framework/docs/auth/session.html @@ -12,7 +12,7 @@
    {% if user.is_authenticated %} -

    You are logged in as {{ user.username }}.

    +

    You are logged in as {{ user.get_username }}.

    {% else %}
    From 1e519486e14da11bcf2b92845ddd65c48761edc0 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Wed, 1 May 2019 17:42:10 -0700 Subject: [PATCH 36/69] Fixup isort command/config (#6639) --- runtests.py | 2 +- setup.cfg | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/runtests.py b/runtests.py index a32dde96c..19513cdbf 100755 --- a/runtests.py +++ b/runtests.py @@ -11,7 +11,7 @@ PYTEST_ARGS = { FLAKE8_ARGS = ['rest_framework', 'tests'] -ISORT_ARGS = ['--recursive', '--check-only', '--diff', '-o' 'uritemplate', '-p', 'tests', 'rest_framework', 'tests'] +ISORT_ARGS = ['--recursive', '--check-only', '--diff', 'rest_framework', 'tests'] def exit_on_failure(ret, message=None): diff --git a/setup.cfg b/setup.cfg index b4dee6804..c021fdde0 100644 --- a/setup.cfg +++ b/setup.cfg @@ -14,8 +14,8 @@ skip=.tox atomic=true multi_line_output=5 known_standard_library=types -known_third_party=pytest,_pytest,django,pytz -known_first_party=rest_framework +known_third_party=pytest,_pytest,django,pytz,uritemplate +known_first_party=rest_framework,tests [coverage:run] # NOTE: source is ignored with pytest-cov (but uses the same). From 14fad0d6902550cd61fc07370759ef785effa207 Mon Sep 17 00:00:00 2001 From: Jimmy Merrild Krag Date: Fri, 3 May 2019 03:17:33 +0200 Subject: [PATCH 37/69] Fix capitalization, markdown syntax link in docs (#6621) The `Pygments` and `Markdown` python packages have first letter capital. Fixed link to markdown syntax to go directly to the syntax page. --- docs/topics/documenting-your-api.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/topics/documenting-your-api.md b/docs/topics/documenting-your-api.md index 7eab08ecf..701b5824b 100644 --- a/docs/topics/documenting-your-api.md +++ b/docs/topics/documenting-your-api.md @@ -17,7 +17,7 @@ The built-in API documentation includes: ### Installation The `coreapi` library is required as a dependency for the API docs. Make sure -to install the latest version. The `pygments` and `markdown` libraries +to install the latest version. The `Pygments` and `Markdown` libraries are optional but recommended. To install the API documentation, you'll need to include it in your project's URLconf: @@ -277,7 +277,7 @@ When working with viewsets, an appropriate suffix is appended to each generated The description in the browsable API is generated from the docstring of the view or viewset. -If the python `markdown` library is installed, then [markdown syntax][markdown] may be used in the docstring, and will be converted to HTML in the browsable API. For example: +If the python `Markdown` library is installed, then [markdown syntax][markdown] may be used in the docstring, and will be converted to HTML in the browsable API. For example: class AccountListView(views.APIView): """ @@ -331,7 +331,7 @@ To implement a hypermedia API you'll need to decide on an appropriate media type [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/ +[markdown]: https://daringfireball.net/projects/markdown/syntax [hypermedia-docs]: rest-hypermedia-hateoas.md [image-drf-docs]: ../img/drfdocs.png [image-django-rest-swagger]: ../img/django-rest-swagger.png From 0f819d844d33c63e0d34d0885a9cde1aa854441d Mon Sep 17 00:00:00 2001 From: Aart Goossens Date: Sat, 4 May 2019 00:26:06 +0200 Subject: [PATCH 38/69] Remove recommendation for DRF Docs (#6580) Since DRF Docs is not compatible with the latest version of DRF (or Django?; related issue: https://github.com/manosim/django-rest-framework-docs/issues/180) and the latest release is almost 3 years ago I suggest to remove the recommendation for this package. --- docs/img/drfdocs.png | Bin 580358 -> 0 bytes docs/topics/documenting-your-api.md | 18 +----------------- 2 files changed, 1 insertion(+), 17 deletions(-) delete mode 100644 docs/img/drfdocs.png diff --git a/docs/img/drfdocs.png b/docs/img/drfdocs.png deleted file mode 100644 index 0cccb41f710cab2a2c75fe0f04f4c18303beb9e9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 580358 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μ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

    0y=r=px)&Acre|!qeS% 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

    -`47=#jBJ_5@ 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

    v++Ct4@{s=7N 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

    #s0~YCV)!$8yOd>`pmg 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�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 z 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 Date: Tue, 7 May 2019 00:35:58 +0600 Subject: [PATCH 39/69] Drop Python 3.4 support (#6620) --- .travis.yml | 3 --- README.md | 2 +- docs/index.md | 2 +- setup.py | 5 ++--- tests/test_fields.py | 9 +-------- tox.ini | 4 ++-- 6 files changed, 7 insertions(+), 18 deletions(-) diff --git a/.travis.yml b/.travis.yml index 04a5ff99e..a4a4ed8b5 100644 --- a/.travis.yml +++ b/.travis.yml @@ -5,9 +5,6 @@ matrix: fast_finish: true include: - - { python: "3.4", env: DJANGO=1.11 } - - { python: "3.4", env: DJANGO=2.0 } - - { python: "3.5", env: DJANGO=1.11 } - { python: "3.5", env: DJANGO=2.0 } - { python: "3.5", env: DJANGO=2.1 } diff --git a/README.md b/README.md index 7d0bdd2ad..b80b7fe01 100644 --- a/README.md +++ b/README.md @@ -53,7 +53,7 @@ There is a live example API for testing purposes, [available here][sandbox]. # Requirements -* Python (3.4, 3.5, 3.6, 3.7) +* Python (3.5, 3.6, 3.7) * Django (1.11, 2.0, 2.1, 2.2) We **highly recommend** and only officially support the latest patch release of diff --git a/docs/index.md b/docs/index.md index 7adc52dfb..8a550140a 100644 --- a/docs/index.md +++ b/docs/index.md @@ -84,7 +84,7 @@ continued development by **[signing up for a paid plan][funding]**. REST framework requires the following: -* Python (3.4, 3.5, 3.6, 3.7) +* Python (3.5, 3.6, 3.7) * Django (1.11, 2.0, 2.1, 2.2) We **highly recommend** and only officially support the latest patch release of diff --git a/setup.py b/setup.py index 632c7dfd3..6c0d64239 100755 --- a/setup.py +++ b/setup.py @@ -8,7 +8,7 @@ from io import open from setuptools import find_packages, setup CURRENT_PYTHON = sys.version_info[:2] -REQUIRED_PYTHON = (3, 4) +REQUIRED_PYTHON = (3, 5) # This check and everything above must remain compatible with Python 2.7. if CURRENT_PYTHON < REQUIRED_PYTHON: @@ -79,7 +79,7 @@ setup( packages=find_packages(exclude=['tests*']), include_package_data=True, install_requires=[], - python_requires=">=3.4", + python_requires=">=3.5", zip_safe=False, classifiers=[ 'Development Status :: 5 - Production/Stable', @@ -94,7 +94,6 @@ setup( 'Operating System :: OS Independent', 'Programming Language :: Python', 'Programming Language :: Python :: 3', - 'Programming Language :: Python :: 3.4', 'Programming Language :: Python :: 3.5', 'Programming Language :: Python :: 3.6', 'Programming Language :: Python :: 3.7', diff --git a/tests/test_fields.py b/tests/test_fields.py index e0833564b..41d08bd5e 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -1,7 +1,6 @@ import datetime import os import re -import unittest import uuid from decimal import ROUND_DOWN, ROUND_UP, Decimal @@ -17,15 +16,10 @@ from rest_framework import exceptions, serializers from rest_framework.compat import ProhibitNullCharactersValidator from rest_framework.fields import DjangoImageField, is_simple_callable -try: - import typing -except ImportError: - typing = False - - # Tests for helper functions. # --------------------------- + class TestIsSimpleCallable: def test_method(self): @@ -92,7 +86,6 @@ class TestIsSimpleCallable: assert is_simple_callable(ChoiceModel().get_choice_field_display) - @unittest.skipUnless(typing, 'requires python 3.5') def test_type_annotation(self): # The annotation will otherwise raise a syntax error in python < 3.5 locals = {} diff --git a/tox.ini b/tox.ini index fcd32f88a..ab5e54cc3 100644 --- a/tox.ini +++ b/tox.ini @@ -1,7 +1,7 @@ [tox] envlist = - {py34,py35,py36}-django111, - {py34,py35,py36,py37}-django20, + {py35,py36}-django111, + {py35,py36,py37}-django20, {py35,py36,py37}-django21 {py35,py36,py37}-django22 {py36,py37}-djangomaster, From 680ed8aa8b579f344cf4806476c43173f939fcd6 Mon Sep 17 00:00:00 2001 From: Serkan Hosca Date: Mon, 6 May 2019 19:19:51 -0400 Subject: [PATCH 40/69] Add django-rest-witchcraft to third party packages (#6587) --- 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 ace54f6f7..135b600f9 100644 --- a/docs/community/third-party-packages.md +++ b/docs/community/third-party-packages.md @@ -264,6 +264,7 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque * [djangorest-alchemy][djangorest-alchemy] - SQLAlchemy support for REST framework. * [djangorestframework-datatables][djangorestframework-datatables] - Seamless integration between Django REST framework and [Datatables](https://datatables.net). * [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 [cite]: http://www.software-ecosystems.com/Software_Ecosystems/Ecosystems.html [cookiecutter]: https://github.com/jpadilla/cookiecutter-django-rest-framework @@ -338,3 +339,4 @@ To submit new content, [open an issue][drf-create-issue] or [create a pull reque [djangorest-alchemy]: https://github.com/dealertrack/djangorest-alchemy [djangorestframework-datatables]: https://github.com/izimobil/django-rest-framework-datatables [django-rest-framework-condition]: https://github.com/jozo/django-rest-framework-condition +[django-rest-witchcraft]: https://github.com/shosca/django-rest-witchcraft From be5a9f78f324bcda14f865196ac2b307eb597167 Mon Sep 17 00:00:00 2001 From: Andreu Vallbona Plazas Date: Tue, 7 May 2019 20:01:24 +0200 Subject: [PATCH 41/69] Added note on serializing extra fields from Through Model (#6652) * adding small clarification on ManyToManyFields with a Through Model As pointed here: https://github.com/encode/django-rest-framework/pull/6585#issuecomment-490145334 I suggest to add the small clarification to work with **ManyToManyFields with a Through Model**. * Remove blank line. --- docs/api-guide/relations.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/api-guide/relations.md b/docs/api-guide/relations.md index 8665e80f6..2048cd923 100644 --- a/docs/api-guide/relations.md +++ b/docs/api-guide/relations.md @@ -576,6 +576,8 @@ If you explicitly specify a relational field pointing to a ``ManyToManyField`` with a through model, be sure to set ``read_only`` to ``True``. +If you wish to represent [extra fields on a through model][django-intermediary-manytomany] then you may serialize the through model as [a nested object][dealing-with-nested-objects]. + --- # Third Party Packages @@ -596,3 +598,5 @@ The [rest-framework-generic-relations][drf-nested-relations] library provides re [generic-relations]: https://docs.djangoproject.com/en/stable/ref/contrib/contenttypes/#id1 [drf-nested-routers]: https://github.com/alanjds/drf-nested-routers [drf-nested-relations]: https://github.com/Ian-Foote/rest-framework-generic-relations +[django-intermediary-manytomany]: https://docs.djangoproject.com/en/2.2/topics/db/models/#intermediary-manytomany +[dealing-with-nested-objects]: https://www.django-rest-framework.org/api-guide/serializers/#dealing-with-nested-objects From 3a21b390ff51e1b48f6d55d0343050c808460c88 Mon Sep 17 00:00:00 2001 From: Jorrit Date: Wed, 8 May 2019 16:48:45 +0200 Subject: [PATCH 42/69] Fix test with STRICT_JSON setting Test is not overriding the intended setting, should be nested inside settings.REST_FRAMEWORK --- tests/test_utils.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/test_utils.py b/tests/test_utils.py index a6f8b9d16..0d61cc2f9 100644 --- a/tests/test_utils.py +++ b/tests/test_utils.py @@ -189,7 +189,7 @@ class JsonFloatTests(TestCase): json.loads("NaN") -@override_settings(STRICT_JSON=False) +@override_settings(REST_FRAMEWORK={'STRICT_JSON': False}) class NonStrictJsonFloatTests(JsonFloatTests): """ 'STRICT_JSON = False' should not somehow affect internal json behavior From 564faddb0fe6f640f38a1abb7387a86d6fe13243 Mon Sep 17 00:00:00 2001 From: Tim Gates <47873678+timgates42@users.noreply.github.com> Date: Thu, 9 May 2019 12:34:38 +1000 Subject: [PATCH 43/69] Make Markdown 2.6 the minimum compatible version (#6576) --- docs/index.md | 2 +- rest_framework/compat.py | 13 +++---------- 2 files changed, 4 insertions(+), 11 deletions(-) diff --git a/docs/index.md b/docs/index.md index 8a550140a..c8507cf1e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -93,7 +93,7 @@ each Python and Django series. The following packages are optional: * [coreapi][coreapi] (1.32.0+) - Schema generation support. -* [Markdown][markdown] (2.1.0+) - Markdown support for the browsable API. +* [Markdown][markdown] (2.6.0+) - Markdown support for the browsable API. * [django-filter][django-filter] (1.0.1+) - Filtering support. * [django-crispy-forms][django-crispy-forms] - Improved HTML display for filtering. * [django-guardian][django-guardian] (1.1.1+) - Object level permissions support. diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 3068665a8..1feaf9faa 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -143,19 +143,12 @@ if 'patch' not in View.http_method_names: View.http_method_names = View.http_method_names + ['patch'] -# Markdown is optional +# Markdown is optional (version 2.6+ required) try: import markdown - if markdown.version <= '2.2': - HEADERID_EXT_PATH = 'headerid' - LEVEL_PARAM = 'level' - elif markdown.version < '2.6': - HEADERID_EXT_PATH = 'markdown.extensions.headerid' - LEVEL_PARAM = 'level' - else: - HEADERID_EXT_PATH = 'markdown.extensions.toc' - LEVEL_PARAM = 'baselevel' + HEADERID_EXT_PATH = 'markdown.extensions.toc' + LEVEL_PARAM = 'baselevel' def apply_markdown(text): """ From a7c577cb31c80715570df978faf58267c3c06618 Mon Sep 17 00:00:00 2001 From: gaetano-guerriero Date: Thu, 9 May 2019 10:18:20 +0200 Subject: [PATCH 44/69] Dict field allow empty (#6583) * dict field: support allow_empty option * document ListField allow_empty option * document HStoreField allow_empty parameter --- docs/api-guide/fields.md | 9 ++++++--- rest_framework/fields.py | 7 ++++++- tests/test_fields.py | 11 +++++++++++ 3 files changed, 23 insertions(+), 4 deletions(-) diff --git a/docs/api-guide/fields.md b/docs/api-guide/fields.md index d371bb8fd..b2830d0c9 100644 --- a/docs/api-guide/fields.md +++ b/docs/api-guide/fields.md @@ -448,9 +448,10 @@ Requires either the `Pillow` package or `PIL` package. The `Pillow` package is A field class that validates a list of objects. -**Signature**: `ListField(child=, min_length=None, max_length=None)` +**Signature**: `ListField(child=, allow_empty=True, min_length=None, max_length=None)` - `child` - A field instance that should be used for validating the objects in the list. If this argument is not provided then objects in the list will not be validated. +- `allow_empty` - Designates if empty lists are allowed. - `min_length` - Validates that the list contains no fewer than this number of elements. - `max_length` - Validates that the list contains no more than this number of elements. @@ -471,9 +472,10 @@ We can now reuse our custom `StringListField` class throughout our application, A field class that validates a dictionary of objects. The keys in `DictField` are always assumed to be string values. -**Signature**: `DictField(child=)` +**Signature**: `DictField(child=, allow_empty=True)` - `child` - A field instance that should be used for validating the values in the dictionary. If this argument is not provided then values in the mapping will not be validated. +- `allow_empty` - Designates if empty dictionaries are allowed. For example, to create a field that validates a mapping of strings to strings, you would write something like this: @@ -488,9 +490,10 @@ You can also use the declarative style, as with `ListField`. For example: A preconfigured `DictField` that is compatible with Django's postgres `HStoreField`. -**Signature**: `HStoreField(child=)` +**Signature**: `HStoreField(child=, allow_empty=True)` - `child` - A field instance that is used for validating the values in the dictionary. The default child field accepts both empty strings and null values. +- `allow_empty` - Designates if empty dictionaries are allowed. Note that the child field **must** be an instance of `CharField`, as the hstore extension stores values as strings. diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 5e3132074..e2fb8cdc6 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1663,11 +1663,13 @@ class DictField(Field): child = _UnvalidatedField() initial = {} default_error_messages = { - 'not_a_dict': _('Expected a dictionary of items but got type "{input_type}".') + 'not_a_dict': _('Expected a dictionary of items but got type "{input_type}".'), + 'empty': _('This dictionary may not be empty.'), } def __init__(self, *args, **kwargs): self.child = kwargs.pop('child', copy.deepcopy(self.child)) + self.allow_empty = kwargs.pop('allow_empty', True) assert not inspect.isclass(self.child), '`child` has not been instantiated.' assert self.child.source is None, ( @@ -1693,6 +1695,9 @@ class DictField(Field): data = html.parse_html_dict(data) if not isinstance(data, dict): self.fail('not_a_dict', input_type=type(data).__name__) + if not self.allow_empty and len(data) == 0: + self.fail('empty') + return self.run_child_validation(data) def to_representation(self, value): diff --git a/tests/test_fields.py b/tests/test_fields.py index 41d08bd5e..e7f16c178 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -1982,6 +1982,7 @@ class TestDictField(FieldValues): """ valid_inputs = [ ({'a': 1, 'b': '2', 3: 3}, {'a': '1', 'b': '2', '3': '3'}), + ({}, {}), ] invalid_inputs = [ ({'a': 1, 'b': None, 'c': None}, {'b': ['This field may not be null.'], 'c': ['This field may not be null.']}), @@ -2009,6 +2010,16 @@ class TestDictField(FieldValues): output = field.run_validation(None) assert output is None + def test_allow_empty_disallowed(self): + """ + If allow_empty is False then an empty dict is not a valid input. + """ + field = serializers.DictField(allow_empty=False) + with pytest.raises(serializers.ValidationError) as exc_info: + field.run_validation({}) + + assert exc_info.value.detail == ['This dictionary may not be empty.'] + class TestNestedDictField(FieldValues): """ From 9811a29a5a1348f1a5de30a9a7a5d0f8d2fd4843 Mon Sep 17 00:00:00 2001 From: Ran Benita Date: Thu, 9 May 2019 11:20:33 +0300 Subject: [PATCH 45/69] Pass through memo in __deepcopy__ as required by the docs (#6660) This is needed to avoid problems with recursive loops. See https://docs.python.org/3.7/library/copy.html toward the end. --- rest_framework/fields.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index e2fb8cdc6..aecfa3302 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -614,7 +614,7 @@ class Field: for item in self._args ] kwargs = { - key: (copy.deepcopy(value) if (key not in ('validators', 'regex')) else value) + key: (copy.deepcopy(value, memo) if (key not in ('validators', 'regex')) else value) for key, value in self._kwargs.items() } return self.__class__(*args, **kwargs) From a91e6a0e693f427a4559cee464aa240243f51d6a Mon Sep 17 00:00:00 2001 From: Asif Saif Uddin Date: Mon, 13 May 2019 14:21:27 +0600 Subject: [PATCH 46/69] Updated test packges version (#6665) --- requirements/requirements-testing.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/requirements/requirements-testing.txt b/requirements/requirements-testing.txt index a2a2fa753..152ca7169 100644 --- a/requirements/requirements-testing.txt +++ b/requirements/requirements-testing.txt @@ -1,4 +1,4 @@ # Pytest for running the tests. -pytest==4.3.0 -pytest-django==3.4.8 -pytest-cov==2.6.1 +pytest>=4.5.0,<4.6 +pytest-django>=3.4.8,<3.5 +pytest-cov>=2.7.1 From 37f210a455cc92cb3f61a23e194a1d0de58d149b Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Mon, 13 May 2019 16:07:03 +0200 Subject: [PATCH 47/69] Added OpenAPI Schema Generation. (#6532) Co-authored-by: Lucidiot Co-authored-by: dongfangtianyu --- rest_framework/filters.py | 29 + .../management/commands/generateschema.py | 49 +- rest_framework/pagination.py | 94 ++- rest_framework/renderers.py | 33 +- rest_framework/schemas/__init__.py | 18 +- rest_framework/schemas/coreapi.py | 616 ++++++++++++++++++ rest_framework/schemas/generators.py | 265 ++------ rest_framework/schemas/inspectors.py | 430 ------------ rest_framework/schemas/openapi.py | 377 +++++++++++ rest_framework/schemas/utils.py | 17 + rest_framework/schemas/views.py | 15 +- rest_framework/settings.py | 2 +- tests/schemas/__init__.py | 0 .../test_coreapi.py} | 98 +-- tests/schemas/test_get_schema_view.py | 20 + .../test_managementcommand.py} | 39 +- tests/schemas/test_openapi.py | 245 +++++++ tests/schemas/views.py | 58 ++ 18 files changed, 1671 insertions(+), 734 deletions(-) create mode 100644 rest_framework/schemas/coreapi.py create mode 100644 rest_framework/schemas/openapi.py create mode 100644 tests/schemas/__init__.py rename tests/{test_schemas.py => schemas/test_coreapi.py} (94%) create mode 100644 tests/schemas/test_get_schema_view.py rename tests/{test_generateschema.py => schemas/test_managementcommand.py} (57%) create mode 100644 tests/schemas/test_openapi.py create mode 100644 tests/schemas/views.py diff --git a/rest_framework/filters.py b/rest_framework/filters.py index d5fe36964..e3b0468c7 100644 --- a/rest_framework/filters.py +++ b/rest_framework/filters.py @@ -37,6 +37,9 @@ class BaseFilterBackend: assert coreschema is not None, 'coreschema must be installed to use `get_schema_fields()`' return [] + def get_schema_operation_parameters(self, view): + return [] + class SearchFilter(BaseFilterBackend): # The URL query parameter used for the search. @@ -156,6 +159,19 @@ class SearchFilter(BaseFilterBackend): ) ] + def get_schema_operation_parameters(self, view): + return [ + { + 'name': self.search_param, + 'required': False, + 'in': 'query', + 'description': force_text(self.search_description), + 'schema': { + 'type': 'string', + }, + }, + ] + class OrderingFilter(BaseFilterBackend): # The URL query parameter used for the ordering. @@ -287,6 +303,19 @@ class OrderingFilter(BaseFilterBackend): ) ] + def get_schema_operation_parameters(self, view): + return [ + { + 'name': self.ordering_param, + 'required': False, + 'in': 'query', + 'description': force_text(self.ordering_description), + 'schema': { + 'type': 'string', + }, + }, + ] + class DjangoObjectPermissionsFilter(BaseFilterBackend): """ diff --git a/rest_framework/management/commands/generateschema.py b/rest_framework/management/commands/generateschema.py index 40909bd04..631f40290 100644 --- a/rest_framework/management/commands/generateschema.py +++ b/rest_framework/management/commands/generateschema.py @@ -1,41 +1,56 @@ from django.core.management.base import BaseCommand -from rest_framework.compat import coreapi -from rest_framework.renderers import ( - CoreJSONRenderer, JSONOpenAPIRenderer, OpenAPIRenderer -) -from rest_framework.schemas.generators import SchemaGenerator +from rest_framework import renderers +from rest_framework.schemas import coreapi +from rest_framework.schemas.openapi import SchemaGenerator + +OPENAPI_MODE = 'openapi' +COREAPI_MODE = 'coreapi' class Command(BaseCommand): help = "Generates configured API schema for project." + def get_mode(self): + return COREAPI_MODE if coreapi.is_enabled() else OPENAPI_MODE + def add_arguments(self, parser): - parser.add_argument('--title', dest="title", default=None, type=str) + parser.add_argument('--title', dest="title", default='', type=str) parser.add_argument('--url', dest="url", default=None, type=str) parser.add_argument('--description', dest="description", default=None, type=str) - parser.add_argument('--format', dest="format", choices=['openapi', 'openapi-json', 'corejson'], default='openapi', type=str) + if self.get_mode() == COREAPI_MODE: + parser.add_argument('--format', dest="format", choices=['openapi', 'openapi-json', 'corejson'], default='openapi', type=str) + else: + parser.add_argument('--format', dest="format", choices=['openapi', 'openapi-json'], default='openapi', type=str) def handle(self, *args, **options): - assert coreapi is not None, 'coreapi must be installed.' - - generator = SchemaGenerator( + generator_class = self.get_generator_class() + generator = generator_class( url=options['url'], title=options['title'], description=options['description'] ) - schema = generator.get_schema(request=None, public=True) - renderer = self.get_renderer(options['format']) output = renderer.render(schema, renderer_context={}) self.stdout.write(output.decode()) def get_renderer(self, format): - renderer_cls = { - 'corejson': CoreJSONRenderer, - 'openapi': OpenAPIRenderer, - 'openapi-json': JSONOpenAPIRenderer, - }[format] + if self.get_mode() == COREAPI_MODE: + renderer_cls = { + 'corejson': renderers.CoreJSONRenderer, + 'openapi': renderers.CoreAPIOpenAPIRenderer, + 'openapi-json': renderers.CoreAPIJSONOpenAPIRenderer, + }[format] + return renderer_cls() + renderer_cls = { + 'openapi': renderers.OpenAPIRenderer, + 'openapi-json': renderers.JSONOpenAPIRenderer, + }[format] return renderer_cls() + + def get_generator_class(self): + if self.get_mode() == COREAPI_MODE: + return coreapi.SchemaGenerator + return SchemaGenerator diff --git a/rest_framework/pagination.py b/rest_framework/pagination.py index 0b2877a45..38d6b9e1c 100644 --- a/rest_framework/pagination.py +++ b/rest_framework/pagination.py @@ -148,6 +148,9 @@ class BasePagination: assert coreapi is not None, 'coreapi must be installed to use `get_schema_fields()`' return [] + def get_schema_operation_parameters(self, view): + return [] + class PageNumberPagination(BasePagination): """ @@ -301,6 +304,32 @@ class PageNumberPagination(BasePagination): ) return fields + def get_schema_operation_parameters(self, view): + parameters = [ + { + 'name': self.page_query_param, + 'required': False, + 'in': 'query', + 'description': force_text(self.page_query_description), + 'schema': { + 'type': 'integer', + }, + }, + ] + if self.page_size_query_param is not None: + parameters.append( + { + 'name': self.page_size_query_param, + 'required': False, + 'in': 'query', + 'description': force_text(self.page_size_query_description), + 'schema': { + 'type': 'integer', + }, + }, + ) + return parameters + class LimitOffsetPagination(BasePagination): """ @@ -430,6 +459,15 @@ class LimitOffsetPagination(BasePagination): context = self.get_html_context() return template.render(context) + def get_count(self, queryset): + """ + Determine an object count, supporting either querysets or regular lists. + """ + try: + return queryset.count() + except (AttributeError, TypeError): + return len(queryset) + def get_schema_fields(self, view): assert coreapi is not None, 'coreapi must be installed to use `get_schema_fields()`' assert coreschema is not None, 'coreschema must be installed to use `get_schema_fields()`' @@ -454,14 +492,28 @@ class LimitOffsetPagination(BasePagination): ) ] - def get_count(self, queryset): - """ - Determine an object count, supporting either querysets or regular lists. - """ - try: - return queryset.count() - except (AttributeError, TypeError): - return len(queryset) + def get_schema_operation_parameters(self, view): + parameters = [ + { + 'name': self.limit_query_param, + 'required': False, + 'in': 'query', + 'description': force_text(self.limit_query_description), + 'schema': { + 'type': 'integer', + }, + }, + { + 'name': self.offset_query_param, + 'required': False, + 'in': 'query', + 'description': force_text(self.offset_query_description), + 'schema': { + 'type': 'integer', + }, + }, + ] + return parameters class CursorPagination(BasePagination): @@ -816,3 +868,29 @@ class CursorPagination(BasePagination): ) ) return fields + + def get_schema_operation_parameters(self, view): + parameters = [ + { + 'name': self.cursor_query_param, + 'required': False, + 'in': 'query', + 'description': force_text(self.cursor_query_description), + 'schema': { + 'type': 'integer', + }, + } + ] + if self.page_size_query_param is not None: + parameters.append( + { + 'name': self.page_size_query_param, + 'required': False, + 'in': 'query', + 'description': force_text(self.page_size_query_description), + 'schema': { + 'type': 'integer', + }, + } + ) + return parameters diff --git a/rest_framework/renderers.py b/rest_framework/renderers.py index 143d1b7e7..2a4ae5905 100644 --- a/rest_framework/renderers.py +++ b/rest_framework/renderers.py @@ -1013,28 +1013,49 @@ class _BaseOpenAPIRenderer: } -class OpenAPIRenderer(_BaseOpenAPIRenderer): +class CoreAPIOpenAPIRenderer(_BaseOpenAPIRenderer): media_type = 'application/vnd.oai.openapi' charset = None format = 'openapi' def __init__(self): - assert coreapi, 'Using OpenAPIRenderer, but `coreapi` is not installed.' - assert yaml, 'Using OpenAPIRenderer, but `pyyaml` is not installed.' + assert coreapi, 'Using CoreAPIOpenAPIRenderer, but `coreapi` is not installed.' + assert yaml, 'Using CoreAPIOpenAPIRenderer, but `pyyaml` is not installed.' def render(self, data, media_type=None, renderer_context=None): structure = self.get_structure(data) return yaml.dump(structure, default_flow_style=False).encode() -class JSONOpenAPIRenderer(_BaseOpenAPIRenderer): +class CoreAPIJSONOpenAPIRenderer(_BaseOpenAPIRenderer): media_type = 'application/vnd.oai.openapi+json' charset = None format = 'openapi-json' def __init__(self): - assert coreapi, 'Using JSONOpenAPIRenderer, but `coreapi` is not installed.' + assert coreapi, 'Using CoreAPIJSONOpenAPIRenderer, but `coreapi` is not installed.' def render(self, data, media_type=None, renderer_context=None): structure = self.get_structure(data) - return json.dumps(structure, indent=4).encode() + return json.dumps(structure, indent=4).encode('utf-8') + + +class OpenAPIRenderer(BaseRenderer): + media_type = 'application/vnd.oai.openapi' + charset = None + format = 'openapi' + + def __init__(self): + assert yaml, 'Using OpenAPIRenderer, but `pyyaml` is not installed.' + + def render(self, data, media_type=None, renderer_context=None): + return yaml.dump(data, default_flow_style=False).encode('utf-8') + + +class JSONOpenAPIRenderer(BaseRenderer): + media_type = 'application/vnd.oai.openapi+json' + charset = None + format = 'openapi-json' + + def render(self, data, media_type=None, renderer_context=None): + return json.dumps(data, indent=2).encode('utf-8') diff --git a/rest_framework/schemas/__init__.py b/rest_framework/schemas/__init__.py index ba0ec6536..8fdb2d86a 100644 --- a/rest_framework/schemas/__init__.py +++ b/rest_framework/schemas/__init__.py @@ -22,24 +22,32 @@ Other access should target the submodules directly """ from rest_framework.settings import api_settings -from .generators import SchemaGenerator -from .inspectors import AutoSchema, DefaultSchema, ManualSchema # noqa +from . import coreapi, openapi +from .inspectors import DefaultSchema # noqa +from .coreapi import AutoSchema, ManualSchema, SchemaGenerator # noqa def get_schema_view( title=None, url=None, description=None, urlconf=None, renderer_classes=None, - public=False, patterns=None, generator_class=SchemaGenerator, + public=False, patterns=None, generator_class=None, authentication_classes=api_settings.DEFAULT_AUTHENTICATION_CLASSES, permission_classes=api_settings.DEFAULT_PERMISSION_CLASSES): """ Return a schema view. """ - # Avoid import cycle on APIView - from .views import SchemaView + if generator_class is None: + if coreapi.is_enabled(): + generator_class = coreapi.SchemaGenerator + else: + generator_class = openapi.SchemaGenerator + generator = generator_class( title=title, url=url, description=description, urlconf=urlconf, patterns=patterns, ) + + # Avoid import cycle on APIView + from .views import SchemaView return SchemaView.as_view( renderer_classes=renderer_classes, schema_generator=generator, diff --git a/rest_framework/schemas/coreapi.py b/rest_framework/schemas/coreapi.py new file mode 100644 index 000000000..5cf789f9f --- /dev/null +++ b/rest_framework/schemas/coreapi.py @@ -0,0 +1,616 @@ +import re +import warnings +from collections import Counter, OrderedDict +from urllib import parse + +from django.db import models +from django.utils.encoding import force_text, smart_text + +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 # +# TODO: Pull some of this into base. + + +def is_custom_action(action): + return action not in { + 'retrieve', 'list', 'create', 'update', 'partial_update', 'destroy' + } + + +def distribute_links(obj): + for key, value in obj.items(): + distribute_links(value) + + for preferred_key, link in obj.links: + key = obj.get_available_key(preferred_key) + obj[key] = link + + +INSERT_INTO_COLLISION_FMT = """ +Schema Naming Collision. + +coreapi.Link for URL path {value_url} cannot be inserted into schema. +Position conflicts with coreapi.Link for URL path {target_url}. + +Attempted to insert link with keys: {keys}. + +Adjust URLs to avoid naming collision or override `SchemaGenerator.get_keys()` +to customise schema structure. +""" + + +class LinkNode(OrderedDict): + def __init__(self): + self.links = [] + self.methods_counter = Counter() + super(LinkNode, self).__init__() + + def get_available_key(self, preferred_key): + if preferred_key not in self: + return preferred_key + + while True: + current_val = self.methods_counter[preferred_key] + self.methods_counter[preferred_key] += 1 + + key = '{}_{}'.format(preferred_key, current_val) + if key not in self: + return key + + +def insert_into(target, keys, value): + """ + Nested dictionary insertion. + + >>> example = {} + >>> insert_into(example, ['a', 'b', 'c'], 123) + >>> example + LinkNode({'a': LinkNode({'b': LinkNode({'c': LinkNode(links=[123])}}}))) + """ + for key in keys[:-1]: + if key not in target: + target[key] = LinkNode() + target = target[key] + + try: + target.links.append((keys[-1], value)) + except TypeError: + msg = INSERT_INTO_COLLISION_FMT.format( + value_url=value.url, + target_url=target.url, + keys=keys + ) + raise ValueError(msg) + + +class SchemaGenerator(BaseSchemaGenerator): + """ + Original CoreAPI version. + """ + # Map HTTP methods onto actions. + default_mapping = { + 'get': 'retrieve', + 'post': 'create', + 'put': 'update', + 'patch': 'partial_update', + 'delete': 'destroy', + } + + # Map the method names we use for viewset actions onto external schema names. + # These give us names that are more suitable for the external representation. + # Set by 'SCHEMA_COERCE_METHOD_NAMES'. + coerce_method_names = None + + def __init__(self, title=None, url=None, description=None, patterns=None, urlconf=None): + assert coreapi, '`coreapi` must be installed for schema support.' + assert coreschema, '`coreschema` must be installed for schema support.' + + super(SchemaGenerator, self).__init__(title, url, description, patterns, urlconf) + self.coerce_method_names = api_settings.SCHEMA_COERCE_METHOD_NAMES + + def get_links(self, request=None): + """ + Return a dictionary containing all the links that should be + included in the API schema. + """ + links = LinkNode() + + paths, view_endpoints = self._get_paths_and_endpoints(request) + + # Only generate the path prefix for paths that will be included + if not paths: + return None + prefix = self.determine_path_prefix(paths) + + for path, method, view in view_endpoints: + if not self.has_view_permissions(path, method, view): + continue + link = view.schema.get_link(path, method, base_url=self.url) + subpath = path[len(prefix):] + keys = self.get_keys(subpath, method, view) + insert_into(links, keys, link) + + return links + + def get_schema(self, request=None, public=False): + """ + Generate a `coreapi.Document` representing the API schema. + """ + self._initialise_endpoints() + + links = self.get_links(None if public else request) + if not links: + return None + + url = self.url + if not url and request is not None: + url = request.build_absolute_uri() + + distribute_links(links) + return coreapi.Document( + title=self.title, description=self.description, + url=url, content=links + ) + + # Method for generating the link layout.... + def get_keys(self, subpath, method, view): + """ + Return a list of keys that should be used to layout a link within + the schema document. + + /users/ ("users", "list"), ("users", "create") + /users/{pk}/ ("users", "read"), ("users", "update"), ("users", "delete") + /users/enabled/ ("users", "enabled") # custom viewset list action + /users/{pk}/star/ ("users", "star") # custom viewset detail action + /users/{pk}/groups/ ("users", "groups", "list"), ("users", "groups", "create") + /users/{pk}/groups/{pk}/ ("users", "groups", "read"), ("users", "groups", "update"), ("users", "groups", "delete") + """ + if hasattr(view, 'action'): + # Viewsets have explicitly named actions. + action = view.action + else: + # Views have no associated action, so we determine one from the method. + if is_list_view(subpath, method, view): + action = 'list' + else: + action = self.default_mapping[method.lower()] + + named_path_components = [ + component for component + in subpath.strip('/').split('/') + if '{' not in component + ] + + if is_custom_action(action): + # Custom action, eg "/users/{pk}/activate/", "/users/active/" + if len(view.action_map) > 1: + action = self.default_mapping[method.lower()] + if action in self.coerce_method_names: + action = self.coerce_method_names[action] + return named_path_components + [action] + else: + return named_path_components[:-1] + [action] + + if action in self.coerce_method_names: + action = self.coerce_method_names[action] + + # Default action, eg "/users/", "/users/{pk}/" + return named_path_components + [action] + +# View Inspectors # + + +def field_to_schema(field): + title = force_text(field.label) if field.label else '' + description = force_text(field.help_text) if field.help_text else '' + + if isinstance(field, (serializers.ListSerializer, serializers.ListField)): + child_schema = field_to_schema(field.child) + return coreschema.Array( + items=child_schema, + title=title, + description=description + ) + elif isinstance(field, serializers.DictField): + return coreschema.Object( + title=title, + description=description + ) + elif isinstance(field, serializers.Serializer): + return coreschema.Object( + properties=OrderedDict([ + (key, field_to_schema(value)) + for key, value + in field.fields.items() + ]), + title=title, + description=description + ) + elif isinstance(field, serializers.ManyRelatedField): + related_field_schema = field_to_schema(field.child_relation) + + return coreschema.Array( + items=related_field_schema, + title=title, + description=description + ) + elif isinstance(field, serializers.PrimaryKeyRelatedField): + schema_cls = coreschema.String + model = getattr(field.queryset, 'model', None) + if model is not None: + model_field = model._meta.pk + if isinstance(model_field, models.AutoField): + schema_cls = coreschema.Integer + return schema_cls(title=title, description=description) + elif isinstance(field, serializers.RelatedField): + return coreschema.String(title=title, description=description) + elif isinstance(field, serializers.MultipleChoiceField): + return coreschema.Array( + items=coreschema.Enum(enum=list(field.choices)), + title=title, + description=description + ) + elif isinstance(field, serializers.ChoiceField): + return coreschema.Enum( + enum=list(field.choices), + title=title, + description=description + ) + elif isinstance(field, serializers.BooleanField): + return coreschema.Boolean(title=title, description=description) + elif isinstance(field, (serializers.DecimalField, serializers.FloatField)): + return coreschema.Number(title=title, description=description) + elif isinstance(field, serializers.IntegerField): + return coreschema.Integer(title=title, description=description) + elif isinstance(field, serializers.DateField): + return coreschema.String( + title=title, + description=description, + format='date' + ) + elif isinstance(field, serializers.DateTimeField): + return coreschema.String( + title=title, + description=description, + format='date-time' + ) + elif isinstance(field, serializers.JSONField): + return coreschema.Object(title=title, description=description) + + if field.style.get('base_template') == 'textarea.html': + return coreschema.String( + title=title, + description=description, + format='textarea' + ) + + return coreschema.String(title=title, description=description) + + +class AutoSchema(ViewInspector): + """ + Default inspector for APIView + + Responsible for per-view introspection and schema generation. + """ + def __init__(self, manual_fields=None): + """ + Parameters: + + * `manual_fields`: list of `coreapi.Field` instances that + will be added to auto-generated fields, overwriting on `Field.name` + """ + super(AutoSchema, self).__init__() + if manual_fields is None: + manual_fields = [] + self._manual_fields = manual_fields + + def get_link(self, path, method, base_url): + """ + Generate `coreapi.Link` for self.view, path and method. + + This is the main _public_ access point. + + Parameters: + + * path: Route path for view from URLConf. + * method: The HTTP request method. + * base_url: The project "mount point" as given to SchemaGenerator + """ + fields = self.get_path_fields(path, method) + fields += self.get_serializer_fields(path, method) + fields += self.get_pagination_fields(path, method) + fields += self.get_filter_fields(path, method) + + manual_fields = self.get_manual_fields(path, method) + fields = self.update_fields(fields, manual_fields) + + if fields and any([field.location in ('form', 'body') for field in fields]): + encoding = self.get_encoding(path, method) + else: + encoding = None + + description = self.get_description(path, method) + + if base_url and path.startswith('/'): + path = path[1:] + + return coreapi.Link( + url=parse.urljoin(base_url, path), + action=method.lower(), + encoding=encoding, + fields=fields, + 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 + templated path variables. + """ + view = self.view + model = getattr(getattr(view, 'queryset', None), 'model', None) + fields = [] + + for variable in uritemplate.variables(path): + title = '' + description = '' + schema_cls = coreschema.String + kwargs = {} + if model is not None: + # Attempt to infer a field description if possible. + try: + model_field = model._meta.get_field(variable) + except Exception: + model_field = None + + if model_field is not None and model_field.verbose_name: + title = force_text(model_field.verbose_name) + + if model_field is not None and model_field.help_text: + description = force_text(model_field.help_text) + elif model_field is not None and model_field.primary_key: + description = get_pk_description(model, model_field) + + if hasattr(view, 'lookup_value_regex') and view.lookup_field == variable: + kwargs['pattern'] = view.lookup_value_regex + elif isinstance(model_field, models.AutoField): + schema_cls = coreschema.Integer + + field = coreapi.Field( + name=variable, + location='path', + required=True, + schema=schema_cls(title=title, description=description, **kwargs) + ) + fields.append(field) + + return fields + + def get_serializer_fields(self, path, method): + """ + Return a list of `coreapi.Field` instances corresponding to any + request body input, as determined by the serializer class. + """ + view = self.view + + if method not in ('PUT', 'PATCH', 'POST'): + return [] + + if not hasattr(view, 'get_serializer'): + return [] + + try: + serializer = view.get_serializer() + except exceptions.APIException: + serializer = None + warnings.warn('{}.get_serializer() raised an exception during ' + 'schema generation. Serializer fields will not be ' + 'generated for {} {}.' + .format(view.__class__.__name__, method, path)) + + if isinstance(serializer, serializers.ListSerializer): + return [ + coreapi.Field( + name='data', + location='body', + required=True, + schema=coreschema.Array() + ) + ] + + if not isinstance(serializer, serializers.Serializer): + return [] + + fields = [] + for field in serializer.fields.values(): + if field.read_only or isinstance(field, serializers.HiddenField): + continue + + required = field.required and method != 'PATCH' + field = coreapi.Field( + name=field.field_name, + location='form', + required=required, + schema=field_to_schema(field) + ) + fields.append(field) + + return fields + + def get_pagination_fields(self, path, method): + view = self.view + + if not is_list_view(path, method, view): + return [] + + pagination = getattr(view, 'pagination_class', None) + if not pagination: + return [] + + paginator = view.pagination_class() + return paginator.get_schema_fields(view) + + def _allows_filters(self, path, method): + """ + Determine whether to include filter Fields in schema. + + Default implementation looks for ModelViewSet or GenericAPIView + actions/methods that cause filtering on the default implementation. + + Override to adjust behaviour for your view. + + Note: Introduced in v3.7: Initially "private" (i.e. with leading underscore) + to allow changes based on user experience. + """ + if getattr(self.view, 'filter_backends', None) is None: + return False + + if hasattr(self.view, 'action'): + return self.view.action in ["list", "retrieve", "update", "partial_update", "destroy"] + + return method.lower() in ["get", "put", "patch", "delete"] + + def get_filter_fields(self, path, method): + if not self._allows_filters(path, method): + return [] + + fields = [] + for filter_backend in self.view.filter_backends: + fields += filter_backend().get_schema_fields(self.view) + return fields + + def get_manual_fields(self, path, method): + return self._manual_fields + + @staticmethod + def update_fields(fields, update_with): + """ + Update list of coreapi.Field instances, overwriting on `Field.name`. + + Utility function to handle replacing coreapi.Field fields + from a list by name. Used to handle `manual_fields`. + + Parameters: + + * `fields`: list of `coreapi.Field` instances to update + * `update_with: list of `coreapi.Field` instances to add or replace. + """ + if not update_with: + return fields + + by_name = OrderedDict((f.name, f) for f in fields) + for f in update_with: + by_name[f.name] = f + fields = list(by_name.values()) + return fields + + def get_encoding(self, path, method): + """ + Return the 'encoding' parameter to use for a given endpoint. + """ + view = self.view + + # Core API supports the following request encodings over HTTP... + supported_media_types = { + 'application/json', + 'application/x-www-form-urlencoded', + 'multipart/form-data', + } + parser_classes = getattr(view, 'parser_classes', []) + for parser_class in parser_classes: + media_type = getattr(parser_class, 'media_type', None) + if media_type in supported_media_types: + return media_type + # Raw binary uploads are supported with "application/octet-stream" + if media_type == '*/*': + return 'application/octet-stream' + + return None + + +class ManualSchema(ViewInspector): + """ + Allows providing a list of coreapi.Fields, + plus an optional description. + """ + def __init__(self, fields, description='', encoding=None): + """ + Parameters: + + * `fields`: list of `coreapi.Field` instances. + * `description`: String description for view. Optional. + """ + super(ManualSchema, self).__init__() + assert all(isinstance(f, coreapi.Field) for f in fields), "`fields` must be a list of coreapi.Field instances" + self._fields = fields + self._description = description + self._encoding = encoding + + def get_link(self, path, method, base_url): + + if base_url and path.startswith('/'): + path = path[1:] + + return coreapi.Link( + url=parse.urljoin(base_url, path), + action=method.lower(), + encoding=self._encoding, + fields=self._fields, + description=self._description + ) + + +def is_enabled(): + """Is CoreAPI Mode enabled?""" + return issubclass(api_settings.DEFAULT_SCHEMA_CLASS, AutoSchema) diff --git a/rest_framework/schemas/generators.py b/rest_framework/schemas/generators.py index 66afcca94..ecb07f935 100644 --- a/rest_framework/schemas/generators.py +++ b/rest_framework/schemas/generators.py @@ -4,7 +4,6 @@ generators.py # Top-down schema generation See schemas.__init__.py for package overview. """ import re -from collections import Counter, OrderedDict from importlib import import_module from django.conf import settings @@ -13,15 +12,11 @@ from django.core.exceptions import PermissionDenied from django.http import Http404 from rest_framework import exceptions -from rest_framework.compat import ( - URLPattern, URLResolver, coreapi, coreschema, get_original_route -) +from rest_framework.compat import URLPattern, URLResolver, get_original_route from rest_framework.request import clone_request from rest_framework.settings import api_settings from rest_framework.utils.model_meta import _get_pk -from .utils import is_list_view - def common_path(paths): split_paths = [path.strip('/').split('/') for path in paths] @@ -50,78 +45,6 @@ def is_api_view(callback): return (cls is not None) and issubclass(cls, APIView) -INSERT_INTO_COLLISION_FMT = """ -Schema Naming Collision. - -coreapi.Link for URL path {value_url} cannot be inserted into schema. -Position conflicts with coreapi.Link for URL path {target_url}. - -Attempted to insert link with keys: {keys}. - -Adjust URLs to avoid naming collision or override `SchemaGenerator.get_keys()` -to customise schema structure. -""" - - -class LinkNode(OrderedDict): - def __init__(self): - self.links = [] - self.methods_counter = Counter() - super().__init__() - - def get_available_key(self, preferred_key): - if preferred_key not in self: - return preferred_key - - while True: - current_val = self.methods_counter[preferred_key] - self.methods_counter[preferred_key] += 1 - - key = '{}_{}'.format(preferred_key, current_val) - if key not in self: - return key - - -def insert_into(target, keys, value): - """ - Nested dictionary insertion. - - >>> example = {} - >>> insert_into(example, ['a', 'b', 'c'], 123) - >>> example - LinkNode({'a': LinkNode({'b': LinkNode({'c': LinkNode(links=[123])}}}))) - """ - for key in keys[:-1]: - if key not in target: - target[key] = LinkNode() - target = target[key] - - try: - target.links.append((keys[-1], value)) - except TypeError: - msg = INSERT_INTO_COLLISION_FMT.format( - value_url=value.url, - target_url=target.url, - keys=keys - ) - raise ValueError(msg) - - -def distribute_links(obj): - for key, value in obj.items(): - distribute_links(value) - - for preferred_key, link in obj.links: - key = obj.get_available_key(preferred_key) - obj[key] = link - - -def is_custom_action(action): - return action not in { - 'retrieve', 'list', 'create', 'update', 'partial_update', 'destroy' - } - - def endpoint_ordering(endpoint): path, method, callback = endpoint method_priority = { @@ -190,6 +113,10 @@ class EndpointEnumerator: """ Given a URL conf regex, return a URI template string. """ + # ???: Would it be feasible to adjust this such that we generate the + # path, plus the kwargs, plus the type from the convertor, such that we + # could feed that straight into the parameter schema object? + path = simplify_regex(path_regex) # Strip Django 2.0 convertors as they are incompatible with uritemplate format @@ -228,35 +155,18 @@ class EndpointEnumerator: return [method for method in methods if method not in ('OPTIONS', 'HEAD')] -class SchemaGenerator: - # Map HTTP methods onto actions. - default_mapping = { - 'get': 'retrieve', - 'post': 'create', - 'put': 'update', - 'patch': 'partial_update', - 'delete': 'destroy', - } +class BaseSchemaGenerator(object): endpoint_inspector_cls = EndpointEnumerator - # Map the method names we use for viewset actions onto external schema names. - # These give us names that are more suitable for the external representation. - # Set by 'SCHEMA_COERCE_METHOD_NAMES'. - coerce_method_names = None - # 'pk' isn't great as an externally exposed name for an identifier, # so by default we prefer to use the actual model field name for schemas. # Set by 'SCHEMA_COERCE_PATH_PK'. coerce_path_pk = None def __init__(self, title=None, url=None, description=None, patterns=None, urlconf=None): - assert coreapi, '`coreapi` must be installed for schema support.' - assert coreschema, '`coreschema` must be installed for schema support.' - if url and not url.endswith('/'): url += '/' - self.coerce_method_names = api_settings.SCHEMA_COERCE_METHOD_NAMES self.coerce_path_pk = api_settings.SCHEMA_COERCE_PATH_PK self.patterns = patterns @@ -266,36 +176,15 @@ class SchemaGenerator: self.url = url self.endpoints = None - def get_schema(self, request=None, public=False): - """ - Generate a `coreapi.Document` representing the API schema. - """ + def _initialise_endpoints(self): if self.endpoints is None: inspector = self.endpoint_inspector_cls(self.patterns, self.urlconf) self.endpoints = inspector.get_api_endpoints() - links = self.get_links(None if public else request) - if not links: - return None - - url = self.url - if not url and request is not None: - url = request.build_absolute_uri() - - distribute_links(links) - return coreapi.Document( - title=self.title, description=self.description, - url=url, content=links - ) - - def get_links(self, request=None): + def _get_paths_and_endpoints(self, request): """ - Return a dictionary containing all the links that should be - included in the API schema. + Generate (path, method, view) given (path, method, callback) for paths. """ - links = LinkNode() - - # Generate (path, method, view) given (path, method, callback). paths = [] view_endpoints = [] for path, method, callback in self.endpoints: @@ -304,22 +193,48 @@ class SchemaGenerator: paths.append(path) view_endpoints.append((path, method, view)) - # Only generate the path prefix for paths that will be included - if not paths: - return None - prefix = self.determine_path_prefix(paths) + return paths, view_endpoints - for path, method, view in view_endpoints: - if not self.has_view_permissions(path, method, view): - continue - link = view.schema.get_link(path, method, base_url=self.url) - subpath = path[len(prefix):] - keys = self.get_keys(subpath, method, view) - insert_into(links, keys, link) + def create_view(self, callback, method, request=None): + """ + Given a callback, return an actual view instance. + """ + view = callback.cls(**getattr(callback, 'initkwargs', {})) + view.args = () + view.kwargs = {} + view.format_kwarg = None + view.request = None + view.action_map = getattr(callback, 'actions', None) - return links + actions = getattr(callback, 'actions', None) + if actions is not None: + if method == 'OPTIONS': + view.action = 'metadata' + else: + view.action = actions.get(method.lower()) - # Methods used when we generate a view instance from the raw callback... + if request is not None: + view.request = clone_request(request, method) + + return view + + def coerce_path(self, path, method, view): + """ + Coerce {pk} path arguments into the name of the model field, + where possible. This is cleaner for an external representation. + (Ie. "this is an identifier", not "this is a database primary key") + """ + if not self.coerce_path_pk or '{pk}' not in path: + return path + model = getattr(getattr(view, 'queryset', None), 'model', None) + if model: + field_name = get_pk_name(model) + else: + field_name = 'id' + return path.replace('{pk}', '{%s}' % field_name) + + def get_schema(self, request=None, public=False): + raise NotImplementedError(".get_schema() must be implemented in subclasses.") def determine_path_prefix(self, paths): """ @@ -352,29 +267,6 @@ class SchemaGenerator: prefixes.append('/' + prefix + '/') return common_path(prefixes) - def create_view(self, callback, method, request=None): - """ - Given a callback, return an actual view instance. - """ - view = callback.cls(**getattr(callback, 'initkwargs', {})) - view.args = () - view.kwargs = {} - view.format_kwarg = None - view.request = None - view.action_map = getattr(callback, 'actions', None) - - actions = getattr(callback, 'actions', None) - if actions is not None: - if method == 'OPTIONS': - view.action = 'metadata' - else: - view.action = actions.get(method.lower()) - - if request is not None: - view.request = clone_request(request, method) - - return view - def has_view_permissions(self, path, method, view): """ Return `True` if the incoming request has the correct view permissions. @@ -387,64 +279,3 @@ class SchemaGenerator: except (exceptions.APIException, Http404, PermissionDenied): return False return True - - def coerce_path(self, path, method, view): - """ - Coerce {pk} path arguments into the name of the model field, - where possible. This is cleaner for an external representation. - (Ie. "this is an identifier", not "this is a database primary key") - """ - if not self.coerce_path_pk or '{pk}' not in path: - return path - model = getattr(getattr(view, 'queryset', None), 'model', None) - if model: - field_name = get_pk_name(model) - else: - field_name = 'id' - return path.replace('{pk}', '{%s}' % field_name) - - # Method for generating the link layout.... - - def get_keys(self, subpath, method, view): - """ - Return a list of keys that should be used to layout a link within - the schema document. - - /users/ ("users", "list"), ("users", "create") - /users/{pk}/ ("users", "read"), ("users", "update"), ("users", "delete") - /users/enabled/ ("users", "enabled") # custom viewset list action - /users/{pk}/star/ ("users", "star") # custom viewset detail action - /users/{pk}/groups/ ("users", "groups", "list"), ("users", "groups", "create") - /users/{pk}/groups/{pk}/ ("users", "groups", "read"), ("users", "groups", "update"), ("users", "groups", "delete") - """ - if hasattr(view, 'action'): - # Viewsets have explicitly named actions. - action = view.action - else: - # Views have no associated action, so we determine one from the method. - if is_list_view(subpath, method, view): - action = 'list' - else: - action = self.default_mapping[method.lower()] - - named_path_components = [ - component for component - in subpath.strip('/').split('/') - if '{' not in component - ] - - if is_custom_action(action): - # Custom action, eg "/users/{pk}/activate/", "/users/active/" - if len(view.action_map) > 1: - action = self.default_mapping[method.lower()] - if action in self.coerce_method_names: - action = self.coerce_method_names[action] - return named_path_components + [action] - else: - return named_path_components[:-1] + [action] - - if action in self.coerce_method_names: - action = self.coerce_method_names[action] - - # Default action, eg "/users/", "/users/{pk}/" - return named_path_components + [action] diff --git a/rest_framework/schemas/inspectors.py b/rest_framework/schemas/inspectors.py index 2858c8c5b..86fcdc435 100644 --- a/rest_framework/schemas/inspectors.py +++ b/rest_framework/schemas/inspectors.py @@ -3,125 +3,9 @@ inspectors.py # Per-endpoint view introspection See schemas.__init__.py for package overview. """ -import re -import warnings -from collections import OrderedDict -from urllib import parse from weakref import WeakKeyDictionary -from django.db import models -from django.utils.encoding import force_text, smart_text -from django.utils.translation import gettext_lazy as _ - -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 .utils import is_list_view - -header_regex = re.compile('^[a-zA-Z][0-9A-Za-z_]*:') - - -def field_to_schema(field): - title = force_text(field.label) if field.label else '' - description = force_text(field.help_text) if field.help_text else '' - - if isinstance(field, (serializers.ListSerializer, serializers.ListField)): - child_schema = field_to_schema(field.child) - return coreschema.Array( - items=child_schema, - title=title, - description=description - ) - elif isinstance(field, serializers.DictField): - return coreschema.Object( - title=title, - description=description - ) - elif isinstance(field, serializers.Serializer): - return coreschema.Object( - properties=OrderedDict([ - (key, field_to_schema(value)) - for key, value - in field.fields.items() - ]), - title=title, - description=description - ) - elif isinstance(field, serializers.ManyRelatedField): - related_field_schema = field_to_schema(field.child_relation) - - return coreschema.Array( - items=related_field_schema, - title=title, - description=description - ) - elif isinstance(field, serializers.PrimaryKeyRelatedField): - schema_cls = coreschema.String - model = getattr(field.queryset, 'model', None) - if model is not None: - model_field = model._meta.pk - if isinstance(model_field, models.AutoField): - schema_cls = coreschema.Integer - return schema_cls(title=title, description=description) - elif isinstance(field, serializers.RelatedField): - return coreschema.String(title=title, description=description) - elif isinstance(field, serializers.MultipleChoiceField): - return coreschema.Array( - items=coreschema.Enum(enum=list(field.choices)), - title=title, - description=description - ) - elif isinstance(field, serializers.ChoiceField): - return coreschema.Enum( - enum=list(field.choices), - title=title, - description=description - ) - elif isinstance(field, serializers.BooleanField): - return coreschema.Boolean(title=title, description=description) - elif isinstance(field, (serializers.DecimalField, serializers.FloatField)): - return coreschema.Number(title=title, description=description) - elif isinstance(field, serializers.IntegerField): - return coreschema.Integer(title=title, description=description) - elif isinstance(field, serializers.DateField): - return coreschema.String( - title=title, - description=description, - format='date' - ) - elif isinstance(field, serializers.DateTimeField): - return coreschema.String( - title=title, - description=description, - format='date-time' - ) - elif isinstance(field, serializers.JSONField): - return coreschema.Object(title=title, description=description) - - if field.style.get('base_template') == 'textarea.html': - return coreschema.String( - title=title, - description=description, - format='textarea' - ) - - return coreschema.String(title=title, description=description) - - -def get_pk_description(model, model_field): - if isinstance(model_field, models.AutoField): - value_type = _('unique integer value') - elif isinstance(model_field, models.UUIDField): - value_type = _('UUID string') - else: - value_type = _('unique value') - - return _('A {value_type} identifying this {name}.').format( - value_type=value_type, - name=model._meta.verbose_name, - ) class ViewInspector: @@ -178,320 +62,6 @@ class ViewInspector: def view(self): self._view = None - def get_link(self, path, method, base_url): - """ - Generate `coreapi.Link` for self.view, path and method. - - This is the main _public_ access point. - - Parameters: - - * path: Route path for view from URLConf. - * method: The HTTP request method. - * base_url: The project "mount point" as given to SchemaGenerator - """ - raise NotImplementedError(".get_link() must be overridden.") - - -class AutoSchema(ViewInspector): - """ - Default inspector for APIView - - Responsible for per-view introspection and schema generation. - """ - def __init__(self, manual_fields=None): - """ - Parameters: - - * `manual_fields`: list of `coreapi.Field` instances that - will be added to auto-generated fields, overwriting on `Field.name` - """ - super().__init__() - if manual_fields is None: - manual_fields = [] - self._manual_fields = manual_fields - - def get_link(self, path, method, base_url): - fields = self.get_path_fields(path, method) - fields += self.get_serializer_fields(path, method) - fields += self.get_pagination_fields(path, method) - fields += self.get_filter_fields(path, method) - - manual_fields = self.get_manual_fields(path, method) - fields = self.update_fields(fields, manual_fields) - - if fields and any([field.location in ('form', 'body') for field in fields]): - encoding = self.get_encoding(path, method) - else: - encoding = None - - description = self.get_description(path, method) - - if base_url and path.startswith('/'): - path = path[1:] - - return coreapi.Link( - url=parse.urljoin(base_url, path), - action=method.lower(), - encoding=encoding, - fields=fields, - 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 - templated path variables. - """ - view = self.view - model = getattr(getattr(view, 'queryset', None), 'model', None) - fields = [] - - for variable in uritemplate.variables(path): - title = '' - description = '' - schema_cls = coreschema.String - kwargs = {} - if model is not None: - # Attempt to infer a field description if possible. - try: - model_field = model._meta.get_field(variable) - except Exception: - model_field = None - - if model_field is not None and model_field.verbose_name: - title = force_text(model_field.verbose_name) - - if model_field is not None and model_field.help_text: - description = force_text(model_field.help_text) - elif model_field is not None and model_field.primary_key: - description = get_pk_description(model, model_field) - - if hasattr(view, 'lookup_value_regex') and view.lookup_field == variable: - kwargs['pattern'] = view.lookup_value_regex - elif isinstance(model_field, models.AutoField): - schema_cls = coreschema.Integer - - field = coreapi.Field( - name=variable, - location='path', - required=True, - schema=schema_cls(title=title, description=description, **kwargs) - ) - fields.append(field) - - return fields - - def get_serializer_fields(self, path, method): - """ - Return a list of `coreapi.Field` instances corresponding to any - request body input, as determined by the serializer class. - """ - view = self.view - - if method not in ('PUT', 'PATCH', 'POST'): - return [] - - if not hasattr(view, 'get_serializer'): - return [] - - try: - serializer = view.get_serializer() - except exceptions.APIException: - serializer = None - warnings.warn('{}.get_serializer() raised an exception during ' - 'schema generation. Serializer fields will not be ' - 'generated for {} {}.' - .format(view.__class__.__name__, method, path)) - - if isinstance(serializer, serializers.ListSerializer): - return [ - coreapi.Field( - name='data', - location='body', - required=True, - schema=coreschema.Array() - ) - ] - - if not isinstance(serializer, serializers.Serializer): - return [] - - fields = [] - for field in serializer.fields.values(): - if field.read_only or isinstance(field, serializers.HiddenField): - continue - - required = field.required and method != 'PATCH' - field = coreapi.Field( - name=field.field_name, - location='form', - required=required, - schema=field_to_schema(field) - ) - fields.append(field) - - return fields - - def get_pagination_fields(self, path, method): - view = self.view - - if not is_list_view(path, method, view): - return [] - - pagination = getattr(view, 'pagination_class', None) - if not pagination: - return [] - - paginator = view.pagination_class() - return paginator.get_schema_fields(view) - - def _allows_filters(self, path, method): - """ - Determine whether to include filter Fields in schema. - - Default implementation looks for ModelViewSet or GenericAPIView - actions/methods that cause filtering on the default implementation. - - Override to adjust behaviour for your view. - - Note: Introduced in v3.7: Initially "private" (i.e. with leading underscore) - to allow changes based on user experience. - """ - if getattr(self.view, 'filter_backends', None) is None: - return False - - if hasattr(self.view, 'action'): - return self.view.action in ["list", "retrieve", "update", "partial_update", "destroy"] - - return method.lower() in ["get", "put", "patch", "delete"] - - def get_filter_fields(self, path, method): - if not self._allows_filters(path, method): - return [] - - fields = [] - for filter_backend in self.view.filter_backends: - fields += filter_backend().get_schema_fields(self.view) - return fields - - def get_manual_fields(self, path, method): - return self._manual_fields - - @staticmethod - def update_fields(fields, update_with): - """ - Update list of coreapi.Field instances, overwriting on `Field.name`. - - Utility function to handle replacing coreapi.Field fields - from a list by name. Used to handle `manual_fields`. - - Parameters: - - * `fields`: list of `coreapi.Field` instances to update - * `update_with: list of `coreapi.Field` instances to add or replace. - """ - if not update_with: - return fields - - by_name = OrderedDict((f.name, f) for f in fields) - for f in update_with: - by_name[f.name] = f - return list(by_name.values()) - - def get_encoding(self, path, method): - """ - Return the 'encoding' parameter to use for a given endpoint. - """ - view = self.view - - # Core API supports the following request encodings over HTTP... - supported_media_types = { - 'application/json', - 'application/x-www-form-urlencoded', - 'multipart/form-data', - } - parser_classes = getattr(view, 'parser_classes', []) - for parser_class in parser_classes: - media_type = getattr(parser_class, 'media_type', None) - if media_type in supported_media_types: - return media_type - # Raw binary uploads are supported with "application/octet-stream" - if media_type == '*/*': - return 'application/octet-stream' - - return None - - -class ManualSchema(ViewInspector): - """ - Allows providing a list of coreapi.Fields, - plus an optional description. - """ - def __init__(self, fields, description='', encoding=None): - """ - Parameters: - - * `fields`: list of `coreapi.Field` instances. - * `description`: String description for view. Optional. - """ - super().__init__() - assert all(isinstance(f, coreapi.Field) for f in fields), "`fields` must be a list of coreapi.Field instances" - self._fields = fields - self._description = description - self._encoding = encoding - - def get_link(self, path, method, base_url): - - if base_url and path.startswith('/'): - path = path[1:] - - return coreapi.Link( - url=parse.urljoin(base_url, path), - action=method.lower(), - encoding=self._encoding, - fields=self._fields, - description=self._description - ) - 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 new file mode 100644 index 000000000..44b281be8 --- /dev/null +++ b/rest_framework/schemas/openapi.py @@ -0,0 +1,377 @@ +import warnings + +from django.db import models +from django.utils.encoding import force_text + +from rest_framework import exceptions, serializers +from rest_framework.compat import uritemplate + +from .generators import BaseSchemaGenerator +from .inspectors import ViewInspector +from .utils import get_pk_description, is_list_view + +# Generator + + +class SchemaGenerator(BaseSchemaGenerator): + + def get_info(self): + info = { + 'title': self.title, + 'version': 'TODO', + } + + if self.description is not None: + info['description'] = self.description + + return info + + def get_paths(self, request=None): + result = {} + + paths, view_endpoints = self._get_paths_and_endpoints(request) + + # Only generate the path prefix for paths that will be included + if not paths: + return None + prefix = self.determine_path_prefix(paths) + + for path, method, view in view_endpoints: + if not self.has_view_permissions(path, method, view): + continue + operation = view.schema.get_operation(path, method) + subpath = '/' + path[len(prefix):] + result.setdefault(subpath, {}) + result[subpath][method.lower()] = operation + + return result + + def get_schema(self, request=None, public=False): + """ + Generate a OpenAPI schema. + """ + self._initialise_endpoints() + + paths = self.get_paths(None if public else request) + if not paths: + return None + + schema = { + 'openapi': '3.0.2', + 'info': self.get_info(), + 'paths': paths, + } + + return schema + +# View Inspectors + + +class AutoSchema(ViewInspector): + + content_types = ['application/json'] + method_mapping = { + 'get': 'Retrieve', + 'post': 'Create', + 'put': 'Update', + 'patch': 'PartialUpdate', + 'delete': 'Destroy', + } + + def get_operation(self, path, method): + operation = {} + + operation['operationId'] = self._get_operation_id(path, method) + + parameters = [] + parameters += self._get_path_parameters(path, method) + parameters += self._get_pagination_parameters(path, method) + parameters += self._get_filter_parameters(path, method) + operation['parameters'] = parameters + + request_body = self._get_request_body(path, method) + if request_body: + operation['requestBody'] = request_body + operation['responses'] = self._get_responses(path, method) + + return operation + + def _get_operation_id(self, path, method): + """ + Compute an operation ID from the model, serializer or view name. + """ + method_name = getattr(self.view, 'action', method.lower()) + if is_list_view(path, method, self.view): + action = 'List' + elif method_name not in self.method_mapping: + action = method_name + else: + action = self.method_mapping[method.lower()] + + # Try to deduce the ID from the view's model + model = getattr(getattr(self.view, 'queryset', None), 'model', None) + if model is not None: + name = model.__name__ + + # Try with the serializer class name + elif hasattr(self.view, 'get_serializer_class'): + name = self.view.get_serializer_class().__name__ + if name.endswith('Serializer'): + name = name[:-10] + + # Fallback to the view name + else: + name = self.view.__class__.__name__ + if name.endswith('APIView'): + name = name[:-7] + elif name.endswith('View'): + name = name[:-4] + if name.endswith(action): # ListView, UpdateAPIView, ThingDelete ... + name = name[:-len(action)] + + if action == 'List' and not name.endswith('s'): # ListThings instead of ListThing + name += 's' + + return action + name + + def _get_path_parameters(self, path, method): + """ + Return a list of parameters from templated path variables. + """ + assert uritemplate, '`uritemplate` must be installed for OpenAPI schema support.' + + model = getattr(getattr(self.view, 'queryset', None), 'model', None) + parameters = [] + + for variable in uritemplate.variables(path): + description = '' + if model is not None: # TODO: test this. + # Attempt to infer a field description if possible. + try: + model_field = model._meta.get_field(variable) + except Exception: + model_field = None + + if model_field is not None and model_field.help_text: + description = force_text(model_field.help_text) + elif model_field is not None and model_field.primary_key: + description = get_pk_description(model, model_field) + + parameter = { + "name": variable, + "in": "path", + "required": True, + "description": description, + 'schema': { + 'type': 'string', # TODO: integer, pattern, ... + }, + } + parameters.append(parameter) + + return parameters + + def _get_filter_parameters(self, path, method): + if not self._allows_filters(path, method): + return [] + parameters = [] + for filter_backend in self.view.filter_backends: + parameters += filter_backend().get_schema_operation_parameters(self.view) + return parameters + + def _allows_filters(self, path, method): + """ + Determine whether to include filter Fields in schema. + + Default implementation looks for ModelViewSet or GenericAPIView + actions/methods that cause filtering on the default implementation. + """ + if getattr(self.view, 'filter_backends', None) is None: + return False + if hasattr(self.view, 'action'): + return self.view.action in ["list", "retrieve", "update", "partial_update", "destroy"] + return method.lower() in ["get", "put", "patch", "delete"] + + def _get_pagination_parameters(self, path, method): + view = self.view + + if not is_list_view(path, method, view): + return [] + + pagination = getattr(view, 'pagination_class', None) + if not pagination: + return [] + + paginator = view.pagination_class() + return paginator.get_schema_operation_parameters(view) + + def _map_field(self, field): + + # Nested Serializers, `many` or not. + if isinstance(field, serializers.ListSerializer): + return { + 'type': 'array', + 'items': self._map_serializer(field.child) + } + if isinstance(field, serializers.Serializer): + data = self._map_serializer(field) + data['type'] = 'object' + return data + + # Related fields. + if isinstance(field, serializers.ManyRelatedField): + return { + 'type': 'array', + 'items': self._map_field(field.child_relation) + } + if isinstance(field, serializers.PrimaryKeyRelatedField): + model = getattr(field.queryset, 'model', None) + if model is not None: + model_field = model._meta.pk + if isinstance(model_field, models.AutoField): + return {'type': 'integer'} + + # ChoiceFields (single and multiple). + # Q: + # - Is 'type' required? + # - can we determine the TYPE of a choicefield? + if isinstance(field, serializers.MultipleChoiceField): + return { + 'type': 'array', + 'items': { + 'enum': list(field.choices) + }, + } + + if isinstance(field, serializers.ChoiceField): + return { + 'enum': list(field.choices), + } + + # ListField. + if isinstance(field, serializers.ListField): + return { + 'type': 'array', + } + + # DateField and DateTimeField type is string + if isinstance(field, serializers.DateField): + return { + 'type': 'string', + 'format': 'date', + } + + if isinstance(field, serializers.DateTimeField): + return { + 'type': 'string', + 'format': 'date-time', + } + + # Simplest cases, default to 'string' type: + FIELD_CLASS_SCHEMA_TYPE = { + serializers.BooleanField: 'boolean', + serializers.DecimalField: 'number', + serializers.FloatField: 'number', + serializers.IntegerField: 'integer', + + serializers.JSONField: 'object', + serializers.DictField: 'object', + } + return {'type': FIELD_CLASS_SCHEMA_TYPE.get(field.__class__, 'string')} + + def _map_serializer(self, serializer): + # Assuming we have a valid serializer instance. + # TODO: + # - field is Nested or List serializer. + # - Handle read_only/write_only for request/response differences. + # - could do this with readOnly/writeOnly and then filter dict. + required = [] + properties = {} + + for field in serializer.fields.values(): + if isinstance(field, serializers.HiddenField): + continue + + if field.required: + required.append(field.field_name) + + schema = self._map_field(field) + if field.read_only: + schema['readOnly'] = True + if field.write_only: + schema['writeOnly'] = True + if field.allow_null: + schema['nullable'] = True + + properties[field.field_name] = schema + return { + 'required': required, + 'properties': properties, + } + + def _get_request_body(self, path, method): + view = self.view + + if method not in ('PUT', 'PATCH', 'POST'): + return {} + + if not hasattr(view, 'get_serializer'): + return {} + + try: + serializer = view.get_serializer() + except exceptions.APIException: + serializer = None + warnings.warn('{}.get_serializer() raised an exception during ' + 'schema generation. Serializer fields will not be ' + 'generated for {} {}.' + .format(view.__class__.__name__, method, path)) + + if not isinstance(serializer, serializers.Serializer): + return {} + + content = self._map_serializer(serializer) + # No required fields for PATCH + if method == 'PATCH': + del content['required'] + # No read_only fields for request. + for name, schema in content['properties'].copy().items(): + if 'readOnly' in schema: + del content['properties'][name] + + return { + 'content': { + ct: {'schema': content} + for ct in self.content_types + } + } + + def _get_responses(self, path, method): + # TODO: Handle multiple codes. + content = {} + view = self.view + if hasattr(view, 'get_serializer'): + try: + serializer = view.get_serializer() + except exceptions.APIException: + serializer = None + warnings.warn('{}.get_serializer() raised an exception during ' + 'schema generation. Serializer fields will not be ' + 'generated for {} {}.' + .format(view.__class__.__name__, method, path)) + + if isinstance(serializer, serializers.Serializer): + content = self._map_serializer(serializer) + # No write_only fields for response. + for name, schema in content['properties'].copy().items(): + if 'writeOnly' in schema: + del content['properties'][name] + content['required'] = [f for f in content['required'] if f != name] + + return { + '200': { + 'content': { + ct: {'schema': content} + for ct in self.content_types + } + } + } diff --git a/rest_framework/schemas/utils.py b/rest_framework/schemas/utils.py index 76437a20a..6724eb428 100644 --- a/rest_framework/schemas/utils.py +++ b/rest_framework/schemas/utils.py @@ -3,6 +3,9 @@ utils.py # Shared helper functions See schemas.__init__.py for package overview. """ +from django.db import models +from django.utils.translation import ugettext_lazy as _ + from rest_framework.mixins import RetrieveModelMixin @@ -22,3 +25,17 @@ def is_list_view(path, method, view): if path_components and '{' in path_components[-1]: return False return True + + +def get_pk_description(model, model_field): + if isinstance(model_field, models.AutoField): + value_type = _('unique integer value') + elif isinstance(model_field, models.UUIDField): + value_type = _('UUID string') + else: + value_type = _('unique value') + + return _('A {value_type} identifying this {name}.').format( + value_type=value_type, + name=model._meta.verbose_name, + ) diff --git a/rest_framework/schemas/views.py b/rest_framework/schemas/views.py index fa5cdbdc7..527a23236 100644 --- a/rest_framework/schemas/views.py +++ b/rest_framework/schemas/views.py @@ -5,6 +5,7 @@ See schemas.__init__.py for package overview. """ from rest_framework import exceptions, renderers from rest_framework.response import Response +from rest_framework.schemas import coreapi from rest_framework.settings import api_settings from rest_framework.views import APIView @@ -19,10 +20,16 @@ class SchemaView(APIView): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) if self.renderer_classes is None: - self.renderer_classes = [ - renderers.OpenAPIRenderer, - renderers.CoreJSONRenderer - ] + if coreapi.is_enabled(): + self.renderer_classes = [ + renderers.CoreAPIOpenAPIRenderer, + renderers.CoreJSONRenderer + ] + else: + self.renderer_classes = [ + renderers.OpenAPIRenderer, + renderers.JSONOpenAPIRenderer, + ] if renderers.BrowsableAPIRenderer in api_settings.DEFAULT_RENDERER_CLASSES: self.renderer_classes += [renderers.BrowsableAPIRenderer] diff --git a/rest_framework/settings.py b/rest_framework/settings.py index 1d5dc036f..3520eae36 100644 --- a/rest_framework/settings.py +++ b/rest_framework/settings.py @@ -52,7 +52,7 @@ DEFAULTS = { 'DEFAULT_FILTER_BACKENDS': (), # Schema - 'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema', + 'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.openapi.AutoSchema', # Throttling 'DEFAULT_THROTTLE_RATES': { diff --git a/tests/schemas/__init__.py b/tests/schemas/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/tests/test_schemas.py b/tests/schemas/test_coreapi.py similarity index 94% rename from tests/test_schemas.py rename to tests/schemas/test_coreapi.py index 230f8f012..66275ade9 100644 --- a/tests/test_schemas.py +++ b/tests/schemas/test_coreapi.py @@ -16,15 +16,16 @@ from rest_framework.routers import DefaultRouter, SimpleRouter from rest_framework.schemas import ( AutoSchema, ManualSchema, SchemaGenerator, get_schema_view ) +from rest_framework.schemas.coreapi import field_to_schema from rest_framework.schemas.generators import EndpointEnumerator -from rest_framework.schemas.inspectors import field_to_schema from rest_framework.schemas.utils import is_list_view from rest_framework.test import APIClient, APIRequestFactory from rest_framework.utils import formatting from rest_framework.views import APIView from rest_framework.viewsets import GenericViewSet, ModelViewSet -from .models import BasicModel, ForeignKeySource, ManyToManySource +from . import views +from ..models import BasicModel, ForeignKeySource, ManyToManySource factory = APIRequestFactory() @@ -133,11 +134,12 @@ class ExampleViewSet(ModelViewSet): pass -if coreapi: - schema_view = get_schema_view(title='Example API') -else: - def schema_view(request): - pass +with override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}): + if coreapi: + schema_view = get_schema_view(title='Example API') + else: + def schema_view(request): + pass router = DefaultRouter() router.register('example', ExampleViewSet, basename='example') @@ -148,7 +150,7 @@ urlpatterns = [ @unittest.skipUnless(coreapi, 'coreapi is not installed') -@override_settings(ROOT_URLCONF='tests.test_schemas') +@override_settings(ROOT_URLCONF=__name__, REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestRouterGeneratedSchema(TestCase): def test_anonymous_request(self): client = APIClient() @@ -400,12 +402,13 @@ class ExampleDetailView(APIView): @unittest.skipUnless(coreapi, 'coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestSchemaGenerator(TestCase): def setUp(self): self.patterns = [ - url(r'^example/?$', ExampleListView.as_view()), - url(r'^example/(?P\d+)/?$', ExampleDetailView.as_view()), - url(r'^example/(?P\d+)/sub/?$', ExampleDetailView.as_view()), + url(r'^example/?$', views.ExampleListView.as_view()), + url(r'^example/(?P\d+)/?$', views.ExampleDetailView.as_view()), + url(r'^example/(?P\d+)/sub/?$', views.ExampleDetailView.as_view()), ] def test_schema_for_regular_views(self): @@ -453,12 +456,13 @@ class TestSchemaGenerator(TestCase): @unittest.skipUnless(coreapi, 'coreapi is not installed') @unittest.skipUnless(path, 'needs Django 2') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestSchemaGeneratorDjango2(TestCase): def setUp(self): self.patterns = [ - path('example/', ExampleListView.as_view()), - path('example//', ExampleDetailView.as_view()), - path('example//sub/', ExampleDetailView.as_view()), + path('example/', views.ExampleListView.as_view()), + path('example//', views.ExampleDetailView.as_view()), + path('example//sub/', views.ExampleDetailView.as_view()), ] def test_schema_for_regular_views(self): @@ -505,12 +509,13 @@ class TestSchemaGeneratorDjango2(TestCase): @unittest.skipUnless(coreapi, 'coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestSchemaGeneratorNotAtRoot(TestCase): def setUp(self): self.patterns = [ - url(r'^api/v1/example/?$', ExampleListView.as_view()), - url(r'^api/v1/example/(?P\d+)/?$', ExampleDetailView.as_view()), - url(r'^api/v1/example/(?P\d+)/sub/?$', ExampleDetailView.as_view()), + url(r'^api/v1/example/?$', views.ExampleListView.as_view()), + url(r'^api/v1/example/(?P\d+)/?$', views.ExampleDetailView.as_view()), + url(r'^api/v1/example/(?P\d+)/sub/?$', views.ExampleDetailView.as_view()), ] def test_schema_for_regular_views(self): @@ -558,6 +563,7 @@ class TestSchemaGeneratorNotAtRoot(TestCase): @unittest.skipUnless(coreapi, 'coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestSchemaGeneratorWithMethodLimitedViewSets(TestCase): def setUp(self): router = DefaultRouter() @@ -622,13 +628,14 @@ class TestSchemaGeneratorWithMethodLimitedViewSets(TestCase): @unittest.skipUnless(coreapi, 'coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestSchemaGeneratorWithRestrictedViewSets(TestCase): def setUp(self): router = DefaultRouter() router.register('example1', Http404ExampleViewSet, basename='example1') router.register('example2', PermissionDeniedExampleViewSet, basename='example2') self.patterns = [ - url('^example/?$', ExampleListView.as_view()), + url('^example/?$', views.ExampleListView.as_view()), url(r'^', include(router.urls)) ] @@ -668,6 +675,7 @@ class ForeignKeySourceView(generics.CreateAPIView): @unittest.skipUnless(coreapi, 'coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestSchemaGeneratorWithForeignKey(TestCase): def setUp(self): self.patterns = [ @@ -713,6 +721,7 @@ class ManyToManySourceView(generics.CreateAPIView): @unittest.skipUnless(coreapi, 'coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestSchemaGeneratorWithManyToMany(TestCase): def setUp(self): self.patterns = [ @@ -747,6 +756,7 @@ class TestSchemaGeneratorWithManyToMany(TestCase): @unittest.skipUnless(coreapi, 'coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class Test4605Regression(TestCase): def test_4605_regression(self): generator = SchemaGenerator() @@ -762,6 +772,7 @@ class CustomViewInspector(AutoSchema): pass +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestAutoSchema(TestCase): def test_apiview_schema_descriptor(self): @@ -777,7 +788,7 @@ class TestAutoSchema(TestCase): assert isinstance(view.schema, CustomViewInspector) def test_set_custom_inspector_class_via_settings(self): - with override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'tests.test_schemas.CustomViewInspector'}): + with override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'tests.schemas.test_coreapi.CustomViewInspector'}): view = APIView() assert isinstance(view.schema, CustomViewInspector) @@ -971,6 +982,7 @@ class TestAutoSchema(TestCase): self.assertEqual(field_to_schema(case[0]), case[1]) +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) def test_docstring_is_not_stripped_by_get_description(): class ExampleDocstringAPIView(APIView): """ @@ -1007,25 +1019,25 @@ def test_docstring_is_not_stripped_by_get_description(): # Views for SchemaGenerationExclusionTests -class ExcludedAPIView(APIView): - schema = None +with override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}): + class ExcludedAPIView(APIView): + schema = None - def get(self, request, *args, **kwargs): + def get(self, request, *args, **kwargs): + pass + + @api_view(['GET']) + @schema(None) + def excluded_fbv(request): + pass + + @api_view(['GET']) + def included_fbv(request): pass -@api_view(['GET']) -@schema(None) -def excluded_fbv(request): - pass - - -@api_view(['GET']) -def included_fbv(request): - pass - - @unittest.skipUnless(coreapi, 'coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class SchemaGenerationExclusionTests(TestCase): def setUp(self): self.patterns = [ @@ -1078,11 +1090,6 @@ class SchemaGenerationExclusionTests(TestCase): assert should_include == expected -@api_view(["GET"]) -def simple_fbv(request): - pass - - class BasicModelSerializer(serializers.ModelSerializer): class Meta: model = BasicModel @@ -1118,11 +1125,16 @@ naming_collisions_router.register(r'collision', NamingCollisionViewSet, basename @pytest.mark.skipif(not coreapi, reason='coreapi is not installed') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) class TestURLNamingCollisions(TestCase): """ Ref: https://github.com/encode/django-rest-framework/issues/4704 """ def test_manually_routing_nested_routes(self): + @api_view(["GET"]) + def simple_fbv(request): + pass + patterns = [ url(r'^test', simple_fbv), url(r'^test/list/', simple_fbv), @@ -1228,6 +1240,10 @@ class TestURLNamingCollisions(TestCase): def test_url_under_same_key_not_replaced_another(self): + @api_view(["GET"]) + def simple_fbv(request): + pass + patterns = [ url(r'^test/list/', simple_fbv), url(r'^test/(?P\d+)/list/', simple_fbv), @@ -1302,10 +1318,8 @@ def test_head_and_options_methods_are_excluded(): assert inspector.get_allowed_methods(callback) == ["GET"] -@pytest.mark.skipif(not coreapi, reason='coreapi is not installed') -class TestAutoSchemaAllowsFilters: - class MockAPIView(APIView): - filter_backends = [filters.OrderingFilter] +class MockAPIView(APIView): + filter_backends = [filters.OrderingFilter] def _test(self, method): view = self.MockAPIView() diff --git a/tests/schemas/test_get_schema_view.py b/tests/schemas/test_get_schema_view.py new file mode 100644 index 000000000..f582c6495 --- /dev/null +++ b/tests/schemas/test_get_schema_view.py @@ -0,0 +1,20 @@ +import pytest +from django.test import TestCase, override_settings + +from rest_framework import renderers +from rest_framework.schemas import coreapi, get_schema_view, openapi + + +class GetSchemaViewTests(TestCase): + """For the get_schema_view() helper.""" + def test_openapi(self): + schema_view = get_schema_view(title="With OpenAPI") + assert isinstance(schema_view.initkwargs['schema_generator'], openapi.SchemaGenerator) + assert renderers.OpenAPIRenderer in schema_view.cls().renderer_classes + + @pytest.mark.skipif(not coreapi.coreapi, reason='coreapi is not installed') + def test_coreapi(self): + with override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}): + schema_view = get_schema_view(title="With CoreAPI") + assert isinstance(schema_view.initkwargs['schema_generator'], coreapi.SchemaGenerator) + assert renderers.CoreAPIOpenAPIRenderer in schema_view.cls().renderer_classes diff --git a/tests/test_generateschema.py b/tests/schemas/test_managementcommand.py similarity index 57% rename from tests/test_generateschema.py rename to tests/schemas/test_managementcommand.py index a6a1f2bed..e5960f2b0 100644 --- a/tests/test_generateschema.py +++ b/tests/schemas/test_managementcommand.py @@ -6,7 +6,8 @@ from django.core.management import call_command from django.test import TestCase from django.test.utils import override_settings -from rest_framework.compat import coreapi +from rest_framework.compat import uritemplate, yaml +from rest_framework.management.commands import generateschema from rest_framework.utils import formatting, json from rest_framework.views import APIView @@ -21,15 +22,43 @@ urlpatterns = [ ] -@override_settings(ROOT_URLCONF='tests.test_generateschema') -@pytest.mark.skipif(not coreapi, reason='coreapi is not installed') +@override_settings(ROOT_URLCONF=__name__) +@pytest.mark.skipif(not uritemplate, reason='uritemplate is not installed') class GenerateSchemaTests(TestCase): """Tests for management command generateschema.""" def setUp(self): self.out = io.StringIO() + def test_command_detects_schema_generation_mode(self): + """Switching between CoreAPI & OpenAPI""" + command = generateschema.Command() + assert command.get_mode() == generateschema.OPENAPI_MODE + with override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}): + assert command.get_mode() == generateschema.COREAPI_MODE + + @pytest.mark.skipif(yaml is None, reason='PyYAML is required.') def test_renders_default_schema_with_custom_title_url_and_description(self): + call_command('generateschema', + '--title=SampleAPI', + '--url=http://api.sample.com', + '--description=Sample description', + stdout=self.out) + # Check valid YAML was output. + schema = yaml.load(self.out.getvalue()) + assert schema['openapi'] == '3.0.2' + + def test_renders_openapi_json_schema(self): + call_command('generateschema', + '--format=openapi-json', + stdout=self.out) + # Check valid JSON was output. + out_json = json.loads(self.out.getvalue()) + assert out_json['openapi'] == '3.0.2' + + @pytest.mark.skipif(yaml is None, reason='PyYAML is required.') + @override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) + def test_coreapi_renders_default_schema_with_custom_title_url_and_description(self): expected_out = """info: description: Sample description title: SampleAPI @@ -50,7 +79,8 @@ class GenerateSchemaTests(TestCase): self.assertIn(formatting.dedent(expected_out), self.out.getvalue()) - def test_renders_openapi_json_schema(self): + @override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) + def test_coreapi_renders_openapi_json_schema(self): expected_out = { "openapi": "3.0.0", "info": { @@ -78,6 +108,7 @@ class GenerateSchemaTests(TestCase): self.assertDictEqual(out_json, expected_out) + @override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.AutoSchema'}) def test_renders_corejson_schema(self): expected_out = """{"_type":"document","":{"list":{"_type":"link","url":"/","action":"get"}}}""" call_command('generateschema', diff --git a/tests/schemas/test_openapi.py b/tests/schemas/test_openapi.py new file mode 100644 index 000000000..2ddf54f01 --- /dev/null +++ b/tests/schemas/test_openapi.py @@ -0,0 +1,245 @@ +import pytest +from django.conf.urls import url +from django.test import RequestFactory, TestCase, override_settings + +from rest_framework import filters, generics, pagination, routers, serializers +from rest_framework.compat import uritemplate +from rest_framework.request import Request +from rest_framework.schemas.openapi import AutoSchema, SchemaGenerator + +from . import views + + +def create_request(path): + factory = RequestFactory() + request = Request(factory.get(path)) + return request + + +def create_view(view_cls, method, request): + generator = SchemaGenerator() + view = generator.create_view(view_cls.as_view(), method, request) + return view + + +class TestBasics(TestCase): + def dummy_view(request): + pass + + def test_filters(self): + classes = [filters.SearchFilter, filters.OrderingFilter] + for c in classes: + f = c() + assert f.get_schema_operation_parameters(self.dummy_view) + + def test_pagination(self): + classes = [pagination.PageNumberPagination, pagination.LimitOffsetPagination, pagination.CursorPagination] + for c in classes: + f = c() + assert f.get_schema_operation_parameters(self.dummy_view) + + +@pytest.mark.skipif(uritemplate is None, reason='uritemplate not installed.') +class TestOperationIntrospection(TestCase): + + def test_path_without_parameters(self): + path = '/example/' + method = 'GET' + + view = create_view( + views.ExampleListView, + method, + create_request(path) + ) + inspector = AutoSchema() + inspector.view = view + + operation = inspector.get_operation(path, method) + assert operation == { + 'operationId': 'ListExamples', + 'parameters': [], + 'responses': {'200': {'content': {'application/json': {'schema': {}}}}}, + } + + def test_path_with_id_parameter(self): + path = '/example/{id}/' + method = 'GET' + + view = create_view( + views.ExampleDetailView, + 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', + }, + }] + + def test_request_body(self): + path = '/' + method = 'POST' + + class Serializer(serializers.Serializer): + text = serializers.CharField() + read_only = serializers.CharField(read_only=True) + + class View(generics.GenericAPIView): + serializer_class = Serializer + + view = create_view( + View, + method, + create_request(path) + ) + inspector = AutoSchema() + inspector.view = view + + request_body = inspector._get_request_body(path, method) + assert request_body['content']['application/json']['schema']['required'] == ['text'] + assert list(request_body['content']['application/json']['schema']['properties'].keys()) == ['text'] + + def test_response_body_generation(self): + path = '/' + method = 'POST' + + class Serializer(serializers.Serializer): + text = serializers.CharField() + write_only = serializers.CharField(write_only=True) + + class View(generics.GenericAPIView): + serializer_class = Serializer + + view = create_view( + View, + method, + create_request(path) + ) + inspector = AutoSchema() + inspector.view = view + + responses = inspector._get_responses(path, method) + assert responses['200']['content']['application/json']['schema']['required'] == ['text'] + assert list(responses['200']['content']['application/json']['schema']['properties'].keys()) == ['text'] + + def test_response_body_nested_serializer(self): + path = '/' + method = 'POST' + + class NestedSerializer(serializers.Serializer): + number = serializers.IntegerField() + + class Serializer(serializers.Serializer): + text = serializers.CharField() + nested = NestedSerializer() + + class View(generics.GenericAPIView): + serializer_class = Serializer + + view = create_view( + View, + method, + create_request(path), + ) + inspector = AutoSchema() + inspector.view = view + + responses = inspector._get_responses(path, method) + schema = responses['200']['content']['application/json']['schema'] + assert sorted(schema['required']) == ['nested', 'text'] + assert sorted(list(schema['properties'].keys())) == ['nested', 'text'] + assert schema['properties']['nested']['type'] == 'object' + assert list(schema['properties']['nested']['properties'].keys()) == ['number'] + assert schema['properties']['nested']['required'] == ['number'] + + def test_operation_id_generation(self): + path = '/' + method = 'GET' + + view = create_view( + views.ExampleGenericAPIView, + method, + create_request(path), + ) + inspector = AutoSchema() + inspector.view = view + + operationId = inspector._get_operation_id(path, method) + assert operationId == 'ListExamples' + + def test_repeat_operation_ids(self): + router = routers.SimpleRouter() + router.register('account', views.ExampleGenericViewSet, basename="account") + urlpatterns = router.urls + + generator = SchemaGenerator(patterns=urlpatterns) + + request = create_request('/') + schema = generator.get_schema(request=request) + schema_str = str(schema) + print(schema_str) + assert schema_str.count("operationId") == 2 + assert schema_str.count("newExample") == 1 + assert schema_str.count("oldExample") == 1 + + +@pytest.mark.skipif(uritemplate is None, reason='uritemplate not installed.') +@override_settings(REST_FRAMEWORK={'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.openapi.AutoSchema'}) +class TestGenerator(TestCase): + + def test_override_settings(self): + assert isinstance(views.ExampleListView.schema, AutoSchema) + + def test_paths_construction(self): + """Construction of the `paths` key.""" + patterns = [ + url(r'^example/?$', views.ExampleListView.as_view()), + ] + generator = SchemaGenerator(patterns=patterns) + generator._initialise_endpoints() + + paths = generator.get_paths() + + assert '/example/' in paths + example_operations = paths['/example/'] + assert len(example_operations) == 2 + assert 'get' in example_operations + assert 'post' in example_operations + + def test_schema_construction(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 'openapi' in schema + assert 'paths' in schema + + def test_serializer_datefield(self): + patterns = [ + url(r'^example/?$', views.ExampleGenericViewSet.as_view({"get": "get"})), + ] + generator = SchemaGenerator(patterns=patterns) + + request = create_request('/') + schema = generator.get_schema(request=request) + + response = schema['paths']['/example/']['get']['responses'] + response_schema = response['200']['content']['application/json']['schema']['properties'] + + assert response_schema['date']['type'] == response_schema['datetime']['type'] == 'string' + + assert response_schema['date']['format'] == 'date' + assert response_schema['datetime']['format'] == 'date-time' diff --git a/tests/schemas/views.py b/tests/schemas/views.py new file mode 100644 index 000000000..dc0d6065b --- /dev/null +++ b/tests/schemas/views.py @@ -0,0 +1,58 @@ +from rest_framework import generics, permissions, serializers +from rest_framework.decorators import action +from rest_framework.response import Response +from rest_framework.views import APIView +from rest_framework.viewsets import GenericViewSet + + +class ExampleListView(APIView): + permission_classes = [permissions.IsAuthenticatedOrReadOnly] + + def get(self, *args, **kwargs): + pass + + def post(self, request, *args, **kwargs): + pass + + +class ExampleDetailView(APIView): + permission_classes = [permissions.IsAuthenticatedOrReadOnly] + + def get(self, *args, **kwargs): + pass + + +# Generics. +class ExampleSerializer(serializers.Serializer): + date = serializers.DateField() + datetime = serializers.DateTimeField() + + +class ExampleGenericAPIView(generics.GenericAPIView): + serializer_class = ExampleSerializer + + def get(self, *args, **kwargs): + from datetime import datetime + now = datetime.now() + + serializer = self.get_serializer(data=now.date(), datetime=now) + return Response(serializer.data) + + +class ExampleGenericViewSet(GenericViewSet): + serializer_class = ExampleSerializer + + def get(self, *args, **kwargs): + from datetime import datetime + now = datetime.now() + + serializer = self.get_serializer(data=now.date(), datetime=now) + return Response(serializer.data) + + @action(detail=False) + def new(self, *args, **kwargs): + pass + + @action(detail=False) + def old(self, *args, **kwargs): + pass From c3a13916d2c8025b042a9b9fb1ec5af25f202cb4 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Tue, 14 May 2019 10:13:14 -0700 Subject: [PATCH 48/69] Update release notes (#6671) * Add 3.9.4 release notes to master * Add top-level symlink to release notes --- CHANGELOG.md | 1 + docs/community/release-notes.md | 6 ++++++ 2 files changed, 7 insertions(+) create mode 120000 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 120000 index 000000000..025215c5e --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1 @@ +docs/community/release-notes.md \ No newline at end of file diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index 6fcb5bb6b..cda24809f 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -40,6 +40,12 @@ You can determine your currently installed version using `pip show`: ## 3.9.x series +### 3.9.4 + +**Date**: [10th May 2019] + +This is a maintenance release that fixes an error handling bug under Python 2. + ### 3.9.3 **Date**: [29th April 2019] From ac0f0a177428823c9eeb2a87b8f895ce59b4e7b6 Mon Sep 17 00:00:00 2001 From: Asif Saif Uddin Date: Tue, 14 May 2019 23:14:11 +0600 Subject: [PATCH 49/69] Updated optional requirements (#6673) --- requirements/requirements-optionals.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/requirements/requirements-optionals.txt b/requirements/requirements-optionals.txt index c800a5891..bc20c739a 100644 --- a/requirements/requirements-optionals.txt +++ b/requirements/requirements-optionals.txt @@ -1,8 +1,8 @@ # Optional packages which may be used with REST framework. -psycopg2-binary==2.7.5 +psycopg2-binary>=2.8.2, <2.9 markdown==2.6.11 django-guardian==1.5.0 -django-filter==1.1.0 +django-filter>=2.1.0, <2.2 coreapi==2.3.1 coreschema==0.0.4 pyyaml From 43a9cc1b7a4200deb3423d96a1d8e3cb9f3ceddd Mon Sep 17 00:00:00 2001 From: Joachim Jablon Date: Mon, 20 May 2019 15:41:31 +0200 Subject: [PATCH 50/69] Fix CursorPagination when objects get deleted between calls (#6504) (#6593) * Added regression tests (#6504) Co-Authored-By: Tom Quinonero * Fix CursorPagination when objects get deleted between calls (#6504) Co-Authored-By: Tom Quinonero --- rest_framework/pagination.py | 18 ++++++++++---- tests/test_pagination.py | 46 ++++++++++++++++++++++++++++++++++++ 2 files changed, 60 insertions(+), 4 deletions(-) diff --git a/rest_framework/pagination.py b/rest_framework/pagination.py index 38d6b9e1c..4d65d080a 100644 --- a/rest_framework/pagination.py +++ b/rest_framework/pagination.py @@ -637,7 +637,7 @@ class CursorPagination(BasePagination): if not self.has_next: return None - if self.cursor and self.cursor.reverse and self.cursor.offset != 0: + if self.page and self.cursor and self.cursor.reverse and self.cursor.offset != 0: # If we're reversing direction and we have an offset cursor # then we cannot use the first position we find as a marker. compare = self._get_position_from_instance(self.page[-1], self.ordering) @@ -645,12 +645,14 @@ class CursorPagination(BasePagination): compare = self.next_position offset = 0 + has_item_with_unique_position = False for item in reversed(self.page): position = self._get_position_from_instance(item, self.ordering) if position != compare: # The item in this position and the item following it # have different positions. We can use this position as # our marker. + has_item_with_unique_position = True break # The item in this position has the same position as the item @@ -659,7 +661,7 @@ class CursorPagination(BasePagination): compare = position offset += 1 - else: + if self.page and not has_item_with_unique_position: # There were no unique positions in the page. if not self.has_previous: # We are on the first page. @@ -678,6 +680,9 @@ class CursorPagination(BasePagination): offset = self.cursor.offset + self.page_size position = self.previous_position + if not self.page: + position = self.next_position + cursor = Cursor(offset=offset, reverse=False, position=position) return self.encode_cursor(cursor) @@ -685,7 +690,7 @@ class CursorPagination(BasePagination): if not self.has_previous: return None - if self.cursor and not self.cursor.reverse and self.cursor.offset != 0: + if self.page and self.cursor and not self.cursor.reverse and self.cursor.offset != 0: # If we're reversing direction and we have an offset cursor # then we cannot use the first position we find as a marker. compare = self._get_position_from_instance(self.page[0], self.ordering) @@ -693,12 +698,14 @@ class CursorPagination(BasePagination): compare = self.previous_position offset = 0 + has_item_with_unique_position = False for item in self.page: position = self._get_position_from_instance(item, self.ordering) if position != compare: # The item in this position and the item following it # have different positions. We can use this position as # our marker. + has_item_with_unique_position = True break # The item in this position has the same position as the item @@ -707,7 +714,7 @@ class CursorPagination(BasePagination): compare = position offset += 1 - else: + if self.page and not has_item_with_unique_position: # There were no unique positions in the page. if not self.has_next: # We are on the final page. @@ -726,6 +733,9 @@ class CursorPagination(BasePagination): offset = 0 position = self.next_position + if not self.page: + position = self.previous_position + cursor = Cursor(offset=offset, reverse=True, position=position) return self.encode_cursor(cursor) diff --git a/tests/test_pagination.py b/tests/test_pagination.py index 3c581ddfb..11fd6844d 100644 --- a/tests/test_pagination.py +++ b/tests/test_pagination.py @@ -630,6 +630,52 @@ class CursorPaginationTestsMixin: assert isinstance(self.pagination.to_html(), str) + def test_cursor_pagination_current_page_empty_forward(self): + # Regression test for #6504 + self.pagination.base_url = "/" + + # We have a cursor on the element at position 100, but this element doesn't exist + # anymore. + cursor = pagination.Cursor(reverse=False, offset=0, position=100) + url = self.pagination.encode_cursor(cursor) + self.pagination.base_url = "/" + + # Loading the page with this cursor doesn't crash + (previous, current, next, previous_url, next_url) = self.get_pages(url) + + # The previous url doesn't crash either + (previous, current, next, previous_url, next_url) = self.get_pages(previous_url) + + # And point to things that are not completely off. + assert previous == [7, 7, 7, 8, 9] + assert current == [9, 9, 9, 9, 9] + assert next == [] + assert previous_url is not None + assert next_url is not None + + def test_cursor_pagination_current_page_empty_reverse(self): + # Regression test for #6504 + self.pagination.base_url = "/" + + # We have a cursor on the element at position 100, but this element doesn't exist + # anymore. + cursor = pagination.Cursor(reverse=True, offset=0, position=100) + url = self.pagination.encode_cursor(cursor) + self.pagination.base_url = "/" + + # Loading the page with this cursor doesn't crash + (previous, current, next, previous_url, next_url) = self.get_pages(url) + + # The previous url doesn't crash either + (previous, current, next, previous_url, next_url) = self.get_pages(next_url) + + # And point to things that are not completely off. + assert previous == [7, 7, 7, 7, 8] + assert current == [] + assert next is None + assert previous_url is not None + assert next_url is None + def test_cursor_pagination_with_page_size(self): (previous, current, next, previous_url, next_url) = self.get_pages('/?page_size=20') From 7232586c7caf66f20f56b36f1c6a9c9648eb94a4 Mon Sep 17 00:00:00 2001 From: Ran Benita Date: Mon, 20 May 2019 16:49:47 +0300 Subject: [PATCH 51/69] Simplify Serializer.fields with @cached_property (#6662) --- rest_framework/serializers.py | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/rest_framework/serializers.py b/rest_framework/serializers.py index 742fa6577..7b7959db9 100644 --- a/rest_framework/serializers.py +++ b/rest_framework/serializers.py @@ -348,7 +348,7 @@ class Serializer(BaseSerializer, metaclass=SerializerMetaclass): 'invalid': _('Invalid data. Expected a dictionary, but got {datatype}.') } - @property + @cached_property def fields(self): """ A dictionary of {field_name: field_instance}. @@ -356,11 +356,10 @@ class Serializer(BaseSerializer, metaclass=SerializerMetaclass): # `fields` is evaluated lazily. We do this to ensure that we don't # have issues importing modules that use ModelSerializers as fields, # even if Django's app-loading stage has not yet run. - if not hasattr(self, '_fields'): - self._fields = BindingDict(self) - for key, value in self.get_fields().items(): - self._fields[key] = value - return self._fields + fields = BindingDict(self) + for key, value in self.get_fields().items(): + fields[key] = value + return fields @cached_property def _writable_fields(self): From 2c92548963118104944171842f6558db7eee72d7 Mon Sep 17 00:00:00 2001 From: Rick van Hattem Date: Mon, 20 May 2019 17:09:23 +0200 Subject: [PATCH 52/69] Made the loading of the fund sidebar async (#6686) --- docs_theme/main.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs_theme/main.html b/docs_theme/main.html index b60b231c2..1a1175902 100644 --- a/docs_theme/main.html +++ b/docs_theme/main.html @@ -141,7 +141,7 @@ - + From 1b8141a4aac5774d094eff9df3398f92301446ca Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Mon, 20 May 2019 14:58:02 -0700 Subject: [PATCH 53/69] Fix nullable `source='*'` fields (#6659) --- rest_framework/fields.py | 5 +++++ tests/test_serializer.py | 44 +++++++++++++++++++++++++++++++++++++--- 2 files changed, 46 insertions(+), 3 deletions(-) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index aecfa3302..179dd25c8 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -493,6 +493,11 @@ class Field: if data is None: if not self.allow_null: self.fail('null') + # Nullable `source='*'` fields should not be skipped when its named + # field is given a null value. This is because `source='*'` means + # the field is passed the entire object, which is not null. + elif self.source == '*': + return (False, None) return (True, None) return (False, data) diff --git a/tests/test_serializer.py b/tests/test_serializer.py index e0acf368b..0d4b50c1d 100644 --- a/tests/test_serializer.py +++ b/tests/test_serializer.py @@ -317,7 +317,8 @@ class TestBaseSerializer: class TestStarredSource: """ - Tests for `source='*'` argument, which is used for nested representations. + Tests for `source='*'` argument, which is often used for complex field or + nested representations. For example: @@ -337,11 +338,28 @@ class TestStarredSource: c = serializers.IntegerField() d = serializers.IntegerField() - class TestSerializer(serializers.Serializer): + class NestedBaseSerializer(serializers.Serializer): nested1 = NestedSerializer1(source='*') nested2 = NestedSerializer2(source='*') - self.Serializer = TestSerializer + # nullable nested serializer testing + class NullableNestedSerializer(serializers.Serializer): + nested = NestedSerializer1(source='*', allow_null=True) + + # nullable custom field testing + class CustomField(serializers.Field): + def to_representation(self, instance): + return getattr(instance, 'foo', None) + + def to_internal_value(self, data): + return {'foo': data} + + class NullableFieldSerializer(serializers.Serializer): + field = CustomField(source='*', allow_null=True) + + self.Serializer = NestedBaseSerializer + self.NullableNestedSerializer = NullableNestedSerializer + self.NullableFieldSerializer = NullableFieldSerializer def test_nested_validate(self): """ @@ -356,6 +374,12 @@ class TestStarredSource: 'd': 4 } + def test_nested_null_validate(self): + serializer = self.NullableNestedSerializer(data={'nested': None}) + + # validation should fail (but not error) since nested fields are required + assert not serializer.is_valid() + def test_nested_serialize(self): """ An object can be serialized into a nested representation. @@ -364,6 +388,20 @@ class TestStarredSource: serializer = self.Serializer(instance) assert serializer.data == self.data + def test_field_validate(self): + serializer = self.NullableFieldSerializer(data={'field': 'bar'}) + + # validation should pass since no internal validation + assert serializer.is_valid() + assert serializer.validated_data == {'foo': 'bar'} + + def test_field_null_validate(self): + serializer = self.NullableFieldSerializer(data={'field': None}) + + # validation should pass since no internal validation + assert serializer.is_valid() + assert serializer.validated_data == {'foo': None} + class TestIncorrectlyConfigured: def test_incorrect_field_name(self): From ccd9b71c0ace56f4ff125c16af14d751013dd9e7 Mon Sep 17 00:00:00 2001 From: Ran Benita Date: Tue, 21 May 2019 17:45:31 +0300 Subject: [PATCH 54/69] Don't cache _readable_fields and _writable_fields (#6689) It might be useful for a serializer with many many fields which uses read_only and write_only on a large percentage of the fields. But the memory usage and statefulness it adds are not worth it for the common case. --- rest_framework/serializers.py | 17 ++++++++--------- tests/test_fields.py | 2 +- 2 files changed, 9 insertions(+), 10 deletions(-) diff --git a/rest_framework/serializers.py b/rest_framework/serializers.py index 7b7959db9..b23389c56 100644 --- a/rest_framework/serializers.py +++ b/rest_framework/serializers.py @@ -361,18 +361,17 @@ class Serializer(BaseSerializer, metaclass=SerializerMetaclass): fields[key] = value return fields - @cached_property + @property def _writable_fields(self): - return [ - field for field in self.fields.values() if not field.read_only - ] + for field in self.fields.values(): + if not field.read_only: + yield field - @cached_property + @property def _readable_fields(self): - return [ - field for field in self.fields.values() - if not field.write_only - ] + for field in self.fields.values(): + if not field.write_only: + yield field def get_fields(self): """ diff --git a/tests/test_fields.py b/tests/test_fields.py index e7f16c178..468b33e57 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -219,7 +219,7 @@ class TestReadOnly: Read-only fields should not be writable, even with default () """ serializer = self.Serializer() - assert len(serializer._writable_fields) == 1 + assert len(list(serializer._writable_fields)) == 1 def test_validate_read_only(self): """ From db37512a6e4fa5ba793b7e401d7014dfd0984995 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Tue, 21 May 2019 10:36:55 -0700 Subject: [PATCH 55/69] Remove 3.10 deprecations (#6687) * Remove DjangoObjectPermissionsFilter * Remove detail_route/list_route * Bump deprecation warning versions --- rest_framework/__init__.py | 4 ++-- rest_framework/compat.py | 7 ------ rest_framework/decorators.py | 38 ------------------------------- rest_framework/filters.py | 44 +----------------------------------- rest_framework/routers.py | 26 +-------------------- tests/test_decorators.py | 43 +++-------------------------------- tests/test_permissions.py | 40 +++++++------------------------- 7 files changed, 15 insertions(+), 187 deletions(-) diff --git a/rest_framework/__init__.py b/rest_framework/__init__.py index 53dc7bd47..cead7568d 100644 --- a/rest_framework/__init__.py +++ b/rest_framework/__init__.py @@ -25,9 +25,9 @@ ISO_8601 = 'iso-8601' default_app_config = 'rest_framework.apps.RestFrameworkConfig' -class RemovedInDRF310Warning(DeprecationWarning): +class RemovedInDRF311Warning(DeprecationWarning): pass -class RemovedInDRF311Warning(PendingDeprecationWarning): +class RemovedInDRF312Warning(PendingDeprecationWarning): pass diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 1feaf9faa..2e6a8adda 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -131,13 +131,6 @@ except ImportError: requests = None -def is_guardian_installed(): - """ - django-guardian is optional and only imported if in INSTALLED_APPS. - """ - return 'guardian' in settings.INSTALLED_APPS - - # PATCH method is not implemented by Django if 'patch' not in View.http_method_names: View.http_method_names = View.http_method_names + ['patch'] diff --git a/rest_framework/decorators.py b/rest_framework/decorators.py index 5d7bd14a3..671754fa1 100644 --- a/rest_framework/decorators.py +++ b/rest_framework/decorators.py @@ -7,11 +7,9 @@ based views, as well as the `@detail_route` and `@list_route` decorators, which used to annotate methods on viewsets that should be included by routers. """ import types -import warnings from django.forms.utils import pretty_name -from rest_framework import RemovedInDRF310Warning from rest_framework.views import APIView @@ -214,39 +212,3 @@ class MethodMapper(dict): def trace(self, func): return self._map('trace', func) - - -def detail_route(methods=None, **kwargs): - """ - Used to mark a method on a ViewSet that should be routed for detail requests. - """ - warnings.warn( - "`detail_route` is deprecated and will be removed in 3.10 in favor of " - "`action`, which accepts a `detail` bool. Use `@action(detail=True)` instead.", - RemovedInDRF310Warning, stacklevel=2 - ) - - def decorator(func): - func = action(methods, detail=True, **kwargs)(func) - if 'url_name' not in kwargs: - func.url_name = func.url_path.replace('_', '-') - return func - return decorator - - -def list_route(methods=None, **kwargs): - """ - Used to mark a method on a ViewSet that should be routed for list requests. - """ - warnings.warn( - "`list_route` is deprecated and will be removed in 3.10 in favor of " - "`action`, which accepts a `detail` bool. Use `@action(detail=False)` instead.", - RemovedInDRF310Warning, stacklevel=2 - ) - - def decorator(func): - func = action(methods, detail=False, **kwargs)(func) - if 'url_name' not in kwargs: - func.url_name = func.url_path.replace('_', '-') - return func - return decorator diff --git a/rest_framework/filters.py b/rest_framework/filters.py index e3b0468c7..2af063926 100644 --- a/rest_framework/filters.py +++ b/rest_framework/filters.py @@ -3,7 +3,6 @@ Provides generic filtering backends that can be used to filter the results returned by list views. """ import operator -import warnings from functools import reduce from django.core.exceptions import ImproperlyConfigured @@ -14,10 +13,7 @@ from django.template import loader from django.utils.encoding import force_text from django.utils.translation import gettext_lazy as _ -from rest_framework import RemovedInDRF310Warning -from rest_framework.compat import ( - coreapi, coreschema, distinct, is_guardian_installed -) +from rest_framework.compat import coreapi, coreschema, distinct from rest_framework.settings import api_settings @@ -315,41 +311,3 @@ class OrderingFilter(BaseFilterBackend): }, }, ] - - -class DjangoObjectPermissionsFilter(BaseFilterBackend): - """ - A filter backend that limits results to those where the requesting user - has read object level permissions. - """ - def __init__(self): - warnings.warn( - "`DjangoObjectPermissionsFilter` has been deprecated and moved to " - "the 3rd-party django-rest-framework-guardian package.", - RemovedInDRF310Warning, stacklevel=2 - ) - assert is_guardian_installed(), 'Using DjangoObjectPermissionsFilter, but django-guardian is not installed' - - perm_format = '%(app_label)s.view_%(model_name)s' - - def filter_queryset(self, request, queryset, view): - # We want to defer this import until run-time, rather than import-time. - # See https://github.com/encode/django-rest-framework/issues/4608 - # (Also see #1624 for why we need to make this import explicitly) - from guardian import VERSION as guardian_version - from guardian.shortcuts import get_objects_for_user - - extra = {} - user = request.user - model_cls = queryset.model - kwargs = { - 'app_label': model_cls._meta.app_label, - 'model_name': model_cls._meta.model_name - } - permission = self.perm_format % kwargs - if tuple(guardian_version) >= (1, 3): - # Maintain behavior compatibility with versions prior to 1.3 - extra = {'accept_global_perms': False} - else: - extra = {} - return get_objects_for_user(user, permission, queryset, **extra) diff --git a/rest_framework/routers.py b/rest_framework/routers.py index 9334706f8..ee5760e81 100644 --- a/rest_framework/routers.py +++ b/rest_framework/routers.py @@ -22,9 +22,7 @@ from django.core.exceptions import ImproperlyConfigured from django.urls import NoReverseMatch from django.utils.deprecation import RenameMethodsBase -from rest_framework import ( - RemovedInDRF310Warning, RemovedInDRF311Warning, views -) +from rest_framework import RemovedInDRF311Warning, views from rest_framework.response import Response from rest_framework.reverse import reverse from rest_framework.schemas import SchemaGenerator @@ -36,28 +34,6 @@ Route = namedtuple('Route', ['url', 'mapping', 'name', 'detail', 'initkwargs']) DynamicRoute = namedtuple('DynamicRoute', ['url', 'name', 'detail', 'initkwargs']) -class DynamicDetailRoute: - def __new__(cls, url, name, initkwargs): - warnings.warn( - "`DynamicDetailRoute` is deprecated and will be removed in 3.10 " - "in favor of `DynamicRoute`, which accepts a `detail` boolean. Use " - "`DynamicRoute(url, name, True, initkwargs)` instead.", - RemovedInDRF310Warning, stacklevel=2 - ) - return DynamicRoute(url, name, True, initkwargs) - - -class DynamicListRoute: - def __new__(cls, url, name, initkwargs): - warnings.warn( - "`DynamicListRoute` is deprecated and will be removed in 3.10 in " - "favor of `DynamicRoute`, which accepts a `detail` boolean. Use " - "`DynamicRoute(url, name, False, initkwargs)` instead.", - RemovedInDRF310Warning, stacklevel=2 - ) - return DynamicRoute(url, name, False, initkwargs) - - def escape_curly_brackets(url_path): """ Double brackets in regex of url_path for escape string formatting diff --git a/tests/test_decorators.py b/tests/test_decorators.py index bd30449e5..e10f0e5c5 100644 --- a/tests/test_decorators.py +++ b/tests/test_decorators.py @@ -1,12 +1,11 @@ import pytest from django.test import TestCase -from rest_framework import RemovedInDRF310Warning, status +from rest_framework import status from rest_framework.authentication import BasicAuthentication from rest_framework.decorators import ( - action, api_view, authentication_classes, detail_route, list_route, - parser_classes, permission_classes, renderer_classes, schema, - throttle_classes + action, api_view, authentication_classes, parser_classes, + permission_classes, renderer_classes, schema, throttle_classes ) from rest_framework.parsers import JSONParser from rest_framework.permissions import IsAuthenticated @@ -285,39 +284,3 @@ class ActionDecoratorTestCase(TestCase): @test_action.mapping.post def test_action(): raise NotImplementedError - - def test_detail_route_deprecation(self): - with pytest.warns(RemovedInDRF310Warning) as record: - @detail_route() - def view(request): - raise NotImplementedError - - assert len(record) == 1 - assert str(record[0].message) == ( - "`detail_route` is deprecated and will be removed in " - "3.10 in favor of `action`, which accepts a `detail` bool. Use " - "`@action(detail=True)` instead." - ) - - def test_list_route_deprecation(self): - with pytest.warns(RemovedInDRF310Warning) as record: - @list_route() - def view(request): - raise NotImplementedError - - assert len(record) == 1 - assert str(record[0].message) == ( - "`list_route` is deprecated and will be removed in " - "3.10 in favor of `action`, which accepts a `detail` bool. Use " - "`@action(detail=False)` instead." - ) - - def test_route_url_name_from_path(self): - # pre-3.8 behavior was to base the `url_name` off of the `url_path` - with pytest.warns(RemovedInDRF310Warning): - @list_route(url_path='foo_bar') - def view(request): - raise NotImplementedError - - assert view.url_path == 'foo_bar' - assert view.url_name == 'foo-bar' diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 9c9300694..03b80aae8 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -1,21 +1,20 @@ import base64 import unittest -import warnings from unittest import mock import django import pytest +from django.conf import settings from django.contrib.auth.models import AnonymousUser, Group, Permission, User from django.db import models from django.test import TestCase from django.urls import ResolverMatch from rest_framework import ( - HTTP_HEADER_ENCODING, RemovedInDRF310Warning, authentication, generics, - permissions, serializers, status, views + HTTP_HEADER_ENCODING, authentication, generics, permissions, serializers, + status, views ) -from rest_framework.compat import PY36, is_guardian_installed -from rest_framework.filters import DjangoObjectPermissionsFilter +from rest_framework.compat import PY36 from rest_framework.routers import DefaultRouter from rest_framework.test import APIRequestFactory from tests.models import BasicModel @@ -309,7 +308,7 @@ class GetQuerysetObjectPermissionInstanceView(generics.RetrieveUpdateDestroyAPIV get_queryset_object_permissions_view = GetQuerysetObjectPermissionInstanceView.as_view() -@unittest.skipUnless(is_guardian_installed(), 'django-guardian not installed') +@unittest.skipUnless('guardian' in settings.INSTALLED_APPS, 'django-guardian not installed') class ObjectPermissionsIntegrationTests(TestCase): """ Integration tests for the object level permissions API. @@ -418,37 +417,14 @@ class ObjectPermissionsIntegrationTests(TestCase): self.assertEqual(response.status_code, status.HTTP_200_OK) # Read list - def test_django_object_permissions_filter_deprecated(self): - with warnings.catch_warnings(record=True) as w: - warnings.simplefilter("always") - DjangoObjectPermissionsFilter() - - message = ("`DjangoObjectPermissionsFilter` has been deprecated and moved " - "to the 3rd-party django-rest-framework-guardian package.") - self.assertEqual(len(w), 1) - self.assertIs(w[-1].category, RemovedInDRF310Warning) - self.assertEqual(str(w[-1].message), message) - + # Note: this previously tested `DjangoObjectPermissionsFilter`, which has + # since been moved to a separate package. These now act as sanity checks. def test_can_read_list_permissions(self): request = factory.get('/', HTTP_AUTHORIZATION=self.credentials['readonly']) - object_permissions_list_view.cls.filter_backends = (DjangoObjectPermissionsFilter,) - # TODO: remove in version 3.10 - with warnings.catch_warnings(record=True): - warnings.simplefilter("always") - response = object_permissions_list_view(request) + response = object_permissions_list_view(request) self.assertEqual(response.status_code, status.HTTP_200_OK) self.assertEqual(response.data[0].get('id'), 1) - def test_cannot_read_list_permissions(self): - request = factory.get('/', HTTP_AUTHORIZATION=self.credentials['writeonly']) - object_permissions_list_view.cls.filter_backends = (DjangoObjectPermissionsFilter,) - # TODO: remove in version 3.10 - with warnings.catch_warnings(record=True): - warnings.simplefilter("always") - response = object_permissions_list_view(request) - self.assertEqual(response.status_code, status.HTTP_200_OK) - self.assertListEqual(response.data, []) - def test_cannot_method_not_allowed(self): request = factory.generic('METHOD_NOT_ALLOWED', '/', HTTP_AUTHORIZATION=self.credentials['readonly']) response = object_permissions_list_view(request) From 0d0e7c3ae092e1b98f4826ccf356a87cb9aa2b56 Mon Sep 17 00:00:00 2001 From: Florian Wendelborn <1133858+FlorianWendelborn@users.noreply.github.com> Date: Wed, 22 May 2019 20:25:12 +0200 Subject: [PATCH 56/69] Add HTTP 308 Permanent Redirect (#6693) --- rest_framework/status.py | 1 + 1 file changed, 1 insertion(+) diff --git a/rest_framework/status.py b/rest_framework/status.py index 1489b440c..df0fa0f02 100644 --- a/rest_framework/status.py +++ b/rest_framework/status.py @@ -45,6 +45,7 @@ HTTP_304_NOT_MODIFIED = 304 HTTP_305_USE_PROXY = 305 HTTP_306_RESERVED = 306 HTTP_307_TEMPORARY_REDIRECT = 307 +HTTP_308_PERMANENT_REDIRECT = 308 HTTP_400_BAD_REQUEST = 400 HTTP_401_UNAUTHORIZED = 401 HTTP_402_PAYMENT_REQUIRED = 402 From 19ca86d8d69d37d0e953837fbba1c1934d31dc75 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Wed, 22 May 2019 19:41:53 -0700 Subject: [PATCH 57/69] Fix lazy translation of ListField errors (#6708) * Test init for fields w/ lazy translations * Fix lazy translations for ListField --- rest_framework/fields.py | 4 ++-- tests/importable/__init__.py | 17 ++++++++++++++++- tests/importable/test_installed.py | 17 ++++++++++++++--- 3 files changed, 32 insertions(+), 6 deletions(-) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 179dd25c8..213134793 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1610,10 +1610,10 @@ class ListField(Field): super().__init__(*args, **kwargs) self.child.bind(field_name='', parent=self) if self.max_length is not None: - message = self.error_messages['max_length'].format(max_length=self.max_length) + message = lazy(self.error_messages['max_length'].format, str)(max_length=self.max_length) self.validators.append(MaxLengthValidator(self.max_length, message=message)) if self.min_length is not None: - message = self.error_messages['min_length'].format(min_length=self.min_length) + message = lazy(self.error_messages['min_length'].format, str)(min_length=self.min_length) self.validators.append(MinLengthValidator(self.min_length, message=message)) def get_value(self, dictionary): diff --git a/tests/importable/__init__.py b/tests/importable/__init__.py index b36599027..ded08258c 100644 --- a/tests/importable/__init__.py +++ b/tests/importable/__init__.py @@ -1 +1,16 @@ -from rest_framework import compat # noqa +""" +This test "app" exists to ensure that parts of Django REST Framework can be +imported/invoked before Django itself has been fully initialized. +""" + +from rest_framework import compat, serializers # noqa + + +# test initializing fields with lazy translations +class ExampleSerializer(serializers.Serializer): + charfield = serializers.CharField(min_length=1, max_length=2) + integerfield = serializers.IntegerField(min_value=1, max_value=2) + floatfield = serializers.FloatField(min_value=1, max_value=2) + decimalfield = serializers.DecimalField(max_digits=10, decimal_places=1, min_value=1, max_value=2) + durationfield = serializers.DurationField(min_value=1, max_value=2) + listfield = serializers.ListField(min_length=1, max_length=2) diff --git a/tests/importable/test_installed.py b/tests/importable/test_installed.py index 072d3b2e4..c7e53af23 100644 --- a/tests/importable/test_installed.py +++ b/tests/importable/test_installed.py @@ -4,10 +4,21 @@ from tests import importable def test_installed(): - # ensure that apps can freely import rest_framework.compat + # ensure the test app hasn't been removed from the test suite assert 'tests.importable' in settings.INSTALLED_APPS -def test_imported(): - # ensure that the __init__ hasn't been mucked with +def test_compat(): assert hasattr(importable, 'compat') + + +def test_serializer_fields_initialization(): + assert hasattr(importable, 'ExampleSerializer') + + serializer = importable.ExampleSerializer() + assert 'charfield' in serializer.fields + assert 'integerfield' in serializer.fields + assert 'floatfield' in serializer.fields + assert 'decimalfield' in serializer.fields + assert 'durationfield' in serializer.fields + assert 'listfield' in serializer.fields From afb678433b7dc068213e6e8a359ad1f6fff05b0d Mon Sep 17 00:00:00 2001 From: Mathieu Pillard Date: Thu, 23 May 2019 15:42:29 +0200 Subject: [PATCH 58/69] Always call all throttling classes on the view when checking throttles (#6711) --- rest_framework/views.py | 6 +++++- tests/test_throttling.py | 46 +++++++++++++++++++++++++++++++++++++++- 2 files changed, 50 insertions(+), 2 deletions(-) diff --git a/rest_framework/views.py b/rest_framework/views.py index 6ef7021d4..832f17233 100644 --- a/rest_framework/views.py +++ b/rest_framework/views.py @@ -350,9 +350,13 @@ class APIView(View): Check if request should be throttled. Raises an appropriate exception if the request is throttled. """ + throttle_durations = [] for throttle in self.get_throttles(): if not throttle.allow_request(request, self): - self.throttled(request, throttle.wait()) + throttle_durations.append(throttle.wait()) + + if throttle_durations: + self.throttled(request, max(throttle_durations)) def determine_version(self, request, *args, **kwargs): """ diff --git a/tests/test_throttling.py b/tests/test_throttling.py index b20b6a809..3c172e263 100644 --- a/tests/test_throttling.py +++ b/tests/test_throttling.py @@ -30,6 +30,11 @@ class User3MinRateThrottle(UserRateThrottle): scope = 'minutes' +class User6MinRateThrottle(UserRateThrottle): + rate = '6/min' + scope = 'minutes' + + class NonTimeThrottle(BaseThrottle): def allow_request(self, request, view): if not hasattr(self.__class__, 'called'): @@ -38,6 +43,13 @@ class NonTimeThrottle(BaseThrottle): return False +class MockView_DoubleThrottling(APIView): + throttle_classes = (User3SecRateThrottle, User6MinRateThrottle,) + + def get(self, request): + return Response('foo') + + class MockView(APIView): throttle_classes = (User3SecRateThrottle,) @@ -80,7 +92,8 @@ class ThrottlingTests(TestCase): """ Explicitly set the timer, overriding time.time() """ - view.throttle_classes[0].timer = lambda self: value + for cls in view.throttle_classes: + cls.timer = lambda self: value def test_request_throttling_expires(self): """ @@ -115,6 +128,37 @@ class ThrottlingTests(TestCase): """ self.ensure_is_throttled(MockView, 200) + def test_request_throttling_multiple_throttles(self): + """ + Ensure all throttle classes see each request even when the request is + already being throttled + """ + self.set_throttle_timer(MockView_DoubleThrottling, 0) + request = self.factory.get('/') + for dummy in range(4): + response = MockView_DoubleThrottling.as_view()(request) + assert response.status_code == 429 + assert int(response['retry-after']) == 1 + + # At this point our client made 4 requests (one was throttled) in a + # second. If we advance the timer by one additional second, the client + # should be allowed to make 2 more before being throttled by the 2nd + # throttle class, which has a limit of 6 per minute. + self.set_throttle_timer(MockView_DoubleThrottling, 1) + for dummy in range(2): + response = MockView_DoubleThrottling.as_view()(request) + assert response.status_code == 200 + + response = MockView_DoubleThrottling.as_view()(request) + assert response.status_code == 429 + assert int(response['retry-after']) == 59 + + # Just to make sure check again after two more seconds. + self.set_throttle_timer(MockView_DoubleThrottling, 2) + response = MockView_DoubleThrottling.as_view()(request) + assert response.status_code == 429 + assert int(response['retry-after']) == 58 + def ensure_response_header_contains_proper_throttle_field(self, view, expected_headers): """ Ensure the response returns an Retry-After field with status and next attributes From 514033815d6edf370793adb2f650039aab4f5df2 Mon Sep 17 00:00:00 2001 From: Raffaele Salmaso Date: Fri, 24 May 2019 13:47:35 +0200 Subject: [PATCH 59/69] Allow JSONField encoder customization. (#6713) --- docs/api-guide/fields.md | 3 ++- rest_framework/fields.py | 5 +++-- rest_framework/serializers.py | 5 +++++ tests/test_model_serializer.py | 7 +++++-- 4 files changed, 15 insertions(+), 5 deletions(-) diff --git a/docs/api-guide/fields.md b/docs/api-guide/fields.md index b2830d0c9..64515f804 100644 --- a/docs/api-guide/fields.md +++ b/docs/api-guide/fields.md @@ -501,9 +501,10 @@ Note that the child field **must** be an instance of `CharField`, as the hstore A field class that validates that the incoming data structure consists of valid JSON primitives. In its alternate binary mode, it will represent and validate JSON-encoded binary strings. -**Signature**: `JSONField(binary)` +**Signature**: `JSONField(binary, encoder)` - `binary` - If set to `True` then the field will output and validate a JSON encoded string, rather than a primitive data structure. Defaults to `False`. +- `encoder` - Use this JSON encoder to serialize input object. Defaults to `None`. --- diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 213134793..7da3d2b8e 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1746,6 +1746,7 @@ class JSONField(Field): def __init__(self, *args, **kwargs): self.binary = kwargs.pop('binary', False) + self.encoder = kwargs.pop('encoder', None) super().__init__(*args, **kwargs) def get_value(self, dictionary): @@ -1767,14 +1768,14 @@ class JSONField(Field): data = data.decode() return json.loads(data) else: - json.dumps(data) + json.dumps(data, cls=self.encoder) except (TypeError, ValueError): self.fail('invalid') return data def to_representation(self, value): if self.binary: - value = json.dumps(value) + value = json.dumps(value, cls=self.encoder) value = value.encode() return value diff --git a/rest_framework/serializers.py b/rest_framework/serializers.py index b23389c56..857d3ed94 100644 --- a/rest_framework/serializers.py +++ b/rest_framework/serializers.py @@ -1232,6 +1232,11 @@ class ModelSerializer(Serializer): # `allow_blank` is only valid for textual fields. field_kwargs.pop('allow_blank', None) + if postgres_fields and isinstance(model_field, postgres_fields.JSONField): + # Populate the `encoder` argument of `JSONField` instances generated + # for the PostgreSQL specific `JSONField`. + field_kwargs['encoder'] = getattr(model_field, 'encoder', None) + if postgres_fields and isinstance(model_field, postgres_fields.ArrayField): # Populate the `child` argument on `ListField` instances generated # for the PostgreSQL specific `ArrayField`. diff --git a/tests/test_model_serializer.py b/tests/test_model_serializer.py index 413d7885d..88c6785b2 100644 --- a/tests/test_model_serializer.py +++ b/tests/test_model_serializer.py @@ -13,6 +13,7 @@ from collections import OrderedDict import django import pytest from django.core.exceptions import ImproperlyConfigured +from django.core.serializers.json import DjangoJSONEncoder from django.core.validators import ( MaxValueValidator, MinLengthValidator, MinValueValidator ) @@ -452,15 +453,17 @@ class TestPosgresFieldsMapping(TestCase): def test_json_field(self): class JSONFieldModel(models.Model): json_field = postgres_fields.JSONField() + json_field_with_encoder = postgres_fields.JSONField(encoder=DjangoJSONEncoder) class TestSerializer(serializers.ModelSerializer): class Meta: model = JSONFieldModel - fields = ['json_field'] + fields = ['json_field', 'json_field_with_encoder'] expected = dedent(""" TestSerializer(): - json_field = JSONField(style={'base_template': 'textarea.html'}) + json_field = JSONField(encoder=None, style={'base_template': 'textarea.html'}) + json_field_with_encoder = JSONField(encoder=, style={'base_template': 'textarea.html'}) """) self.assertEqual(repr(TestSerializer()), expected) From 10a0b42b749bd5965ea925633ff5b36e3b53bf74 Mon Sep 17 00:00:00 2001 From: Dani Hodovic Date: Fri, 24 May 2019 19:50:15 +0800 Subject: [PATCH 60/69] Add more DRF job sites (#6691) --- docs/community/jobs.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/community/jobs.md b/docs/community/jobs.md index e74b78c7f..5f3d60b55 100644 --- a/docs/community/jobs.md +++ b/docs/community/jobs.md @@ -9,6 +9,7 @@ Looking for a new Django REST Framework related role? On this site we provide a * [https://www.python.org/jobs/][python-org-jobs] * [https://djangogigs.com][django-gigs-com] * [https://djangojobs.net/jobs/][django-jobs-net] +* [https://findwork.dev/django-rest-framework-jobs][findwork-dev] * [https://www.indeed.com/q-Django-jobs.html][indeed-com] * [https://stackoverflow.com/jobs/developer-jobs-using-django][stackoverflow-com] * [https://www.upwork.com/o/jobs/browse/skill/django-framework/][upwork-com] @@ -26,6 +27,7 @@ Wonder how else you can help? One of the best ways you can help Django REST Fram [python-org-jobs]: https://www.python.org/jobs/ [django-gigs-com]: https://djangogigs.com [django-jobs-net]: https://djangojobs.net/jobs/ +[findwork-dev]: https://findwork.dev/django-rest-framework-jobs [indeed-com]: https://www.indeed.com/q-Django-jobs.html [stackoverflow-com]: https://stackoverflow.com/jobs/developer-jobs-using-django [upwork-com]: https://www.upwork.com/o/jobs/browse/skill/django-framework/ From 063f0de949650ee98a4c795d6bcdf994dadbfe4a Mon Sep 17 00:00:00 2001 From: Monte Hellawell Date: Wed, 29 May 2019 09:57:07 +0100 Subject: [PATCH 61/69] Move security information to the GitHub security tab (#6716) * Create SECURITY.md * Update security policy links in README.md --- README.md | 6 ++---- SECURITY.md | 9 +++++++++ 2 files changed, 11 insertions(+), 4 deletions(-) create mode 100644 SECURITY.md diff --git a/README.md b/README.md index b80b7fe01..ecf59d7fa 100644 --- a/README.md +++ b/README.md @@ -175,9 +175,7 @@ You may also want to [follow the author on Twitter][twitter]. # Security -If you believe you've found something in Django REST framework which has security implications, please **do not raise the issue in a public forum**. - -Send a description of the issue via email to [rest-framework-security@googlegroups.com][security-mail]. The project maintainers will then work with you to resolve any issues where required, prior to any public disclosure. +Please see the [security policy][security-policy]. [build-status-image]: https://secure.travis-ci.org/encode/django-rest-framework.svg?branch=master [travis]: https://travis-ci.org/encode/django-rest-framework?branch=master @@ -225,4 +223,4 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [image]: https://www.django-rest-framework.org/img/quickstart.png [docs]: https://www.django-rest-framework.org/ -[security-mail]: mailto:rest-framework-security@googlegroups.com +[security-policy]: https://github.com/encode/django-rest-framework/security/policy diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 000000000..d3faefa3c --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,9 @@ +# Security Policy + +## Reporting a Vulnerability + +If you believe you've found something in Django REST framework which has security implications, please **do not raise the issue in a public forum**. + +Send a description of the issue via email to [rest-framework-security@googlegroups.com][security-mail]. The project maintainers will then work with you to resolve any issues where required, prior to any public disclosure. + +[security-mail]: mailto:rest-framework-security@googlegroups.com From 62ed1f82707916a23b4e97aae8e48f09ddaf1dea Mon Sep 17 00:00:00 2001 From: Rodolfo Carvalho Date: Wed, 29 May 2019 17:51:24 +0100 Subject: [PATCH 62/69] Use yaml.safe_load instead of load (#6719) Use of PyYAML's yaml.load function without specifying the Loader parameter has been deprecated, see https://msg.pyyaml.org/load. Earlier versions of PyYAML already had the alternative safe_load function, which limits the loader to a subset of YAML constructs, that is enough for what we need here. Fixes #6677 --- tests/schemas/test_managementcommand.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/schemas/test_managementcommand.py b/tests/schemas/test_managementcommand.py index e5960f2b0..42e0e99d1 100644 --- a/tests/schemas/test_managementcommand.py +++ b/tests/schemas/test_managementcommand.py @@ -45,7 +45,7 @@ class GenerateSchemaTests(TestCase): '--description=Sample description', stdout=self.out) # Check valid YAML was output. - schema = yaml.load(self.out.getvalue()) + schema = yaml.safe_load(self.out.getvalue()) assert schema['openapi'] == '3.0.2' def test_renders_openapi_json_schema(self): From c2293e9f251b1f215825186a7bcbf5a006df0cb0 Mon Sep 17 00:00:00 2001 From: Ran Benita Date: Wed, 29 May 2019 21:32:03 +0300 Subject: [PATCH 63/69] Improve performance of lazy validation message formatting (#6709) --- rest_framework/compat.py | 30 ------------------ rest_framework/fields.py | 51 ++++++++++-------------------- rest_framework/utils/formatting.py | 26 +++++++++++++++ tests/test_utils.py | 19 +++++++++++ 4 files changed, 62 insertions(+), 64 deletions(-) diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 2e6a8adda..4bee21f91 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -5,7 +5,6 @@ versions of Django/Python, and compatibility wrappers around optional packages. import sys from django.conf import settings -from django.core import validators from django.views.generic import View try: @@ -238,34 +237,5 @@ LONG_SEPARATORS = (', ', ': ') INDENT_SEPARATORS = (',', ': ') -class CustomValidatorMessage: - """ - We need to avoid evaluation of `lazy` translated `message` in `django.core.validators.BaseValidator.__init__`. - https://github.com/django/django/blob/75ed5900321d170debef4ac452b8b3cf8a1c2384/django/core/validators.py#L297 - - Ref: https://github.com/encode/django-rest-framework/pull/5452 - """ - - def __init__(self, *args, **kwargs): - self.message = kwargs.pop('message', self.message) - super().__init__(*args, **kwargs) - - -class MinValueValidator(CustomValidatorMessage, validators.MinValueValidator): - pass - - -class MaxValueValidator(CustomValidatorMessage, validators.MaxValueValidator): - pass - - -class MinLengthValidator(CustomValidatorMessage, validators.MinLengthValidator): - pass - - -class MaxLengthValidator(CustomValidatorMessage, validators.MaxLengthValidator): - pass - - # Version Constants. PY36 = sys.version_info >= (3, 6) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 7da3d2b8e..a68cd6ecc 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -12,7 +12,8 @@ from django.conf import settings from django.core.exceptions import ObjectDoesNotExist from django.core.exceptions import ValidationError as DjangoValidationError from django.core.validators import ( - EmailValidator, RegexValidator, URLValidator, ip_address_validators + EmailValidator, MaxLengthValidator, MaxValueValidator, MinLengthValidator, + MinValueValidator, RegexValidator, URLValidator, ip_address_validators ) from django.forms import FilePathField as DjangoFilePathField from django.forms import ImageField as DjangoImageField @@ -23,20 +24,17 @@ from django.utils.dateparse import ( from django.utils.duration import duration_string from django.utils.encoding import is_protected_type, smart_text from django.utils.formats import localize_input, sanitize_separators -from django.utils.functional import lazy from django.utils.ipv6 import clean_ipv6_address from django.utils.timezone import utc from django.utils.translation import gettext_lazy as _ from pytz.exceptions import InvalidTimeError from rest_framework import ISO_8601 -from rest_framework.compat import ( - MaxLengthValidator, MaxValueValidator, MinLengthValidator, - MinValueValidator, ProhibitNullCharactersValidator -) +from rest_framework.compat import ProhibitNullCharactersValidator from rest_framework.exceptions import ErrorDetail, ValidationError from rest_framework.settings import api_settings from rest_framework.utils import html, humanize_datetime, json, representation +from rest_framework.utils.formatting import lazy_format class empty: @@ -749,12 +747,11 @@ class CharField(Field): self.min_length = kwargs.pop('min_length', None) super().__init__(**kwargs) if self.max_length is not None: - message = lazy(self.error_messages['max_length'].format, str)(max_length=self.max_length) + message = lazy_format(self.error_messages['max_length'], max_length=self.max_length) self.validators.append( MaxLengthValidator(self.max_length, message=message)) if self.min_length is not None: - message = lazy( - self.error_messages['min_length'].format, str)(min_length=self.min_length) + message = lazy_format(self.error_messages['min_length'], min_length=self.min_length) self.validators.append( MinLengthValidator(self.min_length, message=message)) @@ -915,13 +912,11 @@ class IntegerField(Field): self.min_value = kwargs.pop('min_value', None) super().__init__(**kwargs) if self.max_value is not None: - message = lazy( - self.error_messages['max_value'].format, str)(max_value=self.max_value) + message = lazy_format(self.error_messages['max_value'], max_value=self.max_value) self.validators.append( MaxValueValidator(self.max_value, message=message)) if self.min_value is not None: - message = lazy( - self.error_messages['min_value'].format, str)(min_value=self.min_value) + message = lazy_format(self.error_messages['min_value'], min_value=self.min_value) self.validators.append( MinValueValidator(self.min_value, message=message)) @@ -953,15 +948,11 @@ class FloatField(Field): self.min_value = kwargs.pop('min_value', None) super().__init__(**kwargs) if self.max_value is not None: - message = lazy( - self.error_messages['max_value'].format, - str)(max_value=self.max_value) + message = lazy_format(self.error_messages['max_value'], max_value=self.max_value) self.validators.append( MaxValueValidator(self.max_value, message=message)) if self.min_value is not None: - message = lazy( - self.error_messages['min_value'].format, - str)(min_value=self.min_value) + message = lazy_format(self.error_messages['min_value'], min_value=self.min_value) self.validators.append( MinValueValidator(self.min_value, message=message)) @@ -1012,14 +1003,11 @@ class DecimalField(Field): super().__init__(**kwargs) if self.max_value is not None: - message = lazy( - self.error_messages['max_value'].format, - str)(max_value=self.max_value) + message = lazy_format(self.error_messages['max_value'], max_value=self.max_value) self.validators.append( MaxValueValidator(self.max_value, message=message)) if self.min_value is not None: - message = lazy( - self.error_messages['min_value'].format, str)(min_value=self.min_value) + message = lazy_format(self.error_messages['min_value'], min_value=self.min_value) self.validators.append( MinValueValidator(self.min_value, message=message)) @@ -1357,15 +1345,11 @@ class DurationField(Field): self.min_value = kwargs.pop('min_value', None) super().__init__(**kwargs) if self.max_value is not None: - message = lazy( - self.error_messages['max_value'].format, - str)(max_value=self.max_value) + message = lazy_format(self.error_messages['max_value'], max_value=self.max_value) self.validators.append( MaxValueValidator(self.max_value, message=message)) if self.min_value is not None: - message = lazy( - self.error_messages['min_value'].format, - str)(min_value=self.min_value) + message = lazy_format(self.error_messages['min_value'], min_value=self.min_value) self.validators.append( MinValueValidator(self.min_value, message=message)) @@ -1610,10 +1594,10 @@ class ListField(Field): super().__init__(*args, **kwargs) self.child.bind(field_name='', parent=self) if self.max_length is not None: - message = lazy(self.error_messages['max_length'].format, str)(max_length=self.max_length) + message = lazy_format(self.error_messages['max_length'], max_length=self.max_length) self.validators.append(MaxLengthValidator(self.max_length, message=message)) if self.min_length is not None: - message = lazy(self.error_messages['min_length'].format, str)(min_length=self.min_length) + message = lazy_format(self.error_messages['min_length'], min_length=self.min_length) self.validators.append(MinLengthValidator(self.min_length, message=message)) def get_value(self, dictionary): @@ -1887,8 +1871,7 @@ class ModelField(Field): max_length = kwargs.pop('max_length', None) super().__init__(**kwargs) if max_length is not None: - message = lazy( - self.error_messages['max_length'].format, str)(max_length=self.max_length) + message = lazy_format(self.error_messages['max_length'], max_length=self.max_length) self.validators.append( MaxLengthValidator(self.max_length, message=message)) diff --git a/rest_framework/utils/formatting.py b/rest_framework/utils/formatting.py index 4e003f614..e96cc6719 100644 --- a/rest_framework/utils/formatting.py +++ b/rest_framework/utils/formatting.py @@ -65,3 +65,29 @@ def markup_description(description): description = escape(description).replace('\n', '
    ') description = '

    ' + description + '

    ' return mark_safe(description) + + +class lazy_format: + """ + Delay formatting until it's actually needed. + + Useful when the format string or one of the arguments is lazy. + + Not using Django's lazy because it is too slow. + """ + __slots__ = ('format_string', 'args', 'kwargs', 'result') + + def __init__(self, format_string, *args, **kwargs): + self.result = None + self.format_string = format_string + self.args = args + self.kwargs = kwargs + + def __str__(self): + if self.result is None: + self.result = self.format_string.format(*self.args, **self.kwargs) + self.format_string, self.args, self.kwargs = None, None, None + return self.result + + def __mod__(self, value): + return str(self) % value diff --git a/tests/test_utils.py b/tests/test_utils.py index 0d61cc2f9..885b5a58d 100644 --- a/tests/test_utils.py +++ b/tests/test_utils.py @@ -1,3 +1,5 @@ +from unittest import mock + from django.conf.urls import url from django.test import TestCase, override_settings @@ -6,6 +8,7 @@ from rest_framework.routers import SimpleRouter from rest_framework.serializers import ModelSerializer from rest_framework.utils import json from rest_framework.utils.breadcrumbs import get_breadcrumbs +from rest_framework.utils.formatting import lazy_format from rest_framework.utils.urls import remove_query_param, replace_query_param from rest_framework.views import APIView from rest_framework.viewsets import ModelViewSet @@ -257,3 +260,19 @@ class UrlsRemoveQueryParamTests(TestCase): removed_key = 'page' assert key in remove_query_param(q, removed_key) + + +class LazyFormatTests(TestCase): + def test_it_formats_correctly(self): + formatted = lazy_format('Does {} work? {answer}: %s', 'it', answer='Yes') + assert str(formatted) == 'Does it work? Yes: %s' + assert formatted % 'it does' == 'Does it work? Yes: it does' + + def test_it_formats_lazily(self): + message = mock.Mock(wraps='message') + formatted = lazy_format(message) + assert message.format.call_count == 0 + str(formatted) + assert message.format.call_count == 1 + str(formatted) + assert message.format.call_count == 1 From 8430f3e5b62605e3753018dd2e8f8975b41b0a0a Mon Sep 17 00:00:00 2001 From: Timothy Allen Date: Thu, 30 May 2019 15:23:37 -0400 Subject: [PATCH 64/69] Fix typo in github.com URL. (#6720) --- docs/api-guide/renderers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/renderers.md b/docs/api-guide/renderers.md index 4ec409681..fc35261f1 100644 --- a/docs/api-guide/renderers.md +++ b/docs/api-guide/renderers.md @@ -534,7 +534,7 @@ Comma-separated values are a plain-text tabular data format, that can be easily [messagepack]: https://msgpack.org/ [juanriaza]: https://github.com/juanriaza [mjumbewu]: https://github.com/mjumbewu -[flipperpa]: https://githuc.com/flipperpa +[flipperpa]: https://github.com/flipperpa [wharton]: https://github.com/wharton [drf-renderer-xlsx]: https://github.com/wharton/drf-renderer-xlsx [vbabiy]: https://github.com/vbabiy From 6bd25c09a642dea9918bd85a3c40671fbb8feb2d Mon Sep 17 00:00:00 2001 From: Florian Wendelborn <1133858+FlorianWendelborn@users.noreply.github.com> Date: Thu, 30 May 2019 23:32:46 +0200 Subject: [PATCH 65/69] Add Multiple HTTP Statuses (#6706) --- rest_framework/status.py | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/rest_framework/status.py b/rest_framework/status.py index df0fa0f02..06d090733 100644 --- a/rest_framework/status.py +++ b/rest_framework/status.py @@ -37,6 +37,8 @@ HTTP_204_NO_CONTENT = 204 HTTP_205_RESET_CONTENT = 205 HTTP_206_PARTIAL_CONTENT = 206 HTTP_207_MULTI_STATUS = 207 +HTTP_208_ALREADY_REPORTED = 208 +HTTP_226_IM_USED = 226 HTTP_300_MULTIPLE_CHOICES = 300 HTTP_301_MOVED_PERMANENTLY = 301 HTTP_302_FOUND = 302 @@ -67,6 +69,7 @@ HTTP_417_EXPECTATION_FAILED = 417 HTTP_422_UNPROCESSABLE_ENTITY = 422 HTTP_423_LOCKED = 423 HTTP_424_FAILED_DEPENDENCY = 424 +HTTP_426_UPGRADE_REQUIRED = 426 HTTP_428_PRECONDITION_REQUIRED = 428 HTTP_429_TOO_MANY_REQUESTS = 429 HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE = 431 @@ -77,5 +80,9 @@ HTTP_502_BAD_GATEWAY = 502 HTTP_503_SERVICE_UNAVAILABLE = 503 HTTP_504_GATEWAY_TIMEOUT = 504 HTTP_505_HTTP_VERSION_NOT_SUPPORTED = 505 +HTTP_506_VARIANT_ALSO_NEGOTIATES = 506 HTTP_507_INSUFFICIENT_STORAGE = 507 +HTTP_508_LOOP_DETECTED = 508 +HTTP_509_BANDWIDTH_LIMIT_EXCEEDED = 509 +HTTP_510_NOT_EXTENDED = 510 HTTP_511_NETWORK_AUTHENTICATION_REQUIRED = 511 From b37aa284eb4aee17f5c6659e7533427ffcc5a2c8 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Thu, 30 May 2019 15:05:27 -0700 Subject: [PATCH 66/69] Remove unnecessary bytes() calls (#6626) --- rest_framework/renderers.py | 2 +- rest_framework/response.py | 2 +- rest_framework/test.py | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/rest_framework/renderers.py b/rest_framework/renderers.py index 2a4ae5905..3dc94ed2d 100644 --- a/rest_framework/renderers.py +++ b/rest_framework/renderers.py @@ -88,7 +88,7 @@ class JSONRenderer(BaseRenderer): Render `data` into JSON, returning a bytestring. """ if data is None: - return bytes() + return b'' renderer_context = renderer_context or {} indent = self.get_indent(accepted_media_type, renderer_context) diff --git a/rest_framework/response.py b/rest_framework/response.py index db7977770..495423734 100644 --- a/rest_framework/response.py +++ b/rest_framework/response.py @@ -73,7 +73,7 @@ class Response(SimpleTemplateResponse): 'renderer returned unicode, and did not specify ' 'a charset value.' ) - return bytes(ret.encode(charset)) + return ret.encode(charset) if not ret: del self['Content-Type'] diff --git a/rest_framework/test.py b/rest_framework/test.py index 852d4919e..ab16c2787 100644 --- a/rest_framework/test.py +++ b/rest_framework/test.py @@ -185,7 +185,7 @@ class APIRequestFactory(DjangoRequestFactory): # Coerce text to bytes if required. if isinstance(ret, str): - ret = bytes(ret.encode(renderer.charset)) + ret = ret.encode(renderer.charset) return ret, content_type From 6aac9d2be1f3a40a85ca8068ceabf5d4507994e4 Mon Sep 17 00:00:00 2001 From: Adam Date: Thu, 30 May 2019 20:47:30 -0600 Subject: [PATCH 67/69] Remove references to django-crispy-forms (#6600) --- docs/index.md | 2 -- rest_framework/compat.py | 7 ------- 2 files changed, 9 deletions(-) diff --git a/docs/index.md b/docs/index.md index c8507cf1e..34440214a 100644 --- a/docs/index.md +++ b/docs/index.md @@ -95,7 +95,6 @@ The following packages are optional: * [coreapi][coreapi] (1.32.0+) - Schema generation support. * [Markdown][markdown] (2.6.0+) - Markdown support for the browsable API. * [django-filter][django-filter] (1.0.1+) - Filtering support. -* [django-crispy-forms][django-crispy-forms] - Improved HTML display for filtering. * [django-guardian][django-guardian] (1.1.1+) - Object level permissions support. ## Installation @@ -239,7 +238,6 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. [coreapi]: https://pypi.org/project/coreapi/ [markdown]: https://pypi.org/project/Markdown/ [django-filter]: https://pypi.org/project/django-filter/ -[django-crispy-forms]: https://github.com/maraujop/django-crispy-forms [django-guardian]: https://github.com/django-guardian/django-guardian [index]: . [oauth1-section]: api-guide/authentication/#django-rest-framework-oauth diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 4bee21f91..863d64406 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -116,13 +116,6 @@ except ImportError: yaml = None -# django-crispy-forms is optional -try: - import crispy_forms -except ImportError: - crispy_forms = None - - # requests is optional try: import requests From 3e210ae48d250b36c66c2b438b8ac1428fa24f3b Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Fri, 31 May 2019 14:11:58 -0700 Subject: [PATCH 68/69] Update markdown preprocessor registration (#6722) --- docs/community/release-notes.md | 21 +++++++++++++++++---- docs/index.md | 4 +++- requirements/requirements-optionals.txt | 3 ++- rest_framework/compat.py | 4 ++-- 4 files changed, 24 insertions(+), 8 deletions(-) diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index cda24809f..a27de2b64 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -38,17 +38,26 @@ You can determine your currently installed version using `pip show`: --- +## 3.10.x series + +### 3.10.0 + +**Date**: [Unreleased][3.10.0-milestone] + +* Resolve DeprecationWarning with markdown. [#6317][gh6317] + + ## 3.9.x series ### 3.9.4 -**Date**: [10th May 2019] +**Date**: 10th May 2019 This is a maintenance release that fixes an error handling bug under Python 2. ### 3.9.3 -**Date**: [29th April 2019] +**Date**: 29th April 2019 This is the last Django REST Framework release that will support Python 2. Be sure to upgrade to Python 3 before upgrading to Django REST Framework 3.10. @@ -58,7 +67,7 @@ Be sure to upgrade to Python 3 before upgrading to Django REST Framework 3.10. ### 3.9.2 -**Date**: [3rd March 2019][3.9.1-milestone] +**Date**: [3rd March 2019][3.9.2-milestone] * Routers: invalidate `_urls` cache on `register()` [#6407][gh6407] * Deferred schema renderer creation to avoid requiring pyyaml. [#6416][gh6416] @@ -1181,7 +1190,8 @@ For older release notes, [please see the version 2.x documentation][old-release- [3.8.2-milestone]: https://github.com/encode/django-rest-framework/milestone/68?closed=1 [3.9.0-milestone]: https://github.com/encode/django-rest-framework/milestone/66?closed=1 [3.9.1-milestone]: https://github.com/encode/django-rest-framework/milestone/70?closed=1 -[3.9.1-milestone]: https://github.com/encode/django-rest-framework/milestone/71?closed=1 +[3.9.2-milestone]: https://github.com/encode/django-rest-framework/milestone/71?closed=1 +[3.10.0-milestone]: https://github.com/encode/django-rest-framework/milestone/69?closed=1 [gh2013]: https://github.com/encode/django-rest-framework/issues/2013 @@ -2125,3 +2135,6 @@ For older release notes, [please see the version 2.x documentation][old-release- [gh6613]: https://github.com/encode/django-rest-framework/issues/6613 + + +[gh6317]: https://github.com/encode/django-rest-framework/issues/6317 diff --git a/docs/index.md b/docs/index.md index 34440214a..e20f3f2fb 100644 --- a/docs/index.md +++ b/docs/index.md @@ -93,7 +93,8 @@ each Python and Django series. The following packages are optional: * [coreapi][coreapi] (1.32.0+) - Schema generation support. -* [Markdown][markdown] (2.6.0+) - Markdown support for the browsable API. +* [Markdown][markdown] (3.0.0+) - Markdown support for the browsable API. +* [Pygments][pygments] (2.4.0+) - Add sytax highlighting to Markdown processing. * [django-filter][django-filter] (1.0.1+) - Filtering support. * [django-guardian][django-guardian] (1.1.1+) - Object level permissions support. @@ -237,6 +238,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. [eventbrite]: https://www.eventbrite.co.uk/about/ [coreapi]: https://pypi.org/project/coreapi/ [markdown]: https://pypi.org/project/Markdown/ +[pygments]: https://pypi.org/project/Pygments/ [django-filter]: https://pypi.org/project/django-filter/ [django-guardian]: https://github.com/django-guardian/django-guardian [index]: . diff --git a/requirements/requirements-optionals.txt b/requirements/requirements-optionals.txt index bc20c739a..d38ede9ba 100644 --- a/requirements/requirements-optionals.txt +++ b/requirements/requirements-optionals.txt @@ -1,6 +1,7 @@ # Optional packages which may be used with REST framework. psycopg2-binary>=2.8.2, <2.9 -markdown==2.6.11 +markdown==3.1.1 +pygments==2.4.2 django-guardian==1.5.0 django-filter>=2.1.0, <2.2 coreapi==2.3.1 diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 863d64406..8d28b49e8 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -128,7 +128,7 @@ if 'patch' not in View.http_method_names: View.http_method_names = View.http_method_names + ['patch'] -# Markdown is optional (version 2.6+ required) +# Markdown is optional (version 3.0+ required) try: import markdown @@ -206,7 +206,7 @@ if markdown is not None and pygments is not None: return ret.split("\n") def md_filter_add_syntax_highlight(md): - md.preprocessors.add('highlight', CodeBlockPreprocessor(), "_begin") + md.preprocessors.register(CodeBlockPreprocessor(), 'highlight', 40) return True else: def md_filter_add_syntax_highlight(md): From 3135ae86c90d358c70bcac2b7e7c5fc0cb5fad7d Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Tue, 4 Jun 2019 09:00:11 +0100 Subject: [PATCH 69/69] Create FUNDING.yml --- .github/FUNDING.yml | 1 + 1 file changed, 1 insertion(+) create mode 100644 .github/FUNDING.yml diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 000000000..d7c23d635 --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1 @@ +custom: https://fund.django-rest-framework.org/topics/funding/

    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 z z*DssC0jI|AHKx)~R0F2d-O~`XR_o&TpZ>qPHM7y&16#fjfr2c z`ewCUXH~Aw#DtO5=P7v@kW@M@8ADM?etX+E9Z4O`+G_^E(HTaJ9huhDl@c%Hh{9Bv z{*WP0{%&FDNWYlV8798-a~4d9J4I(*n1Fo+gOi2=RjQIs{h|W(5Q4_{@C@ zkox98sQ9wNuWqN!y1VtD?FkWC)pI1-McuEFP%>IM&5 zR2>s~fK6%o)!G{8xezxZQlKm2?7uF|$!%6x0)@$`)sVRFM{+8~$TF3^zKTA*~ ze$du_pyutu-5CJ5dhPyLs*>M(v@AAVTvW^!;-MahM;YZW(RHE``OMb8I8B9ar0&8~ z|0H9|8xnd_L4Ch($Iu5Dh6yL@m}FCaJ1wppNYgtwH}Fg51}InQVGHsbhoH3w_f zhcR$*_e8aRRymBegbghbzvUS}MZ*QO|Cw_yR36t3;TN$Xy79T2uXf;Ontkz`mD6Hw zqnKiaUe{i?uci5`-5?Xs-7BH*DE)YyYMw^`B~d_tyz)1&+Ks_~jYwR%U|_jOIsMr{ zu}qG={pmH#@x+0w{|_c5u6Lo{UIazjMS8)96vg&4o=CGnGYAG>YW2;$sGO-UGig5k@5PK+SSrLbcpkkBpjwXkRT<3Z2j)T zeC5U_ZJOlvnQd&RF*g<-F78&4Opf#jtaq$+BKGgr>&Q_KaHf;JcE2}k2YzY3aC>2K z;pVBpY>jiTsAR~r53>X+U1})0LVxd@H$fZt)Ga|LEMJ#hs4`vpkZ;4^(B9!FuDHhw zIa$hQblF!ijXxRNBrZDJ%uEk?KSaBJmV#9nUyizL(Ai5KR>o-ITm*{LQZE_p?X#FC z|BrmbZ%FP5mn+WB%-uFpVMRL9|4YyR#lXKW{vjjm?K&wLUYL4k6M}zx`A&25B5g*X z#-#kgh*s?n`ajd_PGj~rTd&5wj3ibLK?m?s#2HcL~ywX78b5Y+It3OIixIDz)qf2VO ztw7#~ZcIt>gA6&@OzA>9_N2OA9p4C|G~$tX`<$a0*!-!liOLM!MOG}fc_K_YX} zR~$Ukg?M0%<%4sg{f4rxWmS<){VZgqv$ok2vIzDthDkpv4>q1WR}n#xy-!@zl++i4 z722+J94$+4o8b@=eM>BhU1szEM$ux zk#05AyP{u%Dl9)8JW6<;F4e)~;QXlE(Eb?c7#(G#{uLME!j{wy^num!Fo-QbIbLn6 zgmLrUQE+xY)7cv8b#wc=Y8Y|+3u``4AiCQdM!i~JA{T*js->3B z+_wKPLtE}Fpp%F~$S5dTn*Z|8(+bLt5clW=9ZTsKirblA#!$yOti)v9FIBw;UOev_ zC=z7MosuM8hH$A+q{I^i%&2C1fQ}}@YrA^3jQHIxqd-+ck=U@|NOrZlvK!Um7>RNC zj0IgNuVJKU4!UUilOP3m4`k@URACMqfZb|6oY>=V)m2wl0I`~kd49gUfjYOg#KFLA zXRVt9g|eszqex5UOy{=Z^kUN3QeCmjQLi_sC`I25KB|ytHLz>_2_w?_bZ+;HC1Q1a zUQONxgyIhfBlEEDgP}A;{`Eq3Xtak-{oqg6w%4=v2Zx(Gj$~-M}#7 zHGbrIA{hC7@86sQX_$b4Yd}F@S`s^~Hy5<~1bBa)YYlQd=ayk&M9kB5J=VIFdv5U3 zwnelrKk_2=kJbRUcRy>E*)RZe40V?T63<6L=8tYxWzEaW`wg+`%1-emIUv8Zkt#n! zyg8n--V=%J-M!4B*^uU0X3MY6L zJ8W>yJ5EfPbstegvLhw6flV9FOr#Hk(e$kA(oc@1ZT^qfFm7s@^=JT>Cnd?TWHh{X z_j>yhIsw&CyxHq2+2ZSM9rb1$py;ie;P1ur7>T7upr|J_x|k=+h&)&j`d8ZoAFcxn z-zC4J;Zg=rLy6ksv0j2bni7|u zX#^q7T@05pS}#;7fDCTpFHR$~Sm9>AF2tm-b9&Hh`xr&wXcLkn5zEtQbw#>?)P$1( zE&9RKraz18eqQ%rqKi$Cm}vMU2*(&w5+=?P)m@L667kN%bVj_?)C@845-7E1t9p6h$Oo${@I_5}Nj@0wom2)>8T1kH zni^nvax62tBY+$=#**C=550(uU(NqQa!7+3*N1fn8$>kyy~nM|);qZk9X$f=eA?tt1k&cqj!4GbGEEWV@Z%+C#`OZ3)CXa@c-*g#zRXLMOKKVYPa&m7EPOIaX!QZR~-E<&(Y=^S_?f>KJE2HAd zwylFhaCf&L!GpUyA-D&3_rih%cMtCF?(PuW-Q6kNzUsc+eed|*eedt7F;1Pa_u6YO znRBl5h@#?s3rm%SZ=ERIWnVQW8W_Fm^|VfwB1DqU-K#Kx6bh_5#4^E>rC#+akC>t_ zW###s10)xXZ{AdQLFG{>8wCIaUgIYI`5-LeiVo`B%#Tctft1bFxaJVdxZjq==)(5Fb>9Nr! zqo!vR(7j31YA=s>ADmv7yMUS;l~krAqf(*cLu1{WtLA-eBS++f6cXbifk*;y=C9&k zwm!Aj;bj^rWsNeH-Db;*_&3sKMv~`lS8awKW?8_l}q0?FlC? zKisw3{Yv2e6(sn>(38g-;C(p_({yqn&>Mafha3}sLO~?k&meVgjWjMP5?gQzSHpZr zw;6By<1%{LynyCW%Y9IlM*FMN#O$-_M9< zh^d4Ue^2NxQ-Lq)#QV}CoH%yBZH%_?T0%l}vmKkiKl8j9*B{!1=Yql8ojSnBiQbk; zGv(@7X1uqjw(}?0&0uy@+jRci?7U%5k&`wsB6Ewl46r^-O%@x-iyHIl$o4hyPOJ?v zH~Xt@`9;%Br5mu^I5{>>Jf|F?l~=)hl1^Rs$Bj?*hiVE^HC5G?w^-h-_yJ1Vi4<1M zPQa#^?6}-L>=*^J0)^B=N~+J`9-Sdmqare{X*(rdDswE7H;+a->l+-MyWm^D?R)5H z-X{r9>^v3|tjX59Uo#Tl1yz02I!CnrNd_Y+z*~||h)n*-7$cD&+o)f2bIa$Y|8^>% zdL=n5usR8AiBhcP^LiU@X@)1bnB_utM;SsXv0E3ap(A6{2eMup?NaGM`OpuZ`TL!fDoy}dgY((zeXi9E6~)Zx#ibZFDKEn~sLMC4l3CupjEK){cx_~K zcXDt#+wt4kCjzrKVWLFl2+Z|Yc;Zx49M(dj1X(CLImPKs-_?S;wyQdrR^5{8Vk z?_8)>0*?>Oo(=n%6vd$VO8!iS`$;kJ@xR?;E$H74FX}j`YfibX)}D~4 zOgtY`%VgvXE)1F(A{j6DzE#P~M>Gc1*20<- zhpxw-PlyivXaps~+epF|aP_(7hDg?%(U|wAey>9B>`@r!82Q>upQ)v8?^FE* zDT6-KGi{PF9}FLv$i-p@n(ftFZ)IM@fZ z`i!iwBReA$CWG^s?)DSQdg}0s!C4Bte<8-4xWH8?UZEmJdY*~BwukIgfKBe-AtDQf zxsrltvs_obfVwU2D-66qZbWX65hgn$+JbSS0E>}?K}D$cCW$zp*0Av&zuOu5>T4IH z-Tu+d!?*Pp%x3EPgV%&|LFB_H2To?1Wq0xfFp&VG7(tHmex?r zbUy}g4(IM(k&`ANtiQDXCUOgRPv*#~D+7Oof*Q*8b?lwjaeJxX6O_UXL|DKXH75&b zc{z>30sQz(7UKAuC-n+Ns@YM2Ysw3*GJ{JUMX@PVFDHtS5AFSaL$3#v-@*=N01%`{ z%!dr2j42LE#(9XmafvIn{{X3?phw|K^jNV(Xg{H?p14LhzlsjMTAh951uiN*%;@P3 z!GGIXQ{0by zTK*_)MsMKgJ!}c@Knh_-xp|EDfTp?GOlD}tcc3rx&;jscr+5t z&$DCjlZQLTN6feWK+;;sn$r+7uNu$$bABqL?P+v@Bqm^ab(C>%K!UjYdgBFeaQ#iG zP-MMCC76&8@0Cin>s%pm6C&2kv~uIaQR}{pn&BbwTQHw(=g%D14Y7B}@$Qt&^~fET-__SBNU7q^Nyk3~7q0J<_zU zKucwBmqIQvC8zuXFC*}VJzRyo6_&&&V_-_bUg7hL$d!1o*z^Ui8P)M>HjaX%up>-} zOX+g!8F}l-N5^kwq9x3M?rQVZbTdaLlib{yVYn=FOHUz9@cN{(c!jA<@1828Tubtf zK;EDtBWIath|J63)A!*)g`M7en;fF|p34|VvyI9uepIX86Sv)NR;K$|9x2XdGI4Kr#8iKYNBS;TKOh0bZQ?|M*hZN_Z<7{)ymrRJ-5f7#4)n?B54fN?#`G8 zo$Q8?C-8_7S-NqDV#%eODi|{!XJ%-QrP>;(Kkv_VdYg0YWHa6COLz9Lv8GE;Un$NR z$YNX>ogeV7-mpT3)i(PN7%7f82nxrZsrZ(u$oULEN|imM5XMP1??}1j-=My+QTh7| zN5`^!EEVv=;c@kp_Pg@j?&0E#jk-Ty3MkBY;KoXGr+c;}&G31$7}qy8JZ(}+_YW&7 zf{ZPN**xRu5CgwvE;HqP<_`!swSE}fDAb=#zA)JAl5#ux34df|7)kY^4VR&Tn$nt$ zU+0l={t+5(!ZH1`06jgprGN*-1Ya%64fYEJsWF%o%*GI`a}~^8m^Zu5g4?+=FB5h3Y+117saW6S3S-|((4y4$tMsUAhTABW?+_A;zA?=rC6n1 zt2(dWyI-EnL4#*wGkHtKmN!s&t=OSnd*W7D)mL~?m`}{)h7q6)}OF%@8r{6b;S{rl;~j; zjNu$g_TjNkOXRI8G+gxV>c3w7uJnSt0y5FnIC$s=I7bfI;mL78E$BJou4`P=s9p^9 z29FuVD=Qz7J4=kGv(bYb<>M#s`%CyHw{s_gUS=*5o;b*BCJD3Obf0=sCgyi`_A9}N*Zvp^N;R?rO4rRQk8xGGZO?$1b`ul#0 zpD0LE_{3EFn9N1Fy*(#p9P!Ja+{%Tz6oN0wWP+b4yABSS^A*99&6dFdL@YG|tg2*yX=pS(g|kW)MYy`mK>V)# zRGvs=CJ~+%5|bO5>(v;Vw`6E0lert5S#zwahRq#S8^!Ac;@I!U6g_3Cx9mP!rSFU9 z*v)eZh)dabINC5f0C~&a4=N=uSN+Dys>?b*4rV^cjB%gSR&=OJ3mJN&-E2w*##CL|1}mLhHQXA&jmT8$@H3&0OHVSFHfmM49yCueHKgq zX25kRkUQ3f?(p_r2msL$wr*-_NYQ>eKd+3EDh+6q%O9hY>WiR;{*ugcONLbXokLGq zMI~~J{4kH~UcJGCQK~{?h{%ny9jsHq;QS{+04WY{eBPXr4aG2fD&5!ftb_IZNR;#h zF9hfV`N8vatw~0&4<^wl+A2C?7qyxp6)AmdZpV(8w@8#+_mpJY5z0Pok(q9I^1Mgl z62P@~N4`D!{-!Ik{du&RVhY}T7g)W6}T)FAZZPr_UDc;e!=0nQ6$cTmwoK z9L+x7V0*^xRLtw|-WNJep5_7tCX-d%;r}w(KtWg1?|rN1!gqF~d;UPDn&om1=Dz zwvnCc*8I#6nsCbNLG5)g-z>V*?GRY-szJ=xKGS)ZID;ka=Hz0)YrRvo)1cz3VE&d& z5#aDE%ejbu?q=8BtkDPVxV1Zi*?TJk)bpMMirR)h{=RLkzD+#(UBnj23|PP25kAUi zPYck-bx^%v5FNfIYuh=4E7X>-2SeA6S0uO3lar0G;Pdno2$=#NmZl%3qy+D#>LoR^sbxd z#R>-r4QU3n@J-^%ENa7F<HEPKVZUdVL^Wmf3%_UKt>bqM}HBl~!!vTM~vj z-SWV#0}<=i=BG_G6bcb<>o6_!`c@}{B@0y`qFy~J8m!m7_#g^vbw<3G3>fqRza^Y( zdTBlO3`9wY%F>@r)#(HVX5Yp27v-BSej3rd*^OI#D7PiCIp+;<*sE`uHZZld&f4+I zDw32aN+?{JJj9V`K-`w#voMqsxJx>;nFr)v+j(mOY`IL)1y$z*~+ zRc*5*%TqIwEIl84TD-Z`{pczDY{%K&4?Xo=OQ)RxjzZJKL^oiz4i31UvOQFJ?Wrl^ za4a+N?w4U^Oa9B5{y@6sNJTZ4H{j&tBT7=V+zOzbJOCPsvI=2EsE4{!F-Iv(mV=tY z4F-W12{eaGHkC6Z?I>50tR3}!jV~c@)_rK4AB)vQN2taOuR3N;vwTgU=yL*Q7uNxw z@Ah`O+soGD!w6#O(PtNw6Z*ozW!_yR!c8Yq<)M)bKNY&pGa%|+h}2;05MBuF^4{L( z#u^8{6}`}*LnAcvcfsd}1mM84=`mm6?mE6CC*l5xYFrcDMUS&{f)(~N?D|Up@375s z9nJ*bmsEKjPUCpaOvnvvNzXST)a_MhxM4UrYOXS4$0Y0af`WjnlwR0;>MiaCUH45D z!Y>ppq3RWPVP@L-oPf{s9YM{mEFW{-wkyzU19#7>E;-TCIhw9YYsiMAb#>PG2bi@C zeTH!*I)OJ!QK(iPT+`EmUmIg0uG_i!{Mb%r^Md5j-)0_$DMQ@)r)eH;E?{DeJgJ69 z4<>i6G-f&cZf9E>0IyiP$1ao*Pm0!RD{RQQdLCZ%)}L{}B|iE#RPstlkT2Erm_XC1Q_{GS#m; zd}C;SVrsv8a#lM1kCdoqO0DuZ1_&yAuelp4t5sxj3kQxP^j^_erj@SVE8ahU8@TVC z45wHKq{YMBtLBJwmLnqV%~z@~2FGpQ#cW8)Q>zyy@)9Fs$ah_F&3uPc^Lgd<^sm|b z-9VnFtykp~m+ib8tnYStFEH>~;1Ti7{T)A<(=>qRT@-I#A>$VnqNLEI;05p1s0{8= zu6MMWnk9YOk8AC`E^FXg1H?jb>fXlti8PD&aid z6b9tI=|~o>*Ab^lKfcFSW4bMpxeW;F5#wb^HAL#Wdx^cD-;^>tzkPbypMMuTk4~GI zEBs7b5AkqFduuI~aec?c*m?j=B4~5@qD9`dFtqXx>wMDTm_Z7-p{N4hgvIIEi zsKJG(J?)$T^|R^tKDB1orPcI)ZL!3j*Yn1u>UhMO9*hvt(ZF5TZWvpNmaaIt0S(-3!6y>6R zTB)xj`@N;{LjM4_3Ca*wUf|}Sj4o~6zOi*btgFR+1`SQiwl`mmp3>YE<>N>8t+&=p z*Q59@KhnNY#}A}5h=_ag3*P~B1tS&Z-M|k77_)*rwlq>%T;Y`xqDBOuK|&G~JKj*O zF7$(Rj5>$GHPjhS?f!XESE@XK3N&U;IuCmB0ph5=%oo_o_9x3UuX6>nQmVOv?B%Vk zxncLT6qd%1IpgR*p8(vE*#L~=kNHji`#0Ix^F|Pe%Zr|P zCcsu*9U-dsF}yJ0v@e@sQ0u(|F?Zm_Z{3eceRZy{}O?!Lmug#Z=#kTOpor2rg9?@K;+>-sdc7CT%~TvcZ?k4 zu}9k6(?5(}3ESrEJgb6>ZyXX`UVRAe98ZrLt|YbHz8i{N+3%A)$7;lsgwFH5<0 zXJV$Dej7tuBF%Yne&jqBA;faBgwkfynLoYYGNyWx_75(jT1`s1MU5~N9fz{$clln} z9iAxxM1JOyArYZnFz@R>?)lZjeIdpzI=|8UZt!?F3NSl`SV%sfYWFg3;is&E8iyT& zo*uvB0*^3wQTxrT`b{I^?3r_b-7?%BtY%Cyjms1?*?XIpV;~Tju!pjBdll#8V`a&) zV~iuYc|iM1EIhNtuHDO3h0kWl^Lk!ABhik-42o2&9c)M*OJFFytcp(N^(1bxs4_BQ zv8(8;S@5IWF=Z z3nYcRtVG^24!Dl5U{{z%7AGE&SY5g93$t{iwaD}j-^F?(IPjy0k#nmUBc=0aBN~=M+1sJq ztvU{lKomg7XU{jN_>1+3udzDA9ahh43W4%^n7Hg(?IheQG=#*TWUMS`dkhV$ul$jt z-v{s`ztf2nU$gxj&_VU&^7V^HC9mENpHcLD#0(}Ln%e>~usY4jw`*aVTtdIM7(KG^ zK26I!?5n8h?@ngd-Ky5dFHyXZ@O-PO{!C^qKA87So+7OTGC9naQ&bM*koZs& zs$nosNCGEDD5q}3(fp3Wd!-P&29s9mFuk?&%4_0@JYfvGe?@I7ymP>d1f>TID~*eZ zzyB(`u?ZL0M>r-7LEd<$gv(zb;q}W1kw?i50%tZ~vj zSW~BiC%tzls=PFZE3tT7E3(pru}G)*7s(SjqPt|&D9chEIJc%Jvl4Ke2)2Ocbrl@v zjw03GnX_>SrygyXxQ!jYgNQv3p4nacCi(Dqzpv9YT#^0Z2&fC(TW6# z4Zt{0fZ@gZ@7Z!NE`RE&lXDVJV7GJ8Cq`#O1vx~5dHLc2ffVvdx5wmN;GnK2sv4tq za4|Zyix~si*T^&cKkDd{n6QT*Pxa_pg)@c^ypK=0d_Rz+R2>U`ecaJY?7 z5V6f)w!irH^`W4lpAb~bs}RuAs2R6w;!Cd6^&Y4H3=RzugyNe=3Qqtt_(eWJtLF-d zi`es!@KT1WgW{Uh?B3)A@hyuIe|v}~)AA37s$7D18p1)7#-5XhgSjg2#aF?h$Rn^YF(`7q#RJ%L)R#YO@F%L&$KKC}D(Hi&4LC|#K-AEnw zhDJKT(0j?Jb);eue`UkN>CQ&@+Dc1r&I-Aru>4Djo`BKYHnuwNfv8o}7WC}tDh&tO zcxt&Jyv2_hA|7C@Of|5SV>1C%IR9Z;**g@*;Gk<}3_qU2hu@mvfmQiCGpO!ny!WBf z8!_A7-pPiRF^>ppTJAlr35Oz;&Un7^ZPxI9GLXigyeQmxmYRVTy?EmVYn}T1#&-Tsd$TRoBf!b~zUN~jqh z_aKDLinIaC=w%?6f8VeWw2Dhj`hga=%hxOmr}1wQY2E0O!oLUBe0~KjHtAE8om2X% z73cznjXRc?+pSuIVn*iXF__B(O9Bn<;5G(wk>&cmT(Kt$+96^Tm6+|Xv6HdH9Zpnv zU%IXiGrgcr7`r>#qqbIWKsu0H*>AVYBk760XBGN2rzdk?RB)K=z~z6vJHFgh{~RK! zO3}6L3e^qL?0P(5PE|;4bgZqFwD2iv{PSW`y)&pu-CwWb_V$bQ zm+2=1!yx^W{m#vRxQl&@P?|KlqAf-o2xvLszMx{a%Qq;e)0k1fJ2r%4WH)nMhd*{k zGma&{m#@)`oGu3!c)48(xj3bqbEuV;mfG}Uf{m#DSW~mxz8<{Y#6}`1r7^|cdiX;C zz31gQgnIQ0X+z_Wg1h_00z8Vs-RasZABTr2e~0wb3!6_hk+hNd9}kjq>&TEN_+K;o z+K|N3&^&K81bSC&p$+FxQ<~Z++MjxKr(Iv;)aUR`~tMp8G_(X=gbg!=js!!uQ zmZB)jZU}kpHk?oIozfiFL2z+$1E3fJ;hPFT-aGSZ@cU)-)%et~Z$-AWb=<-X9j+Eb;Q3-8f6ka@EyKv(&yUD5+COPlsC?eb#5;&(^iycX0*IKU_IO0+mjw0 z9jQ0k=ve6MZ>7V*!9lpO&eaxNYmtBh!qMz=!t){=KEqfcW3e;*h02Iz0wg*EFaZ*CeeDa$-Wjp>hWhkTizV2j^5k?sGx#09CGzi(jfo} z#loG?=3c9dnad_IpFTR)bJtA;=Q|o6ob#!-+K{_UU21<-4mH4aG=G@EerKMFnf;s? z*p6{v?<(lxb58Ae`je+Uy-lQRin#HZ`ls;SI|w_r*yar5Vzm*u9g7B{ePsI$I2;%! zdtv|Xkez%KE@NR~IVw&HJf6jnV8`;+TPP8k8w5qX|G-}u#04`BbIHk3dOebTE>5;- z0i{g<{sl;EOiXJzS=ly_7)JK9%S@}XlvD`OEHJM8Yv$bMXt7ow=}rx9C0#w2M3mw0EAo z>I&pv?0=itY3>7BH?Gb9#{1>=Pkv}in)O_i5#_}An~_%BL^ZLs(`AJ2*C6vhM z#Em#gI%n`3RR4^(mV_zvW2xGWIXe#AHJg^AZ&9Bpqxq0s6|0ugCNxRF#8%JRMC5irXyVC68+C}1)} zN2U-8>SSK1Z>ul6nL=)!G$60<>$2gf21AOoS}p%?%7DSXEHXyqm{>6{F=&R>Hrxb{ zJCbl~lqn8vM`R1Sn46F4-q>D6joF41fH&%@ML zEFss1Uo}%C6sqVR&`_mX?p$QZls#6@8p%qCGhPo3F30dWCucZl@ zAMu~AR!<)#CGh!P>GH=Ig@xYbRDDN3P_vLiBa|YX*3sha(|W%JmKPWA^2mY_ic`!` z5uZCHcKn3$ki>~3FJ^}_Hh!!aZ)u@5GM3w1l?#mn$#X=OjG*=P7k=YdejW`o!>5kC zqLJ^Mo(2b8uL)bhN2l>Z(iHm_1pst)jULf3bGZD-wiQozDJdw>Gt~>`3@6Sf%;|7gwyi#(GX$jZ#)<>oI$4}oH!k2^dbU7w(ro9HS?UV5-06fySL>7 zO+$?!{UDHxBYdr?yz9Uh_sRst@!qU;ud{N;-!lq&b$KS6x`s$3Xk1uOG^+cS9o5mb?Vd<={S7@}8lN$ut%6rWqlk`C#OnMjf#Z%`Ffr2yXD8Kc zfarL{MdscerOd8&A+iju4&D$|DSNP4DKFVJZE!GtDW{E&?r|K86%LbUlZ;y0^+SXD zZw`vS!PduMkxVVKzPP?`F~)nC^YCO0V$t#3KU_?_#+3b&lZ_CFzYP9L`I0#$TTx#4 znKSMT?P_L*k&AMaP{wp=z|c_X544ng-B9*ZG2yjIY6>@sxw-!$%sN4o)8)!yk!+Xv z-6cQ*T;6(C&Mg#y9?cvu@V!w_hOu*sA`A)NyN#~YsZyS^$BGTEpSz;)VEGUSRV8k< znuVGIxFhYgP7rV8k$ku!7J-Tgai>8s+E=u}W-G`Q&zR0yJ7Cw}S6Cw3MY@S$3>E`69t9H5?LxM|mxLIvf#o58NuUUo0ikt5ip`a;7K55FNU8 zD#>0;KM)p=%=wjBEl)q#)a$pqUiArKIQ?k4{c5LP?m0FtIsUx9JHa^prLZ9&NWwAF zp3{dMZ}e#q0B9Xj^~q!G{FpD2By6?VfT+jm+~H`K%N2L`+>(Iu2U`>b^M^;B#0*Q~ zfCtgStQQQ)_o1Dl$pgER=S(hU?K;3h!mY;gLT z7XIz2p7048PH}(`H@Z$%#WkRz>MRnl99!IS8>cTVAn=JnmgEM(JQn$12s!G7cO|H zFQY7_mJt!;F^>ePF-FK8D*R?jna30MwB=K+%`xVUwDJ*>I+;6W@Q(yjs}&e-M`uP9 zf>Q{&gI|u&1rsEw9I%|7!;?iv_Q4stQng6LKs3b{TrvDp=P71anIk2>Wf64 zm9)7|5Lx#Yr1_qmcw+6fhgiAJH-Hr2e&Rj5u>U08>1>u>=?risXsl48IC|}PbQ-8X zFKX8?vE)m`@=Y8WC@a7DB2)EOxd~)~%=Du_ z)-5|Gwp8s=R=&;eDVs{?M}I;NY+DTp$CvKAJH~}6ZsbJJw`!%-rJMSsztoi9H1gXp zW^S*HuBd9Bw3SD_0+wl4FwK2gG%przJY)Rh4ri4cYce7s0@Y4VU9A3gr%rT#5cgHx z9ubm`EWr}L%tI?9B5!tjO`CjNpQ%RZM^K;UVYcK&XfR>9uhaXfJk@4VC%N}AR$Dpg&qZf3{Uo$MFxZT&u#n{ z!}sqH8uVIfvdI-H6A!Y$g1EoeYf=X`*lAZ79lf}{*!iHfTrr~Sbw1_M^{rtSGSSj< zgOTo+x4S^a<6@M#j-%Ef?cA>y>tW7WPU4lwSc~}1Tz6!ZLXpp|Ol#owcK~S_8)BMW zzyl2bWYvlsSRkDbONqUlsTL7k<*sw$L#07#yTy!!gvqS6_z z;)d>iI-O@{XX(-lV?;LRKkfd|8}c-y@|n2-55bo_0z|5hazb{}c=ar)$G&9{nSlgR zD*l(N)lL)zwrV7`{va6mL&f6ny&%BwZ5U1jm;!rWv(A_PxSYL`m*`Gjh7)VC>1$t^~%Syi8Qcubr)8&Fj+{}z= zdnY$K9^*G#RMSc+&t&|c9v*ZDM6XQnY2cv-1mNw7l0v=J(mcGzNz6KsF=e0^$-_I#XBz9IzUN zS4-FL;_0O=$e$q5F4o$+!>r^Fsu_D3u?f)pN^;0{D>Z-4UhSab5k^4AYNVI_;MUT< zhX`)P*?_I6jGy7&~qfkap;3%gQnb;Qp5_+Y_%dC%MS z^29rq%nWI4tOARSJaBg=_OPNS(1%}nF%YqV6C}fs?t5&37UOYBSk!#h@Tc@-*OsWD z+GfU+l{cq-RSQV0GV~9{28#*J)_)(C|GCxxVsNnehaYR}3rI76_-yWoAL%#gfny&* zWl};g)L2o~W$|z4X^q6aPi;DBQpo(L0H-2h=0Yd^>>y#$psmEB?BJ40A+fLJ;8XGybOypMbzUql7Y1@~Us z-sTy1h(YxW>?Y#m!HGg^4{Y~D6?^y0va*t%j%`n)LKAk>XKgOyuVxB?)7-HVk1ec{ zLG#=Vk?_3ylN~^yaebWaXyjV5WK^yQh%V9QNv7}0K4nBq345riux&2+sTiXrk;Tk& zE{0c6Pwk-prYU348x{`Uap$Xj_SP2dX2PE8Lc`OsMbejW(bd?qm1=`GUV=_{)*dA# zMJ0_RqmVj$TCVGy(n)m*h!dx4H~REdb=&w0BaUOznlj0gYt2$U3BL-yY zAKt)1I-opx8kYNlj?QFXG0UevT<-z-<#r&ZdZ!n8L4O`erx1}DSAKI8`oqWu0eXA&qZ!hAFvzU6c=-?4MA}aE)+r2zHDbS=6K!p-OlQb_H;F@(`)Ke56liW3P;(xWkCa| z!{zmun2S%#mP1xav5y6TsQlqWc)-c8=f<$Dz%Y3<2t#bfom@>j=|C=K|u4F zD%YcLRvuSS%2*gAWTdEEAh2HEs`hMr(oSsT-R)|`snL-@9=1cG3KFUp{N>4 z%Eil((V=%En&St1;p6yX95z=5VKVZy#fq_s!HULpQ37LYpB=<_+oe!ac+$+*anX^gp#1KJ**0qeVg4OoIYC^L=xF` zbsyioy}lI4;|BwQoETWDo3{(|2J>a4l2Q@kD9xQ)s1$dBM-T~#_n0vNaxy<1O%but zI$d6FS?52m>lO?!kM)ypoE~{hYhdM>9!3iU?D>Gt%nN#c2UVoTnE(4t@E@7iTEGuQ ztQI(RbW2z#2=Ijbe3BK|eA4bu*L$NL`p6&2%&!Ctw%p~)7OLNxt&zX631SxF-#WHP zE1W4EWc6~Vt|cTq*1T8?8fu-=u35S&t!U+~2w6e~Bo9T;0jFsuG6dC6=s~dw0UCIV zJoL?zZnG`^UHdcAQ@R~lkD)=;Q)8#l<2Yfm=gfQV;G$+($E9Z;NPK!I9wUAl;(X+0 zVsN){U7YCxif6+cpS0Q@$MXelQN-W^#xyNZqp~CLaF#8ge}E)>S9emx1?MIp)(IaC zwVPW+vD%jSuI(1(8{*+fj@52@xVOq|YZU0V z@}tuGl|or9VJj?bz4w_opM-}8&e%Ai=_OX}vU}SJNUqq}&=3e|%x#in>hkl)3JK!| zLkG?8(SMrO;3%+7R?vORHhRKYS4c}qDMr>u6yWWN$t%Mynl66_W&ic8W~q^WhknwX z(2@n+FkG)F%ofF?%rQC~9M5Oo=+Wvg>mp!9HtjD^FMC zE{S4g_eu~#Z8`bvmH8~_-9OaNQ&-A24Fup1e1Ef5*7b&BIm&jC8%No#)Cu$b^=q-# z3fJHelf$?Vc2-%<@N`aXYSadk7Q{>X?ttbZ@JR8IUn{KXO=F1b%n2iM^@rE}Mo_nD znlDabWwwN_`(ecBNKbX+E9738lF_TLnr=w>{X5~8Ff39su3ziUBHESVFG~~5yYWhg zDoK4#Xr3oh^4O%DpD8in55|N5nkmm!+2lG!w$gzSLuAbN6bMA|p)f=iU9b0_d+Qe# zYCFD<@$-KqUFGg!Y2O@(Q7R_>z^~`qi;XVqGM)?%$eXo0F)M zI#uO7yV){zvF(U|&mN*FkG0jl&tMuYRtv-Tw2lGP?#xcBTkOE&8tGQuuUQSg&pLWa3Nda@bv30^ zSfrB&`!4lXajrnJEX%^S1ywAJ?~m_mA+e?zLSwVVMKp{Oi_xS-0404P(Wqc0#wLlv9$b zk=idxl>DLdSEfn6l9k);ba%nFjV4H-O{5odveAGA&HesHq+ya>Npd} z9vsF1vv>k`H@Wv`>?L3;>z!|tIhn!i?NL9K7KyrX^4&XVX_a0J8dJU|o`}x)yh%$t zpGF|tmPRSzO^9Jv3Vpup1wjj71=<#`x5GZ^wIa(l8-ezdF-I-=^ z!eqWZu%B|7BaH|=!ID?D&!YmuIBW+}94ESy5A+20^Q1n&)!81LiFjFmw#7V;+&ahY zR#c1(KjE!n)m^vah>6x}HfA;9eN^bnD=-*@A^!fm^4xAuyT2_1Mobi>|EG%Wv@r#P zvnuHV#|KP|PasW%)PLm`cA2}aFDS^!({u02_r_4uq9ZGpC{WQZ;uqE*V6uVm-){31 zik!qBi&BmkU}F1PG1PHggP)w|;2|lBwZzFx3Z`$>SrPCr{ut*nN>yQ3Zuww&y97S? zll=T&(p~>cmH=W_GeKGz)C4&P7yknxeSi(t!RR3#)76+9*8Q)40?G5xlWYE8ypFCwxI0C|L!_U9?lq#Qp-xOOm4qSAtdhDeO&Qd__U+5A3PE zRt9RIyrL>%D58j>&`4iUkhb6R{~D8JX;-+ete@a>Jzrh@r94FO=;CmYQ9Ih$+3v!1 ze_ngeEt$%Nj@#cKX|y~wy$xHSL7$YC6b8Dfzdkp1a-mfy#Lo>`lO8qv>{Grc5B(7R zd4(=UycIV;f3X+P09sb1KE&-Z%cu%2fZ8O_`)I{b->6#UK-5J$wv1YZ(}A~_?!NBZ zbRdI%x1h(HJHkl{Pa`fSW-AIheh_6C2dkF9(z}Yc>Pcj7E>E?I9Od$|=p~}&H>AFS z{_Thbj@;_(-}%GTF|It4%HF`@Lc0yUH$RJQ6p`E2*K3a1Ho`xV33do1DC$#DzKQDS zWTf9Wy2!E}Jo|qcoL|jt%xnH1$HX@m5^N<+K$?4G_0OsrNX$nbbu&Q|+fpJtM>^~4 zq?+*seu3tLcPL%qw!A zkj3kHGE0y1AUn!uM5?)*31gg?X|`ZoJwBFsH@YHjc^vfo)ZFEhy(My3J2C*sq{3G5 zEmpVhOyrxoF4!omxw^TpJ`yRP9SUOaD9xZ<)#`=!{XF0cO|{hszdcDwW`r)0Q2SDR zN<|^Mb8Jbqvs#-mkn5x6XUWfpc%a8bbaqClynfabt`xMx=%X8o?7hjK=4gX!({>~q z8`ysAR32LJZZAG^`=Pq?uOxGj0Q@Q5Hd8IC*@iC*8khP0$7apg-wEh{J#Aec!Gc3J z16nnD4DiHQ3krGX8!WPfqTmT z2%d1Z=buz8!Ns*}5fP6yHcX&fK$J|g)GHVA(IW~*fUj+hf&XhG9d6l%%5K@u=L<6O zm!(<>#5=Fx=$_{NxYy;{Dj{Auq^@;NWa}4o7NUMIYQ|9I`E^nOz`8IJ zEgnn0|It_=Cw~Sno1~CpUrDlAG0mM-sjb4E!9zGuU5|lzR*-Sfqp{d@0BIgqitwBB zA@gbW=a`Guko;L(FK~69IlB9=x6I&f6`+{|!=`*IVhGwPLzW~qglwo{4qAdASvE~z zLdU>A1CJhJ;lhFz>@vL!4u}b$HZ3-tb-pEvmJnqmon;CG#(1uNzI!MB*`F z`)Y}*vv?m(RE?k!BO@v@>IF+BEv+Cej|NpM2}2q90@<{~@rY#nc_EiS>UM*O;Oo-f zt85E+7O(`au%{awsXItmmQ{b3FaIOG`?uZLL88De#UOL>f=8++{QGg$25j*EW9+S? z;$D|5&;$tX9$Xp-4#Az^5+Jy{ySqCy&;$s<9fH$9aCdiig1fuFK4+D{}|cCAMLXaQ&h zM7z)`o`xOUuj=i4v_Qf?X_{m$$nA;CTgZw zej@o6FoTVGw10+bMBhGR4<*P)Nz9{CsiOaB04~mORzYsG{1g4h0m;dJzMxF~JS#lf z`r2Az6gjy8@(YKfTjH^{Ln#U#2MfdZM`P%O6EQKPIEkq4H;$MmIH+`Pt}}D9e7WV7 z=o@uqHSmxZivWIfX;}#|6h?qFMiu15vr9RcQ{S+cV9P8shG24Zg!iL3w0nm*1VLBH z2Nc7=ki$)=EA4)Y-p7!YwIQc?-b9_GvCnO*dPhHe6D_Tc^~Pd_eRFQb?Pg^=>+w?C z=2_*e1f~fpYIRIqDw04qMu~Qe=Qd52gi=R!zkD7yMEP*sJ@=dnSiQ2v@2t) zQQ6%8DRcktOVt7#)KWvOK$dTS$>2XB+7TyA_Izr!@Ikv!x&;W%!#vFj%M4LSQ~>1Q zE=(>(C|*c&M*&uU!y@;V^^WJ2lw*+6lf+p|Q|-gHao$#lZK10EB?T58mZ|caR{Ig3PgiYafzGM|Q-0!;{!mA(3Sv1* z5Es1)CB56Ny-JB@#Snn|u0u$Y`T+mHgOrrpRyD{vs1%RsxY?kXImPU&+3Lq;6tNgV z9xPplQ{`@-nZ{CFQ7kT@NB1k8WiC!!Tm06vu`7rlnT{Z05$Pvy?$N%XC{dvMblr&* z{C62XO}~LZn1HLvTZ-LB{E(-^)e1CQ%lmgnnj$;}8hkZnFvekMj*(XOK0ZW1sdOe< zq5yY1MoDAmD9YBKiP$HzZFRS940=^dwL+1v;)q=p6&3HP#G$2%>`dBKf3G&8_J`bi z)YK{-q!5!o&!RcwF>U1?xaT+slSrV^yL+_Uj`4@bsW!N##T$gR&L^#5 zv$h&~ovcx2Yu||`nI0Xd`JusYjV*$_O8PDgmt&rSi+3*0>j}0scDXAM5LbXLR*km!FM#fgP zN00V5aD+DPNpvW&HNcbjlsNfQSK$oq9+TECHle9{&qPkJEUTEwWbZIBtt;7JUX^22 zg`P15{n~b>AWe97q zSiEN5J`mC2KqJMFTNOCB*hD%t?Kfk5ZRI5n16qF!|HVA-y~X`=I)kK>?QY(mJ!Z{7 zUOJ5acozQXZ3_&?{R8q45)By zYXZkP#R8ewX#P73{UO7E$f|sSnm+^HG_p;ewQz+0UlWhpzyQgE1xadIh*wLXG3@*L zUi!Y-4Ffx3wjvEtFY8fD{E(Q*C4^Iix#9D-!Afk?SPu3yb;L;B35jvzm zTZhkm@5ag3)6&%4!ge_-N=;3SJN+S-kbp(Jp(Lw{9`q+r-J3=_kE8jJD2IcCXR)?C zch`PNi~oj!S8@ZsLJ?N*#Hywm_xcHv8~s zY{?6miB`1Hwp=)B3`0MUkwl_w=csd$u0 zzjciku0IZ$P@xMPr0i#!s(_EPID_$h)*>m;zw7)Gvy0MoO)~a#aZAktPDZ;46`k7* z_mmC2^f;0fyL@486}GQ)_2&iZSQf?`?YLjYMZ5G)RVuCp+u8~u;AfooYHf&71V(^( z@bLp`6f%FrP@~e2uEfsvEFmW!gNoTh>P>}TF*HOtdnJeUt2d*{1tYa(eLTz>igsON z6+wO68FE&Nx8*887YQ!bdqH|o|+X4 zC86~VJgJ7YS>5cPh0MR6u0PG{s>S{bX{`bZo2b4R*VfKetU+SO?recb7t%#g-cIiP z_WWOj1^y$${5_vR7ZU~sNkZ>Y?pH$6U|5G9{CBgcn`S;%R#ueI;uH z6_?(gjhcLynuHMVooaOqIUFUi{+uYW62PxjHWS{>;)W7F!73lHjdho9qV+c!s8jx> z>se8_zCO{WvcYKke8wH2bn-A@9W7v%I-Wm824^~`g~(jbs-8mmrU=|0*`J3!sMH2r zDMs(Dm2>oZC~0BZV0noXDUZl}h2muq>Ytrmn>>K8?}fh7k>0C3pX zcuDb_n!1k-ED3Ur!+3)ilYBzT4+|tvlCY|=vi8!VBS=e?wkk)#G!e)AIdpbQJPX({ zqhJ$A^l*-5m1^at;u*yFB`zax*gh8*z#wjLQ-7$=w;j3!ZbPDbp-Z$(0a(zh92Xfi z^D|&G`{x50j4CeS)fX3qceX#rXZM5ffhT~yM_*>ujlN&Fl0Xt+s;w&pp^vjRk|+q> ziK={6POH>_$=x>im6AO7{O#foqJPfG(93xk6E6ck-)~fTIjGg#ezG_fM^sE7mszF^ zdd5J_ECq1fZ60B`jhFlz&|G7KaXFZN1wn`;5sm#L_z}+=Psx^<96kS^BkO-PLxILb z?=kSMBkoWIcbBD*`#sFHuRwM%j|R}d%}=wFVaZ45t>oLSb_KjZ~DA z5RcShT@5_3ISJc?F!45E62U}>0Kw_|8?mZijx=p*RhS>5DJdBuG*M0x2!KW1 z;zKAaMouP7OHA~PPKdutSTaN8ADU`&F_m;(O$G&*z@I5Vv{4FV(+GJ@FiqkW zL{(&wE|2*LK`DV^ijOPeP#G#(IQdH@WV373B@J`RJoN$Ft3UDqg?{u#CC|>}e+tha zqP~fjWg|})r^$OK#KfTQ^i!4uiB>ex9}g})`&!zSc5bRrV$KBJK<-&y9HHrV{3?8= z3a;UsP2n11aTZ6ktJTO?4=1Ug4Ws#zs4yaM=Ioa?&+{Ufng@>9dYg@LuZQX6Nvv$# z;*SfxTu+U2E;i4YiXRbiMky1Is8zJwc-B&~_}e9?29%o8mJay%Wao0sBbyH363g^`Pe zk3jH=t^hDEm1>2glIdzq`4ooBP9>$?C0IKzS^v!^-t7C!0m~tD(aZ6;ujcug`&mi3 zbBM*m%-UMuD9&0#OE<+EPHL(? z!%2CHbg3f5$M?PG)k-C^)P}uFD4#gBKbS{05D{cPu&bMpgnZOSJ9EGc4zHZNuY!(6)e7!iSc}m$3fLD zegZD=yL>|k!%#1NZ=b(eVZ(h4<+qqde(py}mblWW-}FIL(3ue^&xev>Yum|#cN(RQ z)lJzw&f(v^>Gk7?YIW3c>?YN87=64kUP~uvHGMdB8u5~ilNICW?TYl+<3{!C+v0dp z_DS(>Q}qzGMtco+gC;3AT9&ch>yxJ`UuE+3x$>jfZPZUqH zq5mCiFd64RedPXQRPvvF4Yv_|LbE?M6hS84f7`N-(nL@sjL4KM<(c zjcp2;Zky7I1@>u0k1%wkST=f8x$(8t+EP_+=zjibR4KTJ*mL!(9A3$Y(6a5V*b90w z7NEovs?#e;DImxrCBe&%f9p##NLol?%cRprFbMFBjHcbR)zK-VY^#gAPE8>>iYO{C zKLKr*kYZY_DxJ@$XeJRJhYN0+=5UP*?B^0oyLDD4TG&}ShiI3lHj!7{z4vUC`YI)? zIx1hX<;LB9S1A|z;Q?|Z7gk+G+_S0#1q_4sdyR`>_P$MWFw96a815Ah#Xe! z0OCq=WYx<}NvqJLH*pqKfvt!o3XT`=Lzgmf8X4f8B@utv+MWO!IUDMvZQZm@Ybm$f zTwEIIX3RpH9${})Q~C6&jTqf7Rxlh9(x3078av4cd{$p(eYb(l){3^e0zlYpEJ*Ru zY~+-BXJ>8i?l{y~TG45kW4u8s%Cpu>ueMc_KyB>tK(@(TyTXJ#GTti||8tK?2Y8cK z-zd0JY0Bqo*Arcgm9Y-2hk$ylFzgD~p3%tD)z*SBGnkl$H+i%?`RuRX>9nl5gXacT zb(+P0oUm2uU=R29NnP=?4CBv>W40sl&jpblfjeJefkN`!3eGbFvt&tFb~Bw7{b{8>?3ANqwQr ziK@e?)SRPO{|X-j1TA9$nwrevia6)HMXH~FE!#bkL%q7cOqg;!vn8Lo*R+lc>SWgg4>#UZm32dO+lCVgq7eNfEsNU0we(ivOK%|Ml<@0jenltGn5rf@q&w zXMdEp5udgqt6|N4)dS2jjWWCH(@0nfXpmx6+D>FzOUCLXA_!D(WWLY9iUhtKK999g+=i8GqCk}E(D zbzr!20YkLPW|lWzVVSk4GN7agnwYk}s&Nsc*e4!*|85OfaCb-Mfx~T739m~L`|u^d zA~)~>w9gScREDBrh+|kE90F#OPYuzbJ1~oDp!-}*@JV@0m*D%`Bp^|yRuu^T>)tQZ z!cltz0&qGF7)W;L{`O0Va)+M`gEwgt!7W9*Htjg{b5B1DU5~GH2jS4Z00Zcqtg+Q{ zL9t-G6x;njm?q|?-^-ezFKd0iRnZeEv}2~6V*C{F_9L}yXzH-Kt5}RuObh9q=q$kJ zC|jv*%q{7QiK;dX#TSXMRw~3VdpY3+NyMZa8iLRK=za|^h7WWd&KZy zIB8p3RbDjiO;nm9VHO!^``q#j5D2a)SE0z4oXWIvP{A_J&O+w8NJZ;4kw>b?z%g#( z2P}C9Yg9@dVr@NtVjTOH&S6n(*i0WpL~&X{Ow}c?#Z$uk2xxEoF5AT zVpd*O)bZ#q5ZX7Y{hiH^XlSgxV-Xiab3T~kXxTkj6g z-zQ{WAAbL;&99|kT;p*Jf0#6Q-#K+oxAi(jO{nRcV8PQm8frdHli3656>9!U=dN%2 z5ub+8da2W4UhqNT-4N;TWg&p$1jsVK=Oq1LQB#f-Ez4B`D`erV%@aVqc{@T+$5-QIl9=h3@69)-A0Lc zcI@`XKSB+qPBFvSl9=lJksvSbhd?m$qsgTExjo=WH($-3s5Dwq0_(s zZ2*jJalMSVnjx*Kinb?HP#^@(Qk(s8K2ZHsvHp=KTZqJSjwbE#O8!;0k&BrRX))zv z(SqVhL>8?|n#;TC#Bx9dFj-rRJpg8oSG{yb*Hre)+F`>_y5C4YnfeioC5(m;jEON8 zY2=QJDmqJU2#G(c1J>}z9QT6hPs*Y7e1s#FBwDFNREbpnOgPEt%<{SOP%Twah8sR^ zBUn&XaezWlYrh~sPv zIU?YC7#Zleg`r3nd1O|?+25yh!@Z(8?$puz9SgFQfyxC%&<@CU<777)texKsG0zgU zQjAj`UG2WHom_1fgBxrtAblo7_>EL${OV&8i$7V2M{#|sRRzUy))tj}H71I*ci3#6 z85lYKN(f!3&`&Z~e`)XEojUGA(0%sSN;z-mxk)-eNzMs8YM;8>4<|5bJWP(VtrVnP zKP5MGAKr?ktgA%#6ap+J6|<&i9i2T9yY=@PXneDy8twEaIjRev?G~HJx0)OO*paW%+{$*#O5JkXVs#8U5Wh-Qw-!T~w zFsJD2HZv?Vx5xBWFm4K*m+jFZAwn7bObP*|$dCh16|4;r{+{&wUpEFx)c4CyLQV_X zqkq4P2p)>$LoYpsJjIoi7s;11VH>SAKTwAt(-Z*~W4;&)D6(7C+H7m5M6RL103K19 zjn%wgf?u_YfPOj6@e4tsc%Jda9tsj`(gg)8aHJ%=-RGPecSfD(vmM_!sZm>!CTB1V z!&;X+jP8!W44J<;6ndl6+U8CX4TcBg33PXKBOW*eJ7LS$p3iacO2915@wPsCNAw8L*fnj!3KcQ)7Tkqf!q} z*N8Y)$o{xpG_LFP~3=97h>hx;^Um!}9z`3q5tS9PB()3odlZbgl6{Q{~I0 zKZa*(9S&sr+F;Umoooib9JuM?Ltj`QUMQzZVic(auD4wg& zq!gdf^*o<^{p>WhNGkfrS4`MBH)?x&#c`|1jPHGIsXE`RNF#c0cj6^Lj1|50iY20scA1)Mh`x93Zdu`OKz=!YgP=QjA4-N<1 zy8Hai$H$8oR@a}Ht|)@fWRAgQ(riar!EnNLo-*@ju^K{@od*%)yY}KR+3RQ#?56t> z!0K}&rKr4H6D9oM>3PrcA}b9s9r}4>Y%sde9HYf0Jr^6>87}x4<7ob*W0={#BV6b+ z0xhj0hO8j6}Kn2uGK2%zxgkZ0#J`-#YuCjt>Lgj zdX6$x3gS8Ykm-QK^>&i=T~7ViUW9`S`NUP5XHWCa6s*mT zwU`bRNzpP04r1~QVCdJP_?T2i*)pXP{KZlFUh_mP+sxPmxu`{3EWWtr>l^qdr_?La zz-J1V&}NLqj@KPb^6X&5Xu>)bZjoZC^td4S779e0h3eIvo2yTPpb(CB&cy_)Q|frL z0ua86@eR`PSu^r&ml*ouZ!hx(pCAhF0@KtuVnBR0a! zWvm*jXlXyS9nvu*yOMJ%X>$55u#}AZy&F_XP)(6?ma~qUv34)l45o5l4XubF{4TX= zy>+}e@X$lE>S9$6mejFh`YbC$bf5-UN(NNiG0;ze!9SLzO)o)nYLeBn#$&bbq*&_{ z{M;_!5cme60!v$zpTg&w5YSN+22rysYm2Hp-7Qrb~Y%AC0n+J^mJ*<6$a_)~jU zYOa_a@(t?Ms-Gjb`i(y$40Yw&*XlrAjcQ{Mmu&&db@gWw)=2*N=v%aVkD$m9@7E8# zpGcJgsOi?H*k@}55^WOWP(HMt6j6LkwssX2MN(33I^RUHzL-nXUU^*YAeDvymRR@@bnF+cmm;ldU|4)Q zVYnFGN_=uJa=vqh7TPrUVe~AHWQY>PLk=jWXTxaeoTuy*XKWwbn zb}pyw_a2JUOe4QX=w|_HUMsd2oOU;o+%EzYAIyk#DXH zVpWp{z#yqoFX-cyZ=_;B6W4PbTW9gk9&5}ApWU8zZkTkiFhiQx)zH}54@gc)I+<#i z+J#^mWDcov!FVopTor+0-fS=+d?>+-Srmm)Ruq>CxIE@|B51P_;nfmVji+J#Y|j_i zudj3U=u};P+_-)trk@mxfF*|ih zK18M`Zt4{$q@}d93^WRKNyk<6L3KZNrB!vr?P8S$IfGTD8PwulaCv{TPZG1Vv`%n? zeDl?x)X5B0#1@Jf331PoIGIUL2LFi-;-jilJ=^NZ1?(8@HWzBdsHsVbUgvUht-ahl zRXsNy)~A0{FCjr8+%8OZIj;K@YP}os4+Qi-1LN=5ad@UMxWkTJZ>#_LH*XMvAeh2O zC@;uP+_c02sN*aNSDr}R*Cc|J7`I&VD&qQ8`EjM|!@!3fvU?d{lTd`#1LK@D&))?r zbgZbe?rgnv4D*3h`gWpzRJJ?%8qi~9qP3bImJ0Y0`lvrv7Z5x@uX&I2Qudz2`unZI zJ)J(Soai^`XRbdP3n>x$G;i!QS4G(9AH)UGf0fW}E77`NO9};HtT)6A)t?z~;n<0j+(`J}5jjXkua7#}F4s}m zL)D-+xH!{2$kxz~?6lU?dJL0aGnNnhQlC&)l>3}xFi^~}%W zps2{A<{4s4$nMc=WvkPi zpZ~S&8rU5bAQ<~!h9`f7G0y$NJhFEf{;fdtzy9F{@Gar+`)#?l&+Xyw(k%Z;Fn`CFJzO9c{8IpEkgV#++K$5V5s-TcEHeqoN4W6GIGmb)+RuvSp5|gsVl>oRnIfrTWInQ_g!bH;Lx`2gSvg~SH z$+^VOHZq7n!ADjG?mZ%vZ>;sMHv~1U_Y@9Gmhy63v|M<`Sub3;neI#_?LPEW1;&$& zegeOq@0ldm3dpfPpT%qb{?_cnGZlv1`HAk1+Qigwby^`0!i}Af*jbzFjXH;oEGaGs zW_fHE{6cYJw>`Pn3vLbLE`f0Vhz@3)aP++%4~kOw@WAQboKDPd_Uw%Mfkky{>DN*E zydq%X!|W-0S6jy6Z}Yk~+Vz4rwcL_CM3-077b!7o z?#A6=ZYgN6#e2W<0e{9wK|PD+{6WiY9EfLQtG(AuE;a7tJUk@rFRLH8UuOC*<_M3z zsl)@9?Uw_>Ni!mm%ws6k7bzv+P?iG!KC0mu@1IQE@H^QdUU-gwc_7Eejh!Clov}`d zS%>|P!#r_@an5OeuMQW8cHk4C)qb~3^e@`(z9jsDyuZ*PvUBf06QunQf#*jziWjwK zMGn@6dRIhTm_=*eoh^O>Tlp3hFD@ zj&q&tm1=l#QxBJ_mSGlrFv(9KYEJ0U9@?ddGSS5FI|%r#?=ys)&#W7^+r-;5)o;<3 zUzaA=Wh?UKy-`AZdc2*aEYhY2gQivijhUHI-zL>5zaS;FH$F|IW?U$Z@5@n9(>5l% z{c_kd77e-axq-R5U>qo07T1CU9$yaVevZKRo$4KR#(P0H~YimCF zWR0Li>xz!40&OBa`xXJ%U^u+&*4FMt#Jk?H|0V}ODAVx}0@IyTuD$DDw>QVgfHsXY z`-S<-edf2Y336uXBb=gOVfeU}D2{Jw2K}}(Ka6Q(bTYkgDp1~__t->-94A1sG5&8-K!&a zerC4^mhG}G>eJ8-ze?W6J*J>7UrW`%O?AP)>@F)3vnsNd4YM_*3A$ZO<}rob7*|3* z$4d!%MG;`MK+D@(18yu}k@N9=f~hI)e`(oo;Kq(7KDxzv zal{pmx5kSsZsy~QQ&kH)zI0L#of7vu$sanM5_%?)OXDI>-PZk{ei$?~J8yiCqn;hm zGymR4TrTst4?F-S7_Kgz5MMqhC>S8(U&x?emA&e#XD}1`dYGOmW1Yb z*g&^G9y?aYIZuM&@>{Axb-78S&sMKm?}50t4p%;9^KhCJBibDfzM+JYhL7+;$u3)N>otqIRUEc4#`UIW^(hJ;se=G@-6NU9p{>Y@h`AI>X zOkT?^-&?uug6_Yx3xcps*nZyT-gTShUv4;-u%)`XH#!zdGKTJPx9pWbb`P2PpS47< zo*Y|S@64Djf)`w2cGc`TLH+j=RfVHMF(2AvAK6GAk@KrcUsWfX4t^j&1vk_`EII3W zrMZuFkiTMJd=9hrv2lsU`nsCLvvDkycFpCoG$_yh)(f}mK@*vwOVpg>d29NlA+O%v zkGY3$D}07GwFI{(!I4N+)A7JvV#6R^17{>zFl&C8kWE}ZczSB=L65Y9uwD>J9f(qPdOR!Qg@t`UcwlBOr+o0t9Ztjd9~7kH3z>t8PK~Ib36U69tV&!S z)RHLd-o3>Rc{jEhnaldP>}R5Gvg&EkF9F^jN*Sy47WQ%Au{kwn=_jA1vn@e86&nV` zUkZ|YJy_(JVA3D@+e;=TCqQ_5BYT!2{yX>Qr!Xew$lv)nun~pN^7uxwJ3+2j8kS?E zakk=JC`dV`FHSj*bo7^CYwK)A_I;bjUp0Gc7z@)XuP-P=bh)BC>1ZApKVAJG;6)pQ}rnJ!mzy1dcYHp|0?(|;=);<8UFgdIg}1$cMNE)b(Hp< z5si{FW0FX-KIaBUI@_06Ge3vP*s$* zYi9dUoN{t=24cXcaUZ;RW)*0y_an%a=8>iEn$)@NR4K~WVl$oHH_N&85nAnvAS_Wk)3 ztD0j>d`ayaPcK-v9ph|FKe}cHdxYO~NzZxIR4_oOnvfJLN=~lU!>r#55Px25`HNAb z^@%*yWaPOA8(D5h%+82TI!zj26aQ`GG8KAEXm@dPF2dhd|72>65kKt9UARbrD+9mpePx@aQYuCDIFeV|>en*kM zcV9=DK-|fnM|6vIa#FzCw%eOI&RMc*M-nDbxJv|j}4@F#H6vg#nb$_2YMfh$KK20N8HO|CEm;Mg$2UmX2-O<%_hkqN#eeL@p69{ znq5#+jC}v$0iP#5_Vs|$fw_KtdgYQiO>@2Z z6C{^^ds5|E`1(Q%K1}jOocOdzY`Q>{9sOPX-ie(Jv|eWR9a4v4%UB;BI_~)UCS6gJ zT;cKutfbpWcFiuN)Elt6ot993Y)f`7X2(Apt+#EsZD;O2pB4<-`;{4y4-nKlMi06Q zceXOu#%ilJ70k$M6;Kf(JE-%81Xq?meJ$4T1gLKn%f4Uw$uPfA@3SW6|YETIp%jP_9QlKA{YU|^4{(O zW@Lb#5#^@ z`Hh}Gy?#euwE&+c2F`S;+D6~;mwTf{Y?FSPM!#3d8{X&k6IpII4z-ypL?4>s<%e?P z7}Ce1<*hM+0(ZiTmoL+-0)^N!^=<`SZ$-A&Y3>`P1W^EgZ~V}O1I2)oRk_gHd}M}U z!sw9&7))nxlgb3j=zu25u&vx*tqApYrddwJDL+-CH6SCO?;rx&BCjQ#5}VpMi2;QWTi<*)+7mw^uuBl+tjzO?Gtl$ABid0H$KAglQlpCZ-r$7V zUd+DY3)O`~SqRx}vL2;MGQ{-Cf?Fb&+gzXpov&=~Z@JncLP9*|!{azrY8+Rj6UPFf z5gkrONxNEwWV4Mf)dUqIWPmFjNuv`^^z&uVu%I3u8kAoDHO-iqw0dr%igu3DXNpwL zD-0PzPFwQ1Er;QLc}emU_YlF?{dZnp1kKFj7sALZ7~#HM2UHK;;bUUpF>8ZjqUcz5 zX1-XQF?3eJc%71jUoYM{64zIHL{ zqHhVYh28$c>ua1g%aeY4*SVo+y4-5u!0;I0>;-a5kLbxCwMANmcOdE$+X`U|H~3eYFY2mBzn58v;iPG5dbol=n%3IUm>c4wb!A8dS}@!``P&WflgY$;7=4vYgZf$&Gk-lcBl-)WI~P>w;L&YJwc!#r6`H zgYpUIiV7zV&qbsKT2ZA0k0b|lOMe_OP`_VGbAy3`ZBvQmCtzxjwhxbnwuodo9J3n{hS*ubzYLBXkSWkVH^vsY9^)U=TF3v_{iVY(x?|wk z$e>%t#X*5CL8xy1DQzwemgamk=6EHfqn`UEfDO2}6ove9`n=}pg`Q=i0dN7&Tqz3< z4+lSRdXWi!0tX%Pe0Qq&79!M!@+KgHi`VM{A*pO~u;;hN4M_lxMsEXq?o8{!HPFR* z^(}Bl`ku40iWa*G?TAQDap-3P87wZx*J=s9q*?I$dcj>!tP)9eM&>;3$Vv&xU(VZB6-CeQ zgz@=LeQdT-zkIsegF5TpS$ofUj;PeWjdRb}_J`N7Ab*nAwRwr|z@I3i>uIY}o?Tla zA^nb$IGU}>dFXJNXyoTMSAcIdQA{9ny+V7Cq$x9rn;^I zdTFwWy$v4m3dJ?jP7ZLS!P`&G%vnBfD|}#b5D_S&^Ooq_14$o6)<7nFFC$~Q$AK!H zIG5|6d}-q<%V9VEi#@zbhYKYghf_^~C3Gw4ol-nCgC247KT%w|u^O0?;zrY)jkl%E zpH4i)T{$wJ=i436^s~AuQq7)U2F)FZ_rO#ilL6FqiZ1~`wKIVk?${?QaP?zD7*3Q2 zftBoz$apu>v4WRJO55>+r}q_?l4kEkdv{S|j94!$ZR{m~S1U+r=T5aS>$E+58UD^y z|Dbwn@8Yoy>A{o7va)@7iGXj5=w;;qi?xZl=)@bo^Hy8g%F;ZX_9D$QgSXwv zk1D#-u=s74!plQ>D1RR!7di$LvY97`EYYiGs4>OyWgfM^Ba3n2nLZ zTOc#kTwRN%sblOl5`uceM|! zqOW2rXRXI*A@!X_hPgMtD~VEmQd{G zExqwcM~R(RBkKGsS>)|xx$MP49}f%_fqGJAKvfE~6yWqAA!3<;#`mGvRf)Jcs9{B! z9W|lgk`O-Ke_K;5*74Rrnh&ex?~ck5u)gC&J9#q^tEr`ezNt z9M>bC^)F8!y{s}JlTOF1`n|j630@y4y8oR~Ydd7B zLL9z4(dYyGA;d2KfQ?=FCvj3`qyW7e!Y`vlH1O~|0h0?4La!x7%mr-7DlGiB*UsPB z2m&JO|Ak<@h&;Ad^uGx{>dhP9LOPN^EaZRU7;6SUiR9}Eegv?RcM90~o@Zlj$JyL2 zo;?F&8$ey%v9DPAtvk+kSYOhd1UDqp5GiP_jAbsCembQg``}?HGOxQ8T@4*2-Y|W5 zmB`A1oV;R)&gv^~ym3)yha*eu;cgiC`LMzqZE2ZL>PNIAvu&^;JF70N>A z*t9h29F2$B;k(n%6q=qPavKxk`l@60N&04{0ZR4!O(`_6yG4gG}OlMZ_gH$^@NW%A#$ekMZzOdlIvnqGh_YFZv(3E;hBV zE)M7qVbN1r25+!Bj)m6&h)gvUAQgZp&$xgA2i9<~;z(yuG=G?z%z#-QhRVteI( zxmJ~@wh!fHU;26BNqcBfK3`3^EZ%Ji5V245Pi$M;Uy1FsTrBG*on4U_$>xp4o(qjJ zOFUjl>{-RO&t0qSt+_R%SG7*Q7ct3qm3V!)KiMV7bv&z|t>1gvxRX;egB|0xg-y82 zPTaO1^&TB&+Bk41cH+dLS)XMdA|!C3h6vW7;*GxVD+LE_G1h#u?El%g9hp~%s2DuLP zk*J$94097+%YAXRaB*q4Sr=~<>Z~4N))#xmHqXrK+)>Yxu9~&icOP5>c|HEBuE6+w zYIQyo*`Os%B*bAsv1V7+mnX;JktoxfrhUi?w5knaWG~7ReWGV)yw>pCT$n2_k4cui zF=onapl*fVLnD&E$q}$HZfy%MF%sDo_DO+RMw)9m9bu?g1z7@ihd^25R1J@_q;1Ap zcN9^&fWuq6%|edqy(}V$J#dvEk8m(vd{5rSMSAT-9W?J zuXt{Wl(at<`WyyNT;!)a268BDiE)t_M-&MCYN>vXL7Y}mCz=mQF8b~QB7Zr`)u)gQ zk4 zZkHr8aSA88^{yZN@=r?r;~^|OZ|3_te|I*HoCW+1hf0-F&2hijrjC5wsYgE5+X`j} z&yc?*j?;Q?ejl-yeB^NkaCOngX+I?}x2%w7{Z{g~ANDoByg2AS$GECR%X-fDeZc){ z-h9(4|K((E1EX`@{n^(C&8RZVm9G8PnQdxnMK90cs$KuA5MkIYoh-X`w|;M|_gA?# zYfTyQmSimIX)GxXx(3_7Zd|BXQ2oPu)!i^jDXfrnzIRY-tE$0UMUov%P?ElQTF@XG zm|IrE+Jl85NtVbW_t(Y3Em*o=YY)vd7k}8m2?HK+lo+8i28h)h`ci29rulR!-YS7z#V)wz|-26jk$^gsw(63XSAIdF;!evu=Z z>k|<;^z#O@B^>gq$vAmMMesCV@kLFS_$A9!^lW<~e$;ymBC^-l7_2PBsZ4!!@Iw+U zlp2W{4+MD1XL6J9@GOo=V!$UcX!mZ(m$cYHSNHSO&NrShxo}1y!l5TYC2?U}KWv0g zZHgc>j`ydEYgd76N%_o7&;=70>sm2?XZhlAt$3jbI&3U@yw)yy-1k1*Pwka{&qzFo z7;Zb^u%3fHs@uqYR+$t$9o-`dC9PGWX%3~?|5qpqV?$BkSz~`N1X){>QbH*e*oQre6 zph^nJ@%Ys5h4lU51|{JiEdWlUJHb2Diu)dkXhH$Za+NTL8hRs4$EFZT*vn#}g!p)t zt^C3J8-+{}XFJ{}?x`4z@qnvHKT9TyuVoswQ!&#`OKex)0`6Q%M-8MCt}G0VndKV`ql_gj*w zK1sgz@o9FUKu7~S3dHoW%^tC^mcmN|o=z;RyN+EV1e*3HBv-86An<N+KY4Y_0L*a;i0PBPU1@uh3*eB|fsW=qsQ1Jm+>V zjUq}N%*EF$wT~6k4BFk-o?q7|G`1p2bA73M`V0ZA_*tyzgQ-#EzQh4G?dv|#qDTY& z#W=E|w+wR^7Ts=Zjncw-D#oI0VZ@TvIH}?Xbj%cm-4XX_3SYxnjUSgmj8>iR-AF^iIuOyiKhK<#s}CeC9=xPu#aiY-#?V_+A~|Eyvtntru4V z>r1$@>+(?8xYdB%W4T7O`TIoGPH`P8(!$#KP~{reFjzRCI!X0tj+X13*K zQYQWmf%yuz240B7B0+foA;QNbHmoYitXZMOKH}NR8Cw_N^c0`HM3ry7H9|xD`XLsW z8{=YyKp_eujSK72QR99o`O9+7g*e+hjiHupdL)0Y zT1*8be*?K?S(&oYps4(DHVylA4=ZunnIsFd zWJLcMijismlUWTTQs3bMw!)7qu_l@1)kOs-&ip&Pyhkpk20Za5%@t-iO`0ZL141ZG zMDpO?vYK)%hr{JS#Hd_ONMvYxWes@})&o)l^uC5+tfTcqmHpdJOv!b{bs=m6hp8W% zx_qo(>7@Cr%1WsIB`CO1tSi}jm5QggOG`JVCjZ-W8o+#WZ(DxiE{#g2jIl+g2!i|SGfsm; zY2STh`o};ssgWM+CsHpogdfVZ zE*1ekISArvo;>+ut{<-nBTtWf<;Q}&3HVys1m{|YFO+_fn#__3XZ|7me8%;3^3b?} zeC@n`D1F_f69?p1{e<-Fcj-=_;Uc0a^oyX9MXRsDpa)(GUi%)s zZc5%lzpI(T-tQhqkRDlE5Y?5&yJI}Mh~70yeg!cYmU)lVVDgUrWyS_!4`2+m;TuqX z@-+RqCQS1!=_Odmfw<3ZeE9`HT&uUlRksOZEu+FZ>p*@ABYzsFj_~B|O*F}iAdk%U zy|eatiTuelY_a&cGJpRQB}O={`F!Gzx!IuGG3Hz%hJ-M%viqs&A&F^WOq)c!`bFU^ zxW=94!P2k+HTfOq^QH=8!Lqp#KoFG>vIsQD#gxA#y*dC>|Az-rC~~I`a}(0p+jH|w z1#Ax;(7ruP7KzYx=)lk>+#_MqzvNzw-6QwB1TDk;G2fIXaTtD;X?7yB*t`~G8*tV1 z4+C!Zu6y8sJf6DyZpWhiBa@%1zun>eNI+oiJjT;=c}k@pQtWA&nUTNvs6rb(vI?Pl zz9O-Q51#z(2n`#sQ~`*;kKsi(Y&`>LTF@riJW#=888kh{1siavFdYM3WzlQ_a3xvX0dOFO`ly5PliZmnobYd zntZ~OL<6T2a56YmU75x1>a_X5@>s|DDi^};j{)Fxz7xY<3V>I>MsYn`BqCJPz#C2U z{wllbG+3GthFsnV(POjk-p;-)BEET$99yxOx6VJLooO;H9}xP$@6H7YCzl=ThpIV0 z3ZnST#cR=VuVngkdOhme`rv0NwSC+A<8nP>FFoR&>xFH<_z~G=36w=gIC;P^N*LuI z_odp7{Yl%8LvfTi!VPerx63ejh(FiOwHrvAb2kq+;WLZUT(0bM>`m};^gCap&OQS67vc^ z8tKg5S}(F**-v2j68Z5aVO1jjrYj@BOgGq=d9d9vmvqc7D{f$vU>{+9?9K-CqneO! zm6f5!O9e{HN>1ytv|M;>uNX?N9xCp6=833%V6TNh>DhU(qG#;8?i9oq-1&j-Dl|z^ zd^CnTQ{JdcUN;kjmb4(=?-C#-T`jV^*+Ah9+mL7FisOup;s-v9Pa9O0(*jtkt|SaH zZ=17%mZPgX#k%)uO)ZSsA-|Gas{g1QK4Wv<_22{k%*C5MX4X4w7{^6Ye&!e`fze#V zs)gIho%X!Wb(~oTVK6cLo{f9&oo_2Su%X$zsSao-uUOhjoJt$_P-E_jMjJ3SHz4e2 z*+FkxZu;K9jh8qE?weysEIm!fD$EVK=+-Qm(OQ~N3(qdgR@lA_`=+!?;08_4PV|cr zeWQsk@OtnN(-_>hbEkJre7aGl0yn?ZR=ko$G-g1mv@7e&Kk!%qoC&jHm4cQ>UCoT5 z)mWUal(e4=fz19Ny+0Pjr<97QEV%PYJIwPTm-5fG@iX?`p+?-5PNALEpIiM=l9eP* z95aR9_Po9KyIR!rWLN6xt`mYgFQNL>TGNDAlZZO&gSIV<35Z+@sx$uF=?-#3A8b~8 z5lF&^{B^qsfcRe^2HQPD!HZS@C|SE9?}Fs7VtV{`i<-^;lPf0ae0RIH-8Q~-LW2=< zbJ6D8;KBAVWJ`{Mc-ilbUP>d@{Q|y8!J$?n(hqEemG$k{6N9f)^`l5M)b+o!`Cll) zFMc(~a{qdjeLD>Uqb7dNQ~}QLllz?0!0(zDJWR%%+8m!TNj(*;t5lH7ix+|`SI?-0 z&en+u98D;n4qBGj?S>=(G}xe3-9ThAe=$UZ|N;Rea|*IhhR@kFGu(bKTzS7>qWQvU;3+6lZIpZu78%^k^@$&mQ;|p zT@%mqcyo@y*KvGqb1HwO$foEPSwHl0vTcf9%o@$|8+M^pKE8Qr)OI#gv1{9k`^LAQ zFm;x`_MDhEG3WS*@8Eo!ACJiIzWQ0{dW6a2QFIurwDA45>)EFd3u#=?m#9CQASls> z*K~D%lt4Q!go#yTlp#l!Wey8Oy-AgGWxtu+?MH7Bg~+U1zsitrZt=CLu3!hR@SE(Y zi8SKah)k|ZsZ4;nV)5-^t)jC8Hx}{1f!oH>9Tf%s7gCoXV$2E$P*P&fncdnW14_?x zZ%QimX)&fg^xnYi&vVygNGd}qk89bKi))e}MVe<^zKlOXf9(9IE z*&moT&?$@4ndo7i6n=0wcNU-xqe^D%iyh2dEl1cWODFr~aWGGfCby6RETFUkHe8(f zs70Ft_GErFlD-)rL1w&JHze!B?6^WpP#}$t_PNH87ckDC_Nn|8cx0;78MLii3V!7E zi=aF13^%ngV(YLHjds&c4lV1ki1=)v^QPjyU%$wp6ML=oz`ihsnd7l1TJ$@&uG_li zjp!i`jo~v)&*xE4w7YH)oAm5@jjb)r9k1f&{>gVW2pJ^WUkx~;cs^lrdRaRj|MA%~ zK|U3NX5Y~tx$r(J(RyqT-@p&SIjOA6z2nI_f-2y-`(oUwgEpqE!*b9mIa*mq_ zdyF7#n6)G7!XbsY)uD|$`2tRUJB4;)GPEuRiF|k6N?&3<>ZrwJA@1`G z`B7i+B~^a)ck^~WfEbPZacUvkEn!3%q80D4Mf_M3-O`K2GB+6fN&|qO94d->=|sH* zk(8L+Y^Gkc)r|9-wQL^@rdhlGa^97wjf~d9Y_A&P=Zbmb+gvb1w>eUx5M9AmOp0z~ zIca$jH8}QF>-9Ir%miKxkyV4RG8-ayli5XHJ$O|Ujt|h{U06IQtbiqdMGjyp2nph~ zPYZ`lI(>DxMIB)HPgUmDRD6j1)q{i;d`lCK{f zmAhUL*G`!T5Nboe9q6D#~cqa$Km<(H?5Ii(5|d!Z4MQz__GyCbP>jrW)v_wnF* zFt20f<}wpo-nzt#;nFtUoctmDIjGegFPQysz`Wr|RITw5LhW@dW&H;CIG!VR_@;l1 zXZe%Lajva57kj&aFGc^$l{mniW?){FpVpc$t3#(c;p{CRjeAV%>@K)6RH2*idKg_7 zA1gy~S)%6FG74f1=p$cf##-7Nm@Ap1YBm=pS_FL=CkkRnMc}V!J*660vSk={S{ADN z%5G2U7G@KF@5%IV#}So_TSlItX*kB(V-z)2Fs1=7bR*8PXm(IzcH6qPK~j<+dpKzY zPW#ymFqWC8lG=^Z({{BvD-{x}E~UAF*_R_zQLH=?d1k?W=zka_1&emZt7~EmBjyXf>k} z(H7`p+3A>cv*Z{2|5zFUJ>SK4-6wiX*_UN++?P*r1pkdD*d=~_v~b|}<2tF{z=mAg zJIRZ%xYgm1dFH=Y=)^y~v0tW^|K@XlM8vRUQ;+tGmi(kh`<7>kR9W7Z-=1(CQkX@} zaKjzJ=lQO~WrYqr*awT9PFwfkk7sP98uNX8a5qH(1*^Sm9-I9~9Aw8;9qkgO8x`lUL@RBAZZ z>-rEUws8r{y`NMzcETuN(An*Qq2HlQ<0AaagRG25$1d8MxV;y$fqu=~=;s3qzN6_q z#jono4fvmKnAYwMnHfnUgTpn~+nmQF-jJ)WEl+MH7&nfthAR2&*!mnL9k3U@@K1`J z`mN}obfTU3H==Mw(!eZH1POi;|6u|NMLBkewM0IR#*VS z`B^h*XHRY=+i%#N)&r$lRr{uDGJki$wEFYioHTgv&afNbp=C7|QeTaoDlhvz;Ado3 ztcnm>N=RqyM_-#!#h14a8(Z?T9SxcPoqj}yXBIVHIFQDP;v?Qga)ndSQrj|fqqZ7I zeMu9q+(IQlb@qxkhKn_e3Vad!K;Bb~pB>=fe}%;OAe)&utJT=w_hK?e2>LzJ+uv^Z z0>h$mM8zj2rRo)uBE$2kY^3QbZkIhjbg2NUW%bPnY8AL74sJy zG#igtd1(Qg*nz~Bwn@ZB=PFw}$p(JtozDZ|b;RL&*wXy2Ut>4Azc1#qcP0jn;2RV& z0%wFfJw^wLI3A5PL(a3EcjV<$ecn{uam;A1`Mfz9dvCjcP zUAoMt^egA!dWaEz{fo}Zf?nhX5)R(pCYR<=2dh^Oji!j;u08x^tKK;(SBo_m@N{ai zkuz20^t&05p6_b~t7u~#!)Hgkz?6k!0#LOVbr&i7Y3xOcTUB^NGhr_TTUhoCml=8# zeV@XI;=X!srRUPs98oy=BL11~4Dx}ypDj)VUP0-{j%#OH%}TZHKW)l3BkC zdKD1!Wm1NclJX9O2?YM45u>=AXx$r~?klzP1+9`E=cR2s6rXJ3q5;+onq4$|4F!jLRQ*PaYI<;x~)s zFg!FAlaaAC#K=_o(f9bXL}R4nUKHbqj?TB7921v=#Ra=8>r58Iu4Y34V$+c9@0XW6 zMRci}R?-T>fE;R)X3dhtwaz_VjC8~2Csv=^p_Qhy1K8%igWmpqe!b3c2(LSJal)72 zGYj;eLzkE-R z*|ErPJL2rcYPFs!f1PSlO8>@gwR^Wjbe}emT9uw_*dM#HrhHE?_R$r~u>{Rv)KUNa zvMutfG8DB{AC%`)bwE&(wbR5A%Mfif^%|e``A;lLp|ZZai3YE9O@h}xsS55_dWKkK z4-R*rlqy8?EOgyd0Hv)nuVjx?4NfDbM{PYyO=w?U++8_0VlHxm4I~g*F@6{2Fqera z9!=yW^1$9^#Ol}P`F1w`+Z`VyNpxStjoc9ysVdJUmwKf{##c?nMkH1s%G6cI4HLjgEwdH* zyIzgm*BOL@y6aE0lrHs|YgTfD32a6131Fl6nejf}B~1!oDSMzL?T5>7yYBCC@Y($@ zopSKC!nNHCSaq(^s53|tJ<*=i6u?edi^hdLvqtK(IyOKG9AbQI?|BtLbH@bQ+(78}RSp+S2Q7TN$;7cV+5E9>S6Ee0zQ1>3oJ z=SVY45u^{LwHoqL{v|}?u%@T-9tyqrYSB*34|_v&<}O_`a;pPK051#hSmIw=2+(A- zH3SV7o6t%M)+1JOBiq4opUF8EwQwd|?rvWCQMm+jjz_mh&LAhwkYd}r#F_$vIp7R zBwZs+#0SA70FkPoF@14d({fH4-(uP%pdQw_1Fd=dQ22^~cNO$Q##~2ZYh_qd>%&2D zslC#_RoDOHK{E5svQY9tVG*>@H6G7+M;I8yTsOzK@nMORza(T$;9nJH|K=?Irj&lc z?uGcgV}AAWOME*?xejK%E?!zBnNVuAh>wBj3(8PU@p@5Lzu;8q484&5*o0SR2w)iU z!(5VLB|b~)#TuB=eH}RQttHT0folrg&bsKi4Wa^`kOZ%$@C}~7ZB20Lxs6F=fEOj~ zKOfo_$@!rVT0%i#?WbGXP0sz;T2&tWW81u8+f%vwhjP1Q3$&JmN>posRyJoR(te*^ zS1F6OXhZMma#nx7_H}$ZHSoBO9c((f(fsnsIb!(c9)a@ zlSkVps^#ZtWJ}&M1pE7I+}%~~afZXN%9qppIpLrDsHmIu5rxvLu{dO}Xu% zF`6Gs->tRmsbxsNHNf(n$ubEG5AOk+N}EnV*{YAd5)xxa`tr0^%p+Sj<>>8PS!#X` zU3Wlghhz00Zic$xO6STi=@&1Tll^^MoQj^sJ#uJ4whuWWp&coEy=n-_d(mcc1K;4h zdSc!)Skk1v50l0YLg@u~a0W)n#MHAv`9h@CBKNfi{LUumJWDsE;rC8aC05T!bF-UN zdD#y5ri14*9_InPADw3{cJ~%=BXzkVG+7>ZZaCxX}iVnZy~7$@?y9GEn~fGWTM7Kk3uh`F1s%d z3ZW~Qg&fBl86oBRts(_cII9fkr5cr8Q{x@KwU1-tra2?GSvN(UkEw)C@73PhW`|vI zYOXIoDAIzt$BY+@R)u7*%agW@q@$KJB45(2(rtKFs?cKSZ$IC&?@Z$Z8OFXv^rYgh zvnw#ScvUu9{ejruZH`iu$E^?EFV5Jm?p+B}XS?^+??k%yed5m^Z$&$f4*0TqwMG{T z?pE;zB1i%Uj{SqSl(9PQ?EJ2kZD_d}$V|rx)@6FA4rCQHY%~sPRR>7k6Hg;YZ(tM> z3>!O}tqK{BHfZNpf1N|Nf!O$% z2PAA(G_U1KjB#xU+7PGGcD3h|q1e{yGSo%dxHjhMB;4XY>`V|E@w_+ETxa`zLma7z zjXE@CXB-)yS8nEYxk5dxKN)ZTB^FAs+s2+RY4TKJ(sud#Dyq!j@2RsnQEil3ga|b6 z%wt28%>-IdPLfN+>)vx!{x@4Ot>AO*VG^rZ7Ma3VJ^X5E#rGCWtvc6@89@?Q`fQ3; zA(X(WS?;2Yl1dQpgp_WR0uoY#<@u2dx9Uk1SQtg|%N-fiDC?^B>L@)e(xK3;mxUPr zXW-U~?7addztdTRtB1ImSb?aD@eNIy%9FRO zSfYe!c&0;odzWU%#4qoIqkInMKD2vsJ}6I5NHavO#!QjZS-85(4tHe2{O~#EXHSYU z7~h!RvYVkBE7jQfnQKaimYGNB6CM!z(rxBng`dd`3NZiLFZB_Urdfa$5iwn=RvJ!K^7t^SB zy}K5B`e0c_Hh0YAp;|QuWEDbpGg}T3nyzahMo{+JFY-;9G`!g~uu4cr3TmC|?ARwW z`5M)~k+cl{8`lcAswlXPd(dMyUq{Bl4qV`oby9obaZ-D6)U%Z4fLxmqYF&3eN^%sGW(>0Wo+i1 z4@gNYh7k7LAJsuC_EaR&-epBdZwX`l6#UxQx9qOjWTRQUF?dqw z|32wxPY-dJ$8OOGe(IO<{1l?bt^d0Co)JWt$nkS`s#TggwN63jA0hM`p@WF@QX+xa zc}{2mljinR1Ht3Hi!^GY6!$EY_|)G%cY3UYsz5k33vRVw0YY{^F2TulEI8fsEiRgH;D z_%{8tcl#(D9UG*tII|loLwyZ`Kfih1 zG}e0<)b@MDq~ExScgG}E>Y3)Tqtu< z7w(&9QFHb4u9;R;&2(}_hkp3Pm-AXRwj=N3$Iz1I-5AIMnkL^@!{RqK6+aZwM&rC1 z=n@anq6x)ZVaZjDov$8?CRqZ{hyc^PV_pb!dN=f->LVHUimheCQSSx%kob3pC*uZz zLX2}^)2mdUX30^>9#xTPvvI_0+w8s)c#jwXMnPFq$;1S8j#yIX*=cbjM6QY(+MX=q zE}g*>NN?`E`Oy1;dObAT);#{XQxtk)Z_jvu7qXsi_=&0c$J$coYd=by+VpxKAhWJA zPKf4MIHqwE(RqVJV>Yn(M_0R=6(Hkg%?0pP?X!>NdwhtGj1z6nCOcPoJ9T|n&T+hX z>AbykNw*(eGpV}RMW#vl{!I0g3V>8n?@)$&7F)&~_tT1IIBt?U(6m2(+0#G+Q+he^x|h3*KlB|tkV@fRwtyySR6`^R;*At>sy$bI=?z*C8a!-WUj- z;1(%2mKQe5P3?@hD;#K~Ol=|_ti7tkW=KBxJ^%$7WlAQ_docExtDtKck6 zxP-mX=95^GrGZb8VxrIizjPVzW_!z52y8Hn6 zn2v*%fkz2C&s2|X%%97&Ptbaw$A?pCJE`R+X^z>}=7kE|RAkQIv~vdpS@mPo_kRZD z`^PU}`>NEEdKxTrf3fao#cCzPVz;*wQKZ>Qo%vcehdS;?rl?|%saB0?J>rjkRl4x^ zMZ1fVM_ex7`15`x=l|0JUt-cR)IWvwX^!$W!Ox9#Z9a|TJ{X=cc>m3O|E&!9hy4&| zybY^LdI2%6%X~5toh_vvjdf|Xr-qQ11B&Je4`h7PdE$4~>fR2JFQE|v^TKwwLJQCd zcC#oxr-lZ9zjvW#cc%^0k|zGp*9X_$$?sEJAqjPf({PXbFxggd<9xAax5O8$k-gPw z;nA*mRBTg!)jB~d(h@L1SECtU-ykVOGsz{PVl`C_`b=zFbrTAv+L_J$86z8{zhrt> z@)^EH{311KHKHd<{X=z-?)qA*WI_}H8G9e zY{foU*e}6YDBJ@3%Stq?fydWfdJY@W?QS#JovLjm#*7Sq*V7J~R$scnX9brOd|l>B z6G)d$`6DR`K#?q~u=&E4Xu>L;Wi$(o>J(jHj5{$>AtAP!Gv2kdU2IE4?MV!^kT+Ni zTot~Xy1LZXZEby16&jxjDl$W$XR37E?;Qlz*ECmwOljW0u8+QY934f+EO!d~8wjDE zblm)+t}BjHdoOu7VpxmOF6H_=Ztviu?+yuLo*N1w_D?fuZYh_OZw>}N(bDTwpg}nz zL_ktb4xu52S2d=J0Io5=PmVA+W)keALe=4Wm7n4=^=y2%N#%3XvWDQfa61G>V9zte z+}d_^E9pL`Q#ZMLKbE-jgd37fG8l^*)h*xbM{3bk#qA%!Wx^I{uiET?tl-}1KSGm4 zwI$oEg?P|ie^Aw8#4?Ll(U(+ClhSBLljXmKTSqz{e^$tM1-erq(QR-VHKjqi5eb*r zGOM`Tk+Al+Zx|kvh*q?#Dw|N1Qh)z-Tkv$@o@Lir-Wv{s;Gdo!oV3(0POGwAPabU( z%oLIqu&jQIv!k(Gp-Hx5eEOMhQCeT&J=Mf64jS<#;Dj+d8h-r1-(-Y7!qaa$N$Tv>K>qKKB55BzRJzTj0iL^um3N*u(hWh0?X zImF4Ze7y)Y^l;il5KPLvm$<3)T>Kn(yo^2urhHB+7Xk|Il;b=ZN>0*$7|%@Xp3Z72gx;W_I2vz)?T(Ho z7aGE%di%@sZ?~>Ixv){xSA9$~IV)9>5?u>Tyzi_czZxJ?QQS2!Tg#(+qB9f5ChEw0 z)1zui-(K$jMW^83Ur^eCzTk!ji;D{bkEHpwyQ}|DElk8(wZHlskEjmB=uY4d=f{^_ z=IeOadE-JjmAN%VGB;Cj+h$ZZc-bquW^n;z;GXotQ9vLA4<;Oz_FI>H;LR4~4yERI zQi2{~$>u5>CsXX(5O=FnM}j)2`9+hviV!z?;1<3zT6z5G+(Ge?!w zgwzn#uA6x2lU{Ff`F;zur1f_G;nU@w$_;*aCYe_}TjqCiLnlB*2OPl2*|>nfKX-Ak zID^fmAMx5T<85Vo6W4PZcA>fg10RcPh1dR48UF?NSzKuyGC=G6-hxl}l8+1)c^F^_ zzm|$~orC^;pyNJh#3=@8i`&ZM%usoDekuRae8hj6g{w+p*YxH4LdBU@oME=7DPHG? z-)wKiB(z|`(yofIws98_4Vs@9noSrjIw(cr%iAVH^0-i_w+RwxPq#6Vs@;yLU=$u9 z+cQ8BzW@7vvWt)ovsX?P9}0t;1jzJJ6~$XalzWh(eyS4ZR(tJGn{4sa-vL^{s#2^Lr)BNXXNsRxSW7EhVm%fq@mJj6L6N zcGi`2K|J|2v=YDbOXy_+;a*g@@>UnjGur7iq93G`huLk4=~$(Nx#w-3AQ`0*2^v^Y zT+5CNW#TO%-p=LPJdorJ|FW3h=%k{ZCLzBdR&x9Z?rOe<8R;GL1O@V3){y{|aE!>}2hQ^s64 zShmhJs*GgwmO?M=utn7OVuu2^12lwAYs_fN#b%(ziK%J7o-8S2HHW)KS%fVc^s#m0>CHZJGIs@A=iAf&#WK= z>&yaf{0HBQ{@`7Oz#5{wJ2@!-{xGrtPrC zLipw(@b`w0AqH&z`mJv5*$2KDXp!%q(}&p~*RQ3&RZ`opC8yA-GUu@LkxTrU>3PUF z`qpTP@$VCs|IqLQq+Wu>OYed+|3{p7OIa07JhaIC;n!xZCz^77OF~#BN>nI=tFF=@ zHy+Jb++)~`?sD%2k{hnSq5%Upcb^@X$50(Ryg3W?ruOIsp)M6K^PNg3*go)}XT#{c zHBZ36mI|RU=5uDfQG;&7nv8hBrlO)^e??y~-$l|ecu=_W%IyGGB9}$UgOqSDHaTCc zbQBN&*{|>Ku47|W+Tvn6y)6cGkaEv)H)bs5>e>ef*G@{C&_9s0_M^!}zS>&_SAr6M zs(e|>tBBek>oar)T~dqoag4`Ndwk$trP$Qe4W1Y{`{lHz%>+Lkn!C@rX-S;yD9>*p z)$D~1Rq(c_1R}(-?r)0cRwlt=QQ0L=NjH*`%1>3UmzI;y%qAv9W->Lda=Vrlvnr!E z@x{QHhQ+;UD~HxQ0OOLu82h^ss;mZcW|eQ595$4zUOSx3E#`z#!sdDDxeC9&Xve37 z{wd?>!D6WYMLRA+XyuTeVK4F_K5L~lhe_Q)PR59>pyqsM(}Y>Cjl`kj2F1KmD?}82 zZjf+N)H`n9vC06qw)I&~-$Zl9!^jYu(^cWJ6%lslUruH$fxtJy zcStkrX@zlbV14KhZjuSse-G9Ly&da3`LNfF%S!o+9TFsjh4lSGya6i$EC{>JEG-ng zQvY&wao?ctC?$noN9oBCC?Qr{U%{{x=#8&vEz%$P+QWutx3!ozQYunAuy6ak-ble0 zeF)^E01Q}Cowefq>B}$2*mZo}PgI zJ65b~>K}>ym*S$kfa@I-Frah^E%#hcgktGJ)btNr5GH`O(rS%-y!a z=tPMNd5tIQmODJwS^41c>PpV>>l2qHSr*x~G5k0Q-7`7FR5e#T6pz(S_jjMQ zZz&*a_7_#!;-49S)NOQ8G@YS9Cjs!7Nt^q2qy!PlF_jLJr$L_8@H~Gb*R_{_JRa!* zjyY#Bk}qJu!dM-}JQ?3qXeLpVWohevHp@nq;Qd$rFdgXB`6yq=HmCZSNS0Xr3SvdO z0Pon=K8I4!Qh7%7YI_628~g}wlksK5t6Ax~kM@U*XdbbD+RQ5x6%svXQ6=@r>G}&d zD#!+Y1tD(y?G-3-#qrbTLskOjUp(mf_*%$!c~>7(%XSGR8~`SrpkSM#e>zp^z(}yzMI@~C6SXiqA4JB;d8`m`)BL-C& zb~IGs61-S6sxs!121p`WRsFG;g6`HzIr^&lSO+iv5D$*$YHjEJ-n%oxn1-#lLV%7m z1CC{0Nc+!rztfk(VC#|u`ww88)TlBTD&{42Yta)#FKsFcNSN@erUXg9b%!zuEXbkT zQ#gl#9BW!6z#QmgD~5jUfA?*vvJ?yLca@SbE+u>9+K`Bwmf_2%a+eTeorcD#MP=&! z&CyYUk#D_bthK645gB(L8>IQh_!ur(M1N!ZaJ?VU8+2=qC{x@VD9UMA=h{lm?v|5N z@q#0%*cwN}3b^_(I7?k1TddR$8VHn>178!;2~I|x*L~V1m-Nz4?EK*dl%%7f$O@V` z4eK$`RnFi%;Kkdx;}ykIMS*4Uyw-e~Hs)p~qO5%?P4)=p1~;aRBm?V@(S;_rRi6~K z>sb?C|2Zy_4&z%!N)r`1KhpNH7|pJi()pE>GZ_n(oV4x%V=41T4wbDGs|i{6e$4P( zln^>SjrR~?C35e)rL1V)1h^becd2sQAAj`GRTyp=Z1Mc2aL1D6+5UJ6WdLsDZPtbN zZ)!F!Z~ZC0QftKhTNRZjQLZ0NaKb+s6Xuf{n>7|8G@{q^Mz_&k9009^(&j~H_VWhb zgu5Q_n%v1&tnr-n&QVv>l5ektlct(h2)>Q`gU!PBd}NX+X~de(@f0u)dLth?-%`$1F${-bD(Zr-7)3O~2moIS!Hr|Y+cj_s?e?;U&Hl79p`e>>Mrr`CXH%oAevaR2Jl>{V(&B^|qNSeuTnRYrCo zBOi@!hCe!=?MB;!C+ru-O@=<`R@cp8xykRfIXF|qfDe<`m3Vtr{6kC9@o-T8KY$q$ z`*)USJbCK^*B6JD|CwDu;$odY)kfKdT5giKP7M{|jgwEVO)bAXSG|u4mM0Dh04F1C zH%q8V50zgx7HaS_c@pAeVFd9 z#4FoXP8OnjL>U`t9)2oJg!q%`kR9tZbTwVOkd>`XHm_ZGkob~6ferWT%&5s_{ot$W zQ_hy2RijB`>DJyBp9HrNE5*mv$%uxtY~dWFiE4A>Q?94WowL>XJU-sf^t$;IHf(d= z7%WTK2Va(cu1z>EFy2)+s_~|fdy$o$WSlWfJA7PoU`i>xF!HNHUsD`-JR`1~^PK3c zNW7lOCXaTgY&nO)4g@ZR;<_=}mH&=jvzxi|(fU5Id#?(O7`DCpii`WlGX3~^3Ufe< zh4w!;;s4`<AE(u6A6VFOfLkhwFIPNPh6`I@F3_zLOj!4J$H81PjPiT5<*-cG!sZehNK# zJmd{ETUCrpk!V0zG#Q9OmEKj;jrulFo=O0K;45Ya&+Sy0RfK*+rt?e}%Sv;cTOJcT z>1cYs!vuHn7n&gYuXdEwgsp6e`k`WpQyn+d95p>5H*VmT*gqYJD*fZefxm9>lR=ykKdD)xdvj)OPQX`jup%FbNyL z;Bm*Z@$%CJ`KEW{a+I#WQ~Z*)v+sT?1b;Ps%&YXHrI=yV1%{^5r#`R`TCw&0G}Fl& zQjUq}qi}*YPBEUi%^C=tudM%Tz>5T_;79VNmD+PJp|D!ZaL-t@^HVuAj=FoMk@GfrQh`a&{L6= zBqgLe*MDR2^4;Mt(*r#&VJvBf_F3MFxlEwf17n)Pj|aa7wjTUTS`!rvpnfIi+c-4H zK{wf>RuA5B5`*m|DX3{4%axSY_~UGo#NQ;ZmfoLO!RAj1rDtl-_h{*nSt~sUcmpOcJb^V#|`Web8-E8n^d5wlrxvy%LZg%cP!}Xb4R~ zuJdQcA(>fq!%O{`pg#oCLYazyx}B&4I<$0eR8nz5uEsBg;^m(Mz6hm-uV60;0o%}w5_=1PGhK{JYl7Jlvi1{3G+j)Gqcy{SSO5tb(f~)60~^J@nn-1a zh2Kf)^cAJOf|5+&ud5$cA-#T7AT?jx47Y-RsDD9XiLYd_|g z*oQ>%86Q^5I85~)Q7?4-5$Un`@!w+UGs2tI!mH=+2&G;g6pj?vg&5IUS~x#`C%<}a zXHF59*OWQm(Vk(QsiwxX5@kp8qKhhsE{N=v-#9{FjzIBOv!l?1^P6@G;vKt#Oi5!E z%~~QNT=cw-2Y>I6dRR}I30XNKj67O9k$<(@RIKE7&Py9lCQ)OQ`CcR5*oo0ymg zhupr`bG%3VX@pGXxk1{-vu9^f>E#s)zd0|BKkc6$|F#U~+wKJeL!<<99K482`hH;> z_&^buwHvw_CQ1~6!!S0j2+_62k6w9JoKlFZJD{6l;bYxq;)T^?^RaO1l<9MXkSyWW zjdZ%mSF$CibKc|yiwA(h7DDMw8$G>@2dkW9LtpGl--b7T5fr;)K0T&~sys|&;YZFD ztP$JI18G&zqf370lXTY9kOJR_(KnueM7-jCLNECezBFIAOWHWzp@_$%uFgh+IWw9z z=E~(*b*_fH@y24+ZFr5hirb4r(-i{I!3EWD&?pZRCjuu(XeBt{?{eIkOB}cF-2d`F(lTg+rX)$036Zk-z_d{_+ z%%>d{vo*9@b6#Ab5j2mP;$2Pj;=8KbW^d8`%;?gC*u14Uu|?OBR|(+N&feylNE>Bm zX=j-fyM-F`?6H){T@i+&qWCnIX|hGjh_T4=1HaA|*er5Q$l4=}G)7s$*H)hmxu2x7PdMxz21#$Tf8%2AtbaTRReF z;DPJ!cgh`cEcIDiGBRA(HMj?Y-OthSPUvBbOXzMSoSqK6U}$RXeKv{faoEZB*ZkF( zkTG+Rl`t%qx4+f>WgSdq;GTJP^P8SwobX}_-7z{zXAd@KLU$UDV^iDa^gr6aqE$$b z4$1Pv#d@R@P-*${Hv?t!AO&i6+auy!XN@m3-vV3&e}65R3Y>PL6Hsu(tDE{klqvN(t8cP_bP;z@WtI{cOT#X?#wrH&xB;IJ2yGkxlTX7 z!#Y!*fh@5uJ&bWdgRs$5TS@5BkfS`UnA(=I#yv#E$|CzN?2eV6tFjE?ZiIiKmU(q( zQyja{;`1P5uA=ku7Hp5T7Q4lUQCThw=c*>-G1`edneZfXlF*9RAz$x!jkIrT^PI)a zXMQV8%^PXBq}lJrzUsu9Y_K{W&Afg}qBxkp>Z>xfO3+te@mMz!fb)v0n>mVrXgO#K zu$!=i#q8eoMI%|Ja+A=KsnW)U?mC9%$V%l7Xz+6$HcfuRxHztMpNJL9HO-JWg?em} z4nUge<*(?=G3sV*-Bd&z+sZIk1ZdBzO8m`Ae5yF{#Hr#IO6qaJ8Qof<&M63pv{dMr zpy-HWGwI~>w`wPD)@YsL>+%M}2m3ccu~r)0m3z~&CUHrj4LAHh*G41N20WgJHdLe) z03*z6b4digX8?R~`*!U-J?wp%D;62M8n3A~JC>?xB65_S-j^uO=~QEuH;H;QUJ|OB zQ;P;47z?Fi&h9(pK3D{#hQF?bP&5M&g5z zMX9L^XQ?}nhs)`>)~{jWNYLM6=`4Eka0+WJqq@!mzu+Wcg9nYG@u43D=6TO%CVNITQ?AcTOTB!VyZVe;EQtnq*8fghTYAJ{kOSlUa59E`5^&e^tefbE2$_Jl6hHT_WrRUS-W zv=t)4F%ZZbK~Lpnush;7-)}JtKi(;E`|fhadlY%9mdD}Z8+NhZF~03~R8Fq=h}+~7Ov;P= zy_-bLqb>IC&@Zoc!qRHL6k@Oot)@-eAoL^6wQ_!TL!SAzYR#d#VKF}_quqv*wn%;D zC_Jp@0`=bl1Pak*Tk_FcfqGgrc|$0W&lC30jx@qoxjJ{o#^6gQ=n?~D6$`WL-P{M~ zd5m_(vtiBTubW)Z>9(af&dn7VK}&GeB#KO0^cM41ek0^72o22?x`^Dwvsm{bhVgbD zWq(XLdV*rtQ9GDrAQ_V6r_?4Z>q78KKTJ;Ep4NokD~Da&)J#zq{L-ks86UDg zrR=f#?X2v07v98*=V@Ws`e4rII$hLiMKst>$&Nk4`wa9Nd`7}C870dSS|za2-yL@g zx=RvGufXVU?6<#i`fNL{!Qf|w^x=l|^2TYj=jkii+wH22WfV**yjfF{c7_VaY_81& z5%Kcg^|GfY7)u(7$~-%vGtmUQ8ZNo^F7? zIurS8$Hwuw&SB5JUlgE-PYj9@OE#fSc5(uwhunE?zjf!ifHz&Eb=Ojxrs;462>;h< z+DSJ15^;d)isVyyKrKTN^yjLU$HoAuGx!-^Y8bk)ZvpL9!HZt`e!~f2hN=$w5s3SQ zjlT%9CE=QFZ-DV&X(G=S1~`xFRwf1$i^mm_Nz9FC)G8bdRvFBMldI$A5mB+GCMMr2 zfhW_S4tyDJ-*&MuaPs5JF@Huy$W93{hvGBY)uwcGL@Ryq^SSn^)X3Ew04AuO>>`8Q zT*0dMyWV=7*)X|=ujB^d`?|%hYwg9yW0!_9Go$iOHPC5=uo>ngvnmgKH5PU+W}Ipj z#T#FH38e@|Xlw-AXtuFcDWp+J=PpX_;8}CSS0LqT4PbL6Cl;85?$4i?NcU=Vr~MX^ zrC6#Sq1rknfxo0euAujE_g>GKOV8sf)0!3qtIOO-Ql}sU?)e)PRhHOQtLkQ|$v2#j zSnN(%@1ti21$&Te+tS5r-F}@RS^P;GNJ=c_{}UzI^b1reQ{qYQ!ZFER%M2VQULU<0rp{`gsvcNF$D}@?ACNG6fnM%TTE65VvWc)2s^b zD`K2#Rd*V-T&;uBFz%!tv7`Nb`X$EL;#@;pZy+VA<1+i$Ngbnd>zlKa>BrZD-D9%| zSECO0U)sGlgog|DReTCp`Mi-_!SCwU&cfH0K11zjg3ff)q|sT&w#r#tKZwOso`uQ> zs}uzxGuri1bnJ1Ku9DE$q#&!Jr^emBStcP%9E@jP#r>$NJVIJU2h$!e3D>A_HLkXX zahG64hGg6+#%x|&Z}Z~4;^xmpVS>EtbMD0l3zK$iYKABVxP4H#q6XAYON!;?J)M*Y)!kV1v*eEY01tcF85F zj$Ug6Hdn8Bn9_0Gm6X^~F7TG>g$RiQX!ve*HeQWY54uVYAAngsI6o`>x9k8u3x*Hm z$X|0)qw9_1UkJ#4-h{(|XsITR(Q@ql+U`|lwC@G7SuMDIn>m1Zqwq(Z=&p=~`R`^~ zDC1j?e<&rICz!pSdrLz;>Ydm0Zey0zJ+C869}@KzcFj~V4L1Ig{dJHK?#e8HPtX6e z$o+xR7sl9XC6!i)H1w`_`g@nds^6g=`ps2!Jk3~#kxehZ&0l==S79pXjGKT`2wkXF zUYmzua{Z=yoz~qmoVl~P>x({Tf4VJG+*tzY2aCv&Dc2Ei+nAp!`J$5}8*(tImg6O> z+u#zYFS&+ENRjjN5d-J79`e=m%=r-ZF`H$vxiMMBZ*r24*Amn+hN`SR^o@m^3UVxo z67=ew4J9&Ef5@h?Flxp=4qI`|$LCuQ6`W4Z8|%J3=bS_Qu=2Xt?z!lUcETNh-MK`< zx*`ET=xi7zoua8po#^CMP%X=Fjj3 zk=ei$Dmlokjy_1C!AnD&YrCx^Lk;ZgiYTTz$r1CH)VA=tAxAY`O@nJC5UDG_7<=gA z&cSDegX6BcDPW>F&?>SB7L%77(nzT@kA!9V6PSu`E+L}T+i2@<`#m?KX4=&{&-|f8 ziDvFRIOP=?uXt6IYZKp`+B&b^97;v?@jQR1fAh<^{;~^j59phDXUtpgSE5q>C$D5x*-khm_!7K^hR2B5p`-@OmHZM%p)>7tYw zf*dTo+ne>)H+r=lo~?n^Wlv#KX)bbr>`rD3^IQ`gZZ^u3EY% zojG#GobtTMX`nc|O_6!m`OBTml$5|GdJxz%B36EBhg!W;NFO{Av-0tD6hVK$mS$;{ z+mLY;b8$oa+W0{lY7-{GVgVtV5ySjmMy-c@Wpy_UVp}UNP#~ z9rXOO`^QJmOSt?-pH`0xy|i4KOCP~Q&~BC%1(M<5q}z6|#OlDw3TzQCqVwEiuXZT? zLmXwe&-B;#75hP4o|sR|QdUB;5YC)Gkj8qWVP{5iOPuWc#}j*I7uQ!o7a#I^{HtEu zXOk#iL59ii+Iv{YN9cU=JPfrge{xZM1Z3{T0oG<02b8 zL`1Q8J!eTpAL9TpmAKYnngq2Wvy>~$^PPY!`@|IQ=`3J@9}A9Qje^LtFrQQ88@vCFb8^Lm-*>WL@ELy@Z-<1atifirF- zvr7*+mOh)+b&1;LNxajFfFxK`Htz0w zpOI4@4w5S8v}i`>YpAKI85=Z6C-(86#5)omn{xAY1CzwHm62hbp{U~`uQCMA#Xzz8 zF==SMdVE=@HvFXJyWj(phf@U}U6E;kBFzdXr(LORy@~P+=GpfeM{gcaNho!CGjAwI zPQmDF3;gfjXzJqduV@WJ-pq@W|6(+sUH$@_W;~;MVqhi%ttBkKaR5gRwAb>fCk`07ASC;==r8fCv~dZPiH=>=G^@`& zX_M?wJUvZKXJuiLvwr*bO=sBSZ59?5&w{)>_cg47E2@k=Zlb%O4-kStPYuVaoW|L7 z>Sw=wvwDUXCzwj4K|z3d^E17z*LaP*mL zhX@7jet!!HZBkQF+8AoBlOZRbm4!ZH=@rw$1BFjF+5@G~$gLk7S>7H{4?1eajX(f& zvTI}Wokf)=s2p*v%W`mX)jn^`?vXBz<*>R^T4rV68hXhUS*KpShFhmw@`@M?5vXTo1|-`~(JdH6lS zswv)jBc1u#H&=%y7n9Qy@urF|k+WnxRGF10{F@S~9s9Z+3U0+oxVcoBT*P4Aa;spP zDJPek8-tGu@g>Ne9gdEUjx0c8GpLOvHmty2+f9o-eIH##?QvQhc*>USX1tm$LU|o` zBlc9t5L*7CK<(GavvSEZ>o8e2$1>BpRtOW4G?6qJ9($);jQz3A8)|$vX?*|Eo69ml zB*5?aW2SqjuP!g|12oL^q8!TNxXLnplo`VP*RQ9m88fLU&L(j*u#1yKNl8HAl@b|ydXD7NbDnj;^zOkGS@ zyN^@o=;)1ZQWYen$+6hYD^S7Troxq|ra;=5{sYKgwamS)cv#)#rOnS>qPP2fUzhF% zho?)C9@;F(ByCR?b_upPQe$rdcPC>W(F|4W$m*J)s(od?M_RS|PzyU*-x7Nr9(U#B zqe5KR-VSONSCD;mblrqX!=j`;jkVLOXdi3CwY+tdtaVf|;sMaE*ycL->!***Z)%ym zpo^zokL<=4h;Xb5_Zn++NKaKnEGa`{7@2KkyK@PYKA9?#_J^sq-8fPo;ZFDjjoEE` zZ>7ctVZ<_rbJjBP@KZJPY)6$Ai;UZAyDGa@fA^!V)d&)i;&|ZwEB|?st37_vWpzTb&1csARCD#}+=g3`ylY4_EVEPyJ%-!87SELcjT%nWoOZWH1~8l~)Nc9eYO zXnm+6Y{9TO>5;+e;&c|GA}7+7*3HMBlX3u{PR#x=9j(;UbrHc+$jnpHD=aZb8rP-D z(Hy3P0(kS#lqiDLteR*^w9+AsTjdpz9r9M?z*vRH@OOh)on;h4Wa|zxZjKC_v+}WZ zy1c2FCoh>7Jf`a1(kES-Uu~xBB_uk%-{nhzHWgS4%H~h@G}t(Bs))D^OfY0v#dd?Q zlDxu* z4!nrG4&Uf;5_S-Ybu&T)b9X4R2LKw3?a9oI>y9Le&5dz%s26U3Nom4(2y5?|iR{h% z_D>iv8Z$djTZ}Olqjxeai--c!n{R7)xVgDstEwW^>YV1o&d~D-43ihCce3l~e5&0K z60xEWSUv&UXyeHbTKBsAZlBL-dMlq0rL?UF&F*cBp<%kZZ?py(g-t`9ypji*1@ zI$Zutm%6_#JRYx#c^efKvbso5Q~oOx^{c>>_32ZOwMAa4hw;Yzm{DGs?yz(EE4V2E z(y=7?Jnsfnq?#(6tzT|dk35GH7-XI`Rz&(s{9a0id4rI?YGM_<^iTcF`LG7rJcTlv zG)rSa>p$%150jR}i}21a*(Q;urt-<7GgP7pL=}Q$JeY7=-xS!d*Dsx#`sgivVZKt+ z_?J>tz{0qKJAsy|er?agT}AM9%AH!y^tg$W}7$N0rv14 zwE86sNMCzV!^6wVdozCsM$n!JhjI2iUh-|s_3#&|-=^xA_rIk<)8gSILB?*mu4%9Y z2k%^NXQVOH#)IIeHw_-AXLrkp+}c;I8b1G64*VdDpQFS$k;?A>(Y0>+-Ky|@gKN2n zkFQVey0fgTg0}0II@1}>qNoEL#`rKcD&^-fkvm~uDF-qs$!BCbR9V*9C%#md&|IFx z(N|%EmBGF~+J$a07)X?zjO>*A61M3GGe%!#h%XqH7WbKTA}&)LMOuZOo4p^FS1OWQ zyvuGNJfWA-E32q0eIvTA-eI_$Mf!`K-+1|OL6!w z&BMJw$9j2VuUG;CPAD@mg@_)_sms~h-7|CEcxG;*%;BVu13%5cYvxK9Y&Zl$PvbQf zyB;6)bT1y39BFn30(HB)rA*SGytfqXs$wxCLJua?faAP&mxaR372|1SWed+o(@r-G zTf$*)3Aht4te|nsZ0hV2Rl2Fl*&sc7$(0i*!Wdc&6*5a9Z|h?P`9i#hq!z%pfnL4A z8}FGzQ(G^~Zd_KWh_cT%JGbIXGHi|2Z~Q9j!z10EgdraKr+b0M8*^zl%}Xb1!&4Da zKm2q|S;$2sHf~=ho5K>2rA)1TFn_O>x$CO%&|`&TDQ5F*FRyhXhpDFS%Tw)IFzzf{ z|FCaFubjnGk{`O7y8d{VZjgMjogLvhU!%(7)uZTQrqOq#JxQ-1>{^R$5<5`i?gq9q zm6`j8V<$v?$L7kf7Qf3myUrYRV6~|IuqZAS$Kc)1Rg!W~y4+2rC1J0R`qXN)5t_CI z@mtuX4B9D*!mdRR+>FOs)uv%Az7m#F@=yWZmzvdD3W*?5JQ+}ZEyJ=~QbwogP#5y4 zjgzb;l0fN2vseo?cosQD5GJ{OwJxR;|`9?UKJzmlo(h6zQgD+9>*2+1kKp zOrSmFPir+P)U>t1z^ftWC$!;1dvqMb8>1Z*r=`MIWMaimBbS9&3#k~p8Wq=0&2}^N zHhM_4yJT|OZQ<-TP%}V=6kEYqk2`v_k|V{AN{H=kAN1~;PZ=yWoNDjiO`jzZ(+6p5 zrD+8^O?sY1p5=n5MMP4fi~JgE)Xa-ZuUmBdkO-v{(;)yR5_syE)dw&9xVRh`yfm`zFbTBU z-jaK9*nSg?N|=)I*Kd-PLJdG*p7FLFbGe@Q21EEX7_%jD$% zWpv+;hGI%4)1v@hTE404@k4BCmWNZnfz<+-9^Z9j77t_;;XeOrT@b90=P)zs_0gCjp!eT;-66sBnJ4EHi4Gro=-t-ugDxnPSPXk$lMTBfwpUPM zHQlMqaA~q>Hw3^{}D;~C{*X??I zYMmvHsu>5wyYFvaPKn#&J=l-mG(Y5&FGgcOFs!_%_1`dKH)%RRX^xyA+fQ44Uq2M) zm@+!UxoY(YbQ|cNxj%ZewsWw&KvI1+q^r=;H~XMQM_PI==9^ij46Yp7*RChk=+wbZZ!7}`pY4x~=n@L;u#`W;Xp+AY#$&ZE~Kq9BX67vNr zJ0JCeW{XkLEh)1Kw;^FCT3<;04iDJ^7LuTBopmnh0ld=fUq0?XD(C*`@#5ddm<{w> z&Y!waaoDC1vrM`UVnHNYv}Y>t!h~@`Lvbi1Y;>xQs-^SCM;FDNZk7G5gl+{&MuN@F z&F$0bEQk`gj03dQ#RFh2WQXThYg03#WzkTc_ zmzO_$>%8k_tz6NW$saL+zdM@0#>}duor@sN?o?W$Cq}(`v4-8PA*R7MVhSkA3Cc?l zX834RiDOI7!)w6%^#@rs;-~k(p)z+(6>DZIfBNBoLj8$_NjB=$HKEY~-q=C?mB;ez zY2W!71%64w&VjQpcjqGU(`>I#U6WcZ2`jqb!Xe3-2Yqd4=!OE^tNGMum-Wno#pM-( zuIy76$NP>(C)x2V`I{EFT@=p=W-m6EZyxMo4k5)`R~L4$91&;F(}pbOTjKjXoQ1jL z>%PKZ`&j#?&#!*wUphV;XWm1jWXFuIpNw*Qxg%fomvFs&et7tpx%H{M&@DRvVMKhi zGU->f`}vO7k&G+Su^E>FOYNiZtTkb>5UbQ<>7K2qMQ5`Bb4SC-*jWymxXHVe6`^e9 zkghcd;3(KJC@S9D>6Q5Biqed;SA4@*noa9`?a{o1T~g@}tmYGOGmr-f*SiHcBlDo3 zsBq^IEjZYF%hi8hX7_q3b1J$^7KliAg)CA2t~VTfSk~h?T*8J&4qI7&u9?bizAKDNC z81D6$0c&jQ+%GvyPR}GNa+VC3Sy+z3GY6{>2#R#Y;g{^yc{~*M!!1%H2Gt%WEN3b(#j9U(CwN3NP%0RU(A&;e}UELmmJEAIwYyd z@9_0peZ?Z!c=XD{gm^+w&I7r!a9qR!vUsd&d8C_;m0JpZ;2HP9cPb(NAYk%FyRE2^ z|723LUX-0gdY7L{Ns~`)zgML(bDdNBUPluN=YdxUsgJP zx_-;SJ}tk!8N6Mp2II)ve>9n>Tn27XM&;z@evy@1&@4b$HqjO7eR{J#H9p>8&KLTI z`YMQ3Qpa2hNJm7p4CYopT+B%>kc_87ap=j)0z4t+PFg0l<~cDH{|5N}HWLU zDp7p3bpPn1_)WThSo}11u|wR9y9wUCCxI`;WUw;Enm6tAo*pP|AILC)Nza1(iB#yx zl!Qc>#OdnJDS}Uxg)O?y8B0s%1_|O6NjI=GDEUGu64FBN7Ktf7Wv}~8?=%zqTH(j1 zD#HKMhxV7e2xun^*x8|qwf1C)m7Oy6bBSx+7YNBS)>nAtFs~MC?-_GM6hd$H8s zlXN!oO2LPg&-%{O2x&6c3ce`8rUtKv3*HDBF4N>g58c_fHJu$KT}pdipnk zG?-q%W=Mv+rvW_+sjXIP-&=9rqk!p5Pe*S#9U;|LAh4N}ur}L@^j-b58ZARj{7J-l zA+T=Ce{Ooj;JXXax52bv>arFL78dwXFTmMqEWuGxIi&qdD>6NjX^%<_@hlBU_Sam| zzd8maf$)klK%OAJrdtrt%ghHu}u6ve~nW4Z$N3l^TDY z&?o~;4BxnbF{WAxviiR>=Jm%9q&6i0dz$T9hi?2sMGU9QDBN+a06qG(+Hb0lm1_K< zyI>RWG51yq97k*>xqdI_^ymkS-g6+d+V_+f^}%`ZMBV*xlybglW2M{wniqW5?QfwV zm#15%S%iy8Kv zc$>I12)pfL-_q07Uu`s||FQ3XBf-;n;~~pe7AO=XdOMqGxjY(AAzsJ}zsn=O`KbA# zm${(0N!lO@^7r5LFaMMT!@T*?M7G=zsT%<|3aj)?Ms8fxg7%rhUkmV0;wGb|aJrXoqDGda;{5QxSVqyXfPyHQ(8x@#Ks{dwnq-nm#aF75m6F= z6cQ(|(?DH4=%DRGedix(h}$4&i!Vclc*m>P?lpTrj@aRz_-A z&I%++VE@f8YZ~ou106d>+DE@6VXf$*L?!+*xgn>9>F=&2JG%}3ZIWav=%05a{bcz2 z=RK8(+k2n&{=y)(fDsNCxS!KG!JY{G9vJZM1sW<*`0;;q!9VNs+pzad@ro zhWGiS%U>$u%n28i+71Hc`kpPPy}Up}8uq6lleKdp5J*0dHv$cgNn;s?o;j;`n1tSjff87{&qiRH3G zR>5!31%L+C*2x&hP`P@2 zr05U`$!aupxUikwuby(r!`ZhTQA{@SMp?m37_P3ah4a;+yR~!><2nz-r*=NI@ZZU9 zG{KgBD!ed%P_o1;Dtr9Ul8A^%0UTV4^_%WNzsLLX(wux8%Yr_BM?XnJ<1p}h_RoLh z^xs4ZTDMVP+}&n{A6~X;)P4TXPAq+4Tx!`Ry6frdeP14LHyWp#HasPTO2JZB>ax`9 zJYPv?1hR=PgkrR-BU70oTi)I@Z!b%4(op|czr|*9xjz<@p8PV<`92-^m)*_Pv4~6S zQO3`{{ZE7GvrLTdp{Fdwj)$eBQ@iP)Nv68mj)*bf%vOf(BU`RL7^e(jNsy78m^*i#4S$vi<=uU_NMqRqMYw}q80HS3AN zC99i3bTaT?Y8*%cS48}LOf)O4$65BVHc76ok?M4nh=oW$#V^Sdp4&H{__ zoLJ*cqW`tIiFN8H4ZY1OA3nd~mtK_qe1(05D~SMI0Nv-}BAr=Nhu7-peZHoj+>n-) znQy=^`7RV-CJHdFa(S|xc!>&xA}bS4 z0@uY6@Uwm7^ToO-Fs(GN0qeWN%gw;c&X9t+DV z$ca`unwmX$pgMz4OUzOM2?SJbAkOI z!wZ2N@1R#3y%YBf3pmQZicWOZ-)*Shk0}qDU2yo;TkH zq}DLj4|X$mhSle<`71GxkN+kdTGrv*W!k9y z)K8S)Og~QZ=AO;+pElCpkLP!C%wNZq`0O}?*DDB1=MJY*qRkTc5wXrl#62(O6$_nW`J2T^Ymo4@znELy&zk2ulwe=vvMKf;hoL*!;j0m&1KCz8kykuTT@u{ zE$%oA(2Lh;g06u8tC5v_QKw(n&1bFFLkjMgR>We7_Kgv525lc6)jS;R8aH$sX#tR1 z+rAwwdk7D6WOT#4Dv?6Rksk$s6kf=BL23@>n{rD_A5G}$%J4?0-0iUzjZN=47NW{|p| zFep`iO8_dTwne6nMCCna-#$N>xQBRtK>>ZgQG^~v;jA?xj6WpxixA~91=<=bX)5_5 zoqtDC9fqr)p~$!&AxAMQgq4+Za4-6KP%6xq*31vdE4o>&a@?QSvo+E{n~~l~=o$mj znCED#iBSN;6*7E?&0!bMX?!QAMx>g!Gp;tZFE01}yM|lueYbPt`+ng#K5^R>;{*Tz z`0P6fP0k_o7QcoCTxRNcUn<#Ant9(y&AB4({Tv+3OL1}}d0AH!>|ukJ;nyKAG$7B| z*+Y9Lm97oO`u`=d1CRX+E**rp^n5k-pbdXPFA-Z zaoWB)%4%R^Gmv>a=QHOu@OEpyD!2q*q9D?rf)Le%3>Nq}36(YP`Jr2JiS*5U=yGy$ z3tgH>x@jdIRBigB=Yi_Sgcyg@gEy&l1|yl0YcX+fjtgxc*`|pT32Y1&WMU{xww#|l z94_$Wm6er!!pCs;&`*?-7QQL^cp+WFQ#@z^?(Zr9^;n)^Td2GrLlkpy9I2nHfN;x{}kgKx^IyKfZ_$@(xXo%9n#7{Qt-dIhJP`dCfh9VwGNFVYADpvhPipr=$``kLug?!c!5|-@>V}6C z6GDZyNWGgWbW$Cs!j!tt9>)H1d%&2bO0zbtlQPmd8mWOjP?Uh}{)_EvI&a=~hC~XV{+> znD8U?Pc8q@_AbMO7qOu7-jD_?$EV5v@67Q(j?yVp7D$6`e(v8V4?Y?R0bwX=}u9W|0)qj1P@B!DL<*_E{?3JGM30NCVq1F&nsZ{ykW4$hbVe;180W^dngG-R3r?~hw<;xO6zk*wQpPJce`|2+NAw}qcE zlb#n-(FuNj{Wk&~)e&YrLpZngD=B`!{O?y5E+$Q;gTS@UW3Q1$VMx{3w+>B_ zcPh~EKIs-C;mQ2Ry-VdRS^fnVy?|&k)PUu)qtHLTk%RE4WVr3Y|NfT){6F83o_2>f=X^wD`!J6-$kbU5_V^e^y-0+FMl_*9|vZ6A&&{TwrCn_3p^Oa4uqa z`SJ+ihT~RZd=ruQ$74}E=&eVY=7|yfLBs#L1vfpIf>ut}1{Aos4=so{eTZ|4mxjsU zhYnSs#tE=(<~6hl;}+1#rF zJEk5O8}IhbZcWx2`l_Sm_koL7)u74f0}0R!2yj@W?&tuUbabto@KAS*uaN+WZMq;< z=jwp8C06c>Q8hq-)pdGpZJ9Bk9B8~}Fz3^Xm-`v ztQ~T?{fg5fT4BEPJul7nv!fgS1Q_9An@W3F?Rs9q+vMz+jsm9bd)5NxTUzFzv|Ca? zE1dWDCq1^IWVZcf2`6ri@P@-(3ft5wr|YygJ}EFrp+=8AzuG>~Vy!P+ zeARt&VqqS=lTy^N1D1}C5Y-tfNPg7G-q@@W{iIsm;7IL3b)B$BM2%}Lz%+aeR?<1~ z4Y(-^-<+EjOLttjF@*DzDOevE<-1LT&(?ow#y8eo_H`wgD;Yj|>oz02+t-ncrDX}}Fom^<*{7Y9*Vpd= zJO_)wC0c1#;|rj)aAWTFkr{omx^l|g-Sg8^f$r}drzkV(@NTDc@belwSb+zkcCpcU zvu1T~vK9{U_1y;BbsG6B7zs21jlAv0z=-qQ{ibNwS>F|>by>6b^ z7oFFucCGztIIGvhy~}>Q{QQd(m~&d3dd?vo)iN>vIkBwO4$YpM{5V#8 z0nFt{(B!jy`I4csQUHyG6}gv2LzGL_cimdEw0Ri(W$DSM&!2w^Plw2ahlO!G_Aj>3 zx!(YVLVpeoDahN9@$>V?m}^)(yS~0=dVRCa#K!is8cCMv?S1*PzxS1o&jYl$RRMht z4q_CP1wGK4DG0L!B7;^~O)YgY8@#<4-MJHlE>eIBpMn_-R&qjYzLEyvC!MbqM< z+xnkp4YQESW$|Lj+#{kU`y|Xwl?&|K2nh|7%_es(yV8AG9A*nyjBGk*;#Bdo34f*^ zRJE`P@m4bsNl)1B0 zPyAN}7&vGgjf7vGev3p0fHrg$0joOM`{%Uq3LE6p(#6JySORVVT%p>PYi;V4*unR6 z$~wGXRedJ5wd&~Xq8O_K}p{&WYL4M&53Kt$U-Uf_&Xjb>rMW+BTX9m0oeBGeo~bK zZ5f4YF;QWoZ9@&lY93d zCp}puuFADb7T)j3=8j=JKQ3lIej4!q7ZyODOKTBmq|#e^$Tk-Dy+EZV^EtX&OGVgx z=#>?sH3cH_7JfIc>oX&Ra4)1Ofe52uPb#9n@P%Lry#+r3FB%O_pkUyoj-}&>n2LvG zs2KAPdOQBv20anmx&L+c3mGt@P!g&_*4aWJ%A5Xg-{{|zMgNZtM4OCDUQeMPy(*5I`OKJ)Yc@b; zzI~!*#DV8@i)Us?0P?ki_+Z$30y^bR+r{Yi6i46TLODsI6*4PCHrIG$^vh^`$g@HP ztW|-6tYPbBRi}&)lb-48b6aVvMHFdI?XK})L02+bpk=bEbw(uj#mqIAS!3cST#gYE zkp)IUQgWOVYu_z==Q(*>)>4$Ls1_w->5dJ(*i+y#tx#?+F~C%K5&DI4`R-AXZdXB$ zt6@0NXxOkpP$yNYFW;+m3;$2yKN=J<+fT`P+xznYL>U^?3bGw@-<=%Y?dM4cs6?L0 zMANYMcn=e1pT4V=Q{!$lSwi?LI2feMSnQXjG-GBF_HJ!jT^mQZ?Dm6%IP%? z?1gL*p6e6thdns16t1&RI=Z{t78e)SN_F9uMBh9Xo9I`+^}lMgu7^<5eqN{c%pS^a zS0sH?XydE_t9!M>mk*~+9NaoKJMEe zF6t?W<{PB~hYgxMdw%5Pb3U`$79Wp}eBtzx$fn=$!y6ea<;lel#F;g+q$bw<>tzNN zk9#6lehaCWqtYj7t%_xtpY9axrnv7@CL0>m*hqE_88EJ_xQsg+(dWX_Lw+8)2s)1b zEM4^0Q=;G@`i>nfB;Xn!ZjIzlXw6UvW$l6P@&e}L-Wy!d31Tdrqb0O%_&02P+*pI~ z*Ucj_%h-50MJLsQ%>P3_7G|IwFi1u>D!mM#nm=(29X>=>=`424fXc<{r z%D4vO(kEwWl?a({;M<8P#a#(4FpYayYrUHbulah(W$U z5zA4-zNy>{Y`ZDQe2}CmB3CKby62HG^NbbfJLr^$%e;{?1>%Xwc6WE0AY{ec`uKfV zgDGsH!7(&4^c74>^0nTK96*?f?i5NqTGW?hQo?Id} z4KAaojtj%JxqdYM zI2gl-RjHU6#Km#ZCK8*+y*$ey^oi?xAe- z7|hf2Q+Sq;`lnnTBC}+-v+cvpaC}A{ZZ@_q==h^73+eL%xN}D%2lgO&%=fEDM46Yd zks=2CGw1s=6V{(}`HFoteFq}oMIgZ1xAm1D%delNp1(7XmD|H%Ha@a_qdI=WFwsvBI5aAlYkJllhd#G#C4f}NI^gEy ztT?<_YswY&wzR3`8ail)oPh}7!}VrF3kVR6XK#^SyPmURj*d<9K4I-w)vL`j2J{E# zgXhvEW)l>1n{H*TGq&)W0mC}sj9G`w>q)!a(kA#e^qhX63zSyJmvQ4&1-$wtIC!o< zX}eliI|y+zvz@nFE!FRo-=AL*OK{SO2>L_kMY&>32wRn*tiRr{yF{!auiM7z&J|Y= zR|k^+U8>x+6H5lAoV|oriQEw28foO zK7`n%%XMEW*UpVsyE{zRQoAmvUFo0z9Y4-dcvqFiJ}CsJY+sw zFL86&M}>r7lZJ{;E)Ed{YY|xO*Gh)qJnR}w4|X~E!SnPZBuumAk}I~q8EsLDBEM$* z>>Z4`OidQkaVeqnBFO*tWE1c>hESA z2_!-Ujv0QE!#($2<*r>F$e=1gl1_GZGZf=ZRo0z�{% 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