From f54a220d8f3c8649b84188c7e2a6dc2ef3be6f4c Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 31 Jan 2019 11:36:40 +0100 Subject: [PATCH 092/185] Corrected coreapi CLI code example generation. (#6428) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Remove “> “ when rendering template. Closes #6333. --- .../templates/rest_framework/docs/langs/shell.html | 2 +- tests/test_renderers.py | 11 +++++++++++ 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/rest_framework/templates/rest_framework/docs/langs/shell.html b/rest_framework/templates/rest_framework/docs/langs/shell.html index 24137e4ae..e5f2a0322 100644 --- a/rest_framework/templates/rest_framework/docs/langs/shell.html +++ b/rest_framework/templates/rest_framework/docs/langs/shell.html @@ -3,4 +3,4 @@ $ coreapi get {{ document.url }}{% if schema_format %} --format {{ schema_format }}{% endif %} # Interact with the API endpoint -$ coreapi action {% if section_key %}{{ section_key }} {% endif %}{{ link_key }}{% for field in link.fields %} -p {{ field.name }}=...{% endfor %}{% endcode %} +$ coreapi action {% if section_key %}{{ section_key }} {% endif %}{{ link_key|cut:"> " }}{% for field in link.fields %} -p {{ field.name }}=...{% endfor %}{% endcode %} diff --git a/tests/test_renderers.py b/tests/test_renderers.py index a68ece734..8518a3f7c 100644 --- a/tests/test_renderers.py +++ b/tests/test_renderers.py @@ -9,6 +9,7 @@ from django.conf.urls import include, url from django.core.cache import cache 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 @@ -827,6 +828,16 @@ class TestDocumentationRenderer(TestCase): html = renderer.render(document, accepted_media_type="text/html", renderer_context={"request": request}) assert '

Data Endpoint API

' in html + def test_shell_code_example_rendering(self): + template = loader.get_template('rest_framework/docs/langs/shell.html') + context = { + 'document': coreapi.Document(url='https://api.example.org/'), + 'link_key': 'testcases > list', + 'link': coreapi.Link(url='/data/', action='get', fields=[]), + } + html = template.render(context) + assert 'testcases list' in html + @pytest.mark.skipif(not coreapi, reason='coreapi is not installed') class TestSchemaJSRenderer(TestCase): From bd9a799e166b1d44c9db444a95765ad0dce2aa8f Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 31 Jan 2019 15:28:01 +0100 Subject: [PATCH 093/185] Fixed SchemaView to reset renderer on exception. (#6429) Fixes #6258. --- rest_framework/schemas/views.py | 8 ++++++++ tests/test_schemas.py | 10 ++++++++++ 2 files changed, 18 insertions(+) diff --git a/rest_framework/schemas/views.py b/rest_framework/schemas/views.py index 845b68ea6..f5e327a94 100644 --- a/rest_framework/schemas/views.py +++ b/rest_framework/schemas/views.py @@ -31,3 +31,11 @@ class SchemaView(APIView): if schema is None: raise exceptions.PermissionDenied() return Response(schema) + + def handle_exception(self, exc): + # Schema renderers do not render exceptions, so re-perform content + # negotiation with default renderers. + 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) diff --git a/tests/test_schemas.py b/tests/test_schemas.py index 8e097f9f4..d3bd43073 100644 --- a/tests/test_schemas.py +++ b/tests/test_schemas.py @@ -1304,3 +1304,13 @@ class TestAutoSchemaAllowsFilters(object): def test_FOO(self): assert not self._test('FOO') + + +@pytest.mark.skipif(not coreapi, reason='coreapi is not installed') +def test_schema_handles_exception(): + schema_view = get_schema_view(permission_classes=[DenyAllUsingPermissionDenied]) + request = factory.get('/') + 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) From 190f6201cbbac18803479020dae922c5ae3e90f2 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 31 Jan 2019 15:59:19 +0100 Subject: [PATCH 094/185] Update Django Guardian dependency. (#6430) * Update Django Guardian dependency. * Skip testing Guardian on PY2. See https://github.com/django-guardian/django-guardian/issues/602 --- requirements/requirements-optionals.txt | 2 +- rest_framework/compat.py | 4 ++++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/requirements/requirements-optionals.txt b/requirements/requirements-optionals.txt index cd0f1f62b..c800a5891 100644 --- a/requirements/requirements-optionals.txt +++ b/requirements/requirements-optionals.txt @@ -1,7 +1,7 @@ # Optional packages which may be used with REST framework. psycopg2-binary==2.7.5 markdown==2.6.11 -django-guardian==1.4.9 +django-guardian==1.5.0 django-filter==1.1.0 coreapi==2.3.1 coreschema==0.0.4 diff --git a/rest_framework/compat.py b/rest_framework/compat.py index fffc17938..5a4bcdf66 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -161,6 +161,10 @@ def is_guardian_installed(): """ django-guardian is optional and only imported if in INSTALLED_APPS. """ + if six.PY2: + # 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 From 2b62941bb4d48e27960690bdea1a343177dd5d0e Mon Sep 17 00:00:00 2001 From: Asif Saif Uddin Date: Thu, 31 Jan 2019 21:50:36 +0600 Subject: [PATCH 095/185] Added testing against Django 2.2a1. (#6422) * Added testing against Django 2.2a1. * Allow failures for Django 2.2 --- .travis.yml | 4 ++++ tox.ini | 3 +++ 2 files changed, 7 insertions(+) diff --git a/.travis.yml b/.travis.yml index c0373077e..c9febbdf9 100644 --- a/.travis.yml +++ b/.travis.yml @@ -12,15 +12,18 @@ matrix: - { python: "3.5", env: DJANGO=1.11 } - { python: "3.5", env: DJANGO=2.0 } - { python: "3.5", env: DJANGO=2.1 } + - { python: "3.5", env: DJANGO=2.2 } - { python: "3.5", env: DJANGO=master } - { python: "3.6", env: DJANGO=1.11 } - { python: "3.6", env: DJANGO=2.0 } - { python: "3.6", env: DJANGO=2.1 } + - { python: "3.6", env: DJANGO=2.2 } - { python: "3.6", env: DJANGO=master } - { python: "3.7", env: DJANGO=2.0 } - { python: "3.7", env: DJANGO=2.1 } + - { python: "3.7", env: DJANGO=2.2 } - { python: "3.7", env: DJANGO=master } - { python: "3.7", env: TOXENV=base } @@ -37,6 +40,7 @@ matrix: allow_failures: - env: DJANGO=master + - env: DJANGO=2.2 install: - pip install tox tox-venv tox-travis diff --git a/tox.ini b/tox.ini index 968ec1ef1..65b941628 100644 --- a/tox.ini +++ b/tox.ini @@ -3,6 +3,7 @@ envlist = {py27,py34,py35,py36}-django111, {py34,py35,py36,py37}-django20, {py35,py36,py37}-django21 + {py35,py36,py37}-django22 {py35,py36,py37}-djangomaster, base,dist,lint,docs, @@ -11,6 +12,7 @@ DJANGO = 1.11: django111 2.0: django20 2.1: django21 + 2.2: django22 master: djangomaster [testenv] @@ -23,6 +25,7 @@ deps = django111: Django>=1.11,<2.0 django20: Django>=2.0,<2.1 django21: Django>=2.1,<2.2 + django22: Django>=2.2a1,<3.0 djangomaster: https://github.com/django/django/archive/master.tar.gz -rrequirements/requirements-testing.txt -rrequirements/requirements-optionals.txt From 63e352586b679d554e1e9ef708e153d858e7e3bf Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 31 Jan 2019 17:16:43 +0100 Subject: [PATCH 096/185] Drop testing Python 3.5 against Django master. (#6431) Not supported in Django 3.0. --- .travis.yml | 1 - tox.ini | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/.travis.yml b/.travis.yml index c9febbdf9..796ef0502 100644 --- a/.travis.yml +++ b/.travis.yml @@ -13,7 +13,6 @@ matrix: - { python: "3.5", env: DJANGO=2.0 } - { python: "3.5", env: DJANGO=2.1 } - { python: "3.5", env: DJANGO=2.2 } - - { python: "3.5", env: DJANGO=master } - { python: "3.6", env: DJANGO=1.11 } - { python: "3.6", env: DJANGO=2.0 } diff --git a/tox.ini b/tox.ini index 65b941628..cf6799a0a 100644 --- a/tox.ini +++ b/tox.ini @@ -4,7 +4,7 @@ envlist = {py34,py35,py36,py37}-django20, {py35,py36,py37}-django21 {py35,py36,py37}-django22 - {py35,py36,py37}-djangomaster, + {py36,py37}-djangomaster, base,dist,lint,docs, [travis:env] From 7310411533873717305f08fcc5d45426cb0f01d9 Mon Sep 17 00:00:00 2001 From: Daniel Roseman Date: Fri, 1 Feb 2019 18:50:27 +0000 Subject: [PATCH 097/185] Updated example models to use `__str__` in relations docs. (#6433) --- docs/api-guide/relations.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/api-guide/relations.md b/docs/api-guide/relations.md index 8683347cb..8665e80f6 100644 --- a/docs/api-guide/relations.md +++ b/docs/api-guide/relations.md @@ -46,12 +46,12 @@ In order to explain the various types of relational fields, we'll use a couple o unique_together = ('album', 'order') ordering = ['order'] - def __unicode__(self): + def __str__(self): return '%d: %s' % (self.order, self.title) ## StringRelatedField -`StringRelatedField` may be used to represent the target of the relationship using its `__unicode__` method. +`StringRelatedField` may be used to represent the target of the relationship using its `__str__` method. For example, the following serializer. @@ -510,7 +510,7 @@ For example, given the following model for a tag, which has a generic relationsh object_id = models.PositiveIntegerField() tagged_object = GenericForeignKey('content_type', 'object_id') - def __unicode__(self): + def __str__(self): return self.tag_name And the following two models, which may have associated tags: From 7c6e34c14f54f1bf0d46ff34dc9a823215987c95 Mon Sep 17 00:00:00 2001 From: jhtimmins Date: Sat, 2 Feb 2019 05:49:58 -0800 Subject: [PATCH 098/185] Fix typo: 'what' to 'that' (#6437) --- docs/api-guide/requests.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/requests.md b/docs/api-guide/requests.md index 35b976c66..28450f082 100644 --- a/docs/api-guide/requests.md +++ b/docs/api-guide/requests.md @@ -50,7 +50,7 @@ The request exposes some properties that allow you to determine the result of th ## .accepted_renderer -The renderer instance what was selected by the content negotiation stage. +The renderer instance that was selected by the content negotiation stage. ## .accepted_media_type From 3c5c61f33bd451496385aec237cb5502db8d6a6a Mon Sep 17 00:00:00 2001 From: carlfarrington <33500423+carlfarrington@users.noreply.github.com> Date: Wed, 6 Feb 2019 09:35:04 +0000 Subject: [PATCH 099/185] fix for a couple of missing words (#6444) --- docs/api-guide/permissions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api-guide/permissions.md b/docs/api-guide/permissions.md index 8a4cb63c6..e04b1199b 100644 --- a/docs/api-guide/permissions.md +++ b/docs/api-guide/permissions.md @@ -10,9 +10,9 @@ Together with [authentication] and [throttling], permissions determine whether a Permission checks are always run at the very start of the view, before any other code is allowed to proceed. Permission checks will typically use the authentication information in the `request.user` and `request.auth` properties to determine if the incoming request should be permitted. -Permissions are used to grant or deny access different classes of users to different parts of the API. +Permissions are used to grant or deny access for different classes of users to different parts of the API. -The simplest style of permission would be to allow access to any authenticated user, and deny access to any unauthenticated user. This corresponds the `IsAuthenticated` class in REST framework. +The simplest style of permission would be to allow access to any authenticated user, and deny access to any unauthenticated user. This corresponds to the `IsAuthenticated` class in REST framework. A slightly less strict style of permission would be to allow full access to authenticated users, but allow read-only access to unauthenticated users. This corresponds to the `IsAuthenticatedOrReadOnly` class in REST framework. From abf07e672e94f2ce7d42e690222f527ba918ad40 Mon Sep 17 00:00:00 2001 From: Tanner Prestegard Date: Wed, 6 Feb 2019 14:26:09 -0600 Subject: [PATCH 100/185] Fix throttling documentation for specifying alternate caches (#6446) --- docs/api-guide/throttling.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/api-guide/throttling.md b/docs/api-guide/throttling.md index de66396a8..dade47460 100644 --- a/docs/api-guide/throttling.md +++ b/docs/api-guide/throttling.md @@ -82,8 +82,10 @@ The throttle classes provided by REST framework use Django's cache backend. You If you need to use a cache other than `'default'`, you can do so by creating a custom throttle class and setting the `cache` attribute. For example: + from django.core.cache import caches + class CustomAnonRateThrottle(AnonRateThrottle): - cache = get_cache('alternate') + cache = caches['alternate'] You'll need to remember to also set your custom throttle class in the `'DEFAULT_THROTTLE_CLASSES'` settings key, or using the `throttle_classes` view attribute. From dc6b3bf42e53c6bfdb597a67de931913c8bd0255 Mon Sep 17 00:00:00 2001 From: briwa Date: Thu, 7 Feb 2019 16:10:11 +0800 Subject: [PATCH 101/185] Fix tutorial instruction to also add pyyaml (#6443) --- docs/tutorial/7-schemas-and-client-libraries.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/tutorial/7-schemas-and-client-libraries.md b/docs/tutorial/7-schemas-and-client-libraries.md index 412759834..203d81ea5 100644 --- a/docs/tutorial/7-schemas-and-client-libraries.md +++ b/docs/tutorial/7-schemas-and-client-libraries.md @@ -29,9 +29,10 @@ automatically generated schemas. Since we're using viewsets and routers, we can simply use the automatic schema generation. You'll need to install the `coreapi` python package in order to include an -API schema. +API schema, and `pyyaml` to render the schema into the commonly used +YAML-based OpenAPI format. - $ pip install coreapi + $ pip install coreapi pyyaml We can now include a schema for our API, by including an autogenerated schema view in our URL configuration. From 9f66fc9a7ca51ad5535cb48e199cf2fbe9eecec6 Mon Sep 17 00:00:00 2001 From: johnthagen Date: Wed, 13 Feb 2019 19:00:16 -0500 Subject: [PATCH 102/185] Fix typo in caching docs --- docs/api-guide/caching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/caching.md b/docs/api-guide/caching.md index ff51aed06..5342345e4 100644 --- a/docs/api-guide/caching.md +++ b/docs/api-guide/caching.md @@ -13,7 +13,7 @@ provided in Django. Django provides a [`method_decorator`][decorator] to use decorators with class based views. This can be used with -with other cache decorators such as [`cache_page`][page] and +other cache decorators such as [`cache_page`][page] and [`vary_on_cookie`][cookie]. ```python From 3b996c6dc27c95749e1c3c2028e3d6adf3993052 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 14 Feb 2019 12:01:36 +0100 Subject: [PATCH 103/185] Correct 3rd-party-packages link in issue template. Closes #6457 --- ISSUE_TEMPLATE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ISSUE_TEMPLATE.md b/ISSUE_TEMPLATE.md index 8f2391d29..566bf9543 100644 --- a/ISSUE_TEMPLATE.md +++ b/ISSUE_TEMPLATE.md @@ -3,7 +3,7 @@ - [ ] I have verified that that issue exists against the `master` branch of Django REST framework. - [ ] I have searched for similar issues in both open and closed tickets and cannot find a duplicate. - [ ] This is not a usage question. (Those should be directed to the [discussion group](https://groups.google.com/forum/#!forum/django-rest-framework) instead.) -- [ ] This cannot be dealt with as a third party library. (We prefer new functionality to be [in the form of third party libraries](https://www.django-rest-framework.org/topics/third-party-resources/#about-third-party-packages) where possible.) +- [ ] This cannot be dealt with as a third party library. (We prefer new functionality to be [in the form of third party libraries](https://www.django-rest-framework.org/community/third-party-packages/#about-third-party-packages) where possible.) - [ ] I have reduced the issue to the simplest possible case. - [ ] I have included a failing test as a pull request. (If you are unable to do so we can still accept the issue.) From 606dd492279a856fa1eaf3487c1e66b36840a9c3 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 14 Feb 2019 08:48:36 +0100 Subject: [PATCH 104/185] Update tox to use Django 2.2b2. --- tox.ini | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tox.ini b/tox.ini index cf6799a0a..4226f1a92 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.2a1,<3.0 + django22: Django>=2.2b1,<3.0 djangomaster: https://github.com/django/django/archive/master.tar.gz -rrequirements/requirements-testing.txt -rrequirements/requirements-optionals.txt From cb4cbb61f259b1fad659c714d64681d5add76c10 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 14 Feb 2019 08:50:27 +0100 Subject: [PATCH 105/185] Fix search filter tests against Django 2.2. Django 2.2 enables foreign key constraint checking on SQLite. --- tests/test_filters.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/test_filters.py b/tests/test_filters.py index a7d9a07c1..2d4eb132e 100644 --- a/tests/test_filters.py +++ b/tests/test_filters.py @@ -221,7 +221,7 @@ class SearchFilterM2MTests(TestCase): # ... for idx in range(3): label = 'w' * (idx + 1) - AttributeModel(label=label) + AttributeModel.objects.create(label=label) for idx in range(10): title = 'z' * (idx + 1) From 481ae69df3b59d628689b03bbf18c6002d11a073 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 14 Feb 2019 09:30:53 +0100 Subject: [PATCH 106/185] Add migration for CustomToken test model. Move authentication tests to sub-app to enable this. --- tests/authentication/__init__.py | 0 .../authentication/migrations/0001_initial.py | 24 +++++++++++++++++++ tests/authentication/migrations/__init__.py | 0 tests/authentication/models.py | 10 ++++++++ .../test_authentication.py | 20 +++++++--------- tests/conftest.py | 1 + 6 files changed, 43 insertions(+), 12 deletions(-) create mode 100644 tests/authentication/__init__.py create mode 100644 tests/authentication/migrations/0001_initial.py create mode 100644 tests/authentication/migrations/__init__.py create mode 100644 tests/authentication/models.py rename tests/{ => authentication}/test_authentication.py (97%) diff --git a/tests/authentication/__init__.py b/tests/authentication/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/tests/authentication/migrations/0001_initial.py b/tests/authentication/migrations/0001_initial.py new file mode 100644 index 000000000..cfc887240 --- /dev/null +++ b/tests/authentication/migrations/0001_initial.py @@ -0,0 +1,24 @@ +# -*- coding: utf-8 -*- +from __future__ import unicode_literals + +from django.conf import settings +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + migrations.swappable_dependency(settings.AUTH_USER_MODEL), + ] + + operations = [ + migrations.CreateModel( + name='CustomToken', + fields=[ + ('key', models.CharField(max_length=40, primary_key=True, serialize=False)), + ('user', models.OneToOneField(on_delete=models.CASCADE, to=settings.AUTH_USER_MODEL)), + ], + ), + ] diff --git a/tests/authentication/migrations/__init__.py b/tests/authentication/migrations/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/tests/authentication/models.py b/tests/authentication/models.py new file mode 100644 index 000000000..b8d1fd5a6 --- /dev/null +++ b/tests/authentication/models.py @@ -0,0 +1,10 @@ +# coding: utf-8 +from __future__ import unicode_literals + +from django.conf import settings +from django.db import models + + +class CustomToken(models.Model): + key = models.CharField(max_length=40, primary_key=True) + user = models.OneToOneField(settings.AUTH_USER_MODEL, on_delete=models.CASCADE) diff --git a/tests/test_authentication.py b/tests/authentication/test_authentication.py similarity index 97% rename from tests/test_authentication.py rename to tests/authentication/test_authentication.py index f2714acb5..793773542 100644 --- a/tests/test_authentication.py +++ b/tests/authentication/test_authentication.py @@ -8,7 +8,6 @@ import pytest from django.conf import settings from django.conf.urls import include, url from django.contrib.auth.models import User -from django.db import models from django.http import HttpResponse from django.test import TestCase, override_settings from django.utils import six @@ -26,14 +25,11 @@ from rest_framework.response import Response from rest_framework.test import APIClient, APIRequestFactory from rest_framework.views import APIView +from .models import CustomToken + factory = APIRequestFactory() -class CustomToken(models.Model): - key = models.CharField(max_length=40, primary_key=True) - user = models.OneToOneField(User, on_delete=models.CASCADE) - - class CustomTokenAuthentication(TokenAuthentication): model = CustomToken @@ -87,7 +83,7 @@ urlpatterns = [ ] -@override_settings(ROOT_URLCONF='tests.test_authentication') +@override_settings(ROOT_URLCONF=__name__) class BasicAuthTests(TestCase): """Basic authentication""" def setUp(self): @@ -169,7 +165,7 @@ class BasicAuthTests(TestCase): assert response.status_code == status.HTTP_401_UNAUTHORIZED -@override_settings(ROOT_URLCONF='tests.test_authentication') +@override_settings(ROOT_URLCONF=__name__) class SessionAuthTests(TestCase): """User session authentication""" def setUp(self): @@ -370,7 +366,7 @@ class BaseTokenAuthTests(object): assert response.status_code == status.HTTP_401_UNAUTHORIZED -@override_settings(ROOT_URLCONF='tests.test_authentication') +@override_settings(ROOT_URLCONF=__name__) class TokenAuthTests(BaseTokenAuthTests, TestCase): model = Token path = '/token/' @@ -429,13 +425,13 @@ class TokenAuthTests(BaseTokenAuthTests, TestCase): assert response.data['token'] == self.key -@override_settings(ROOT_URLCONF='tests.test_authentication') +@override_settings(ROOT_URLCONF=__name__) class CustomTokenAuthTests(BaseTokenAuthTests, TestCase): model = CustomToken path = '/customtoken/' -@override_settings(ROOT_URLCONF='tests.test_authentication') +@override_settings(ROOT_URLCONF=__name__) class CustomKeywordTokenAuthTests(BaseTokenAuthTests, TestCase): model = Token path = '/customkeywordtoken/' @@ -549,7 +545,7 @@ class BasicAuthenticationUnitTests(TestCase): authentication.authenticate = old_authenticate -@override_settings(ROOT_URLCONF='tests.test_authentication', +@override_settings(ROOT_URLCONF=__name__, AUTHENTICATION_BACKENDS=('django.contrib.auth.backends.RemoteUserBackend',)) class RemoteUserAuthenticationUnitTests(TestCase): def setUp(self): diff --git a/tests/conftest.py b/tests/conftest.py index 27558c02b..1c0c6dda7 100644 --- a/tests/conftest.py +++ b/tests/conftest.py @@ -56,6 +56,7 @@ def pytest_configure(config): 'django.contrib.staticfiles', 'rest_framework', 'rest_framework.authtoken', + 'tests.authentication', 'tests.importable', 'tests', ), From 59fcbc6dd553cbbbd60a3dd7c57fb72fde8e7f68 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 14 Feb 2019 14:29:57 +0100 Subject: [PATCH 107/185] Add migration for generic relations Tag model. --- tests/conftest.py | 1 + tests/generic_relations/__init__.py | 0 .../migrations/0001_initial.py | 36 +++++++++++++++ .../generic_relations/migrations/__init__.py | 0 tests/generic_relations/models.py | 46 +++++++++++++++++++ .../test_generic_relations.py} | 44 +----------------- 6 files changed, 84 insertions(+), 43 deletions(-) create mode 100644 tests/generic_relations/__init__.py create mode 100644 tests/generic_relations/migrations/0001_initial.py create mode 100644 tests/generic_relations/migrations/__init__.py create mode 100644 tests/generic_relations/models.py rename tests/{test_relations_generic.py => generic_relations/test_generic_relations.py} (63%) diff --git a/tests/conftest.py b/tests/conftest.py index 1c0c6dda7..ac29e4a42 100644 --- a/tests/conftest.py +++ b/tests/conftest.py @@ -57,6 +57,7 @@ def pytest_configure(config): 'rest_framework', 'rest_framework.authtoken', 'tests.authentication', + 'tests.generic_relations', 'tests.importable', 'tests', ), diff --git a/tests/generic_relations/__init__.py b/tests/generic_relations/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/tests/generic_relations/migrations/0001_initial.py b/tests/generic_relations/migrations/0001_initial.py new file mode 100644 index 000000000..ea04d8d67 --- /dev/null +++ b/tests/generic_relations/migrations/0001_initial.py @@ -0,0 +1,36 @@ +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('contenttypes', '0002_remove_content_type_name'), + ] + + operations = [ + migrations.CreateModel( + name='Bookmark', + fields=[ + ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('url', models.URLField()), + ], + ), + migrations.CreateModel( + name='Note', + fields=[ + ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('text', models.TextField()), + ], + ), + migrations.CreateModel( + name='Tag', + fields=[ + ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('tag', models.SlugField()), + ('object_id', models.PositiveIntegerField()), + ('content_type', models.ForeignKey(on_delete=models.CASCADE, to='contenttypes.ContentType')), + ], + ), + ] diff --git a/tests/generic_relations/migrations/__init__.py b/tests/generic_relations/migrations/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/tests/generic_relations/models.py b/tests/generic_relations/models.py new file mode 100644 index 000000000..55bc243cb --- /dev/null +++ b/tests/generic_relations/models.py @@ -0,0 +1,46 @@ +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. + """ + tag = models.SlugField() + content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE) + object_id = models.PositiveIntegerField() + tagged_item = GenericForeignKey('content_type', 'object_id') + + def __str__(self): + return self.tag + + +@python_2_unicode_compatible +class Bookmark(models.Model): + """ + A URL bookmark that may have multiple tags attached. + """ + url = models.URLField() + tags = GenericRelation(Tag) + + def __str__(self): + return 'Bookmark: %s' % self.url + + +@python_2_unicode_compatible +class Note(models.Model): + """ + A textual note that may have multiple tags attached. + """ + text = models.TextField() + tags = GenericRelation(Tag) + + def __str__(self): + return 'Note: %s' % self.text diff --git a/tests/test_relations_generic.py b/tests/generic_relations/test_generic_relations.py similarity index 63% rename from tests/test_relations_generic.py rename to tests/generic_relations/test_generic_relations.py index a3798b0a3..c8de332e1 100644 --- a/tests/test_relations_generic.py +++ b/tests/generic_relations/test_generic_relations.py @@ -1,52 +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.test import TestCase -from django.utils.encoding import python_2_unicode_compatible from rest_framework import serializers - -@python_2_unicode_compatible -class Tag(models.Model): - """ - Tags have a descriptive slug, and are attached to an arbitrary object. - """ - tag = models.SlugField() - content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE) - object_id = models.PositiveIntegerField() - tagged_item = GenericForeignKey('content_type', 'object_id') - - def __str__(self): - return self.tag - - -@python_2_unicode_compatible -class Bookmark(models.Model): - """ - A URL bookmark that may have multiple tags attached. - """ - url = models.URLField() - tags = GenericRelation(Tag) - - def __str__(self): - return 'Bookmark: %s' % self.url - - -@python_2_unicode_compatible -class Note(models.Model): - """ - A textual note that may have multiple tags attached. - """ - text = models.TextField() - tags = GenericRelation(Tag) - - def __str__(self): - return 'Note: %s' % self.text +from .models import Bookmark, Note, Tag class TestGenericRelations(TestCase): From 1c5466eae772212eaf1df1832870cf64b77c9dc5 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 14 Feb 2019 15:23:15 +0100 Subject: [PATCH 108/185] Remove Django 2.2 from allowed failure. --- .travis.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.travis.yml b/.travis.yml index 796ef0502..9543cb452 100644 --- a/.travis.yml +++ b/.travis.yml @@ -39,7 +39,6 @@ matrix: allow_failures: - env: DJANGO=master - - env: DJANGO=2.2 install: - pip install tox tox-venv tox-travis From 65f5c11a5b8aca5a6aca14c7ad85293fa941c37d Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 14 Feb 2019 15:38:21 +0100 Subject: [PATCH 109/185] Document support for Django 2.2. --- README.md | 2 +- docs/index.md | 2 +- setup.py | 1 + 3 files changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 02f8ca275..0309ee2bd 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,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) -* Django (1.11, 2.0, 2.1) +* Django (1.11, 2.0, 2.1, 2.2) We **highly recommend** and only officially support the latest patch release of each Python and Django series. diff --git a/docs/index.md b/docs/index.md index b5ef5f5a6..c74b2caf0 100644 --- a/docs/index.md +++ b/docs/index.md @@ -87,7 +87,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) -* Django (1.11, 2.0, 2.1) +* Django (1.11, 2.0, 2.1, 2.2) We **highly recommend** and only officially support the latest patch release of each Python and Django series. diff --git a/setup.py b/setup.py index 341f33990..96384ab46 100755 --- a/setup.py +++ b/setup.py @@ -61,6 +61,7 @@ setup( 'Framework :: Django :: 1.11', 'Framework :: Django :: 2.0', 'Framework :: Django :: 2.1', + 'Framework :: Django :: 2.2', 'Intended Audience :: Developers', 'License :: OSI Approved :: BSD License', 'Operating System :: OS Independent', From e8b4bb1471b9fbd5895a63cc23b3b53ff45b3df1 Mon Sep 17 00:00:00 2001 From: kuter Date: Thu, 14 Feb 2019 17:51:10 +0100 Subject: [PATCH 110/185] Added tests for generateschema management command. (#6442) --- tests/test_generateschema.py | 88 ++++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 tests/test_generateschema.py diff --git a/tests/test_generateschema.py b/tests/test_generateschema.py new file mode 100644 index 000000000..915c6ea05 --- /dev/null +++ b/tests/test_generateschema.py @@ -0,0 +1,88 @@ +from __future__ import unicode_literals + +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 +from rest_framework.views import APIView + + +class FooView(APIView): + def get(self, request): + pass + + +urlpatterns = [ + url(r'^$', FooView.as_view()) +] + + +@override_settings(ROOT_URLCONF='tests.test_generateschema') +@pytest.mark.skipif(not coreapi, reason='coreapi is not installed') +class GenerateSchemaTests(TestCase): + """Tests for management command generateschema.""" + + def setUp(self): + self.out = six.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 + title: SampleAPI + version: '' + openapi: 3.0.0 + paths: + /: + get: + operationId: list + servers: + - url: http://api.sample.com/ + """ + call_command('generateschema', + '--title=SampleAPI', + '--url=http://api.sample.com', + '--description=Sample description', + stdout=self.out) + + self.assertIn(formatting.dedent(expected_out), self.out.getvalue()) + + def test_renders_openapi_json_schema(self): + expected_out = { + "openapi": "3.0.0", + "info": { + "version": "", + "title": "", + "description": "" + }, + "servers": [ + { + "url": "" + } + ], + "paths": { + "/": { + "get": { + "operationId": "list" + } + } + } + } + call_command('generateschema', + '--format=openapi-json', + stdout=self.out) + out_json = json.loads(self.out.getvalue()) + + self.assertDictEqual(out_json, expected_out) + + def test_renders_corejson_schema(self): + expected_out = """{"_type":"document","":{"list":{"_type":"link","url":"/","action":"get"}}}""" + call_command('generateschema', + '--format=corejson', + stdout=self.out) + self.assertIn(expected_out, self.out.getvalue()) From de3929fb3334262bbf57980fff41d3f8c6f2b8b4 Mon Sep 17 00:00:00 2001 From: Rohit Gupta Date: Fri, 15 Feb 2019 15:27:02 +0530 Subject: [PATCH 111/185] Add Python 3.7 to classifiers. (#6458) --- setup.py | 1 + 1 file changed, 1 insertion(+) diff --git a/setup.py b/setup.py index 96384ab46..cb850a3ae 100755 --- a/setup.py +++ b/setup.py @@ -72,6 +72,7 @@ setup( 'Programming Language :: Python :: 3.4', 'Programming Language :: Python :: 3.5', 'Programming Language :: Python :: 3.6', + 'Programming Language :: Python :: 3.7', 'Topic :: Internet :: WWW/HTTP', ] ) From f9401f5ff0c4738d02ea5d7576435913582006ce Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Michael=20K=C3=A4ufl?= Date: Sat, 16 Feb 2019 15:47:13 +0100 Subject: [PATCH 112/185] Fix Python 3 compat in documentation --- docs/api-guide/serializers.md | 12 ++++++------ docs/community/3.0-announcement.md | 2 +- docs/tutorial/1-serialization.md | 14 +++++++------- docs/tutorial/2-requests-and-responses.md | 10 +++++----- 4 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/api-guide/serializers.md b/docs/api-guide/serializers.md index 3ef930c64..e25053936 100644 --- a/docs/api-guide/serializers.md +++ b/docs/api-guide/serializers.md @@ -152,7 +152,7 @@ When deserializing data, you always need to call `is_valid()` before attempting serializer.is_valid() # False serializer.errors - # {'email': [u'Enter a valid e-mail address.'], 'created': [u'This field is required.']} + # {'email': ['Enter a valid e-mail address.'], 'created': ['This field is required.']} Each key in the dictionary will be the field name, and the values will be lists of strings of any error messages corresponding to that field. The `non_field_errors` key may also be present, and will list any general validation errors. The name of the `non_field_errors` key may be customized using the `NON_FIELD_ERRORS_KEY` REST framework setting. @@ -253,7 +253,7 @@ When passing data to a serializer instance, the unmodified data will be made ava By default, serializers must be passed values for all required fields or they will raise validation errors. You can use the `partial` argument in order to allow partial updates. # Update `comment` with partial data - serializer = CommentSerializer(comment, data={'content': u'foo bar'}, partial=True) + serializer = CommentSerializer(comment, data={'content': 'foo bar'}, partial=True) ## Dealing with nested objects @@ -293,7 +293,7 @@ When dealing with nested representations that support deserializing the data, an serializer.is_valid() # False serializer.errors - # {'user': {'email': [u'Enter a valid e-mail address.']}, 'created': [u'This field is required.']} + # {'user': {'email': ['Enter a valid e-mail address.']}, 'created': ['This field is required.']} Similarly, the `.validated_data` property will include nested data structures. @@ -415,7 +415,7 @@ You can provide arbitrary additional context by passing a `context` argument whe serializer = AccountSerializer(account, context={'request': request}) serializer.data - # {'id': 6, 'owner': u'denvercoder9', 'created': datetime.datetime(2013, 2, 12, 09, 44, 56, 678870), 'details': 'http://example.com/accounts/6/details'} + # {'id': 6, 'owner': 'denvercoder9', 'created': datetime.datetime(2013, 2, 12, 09, 44, 56, 678870), 'details': 'http://example.com/accounts/6/details'} The context dictionary can be used within any serializer field logic, such as a custom `.to_representation()` method, by accessing the `self.context` attribute. @@ -1094,10 +1094,10 @@ This would then allow you to do the following: >>> model = User >>> fields = ('id', 'username', 'email') >>> - >>> print UserSerializer(user) + >>> print(UserSerializer(user)) {'id': 2, 'username': 'jonwatts', 'email': 'jon@example.com'} >>> - >>> print UserSerializer(user, fields=('id', 'email')) + >>> print(UserSerializer(user, fields=('id', 'email'))) {'id': 2, 'email': 'jon@example.com'} ## Customizing the default fields diff --git a/docs/community/3.0-announcement.md b/docs/community/3.0-announcement.md index 13be1e3cd..dc118d70c 100644 --- a/docs/community/3.0-announcement.md +++ b/docs/community/3.0-announcement.md @@ -389,7 +389,7 @@ You can include `expiry_date` as a field option on a `ModelSerializer` class. These fields will be mapped to `serializers.ReadOnlyField()` instances. >>> serializer = InvitationSerializer() - >>> print repr(serializer) + >>> print(repr(serializer)) InvitationSerializer(): to_email = EmailField(max_length=75) message = CharField(max_length=1000) diff --git a/docs/tutorial/1-serialization.md b/docs/tutorial/1-serialization.md index 387f99eda..ec507df05 100644 --- a/docs/tutorial/1-serialization.md +++ b/docs/tutorial/1-serialization.md @@ -137,20 +137,20 @@ Okay, once we've got a few imports out of the way, let's create a couple of code snippet = Snippet(code='foo = "bar"\n') snippet.save() - snippet = Snippet(code='print "hello, world"\n') + snippet = Snippet(code='print("hello, world")\n') snippet.save() We've now got a few snippet instances to play with. Let's take a look at serializing one of those instances. serializer = SnippetSerializer(snippet) serializer.data - # {'id': 2, 'title': u'', 'code': u'print "hello, world"\n', 'linenos': False, 'language': u'python', 'style': u'friendly'} + # {'id': 2, 'title': '', 'code': 'print("hello, world")\n', 'linenos': False, 'language': 'python', 'style': 'friendly'} At this point we've translated the model instance into Python native datatypes. To finalize the serialization process we render the data into `json`. content = JSONRenderer().render(serializer.data) content - # '{"id": 2, "title": "", "code": "print \\"hello, world\\"\\n", "linenos": false, "language": "python", "style": "friendly"}' + # '{"id": 2, "title": "", "code": "print(\\"hello, world\\")\\n", "linenos": false, "language": "python", "style": "friendly"}' Deserialization is similar. First we parse a stream into Python native datatypes... @@ -165,7 +165,7 @@ Deserialization is similar. First we parse a stream into Python native datatype serializer.is_valid() # True serializer.validated_data - # OrderedDict([('title', ''), ('code', 'print "hello, world"\n'), ('linenos', False), ('language', 'python'), ('style', 'friendly')]) + # OrderedDict([('title', ''), ('code', 'print("hello, world")\n'), ('linenos', False), ('language', 'python'), ('style', 'friendly')]) serializer.save() # @@ -175,7 +175,7 @@ We can also serialize querysets instead of model instances. To do so we simply serializer = SnippetSerializer(Snippet.objects.all(), many=True) serializer.data - # [OrderedDict([('id', 1), ('title', u''), ('code', u'foo = "bar"\n'), ('linenos', False), ('language', 'python'), ('style', 'friendly')]), OrderedDict([('id', 2), ('title', u''), ('code', u'print "hello, world"\n'), ('linenos', False), ('language', 'python'), ('style', 'friendly')]), OrderedDict([('id', 3), ('title', u''), ('code', u'print "hello, world"'), ('linenos', False), ('language', 'python'), ('style', 'friendly')])] + # [OrderedDict([('id', 1), ('title', ''), ('code', 'foo = "bar"\n'), ('linenos', False), ('language', 'python'), ('style', 'friendly')]), OrderedDict([('id', 2), ('title', ''), ('code', 'print("hello, world")\n'), ('linenos', False), ('language', 'python'), ('style', 'friendly')]), OrderedDict([('id', 3), ('title', ''), ('code', 'print("hello, world")'), ('linenos', False), ('language', 'python'), ('style', 'friendly')])] ## Using ModelSerializers @@ -338,7 +338,7 @@ Finally, we can get a list of all of the snippets: { "id": 2, "title": "", - "code": "print \"hello, world\"\n", + "code": "print(\"hello, world\")\n", "linenos": false, "language": "python", "style": "friendly" @@ -354,7 +354,7 @@ Or we can get a particular snippet by referencing its id: { "id": 2, "title": "", - "code": "print \"hello, world\"\n", + "code": "print(\"hello, world\")\n", "linenos": false, "language": "python", "style": "friendly" diff --git a/docs/tutorial/2-requests-and-responses.md b/docs/tutorial/2-requests-and-responses.md index 4a9b0dbf7..e3d21e864 100644 --- a/docs/tutorial/2-requests-and-responses.md +++ b/docs/tutorial/2-requests-and-responses.md @@ -143,7 +143,7 @@ We can get a list of all of the snippets, as before. { "id": 2, "title": "", - "code": "print \"hello, world\"\n", + "code": "print(\"hello, world\")\n", "linenos": false, "language": "python", "style": "friendly" @@ -163,24 +163,24 @@ Or by appending a format suffix: Similarly, we can control the format of the request that we send, using the `Content-Type` header. # POST using form data - http --form POST http://127.0.0.1:8000/snippets/ code="print 123" + http --form POST http://127.0.0.1:8000/snippets/ code="print(123)" { "id": 3, "title": "", - "code": "print 123", + "code": "print(123)", "linenos": false, "language": "python", "style": "friendly" } # POST using JSON - http --json POST http://127.0.0.1:8000/snippets/ code="print 456" + http --json POST http://127.0.0.1:8000/snippets/ code="print(456)" { "id": 4, "title": "", - "code": "print 456", + "code": "print(456)", "linenos": false, "language": "python", "style": "friendly" From eb3180173ed119192c57a6ab52097025c00148e3 Mon Sep 17 00:00:00 2001 From: jeffrey k eliasen Date: Tue, 19 Feb 2019 03:15:03 -0800 Subject: [PATCH 113/185] Made templates compatible with session-based CSRF. (#6207) --- rest_framework/static/rest_framework/js/csrf.js | 2 +- rest_framework/templates/rest_framework/admin.html | 2 +- rest_framework/templates/rest_framework/base.html | 2 +- tests/test_templates.py | 12 +++++++++++- 4 files changed, 14 insertions(+), 4 deletions(-) diff --git a/rest_framework/static/rest_framework/js/csrf.js b/rest_framework/static/rest_framework/js/csrf.js index 97c8d0124..6e4bf39a7 100644 --- a/rest_framework/static/rest_framework/js/csrf.js +++ b/rest_framework/static/rest_framework/js/csrf.js @@ -38,7 +38,7 @@ function sameOrigin(url) { !(/^(\/\/|http:|https:).*/.test(url)); } -var csrftoken = getCookie(window.drf.csrfCookieName); +var csrftoken = window.drf.csrfToken; $.ajaxSetup({ beforeSend: function(xhr, settings) { diff --git a/rest_framework/templates/rest_framework/admin.html b/rest_framework/templates/rest_framework/admin.html index 66d8431f1..f058b2694 100644 --- a/rest_framework/templates/rest_framework/admin.html +++ b/rest_framework/templates/rest_framework/admin.html @@ -247,7 +247,7 @@ diff --git a/rest_framework/templates/rest_framework/base.html b/rest_framework/templates/rest_framework/base.html index e8a13674e..6d740f2b5 100644 --- a/rest_framework/templates/rest_framework/base.html +++ b/rest_framework/templates/rest_framework/base.html @@ -290,7 +290,7 @@ diff --git a/tests/test_templates.py b/tests/test_templates.py index a296395f6..19f511b96 100644 --- a/tests/test_templates.py +++ b/tests/test_templates.py @@ -1,7 +1,17 @@ +import re + 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')) + + def test_base_template_with_no_context(): # base.html should be renderable with no context, # so it can be easily extended. - render({}, 'rest_framework/base.html') + 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')) From 6de33effd6d0e1cc9ad2dc3a2a4d0487583a116f Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Tue, 19 Feb 2019 16:18:55 +0100 Subject: [PATCH 114/185] =?UTF-8?q?Doc=E2=80=99d=20requirement=20to=20impl?= =?UTF-8?q?ement=20has=5Fobject=5Fpermission()=20(#6462)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit …when using provided permission classes. Closes #6402. --- docs/api-guide/permissions.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/api-guide/permissions.md b/docs/api-guide/permissions.md index e04b1199b..a797da9ac 100644 --- a/docs/api-guide/permissions.md +++ b/docs/api-guide/permissions.md @@ -48,6 +48,19 @@ For example: self.check_object_permissions(self.request, obj) return obj +--- + +**Note**: With the exception of `DjangoObjectPermissions`, the provided +permission classes in `rest_framework.permssions` **do not** implement the +methods necessary to check object permissions. + +If you wish to use the provided permission classes in order to check object +permissions, **you must** subclass them and implement the +`has_object_permission()` method described in the [_Custom +permissions_](#custom-permissions) section (below). + +--- + #### Limitations of object level permissions For performance reasons the generic views will not automatically apply object level permissions to each instance in a queryset when returning a list of objects. From 1ece516d2d0d942d9de513f85d601afcccf67ebd Mon Sep 17 00:00:00 2001 From: Si Feng Date: Tue, 19 Feb 2019 07:38:20 -0800 Subject: [PATCH 115/185] Adjusted field `validators` to accept iterables. (#6282) Closes 6280. --- rest_framework/fields.py | 4 ++-- rest_framework/serializers.py | 4 ++-- tests/test_fields.py | 19 +++++++++++++++++++ tests/test_serializer.py | 34 +++++++++++++++++++++++++++++++++- 4 files changed, 56 insertions(+), 5 deletions(-) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 562e52b22..2cbfd22bb 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -350,7 +350,7 @@ class Field(object): self.default_empty_html = default if validators is not None: - self.validators = validators[:] + self.validators = list(validators) # These are set up by `.bind()` when the field is added to a serializer. self.field_name = None @@ -410,7 +410,7 @@ class Field(object): self._validators = validators def get_validators(self): - return self.default_validators[:] + return list(self.default_validators) def get_initial(self): """ diff --git a/rest_framework/serializers.py b/rest_framework/serializers.py index eae08a34c..9830edb3f 100644 --- a/rest_framework/serializers.py +++ b/rest_framework/serializers.py @@ -393,7 +393,7 @@ class Serializer(BaseSerializer): # Used by the lazily-evaluated `validators` property. meta = getattr(self, 'Meta', None) validators = getattr(meta, 'validators', None) - return validators[:] if validators else [] + return list(validators) if validators else [] def get_initial(self): if hasattr(self, 'initial_data'): @@ -1480,7 +1480,7 @@ class ModelSerializer(Serializer): # If the validators have been declared explicitly then use that. validators = getattr(getattr(self, 'Meta', None), 'validators', None) if validators is not None: - return validators[:] + return list(validators) # Otherwise use the default set of validators. return ( diff --git a/tests/test_fields.py b/tests/test_fields.py index 9a1d04979..12c936b22 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -740,6 +740,25 @@ class TestCharField(FieldValues): 'Null characters are not allowed.' ] + def test_iterable_validators(self): + """ + Ensure `validators` parameter is compatible with reasonable iterables. + """ + value = 'example' + + for validators in ([], (), set()): + field = serializers.CharField(validators=validators) + field.run_validation(value) + + def raise_exception(value): + raise exceptions.ValidationError('Raised error') + + for validators in ([raise_exception], (raise_exception,), set([raise_exception])): + field = serializers.CharField(validators=validators) + with pytest.raises(serializers.ValidationError) as exc_info: + field.run_validation(value) + assert exc_info.value.detail == ['Raised error'] + class TestEmailField(FieldValues): """ diff --git a/tests/test_serializer.py b/tests/test_serializer.py index efa1adf0e..6e4ff22b2 100644 --- a/tests/test_serializer.py +++ b/tests/test_serializer.py @@ -10,7 +10,7 @@ from collections import Mapping import pytest from django.db import models -from rest_framework import fields, relations, serializers +from rest_framework import exceptions, fields, relations, serializers from rest_framework.compat import unicode_repr from rest_framework.fields import Field @@ -183,6 +183,38 @@ class TestSerializer: assert serializer.validated_data.coords[1] == 50.941357 assert serializer.errors == {} + def test_iterable_validators(self): + """ + Ensure `validators` parameter is compatible with reasonable iterables. + """ + data = {'char': 'abc', 'integer': 123} + + for validators in ([], (), set()): + class ExampleSerializer(serializers.Serializer): + char = serializers.CharField(validators=validators) + integer = serializers.IntegerField() + + serializer = ExampleSerializer(data=data) + assert serializer.is_valid() + assert serializer.validated_data == data + assert serializer.errors == {} + + def raise_exception(value): + raise exceptions.ValidationError('Raised error') + + for validators in ([raise_exception], (raise_exception,), set([raise_exception])): + class ExampleSerializer(serializers.Serializer): + char = serializers.CharField(validators=validators) + integer = serializers.IntegerField() + + serializer = ExampleSerializer(data=data) + assert not serializer.is_valid() + assert serializer.data == data + assert serializer.validated_data == {} + assert serializer.errors == {'char': [ + exceptions.ErrorDetail(string='Raised error', code='invalid') + ]} + class TestValidateMethod: def test_non_field_error_validate_method(self): From d110454d4c15fe6617a112e846b89e09ed6c95b2 Mon Sep 17 00:00:00 2001 From: Allan Reyes Date: Tue, 19 Feb 2019 08:18:14 -0800 Subject: [PATCH 116/185] Added SearchFilter.get_search_fields() hook. (#6279) --- docs/api-guide/filtering.md | 7 +++++++ rest_framework/filters.py | 10 +++++++++- tests/test_filters.py | 25 +++++++++++++++++++++++++ 3 files changed, 41 insertions(+), 1 deletion(-) diff --git a/docs/api-guide/filtering.md b/docs/api-guide/filtering.md index 1a04ad5e3..5d1f6e49a 100644 --- a/docs/api-guide/filtering.md +++ b/docs/api-guide/filtering.md @@ -218,6 +218,13 @@ For example: By default, the search parameter is named `'search`', but this may be overridden with the `SEARCH_PARAM` setting. +To dynamically change search fields based on request content, it's possible to subclass the `SearchFilter` and override the `get_search_fields()` function. For example, the following subclass will only search on `title` if the query parameter `title_only` is in the request: + + class CustomSearchFilter(self, view, request): + if request.query_params.get('title_only'): + return ('title',) + return super(CustomSearchFilter, self).get_search_fields(view, request) + For more details, see the [Django documentation][search-django-admin]. --- diff --git a/rest_framework/filters.py b/rest_framework/filters.py index 0627bd8c4..53d49ae45 100644 --- a/rest_framework/filters.py +++ b/rest_framework/filters.py @@ -53,6 +53,14 @@ class SearchFilter(BaseFilterBackend): search_title = _('Search') search_description = _('A search term.') + def get_search_fields(self, view, request): + """ + Search fields are obtained from the view, but the request is always + passed to this method. Sub-classes can override this method to + dynamically change the search fields based on request content. + """ + return getattr(view, 'search_fields', None) + def get_search_terms(self, request): """ Search terms are set by a ?search=... query parameter, @@ -90,7 +98,7 @@ class SearchFilter(BaseFilterBackend): return False def filter_queryset(self, request, queryset, view): - search_fields = getattr(view, 'search_fields', None) + search_fields = self.get_search_fields(view, request) search_terms = self.get_search_terms(request) if not search_fields or not search_terms: diff --git a/tests/test_filters.py b/tests/test_filters.py index 2d4eb132e..39a96f994 100644 --- a/tests/test_filters.py +++ b/tests/test_filters.py @@ -156,6 +156,31 @@ class SearchFilterTests(TestCase): reload_module(filters) + def test_search_with_filter_subclass(self): + class CustomSearchFilter(filters.SearchFilter): + # Filter that dynamically changes search fields + 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) + + class SearchListView(generics.ListAPIView): + queryset = SearchFilterModel.objects.all() + serializer_class = SearchFilterSerializer + filter_backends = (CustomSearchFilter,) + search_fields = ('$title', '$text') + + view = SearchListView.as_view() + request = factory.get('/', {'search': '^\w{3}$'}) + response = view(request) + assert len(response.data) == 10 + + request = factory.get('/', {'search': '^\w{3}$', 'title_only': 'true'}) + response = view(request) + assert response.data == [ + {'id': 3, 'title': 'zzz', 'text': 'cde'} + ] + class AttributeModel(models.Model): label = models.CharField(max_length=32) From d932baa64660012cb7e5b86ba0f985fee8d5e57c Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Fri, 22 Feb 2019 11:11:52 +0100 Subject: [PATCH 117/185] Corrected link to ajax-form library. Closes #6465. --- docs/topics/browser-enhancements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/topics/browser-enhancements.md b/docs/topics/browser-enhancements.md index 0e79a66e1..fa07b6064 100644 --- a/docs/topics/browser-enhancements.md +++ b/docs/topics/browser-enhancements.md @@ -81,7 +81,7 @@ was later [dropped from the spec][html5]. There remains as well as how to support content types other than form-encoded data. [cite]: https://www.amazon.com/RESTful-Web-Services-Leonard-Richardson/dp/0596529260 -[ajax-form]: https://github.com/encode/ajax-form +[ajax-form]: https://github.com/tomchristie/ajax-form [rails]: https://guides.rubyonrails.org/form_helpers.html#how-do-forms-with-put-or-delete-methods-work [html5]: https://www.w3.org/TR/html5-diff/#changes-2010-06-24 [put_delete]: http://amundsen.com/examples/put-delete-forms/ From 286cf57a8d22aafd51054a40a5cf8a58edfc8226 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Fri, 22 Feb 2019 10:58:01 -0800 Subject: [PATCH 118/185] Update filtering docs (#6467) --- docs/api-guide/filtering.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/api-guide/filtering.md b/docs/api-guide/filtering.md index 5d1f6e49a..aff267818 100644 --- a/docs/api-guide/filtering.md +++ b/docs/api-guide/filtering.md @@ -127,7 +127,7 @@ Note that you can use both an overridden `.get_queryset()` and generic filtering """ model = Product serializer_class = ProductSerializer - filter_class = ProductFilter + filterset_class = ProductFilter def get_queryset(self): user = self.request.user @@ -305,9 +305,9 @@ A complete example using both `DjangoObjectPermissionsFilter` and `DjangoObjectP **permissions.py**: class CustomObjectPermissions(permissions.DjangoObjectPermissions): - """ - Similar to `DjangoObjectPermissions`, but adding 'view' permissions. - """ + """ + Similar to `DjangoObjectPermissions`, but adding 'view' permissions. + """ perms_map = { 'GET': ['%(app_label)s.view_%(model_name)s'], 'OPTIONS': ['%(app_label)s.view_%(model_name)s'], @@ -321,11 +321,11 @@ A complete example using both `DjangoObjectPermissionsFilter` and `DjangoObjectP **views.py**: class EventViewSet(viewsets.ModelViewSet): - """ - Viewset that only lists events if user has 'view' permissions, and only - allows operations on individual events if user has appropriate 'view', 'add', - 'change' or 'delete' permissions. - """ + """ + Viewset that only lists events if user has 'view' permissions, and only + allows operations on individual events if user has appropriate 'view', 'add', + 'change' or 'delete' permissions. + """ queryset = Event.objects.all() serializer_class = EventSerializer filter_backends = (filters.DjangoObjectPermissionsFilter,) From 07c5c968ce8b06c7ebbcc91a070aa492510611b2 Mon Sep 17 00:00:00 2001 From: Charlie Hornsby Date: Mon, 25 Feb 2019 10:17:04 +0200 Subject: [PATCH 119/185] Fix DeprecationWarning when accessing collections.abc classes via collections (#6268) * Use compat version of collections.abc.Mapping Since the Mapping class will no longer be available to import directly from the collections module in Python 3.8, we should use the compatibility helper introduced in #6154 in the fields module. * Alias and use compat version of collections.abc.MutableMapping Since the MutableMapping class will no longer be available to import directly from the collections module in Python 3.8, we should create an alias for it in the compat module and use that instead. --- rest_framework/compat.py | 4 ++-- rest_framework/fields.py | 7 +++---- rest_framework/utils/serializer_helpers.py | 5 ++--- 3 files changed, 7 insertions(+), 9 deletions(-) diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 5a4bcdf66..59217c587 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -12,10 +12,10 @@ from django.views.generic import View try: # Python 3 - from collections.abc import Mapping # noqa + from collections.abc import Mapping, MutableMapping # noqa except ImportError: # Python 2.7 - from collections import Mapping # noqa + from collections import Mapping, MutableMapping # noqa try: from django.urls import ( # noqa diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 2cbfd22bb..1b8387714 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1,6 +1,5 @@ from __future__ import unicode_literals -import collections import copy import datetime import decimal @@ -33,7 +32,7 @@ from pytz.exceptions import InvalidTimeError from rest_framework import ISO_8601 from rest_framework.compat import ( - MaxLengthValidator, MaxValueValidator, MinLengthValidator, + Mapping, MaxLengthValidator, MaxValueValidator, MinLengthValidator, MinValueValidator, ProhibitNullCharactersValidator, unicode_repr, unicode_to_repr ) @@ -96,7 +95,7 @@ def get_attribute(instance, attrs): """ for attr in attrs: try: - if isinstance(instance, collections.Mapping): + if isinstance(instance, Mapping): instance = instance[attr] else: instance = getattr(instance, attr) @@ -1661,7 +1660,7 @@ class ListField(Field): """ if html.is_html_input(data): data = html.parse_html_list(data, default=[]) - if isinstance(data, type('')) or isinstance(data, collections.Mapping) or not hasattr(data, '__iter__'): + if isinstance(data, type('')) or isinstance(data, 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') diff --git a/rest_framework/utils/serializer_helpers.py b/rest_framework/utils/serializer_helpers.py index 6b662a66c..c24e51d09 100644 --- a/rest_framework/utils/serializer_helpers.py +++ b/rest_framework/utils/serializer_helpers.py @@ -1,11 +1,10 @@ from __future__ import unicode_literals -import collections from collections import OrderedDict from django.utils.encoding import force_text -from rest_framework.compat import unicode_to_repr +from rest_framework.compat import MutableMapping, unicode_to_repr from rest_framework.utils import json @@ -130,7 +129,7 @@ class NestedBoundField(BoundField): return self.__class__(self._field, values, self.errors, self._prefix) -class BindingDict(collections.MutableMapping): +class BindingDict(MutableMapping): """ This dict-like object is used to store fields on a serializer. From 8a29c53226f63733775a232fea0c2c65cb50b6b0 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Mon, 25 Feb 2019 11:49:29 +0100 Subject: [PATCH 120/185] Allowed Q objects in limit_choices_to introspection. (#6472) Closes #6470. --- rest_framework/utils/field_mapping.py | 4 +++- tests/models.py | 7 +++++++ tests/test_relations_pk.py | 21 +++++++++++++++++---- 3 files changed, 27 insertions(+), 5 deletions(-) diff --git a/rest_framework/utils/field_mapping.py b/rest_framework/utils/field_mapping.py index 991f20f17..f11b4b94e 100644 --- a/rest_framework/utils/field_mapping.py +++ b/rest_framework/utils/field_mapping.py @@ -251,7 +251,9 @@ def get_relation_kwargs(field_name, relation_info): limit_choices_to = model_field and model_field.get_limit_choices_to() if limit_choices_to: - kwargs['queryset'] = kwargs['queryset'].filter(**limit_choices_to) + if not isinstance(limit_choices_to, models.Q): + limit_choices_to = models.Q(**limit_choices_to) + kwargs['queryset'] = kwargs['queryset'].filter(limit_choices_to) if has_through_model: kwargs['read_only'] = True diff --git a/tests/models.py b/tests/models.py index 55f250e04..17bf23cda 100644 --- a/tests/models.py +++ b/tests/models.py @@ -59,6 +59,13 @@ class ForeignKeySourceWithLimitedChoices(RESTFrameworkModel): on_delete=models.CASCADE) +class ForeignKeySourceWithQLimitedChoices(RESTFrameworkModel): + target = models.ForeignKey(ForeignKeyTarget, help_text='Target', + verbose_name='Target', + limit_choices_to=models.Q(name__startswith="limited-"), + on_delete=models.CASCADE) + + # Nullable ForeignKey class NullableForeignKeySource(RESTFrameworkModel): name = models.CharField(max_length=100) diff --git a/tests/test_relations_pk.py b/tests/test_relations_pk.py index 31b6bb867..2cffb62e6 100644 --- a/tests/test_relations_pk.py +++ b/tests/test_relations_pk.py @@ -5,10 +5,11 @@ from django.utils import six from rest_framework import serializers from tests.models import ( - ForeignKeySource, ForeignKeySourceWithLimitedChoices, ForeignKeyTarget, - ManyToManySource, ManyToManyTarget, NullableForeignKeySource, - NullableOneToOneSource, NullableUUIDForeignKeySource, OneToOnePKSource, - OneToOneTarget, UUIDForeignKeyTarget + ForeignKeySource, ForeignKeySourceWithLimitedChoices, + ForeignKeySourceWithQLimitedChoices, ForeignKeyTarget, ManyToManySource, + ManyToManyTarget, NullableForeignKeySource, NullableOneToOneSource, + NullableUUIDForeignKeySource, OneToOnePKSource, OneToOneTarget, + UUIDForeignKeyTarget ) @@ -378,6 +379,18 @@ class PKForeignKeyTests(TestCase): queryset = ForeignKeySourceWithLimitedChoicesSerializer().fields["target"].get_queryset() assert len(queryset) == 1 + def test_queryset_size_with_Q_limited_choices(self): + limited_target = ForeignKeyTarget(name="limited-target") + limited_target.save() + + class QLimitedChoicesSerializer(serializers.ModelSerializer): + class Meta: + model = ForeignKeySourceWithQLimitedChoices + fields = ("id", "target") + + queryset = QLimitedChoicesSerializer().fields["target"].get_queryset() + assert len(queryset) == 1 + class PKNullableForeignKeyTests(TestCase): def setUp(self): From 94fbfcb6fdc8f9755a9f005bd005b00be3309ff8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Massart?= Date: Mon, 25 Feb 2019 20:47:02 +0800 Subject: [PATCH 121/185] Added lazy evaluation to composed permissions. (#6463) Refs #6402. --- rest_framework/compat.py | 11 +++++ rest_framework/permissions.py | 8 ++-- tests/test_permissions.py | 87 ++++++++++++++++++++++++++++++++++- 3 files changed, 101 insertions(+), 5 deletions(-) diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 59217c587..9422e6ad5 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -5,6 +5,8 @@ versions of Django/Python, and compatibility wrappers around optional packages. from __future__ import unicode_literals +import sys + from django.conf import settings from django.core import validators from django.utils import six @@ -34,6 +36,11 @@ try: except ImportError: ProhibitNullCharactersValidator = None +try: + from unittest import mock +except ImportError: + mock = None + def get_original_route(urlpattern): """ @@ -314,3 +321,7 @@ class MinLengthValidator(CustomValidatorMessage, validators.MinLengthValidator): class MaxLengthValidator(CustomValidatorMessage, validators.MaxLengthValidator): pass + + +# Version Constants. +PY36 = sys.version_info >= (3, 6) diff --git a/rest_framework/permissions.py b/rest_framework/permissions.py index ac616e202..69432d79a 100644 --- a/rest_framework/permissions.py +++ b/rest_framework/permissions.py @@ -44,13 +44,13 @@ class AND: def has_permission(self, request, view): return ( - self.op1.has_permission(request, view) & + self.op1.has_permission(request, view) and self.op2.has_permission(request, view) ) def has_object_permission(self, request, view, obj): return ( - self.op1.has_object_permission(request, view, obj) & + self.op1.has_object_permission(request, view, obj) and self.op2.has_object_permission(request, view, obj) ) @@ -62,13 +62,13 @@ class OR: def has_permission(self, request, view): return ( - self.op1.has_permission(request, view) | + self.op1.has_permission(request, view) or self.op2.has_permission(request, view) ) def has_object_permission(self, request, view, obj): return ( - self.op1.has_object_permission(request, view, obj) | + self.op1.has_object_permission(request, view, obj) or self.op2.has_object_permission(request, view, obj) ) diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 381ec448c..f9d53430f 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -5,6 +5,7 @@ import unittest import warnings import django +import pytest from django.contrib.auth.models import AnonymousUser, Group, Permission, User from django.db import models from django.test import TestCase @@ -14,7 +15,7 @@ from rest_framework import ( HTTP_HEADER_ENCODING, authentication, generics, permissions, serializers, status, views ) -from rest_framework.compat import is_guardian_installed +from rest_framework.compat import PY36, is_guardian_installed, mock from rest_framework.filters import DjangoObjectPermissionsFilter from rest_framework.routers import DefaultRouter from rest_framework.test import APIRequestFactory @@ -600,3 +601,87 @@ class PermissionsCompositionTests(TestCase): permissions.IsAuthenticated ) assert composed_perm().has_permission(request, None) is True + + @pytest.mark.skipif(not PY36, reason="assert_called_once() not available") + def test_or_lazyness(self): + request = factory.get('/1', format='json') + request.user = AnonymousUser() + + with mock.patch.object(permissions.AllowAny, 'has_permission', return_value=True) as mock_allow: + with mock.patch.object(permissions.IsAuthenticated, 'has_permission', return_value=False) as mock_deny: + composed_perm = (permissions.AllowAny | permissions.IsAuthenticated) + hasperm = composed_perm().has_permission(request, None) + self.assertIs(hasperm, True) + mock_allow.assert_called_once() + mock_deny.assert_not_called() + + with mock.patch.object(permissions.AllowAny, 'has_permission', return_value=True) as mock_allow: + with mock.patch.object(permissions.IsAuthenticated, 'has_permission', return_value=False) as mock_deny: + composed_perm = (permissions.IsAuthenticated | permissions.AllowAny) + hasperm = composed_perm().has_permission(request, None) + self.assertIs(hasperm, True) + mock_deny.assert_called_once() + mock_allow.assert_called_once() + + @pytest.mark.skipif(not PY36, reason="assert_called_once() not available") + def test_object_or_lazyness(self): + request = factory.get('/1', format='json') + request.user = AnonymousUser() + + with mock.patch.object(permissions.AllowAny, 'has_object_permission', return_value=True) as mock_allow: + with mock.patch.object(permissions.IsAuthenticated, 'has_object_permission', return_value=False) as mock_deny: + composed_perm = (permissions.AllowAny | permissions.IsAuthenticated) + hasperm = composed_perm().has_object_permission(request, None, None) + self.assertIs(hasperm, True) + mock_allow.assert_called_once() + mock_deny.assert_not_called() + + with mock.patch.object(permissions.AllowAny, 'has_object_permission', return_value=True) as mock_allow: + with mock.patch.object(permissions.IsAuthenticated, 'has_object_permission', return_value=False) as mock_deny: + composed_perm = (permissions.IsAuthenticated | permissions.AllowAny) + hasperm = composed_perm().has_object_permission(request, None, None) + self.assertIs(hasperm, True) + mock_deny.assert_called_once() + mock_allow.assert_called_once() + + @pytest.mark.skipif(not PY36, reason="assert_called_once() not available") + def test_and_lazyness(self): + request = factory.get('/1', format='json') + request.user = AnonymousUser() + + with mock.patch.object(permissions.AllowAny, 'has_permission', return_value=True) as mock_allow: + with mock.patch.object(permissions.IsAuthenticated, 'has_permission', return_value=False) as mock_deny: + composed_perm = (permissions.AllowAny & permissions.IsAuthenticated) + hasperm = composed_perm().has_permission(request, None) + self.assertIs(hasperm, False) + mock_allow.assert_called_once() + mock_deny.assert_called_once() + + with mock.patch.object(permissions.AllowAny, 'has_permission', return_value=True) as mock_allow: + with mock.patch.object(permissions.IsAuthenticated, 'has_permission', return_value=False) as mock_deny: + composed_perm = (permissions.IsAuthenticated & permissions.AllowAny) + hasperm = composed_perm().has_permission(request, None) + self.assertIs(hasperm, False) + mock_allow.assert_not_called() + mock_deny.assert_called_once() + + @pytest.mark.skipif(not PY36, reason="assert_called_once() not available") + def test_object_and_lazyness(self): + request = factory.get('/1', format='json') + request.user = AnonymousUser() + + with mock.patch.object(permissions.AllowAny, 'has_object_permission', return_value=True) as mock_allow: + with mock.patch.object(permissions.IsAuthenticated, 'has_object_permission', return_value=False) as mock_deny: + composed_perm = (permissions.AllowAny & permissions.IsAuthenticated) + hasperm = composed_perm().has_object_permission(request, None, None) + self.assertIs(hasperm, False) + mock_allow.assert_called_once() + mock_deny.assert_called_once() + + with mock.patch.object(permissions.AllowAny, 'has_object_permission', return_value=True) as mock_allow: + with mock.patch.object(permissions.IsAuthenticated, 'has_object_permission', return_value=False) as mock_deny: + composed_perm = (permissions.IsAuthenticated & permissions.AllowAny) + hasperm = composed_perm().has_object_permission(request, None, None) + self.assertIs(hasperm, False) + mock_allow.assert_not_called() + mock_deny.assert_called_once() From 739b0a272a66d9beb7afb7490f201d71d7cdc910 Mon Sep 17 00:00:00 2001 From: Xtreak Date: Mon, 25 Feb 2019 19:52:45 +0530 Subject: [PATCH 122/185] Fix DeprecationWarning in tests when accessing collections.abc classes via collections (#6473) --- tests/test_renderers.py | 4 ++-- tests/test_serializer.py | 3 +-- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/tests/test_renderers.py b/tests/test_renderers.py index 8518a3f7c..b4c41b148 100644 --- a/tests/test_renderers.py +++ b/tests/test_renderers.py @@ -2,7 +2,7 @@ from __future__ import unicode_literals import re -from collections import MutableMapping, OrderedDict +from collections import OrderedDict import pytest from django.conf.urls import include, url @@ -16,7 +16,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 coreapi +from rest_framework.compat import MutableMapping, 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 6e4ff22b2..0f1e81965 100644 --- a/tests/test_serializer.py +++ b/tests/test_serializer.py @@ -5,13 +5,12 @@ import inspect import pickle import re import unittest -from collections import Mapping import pytest from django.db import models from rest_framework import exceptions, fields, relations, serializers -from rest_framework.compat import unicode_repr +from rest_framework.compat import Mapping, unicode_repr from rest_framework.fields import Field from .models import ( From 2daf6f13414f1a5d363b5bc4a2ce3ba294a7766c Mon Sep 17 00:00:00 2001 From: Adrien Brunet Date: Mon, 25 Feb 2019 15:33:40 +0100 Subject: [PATCH 123/185] Add negation ~ operator to permissions composition (#6361) --- docs/api-guide/permissions.md | 2 +- rest_framework/permissions.py | 24 ++++++++++++++++++++++++ tests/test_permissions.py | 25 ++++++++++++++++++++++++- 3 files changed, 49 insertions(+), 2 deletions(-) diff --git a/docs/api-guide/permissions.md b/docs/api-guide/permissions.md index a797da9ac..6a1297e60 100644 --- a/docs/api-guide/permissions.md +++ b/docs/api-guide/permissions.md @@ -134,7 +134,7 @@ Provided they inherit from `rest_framework.permissions.BasePermission`, permissi } return Response(content) -__Note:__ it only supports & -and- and | -or-. +__Note:__ it supports & (and), | (or) and ~ (not). --- diff --git a/rest_framework/permissions.py b/rest_framework/permissions.py index 69432d79a..5d75f54ba 100644 --- a/rest_framework/permissions.py +++ b/rest_framework/permissions.py @@ -24,6 +24,19 @@ class OperationHolderMixin: def __ror__(self, other): return OperandHolder(OR, other, self) + def __invert__(self): + return SingleOperandHolder(NOT, self) + + +class SingleOperandHolder(OperationHolderMixin): + def __init__(self, operator_class, op1_class): + self.operator_class = operator_class + self.op1_class = op1_class + + def __call__(self, *args, **kwargs): + op1 = self.op1_class(*args, **kwargs) + return self.operator_class(op1) + class OperandHolder(OperationHolderMixin): def __init__(self, operator_class, op1_class, op2_class): @@ -73,6 +86,17 @@ class OR: ) +class NOT: + def __init__(self, op1): + self.op1 = op1 + + def has_permission(self, request, view): + return not self.op1.has_permission(request, view) + + def has_object_permission(self, request, view, obj): + return not self.op1.has_object_permission(request, view, obj) + + class BasePermissionMetaclass(OperationHolderMixin, type): pass diff --git a/tests/test_permissions.py b/tests/test_permissions.py index f9d53430f..807006858 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -580,7 +580,19 @@ class PermissionsCompositionTests(TestCase): composed_perm = permissions.IsAuthenticated | permissions.AllowAny assert composed_perm().has_permission(request, None) is True - def test_several_levels(self): + def test_not_false(self): + request = factory.get('/1', format='json') + request.user = AnonymousUser() + composed_perm = ~permissions.IsAuthenticated + assert composed_perm().has_permission(request, None) is True + + def test_not_true(self): + request = factory.get('/1', format='json') + request.user = self.user + composed_perm = ~permissions.AllowAny + assert composed_perm().has_permission(request, None) is False + + def test_several_levels_without_negation(self): request = factory.get('/1', format='json') request.user = self.user composed_perm = ( @@ -591,6 +603,17 @@ class PermissionsCompositionTests(TestCase): ) assert composed_perm().has_permission(request, None) is True + def test_several_levels_and_precedence_with_negation(self): + request = factory.get('/1', format='json') + request.user = self.user + composed_perm = ( + permissions.IsAuthenticated & + ~ permissions.IsAdminUser & + permissions.IsAuthenticated & + ~(permissions.IsAdminUser & permissions.IsAdminUser) + ) + assert composed_perm().has_permission(request, None) is True + def test_several_levels_and_precedence(self): request = factory.get('/1', format='json') request.user = self.user From 317174b163d80aaa8be44b8d3bf073d5c50acb14 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andrzej=20G=C3=B3rski?= Date: Mon, 25 Feb 2019 16:59:25 +0100 Subject: [PATCH 124/185] Avoided calling distinct on annotated fields in SearchFilter. (#6240) Fixes #6094 --- rest_framework/filters.py | 3 +++ tests/test_filters.py | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 36 insertions(+) diff --git a/rest_framework/filters.py b/rest_framework/filters.py index 53d49ae45..7989ace34 100644 --- a/rest_framework/filters.py +++ b/rest_framework/filters.py @@ -85,6 +85,9 @@ class SearchFilter(BaseFilterBackend): opts = queryset.model._meta if search_field[0] in self.lookup_prefixes: search_field = search_field[1:] + # Annotated fields do not need to be distinct + if isinstance(queryset, models.QuerySet) and search_field in queryset.query.annotations: + return False parts = search_field.split(LOOKUP_SEP) for part in parts: field = opts.get_field(part) diff --git a/tests/test_filters.py b/tests/test_filters.py index 39a96f994..088d25436 100644 --- a/tests/test_filters.py +++ b/tests/test_filters.py @@ -5,6 +5,7 @@ import datetime import pytest from django.core.exceptions import ImproperlyConfigured 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 @@ -329,6 +330,38 @@ class SearchFilterToManyTests(TestCase): assert len(response.data) == 1 +class SearchFilterAnnotatedSerializer(serializers.ModelSerializer): + title_text = serializers.CharField() + + class Meta: + model = SearchFilterModel + fields = ('title', 'text', 'title_text') + + +class SearchFilterAnnotatedFieldTests(TestCase): + @classmethod + def setUpTestData(cls): + SearchFilterModel.objects.create(title='abc', text='def') + SearchFilterModel.objects.create(title='ghi', text='jkl') + + def test_search_in_annotated_field(self): + class SearchListView(generics.ListAPIView): + queryset = SearchFilterModel.objects.annotate( + title_text=Upper( + Concat(models.F('title'), models.F('text')) + ) + ).all() + serializer_class = SearchFilterAnnotatedSerializer + filter_backends = (filters.SearchFilter,) + search_fields = ('title_text',) + + view = SearchListView.as_view() + request = factory.get('/', {'search': 'ABCDEF'}) + response = view(request) + assert len(response.data) == 1 + assert response.data[0]['title_text'] == 'ABCDEF' + + class OrderingFilterModel(models.Model): title = models.CharField(max_length=20, verbose_name='verbose title') text = models.CharField(max_length=100) From 1dc81acb4d351ef954291391b9151fa9c524ea43 Mon Sep 17 00:00:00 2001 From: Ramon de Jezus Date: Thu, 28 Feb 2019 15:18:58 +0100 Subject: [PATCH 125/185] Fixed a typo in pagination docs. (#6475) --- docs/api-guide/pagination.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/pagination.md b/docs/api-guide/pagination.md index 7ae351a7f..99612ef46 100644 --- a/docs/api-guide/pagination.md +++ b/docs/api-guide/pagination.md @@ -311,7 +311,7 @@ The [`drf-proxy-pagination` package][drf-proxy-pagination] includes a `ProxyPagi ## link-header-pagination -The [`django-rest-framework-link-header-pagination` package][drf-link-header-pagination] includes a `LinkHeaderPagination` class which provides pagination via an HTTP `Link` header as desribed in [Github's developer documentation](github-link-pagination). +The [`django-rest-framework-link-header-pagination` package][drf-link-header-pagination] includes a `LinkHeaderPagination` class which provides pagination via an HTTP `Link` header as described in [Github's developer documentation](github-link-pagination). [cite]: https://docs.djangoproject.com/en/stable/topics/pagination/ [link-header]: ../img/link-header-pagination.png From 31bf59708121127994bdbcd038f4f76bb28059d7 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Fri, 1 Mar 2019 12:48:12 +0100 Subject: [PATCH 126/185] Updated note on BooleanField required kwarg generation. Closes #6474. --- docs/api-guide/fields.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/api-guide/fields.md b/docs/api-guide/fields.md index 8d25d6c78..74ce2251d 100644 --- a/docs/api-guide/fields.md +++ b/docs/api-guide/fields.md @@ -124,7 +124,14 @@ A boolean representation. When using HTML encoded form input be aware that omitting a value will always be treated as setting a field to `False`, even if it has a `default=True` option specified. This is because HTML checkbox inputs represent the unchecked state by omitting the value, so REST framework treats omission as if it is an empty checkbox input. -Note that default `BooleanField` instances will be generated with a `required=False` option (since Django `models.BooleanField` is always `blank=True`). If you want to change this behaviour explicitly declare the `BooleanField` on the serializer class. +Note that Django 2.1 removed the `blank` kwarg from `models.BooleanField`. +Prior to Django 2.1 `models.BooleanField` fields were always `blank=True`. Thus +since Django 2.1 default `serializers.BooleanField` instances will be generated +without the `required` kwarg (i.e. equivalent to `required=True`) whereas with +previous versions of Django, default `BooleanField` instances will be generated +with a `required=False` option. If you want to control this behaviour manually, +explicitly declare the `BooleanField` on the serializer class, or use the +`extra_kwargs` option to set the `required` flag. Corresponds to `django.db.models.fields.BooleanField`. From a216d02ce0661510d456cfd327fadc3acb9ec960 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Sat, 2 Mar 2019 12:48:03 -0800 Subject: [PATCH 127/185] Merge multiple isinstance() calls to one (#6481) https://docs.python.org/3/library/functions.html#isinstance > If classinfo is a tuple of type objects (or recursively, other such > tuples), return true if object is an instance of any of the types. --- 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 1b8387714..b5fafeaa3 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1660,7 +1660,7 @@ class ListField(Field): """ if html.is_html_input(data): data = html.parse_html_list(data, default=[]) - if isinstance(data, type('')) or isinstance(data, Mapping) or not hasattr(data, '__iter__'): + if isinstance(data, (type(''), 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') From 94593b3a503472c7d1ca97b8e191ef5c8a3c00ff Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Sun, 3 Mar 2019 09:20:45 +0100 Subject: [PATCH 128/185] =?UTF-8?q?Introduce=20RemovedInDRF=E2=80=A6Warnin?= =?UTF-8?q?g=20classes=20to=20simplify=20deprecations.=20(#6480)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes #6290. --- docs/community/release-notes.md | 4 ++-- rest_framework/__init__.py | 8 ++++++++ rest_framework/decorators.py | 5 +++-- rest_framework/filters.py | 3 ++- rest_framework/routers.py | 12 +++++++----- tests/test_decorators.py | 8 ++++---- tests/test_permissions.py | 6 +++--- tests/test_routers.py | 8 +++++--- 8 files changed, 34 insertions(+), 20 deletions(-) diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index 0efc7fa6c..62ad95723 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -18,9 +18,9 @@ REST framework releases follow a formal deprecation policy, which is in line wit The timeline for deprecation of a feature present in version 1.0 would work as follows: -* Version 1.1 would remain **fully backwards compatible** with 1.0, but would raise `PendingDeprecationWarning` warnings if you use the feature that are due to be deprecated. These warnings are **silent by default**, but can be explicitly enabled when you're ready to start migrating any required changes. For example if you start running your tests using `python -Wd manage.py test`, you'll be warned of any API changes you need to make. +* Version 1.1 would remain **fully backwards compatible** with 1.0, but would raise `RemovedInDRF13Warning` warnings, subclassing `PendingDeprecationWarning`, if you use the feature that are due to be deprecated. These warnings are **silent by default**, but can be explicitly enabled when you're ready to start migrating any required changes. For example if you start running your tests using `python -Wd manage.py test`, you'll be warned of any API changes you need to make. -* Version 1.2 would escalate these warnings to `DeprecationWarning`, which is loud by default. +* Version 1.2 would escalate these warnings to subclass `DeprecationWarning`, which is loud by default. * Version 1.3 would remove the deprecated bits of API entirely. diff --git a/rest_framework/__init__.py b/rest_framework/__init__.py index b9da046ae..eacc8dca0 100644 --- a/rest_framework/__init__.py +++ b/rest_framework/__init__.py @@ -23,3 +23,11 @@ HTTP_HEADER_ENCODING = 'iso-8859-1' ISO_8601 = 'iso-8601' default_app_config = 'rest_framework.apps.RestFrameworkConfig' + + +class RemovedInDRF310Warning(DeprecationWarning): + pass + + +class RemovedInDRF311Warning(PendingDeprecationWarning): + pass diff --git a/rest_framework/decorators.py b/rest_framework/decorators.py index f6d557d11..30bfcc4e5 100644 --- a/rest_framework/decorators.py +++ b/rest_framework/decorators.py @@ -14,6 +14,7 @@ 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 @@ -225,7 +226,7 @@ def detail_route(methods=None, **kwargs): 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.", - DeprecationWarning, stacklevel=2 + RemovedInDRF310Warning, stacklevel=2 ) def decorator(func): @@ -243,7 +244,7 @@ def list_route(methods=None, **kwargs): 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.", - DeprecationWarning, stacklevel=2 + RemovedInDRF310Warning, stacklevel=2 ) def decorator(func): diff --git a/rest_framework/filters.py b/rest_framework/filters.py index 7989ace34..bb1b86586 100644 --- a/rest_framework/filters.py +++ b/rest_framework/filters.py @@ -17,6 +17,7 @@ from django.utils import six from django.utils.encoding import force_text from django.utils.translation import ugettext_lazy as _ +from rest_framework import RemovedInDRF310Warning from rest_framework.compat import ( coreapi, coreschema, distinct, is_guardian_installed ) @@ -299,7 +300,7 @@ class DjangoObjectPermissionsFilter(BaseFilterBackend): warnings.warn( "`DjangoObjectPermissionsFilter` has been deprecated and moved to " "the 3rd-party django-rest-framework-guardian package.", - DeprecationWarning, stacklevel=2 + RemovedInDRF310Warning, stacklevel=2 ) assert is_guardian_installed(), 'Using DjangoObjectPermissionsFilter, but django-guardian is not installed' diff --git a/rest_framework/routers.py b/rest_framework/routers.py index 2c24f9099..1cacea181 100644 --- a/rest_framework/routers.py +++ b/rest_framework/routers.py @@ -25,7 +25,9 @@ from django.urls import NoReverseMatch from django.utils import six from django.utils.deprecation import RenameMethodsBase -from rest_framework import views +from rest_framework import ( + RemovedInDRF310Warning, RemovedInDRF311Warning, views +) from rest_framework.response import Response from rest_framework.reverse import reverse from rest_framework.schemas import SchemaGenerator @@ -43,7 +45,7 @@ class DynamicDetailRoute(object): "`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.", - DeprecationWarning, stacklevel=2 + RemovedInDRF310Warning, stacklevel=2 ) return DynamicRoute(url, name, True, initkwargs) @@ -54,7 +56,7 @@ class DynamicListRoute(object): "`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.", - DeprecationWarning, stacklevel=2 + RemovedInDRF310Warning, stacklevel=2 ) return DynamicRoute(url, name, False, initkwargs) @@ -77,7 +79,7 @@ def flatten(list_of_lists): class RenameRouterMethods(RenameMethodsBase): renamed_methods = ( - ('get_default_base_name', 'get_default_basename', PendingDeprecationWarning), + ('get_default_base_name', 'get_default_basename', RemovedInDRF311Warning), ) @@ -88,7 +90,7 @@ class BaseRouter(six.with_metaclass(RenameRouterMethods)): def register(self, prefix, viewset, basename=None, base_name=None): if base_name is not None: msg = "The `base_name` argument is pending deprecation in favor of `basename`." - warnings.warn(msg, PendingDeprecationWarning, 2) + warnings.warn(msg, RemovedInDRF311Warning, 2) assert not (basename and base_name), ( "Do not provide both the `basename` and `base_name` arguments.") diff --git a/tests/test_decorators.py b/tests/test_decorators.py index 9c6a899bf..13dd41ff3 100644 --- a/tests/test_decorators.py +++ b/tests/test_decorators.py @@ -3,7 +3,7 @@ from __future__ import unicode_literals import pytest from django.test import TestCase -from rest_framework import status +from rest_framework import RemovedInDRF310Warning, status from rest_framework.authentication import BasicAuthentication from rest_framework.decorators import ( action, api_view, authentication_classes, detail_route, list_route, @@ -290,7 +290,7 @@ class ActionDecoratorTestCase(TestCase): raise NotImplementedError def test_detail_route_deprecation(self): - with pytest.warns(DeprecationWarning) as record: + with pytest.warns(RemovedInDRF310Warning) as record: @detail_route() def view(request): raise NotImplementedError @@ -303,7 +303,7 @@ class ActionDecoratorTestCase(TestCase): ) def test_list_route_deprecation(self): - with pytest.warns(DeprecationWarning) as record: + with pytest.warns(RemovedInDRF310Warning) as record: @list_route() def view(request): raise NotImplementedError @@ -317,7 +317,7 @@ class ActionDecoratorTestCase(TestCase): 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(DeprecationWarning): + with pytest.warns(RemovedInDRF310Warning): @list_route(url_path='foo_bar') def view(request): raise NotImplementedError diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 807006858..2fabdfa05 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -12,8 +12,8 @@ from django.test import TestCase from django.urls import ResolverMatch from rest_framework import ( - HTTP_HEADER_ENCODING, authentication, generics, permissions, serializers, - status, views + HTTP_HEADER_ENCODING, RemovedInDRF310Warning, authentication, generics, + permissions, serializers, status, views ) from rest_framework.compat import PY36, is_guardian_installed, mock from rest_framework.filters import DjangoObjectPermissionsFilter @@ -427,7 +427,7 @@ class ObjectPermissionsIntegrationTests(TestCase): 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, DeprecationWarning) + self.assertIs(w[-1].category, RemovedInDRF310Warning) self.assertEqual(str(w[-1].message), message) def test_can_read_list_permissions(self): diff --git a/tests/test_routers.py b/tests/test_routers.py index c74055347..a3a731f93 100644 --- a/tests/test_routers.py +++ b/tests/test_routers.py @@ -10,7 +10,9 @@ from django.db import models from django.test import TestCase, override_settings from django.urls import resolve, reverse -from rest_framework import permissions, serializers, viewsets +from rest_framework import ( + RemovedInDRF311Warning, permissions, serializers, viewsets +) from rest_framework.compat import get_regex_pattern from rest_framework.decorators import action from rest_framework.response import Response @@ -508,7 +510,7 @@ class TestBaseNameRename(TestCase): def test_base_name_argument_deprecation(self): router = SimpleRouter() - with pytest.warns(PendingDeprecationWarning) as w: + with pytest.warns(RemovedInDRF311Warning) as w: warnings.simplefilter('always') router.register('mock', MockViewSet, base_name='mock') @@ -535,7 +537,7 @@ class TestBaseNameRename(TestCase): msg = "`CustomRouter.get_default_base_name` method should be renamed `get_default_basename`." # Class definition should raise a warning - with pytest.warns(PendingDeprecationWarning) as w: + with pytest.warns(RemovedInDRF311Warning) as w: warnings.simplefilter('always') class CustomRouter(SimpleRouter): From 7eac86688a73503c6668568ad564f6b2539049f0 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Sun, 3 Mar 2019 10:39:08 -0800 Subject: [PATCH 129/185] Remove executable bit from static assets (#6484) These files are simply static assets and do not require an executable bit. They are never intended to be executed as standalone scripts. --- docs_theme/css/bootstrap-responsive.css | 0 docs_theme/css/bootstrap.css | 0 docs_theme/js/bootstrap-2.1.1-min.js | 0 .../docs/css/jquery.json-view.min.css | 0 .../rest_framework/docs/js/jquery.json-view.min.js | 0 .../rest_framework/fonts/fontawesome-webfont.eot | Bin .../rest_framework/fonts/fontawesome-webfont.svg | 0 .../rest_framework/fonts/fontawesome-webfont.ttf | Bin .../rest_framework/fonts/fontawesome-webfont.woff | Bin 9 files changed, 0 insertions(+), 0 deletions(-) mode change 100755 => 100644 docs_theme/css/bootstrap-responsive.css mode change 100755 => 100644 docs_theme/css/bootstrap.css mode change 100755 => 100644 docs_theme/js/bootstrap-2.1.1-min.js mode change 100755 => 100644 rest_framework/static/rest_framework/docs/css/jquery.json-view.min.css mode change 100755 => 100644 rest_framework/static/rest_framework/docs/js/jquery.json-view.min.js mode change 100755 => 100644 rest_framework/static/rest_framework/fonts/fontawesome-webfont.eot mode change 100755 => 100644 rest_framework/static/rest_framework/fonts/fontawesome-webfont.svg mode change 100755 => 100644 rest_framework/static/rest_framework/fonts/fontawesome-webfont.ttf mode change 100755 => 100644 rest_framework/static/rest_framework/fonts/fontawesome-webfont.woff diff --git a/docs_theme/css/bootstrap-responsive.css b/docs_theme/css/bootstrap-responsive.css old mode 100755 new mode 100644 diff --git a/docs_theme/css/bootstrap.css b/docs_theme/css/bootstrap.css old mode 100755 new mode 100644 diff --git a/docs_theme/js/bootstrap-2.1.1-min.js b/docs_theme/js/bootstrap-2.1.1-min.js old mode 100755 new mode 100644 diff --git a/rest_framework/static/rest_framework/docs/css/jquery.json-view.min.css b/rest_framework/static/rest_framework/docs/css/jquery.json-view.min.css old mode 100755 new mode 100644 diff --git a/rest_framework/static/rest_framework/docs/js/jquery.json-view.min.js b/rest_framework/static/rest_framework/docs/js/jquery.json-view.min.js old mode 100755 new mode 100644 diff --git a/rest_framework/static/rest_framework/fonts/fontawesome-webfont.eot b/rest_framework/static/rest_framework/fonts/fontawesome-webfont.eot old mode 100755 new mode 100644 diff --git a/rest_framework/static/rest_framework/fonts/fontawesome-webfont.svg b/rest_framework/static/rest_framework/fonts/fontawesome-webfont.svg old mode 100755 new mode 100644 diff --git a/rest_framework/static/rest_framework/fonts/fontawesome-webfont.ttf b/rest_framework/static/rest_framework/fonts/fontawesome-webfont.ttf old mode 100755 new mode 100644 diff --git a/rest_framework/static/rest_framework/fonts/fontawesome-webfont.woff b/rest_framework/static/rest_framework/fonts/fontawesome-webfont.woff old mode 100755 new mode 100644 From ac4c78967ad96ccf6c46e6464b6e9298cfbb7734 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Sun, 3 Mar 2019 15:33:16 +0100 Subject: [PATCH 130/185] Update version for v3.9.2 release. --- rest_framework/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rest_framework/__init__.py b/rest_framework/__init__.py index eacc8dca0..55c06982d 100644 --- a/rest_framework/__init__.py +++ b/rest_framework/__init__.py @@ -8,7 +8,7 @@ ______ _____ _____ _____ __ """ __title__ = 'Django REST framework' -__version__ = '3.9.1' +__version__ = '3.9.2' __author__ = 'Tom Christie' __license__ = 'BSD 2-Clause' __copyright__ = 'Copyright 2011-2019 Encode OSS Ltd' From 0ab527a3df39e344904f1e6543d76b6ce9b45c61 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Sun, 3 Mar 2019 15:46:57 +0100 Subject: [PATCH 131/185] Updated release notes for v3.9.2 --- docs/community/release-notes.md | 39 +++++++++++++++++++++++++++++++-- 1 file changed, 37 insertions(+), 2 deletions(-) diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index 62ad95723..288bf6d58 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -40,9 +40,25 @@ You can determine your currently installed version using `pip show`: ## 3.9.x series -### 3.9.2 - IN DEVELOPMENT +### 3.9.2 -... +**Date**: [3rd March 2019][3.9.1-milestone] + +* Routers: invalidate `_urls` cache on `register()` [#6407][gh6407] +* Deferred schema renderer creation to avoid requiring pyyaml. [#6416][gh6416] +* Added 'request_forms' block to base.html [#6340][gh6340] +* Fixed SchemaView to reset renderer on exception. [#6429][gh6429] +* Update Django Guardian dependency. [#6430][gh6430] +* Ensured support for Django 2.2 [#6422][gh6422] & [#6455][gh6455] +* Made templates compatible with session-based CSRF. [#6207][gh6207] +* Adjusted field `validators` to accept non-list iterables. [#6282][gh6282] +* Added SearchFilter.get_search_fields() hook. [#6279][gh6279] +* Fix DeprecationWarning when accessing collections.abc classes via collections [#6268][gh6268] +* Allowed Q objects in limit_choices_to introspection. [#6472][gh6472] +* Added lazy evaluation to composed permissions. [#6463][gh6463] +* Add negation ~ operator to permissions composition [#6361][gh6361] +* Avoided calling distinct on annotated fields in SearchFilter. [#6240][gh6240] +* Introduced `RemovedInDRF…Warning` classes to simplify deprecations. [#6480][gh6480] ### 3.9.1 @@ -1149,6 +1165,7 @@ 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 [gh2013]: https://github.com/encode/django-rest-framework/issues/2013 @@ -2071,3 +2088,21 @@ For older release notes, [please see the version 2.x documentation][old-release- [gh6330]: https://github.com/encode/django-rest-framework/issues/6330 [gh6299]: https://github.com/encode/django-rest-framework/issues/6299 [gh6371]: https://github.com/encode/django-rest-framework/issues/6371 + + +[gh6480]: https://github.com/encode/django-rest-framework/issues/6480 +[gh6240]: https://github.com/encode/django-rest-framework/issues/6240 +[gh6361]: https://github.com/encode/django-rest-framework/issues/6361 +[gh6463]: https://github.com/encode/django-rest-framework/issues/6463 +[gh6472]: https://github.com/encode/django-rest-framework/issues/6472 +[gh6268]: https://github.com/encode/django-rest-framework/issues/6268 +[gh6279]: https://github.com/encode/django-rest-framework/issues/6279 +[gh6282]: https://github.com/encode/django-rest-framework/issues/6282 +[gh6207]: https://github.com/encode/django-rest-framework/issues/6207 +[gh6455]: https://github.com/encode/django-rest-framework/issues/6455 +[gh6422]: https://github.com/encode/django-rest-framework/issues/6422 +[gh6430]: https://github.com/encode/django-rest-framework/issues/6430 +[gh6429]: https://github.com/encode/django-rest-framework/issues/6429 +[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 From ac7b20cca2f7189f44fd3b86a9339d8f1763f17a Mon Sep 17 00:00:00 2001 From: SrdjanCosicPrica Date: Mon, 4 Mar 2019 14:46:14 +0100 Subject: [PATCH 132/185] Fix get_search_fields example (#6487) --- docs/api-guide/filtering.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/api-guide/filtering.md b/docs/api-guide/filtering.md index aff267818..8a500f386 100644 --- a/docs/api-guide/filtering.md +++ b/docs/api-guide/filtering.md @@ -220,10 +220,13 @@ By default, the search parameter is named `'search`', but this may be overridden To dynamically change search fields based on request content, it's possible to subclass the `SearchFilter` and override the `get_search_fields()` function. For example, the following subclass will only search on `title` if the query parameter `title_only` is in the request: - class CustomSearchFilter(self, view, request): - if request.query_params.get('title_only'): - return ('title',) - return super(CustomSearchFilter, self).get_search_fields(view, request) + from rest_framework import filters + + class CustomSearchFilter(filters.SearchFilter): + 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) For more details, see the [Django documentation][search-django-admin]. From dfc277cce669af8c574c5fd0ac0a3a432b6d45e6 Mon Sep 17 00:00:00 2001 From: Luoxzhg Date: Tue, 5 Mar 2019 18:50:13 +0800 Subject: [PATCH 133/185] Corrected tutorial 1 example renderer output to bytes. (#6486) --- docs/tutorial/1-serialization.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorial/1-serialization.md b/docs/tutorial/1-serialization.md index ec507df05..07ee8f208 100644 --- a/docs/tutorial/1-serialization.md +++ b/docs/tutorial/1-serialization.md @@ -150,7 +150,7 @@ At this point we've translated the model instance into Python native datatypes. content = JSONRenderer().render(serializer.data) content - # '{"id": 2, "title": "", "code": "print(\\"hello, world\\")\\n", "linenos": false, "language": "python", "style": "friendly"}' + # b'{"id": 2, "title": "", "code": "print(\\"hello, world\\")\\n", "linenos": false, "language": "python", "style": "friendly"}' Deserialization is similar. First we parse a stream into Python native datatypes... From 9d06e43d05abf1ec57f15566b29ad53ac418ae05 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 5 Mar 2019 03:11:46 -0800 Subject: [PATCH 134/185] Replace type('') with six.text_type (#6482) As all source files import unicode_literals, type('') is always equivalent to six.text_type (str on Python 3 and unicode on Python 2). Removes the need to call type(), is more explicit, and will be easier to catch places to change for when it is time to eventually drop Python 2. --- rest_framework/fields.py | 4 ++-- rest_framework/relations.py | 2 +- tests/test_pagination.py | 9 +++++---- tests/test_validation.py | 3 ++- 4 files changed, 10 insertions(+), 8 deletions(-) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index b5fafeaa3..c8f65db0e 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1486,7 +1486,7 @@ class MultipleChoiceField(ChoiceField): return dictionary.get(self.field_name, empty) def to_internal_value(self, data): - if isinstance(data, type('')) or not hasattr(data, '__iter__'): + if isinstance(data, six.text_type) 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') @@ -1660,7 +1660,7 @@ class ListField(Field): """ if html.is_html_input(data): data = html.parse_html_list(data, default=[]) - if isinstance(data, (type(''), Mapping)) or not hasattr(data, '__iter__'): + if isinstance(data, (six.text_type, 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') diff --git a/rest_framework/relations.py b/rest_framework/relations.py index e8a4ec2ac..31c1e7561 100644 --- a/rest_framework/relations.py +++ b/rest_framework/relations.py @@ -518,7 +518,7 @@ class ManyRelatedField(Field): return dictionary.get(self.field_name, empty) def to_internal_value(self, data): - if isinstance(data, type('')) or not hasattr(data, '__iter__'): + if isinstance(data, six.text_type) 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/tests/test_pagination.py b/tests/test_pagination.py index d9ad9e6f6..6d940fe2b 100644 --- a/tests/test_pagination.py +++ b/tests/test_pagination.py @@ -5,6 +5,7 @@ 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 @@ -207,7 +208,7 @@ class TestPageNumberPagination: ] } assert self.pagination.display_page_controls - assert isinstance(self.pagination.to_html(), type('')) + assert isinstance(self.pagination.to_html(), six.text_type) def test_second_page(self): request = Request(factory.get('/', {'page': 2})) @@ -313,7 +314,7 @@ class TestPageNumberPaginationOverride: ] } assert not self.pagination.display_page_controls - assert isinstance(self.pagination.to_html(), type('')) + assert isinstance(self.pagination.to_html(), six.text_type) def test_invalid_page(self): request = Request(factory.get('/', {'page': 'invalid'})) @@ -368,7 +369,7 @@ class TestLimitOffset: ] } assert self.pagination.display_page_controls - assert isinstance(self.pagination.to_html(), type('')) + assert isinstance(self.pagination.to_html(), six.text_type) def test_pagination_not_applied_if_limit_or_default_limit_not_set(self): class MockPagination(pagination.LimitOffsetPagination): @@ -631,7 +632,7 @@ class CursorPaginationTestsMixin: assert current == [1, 1, 1, 1, 1] assert next == [1, 2, 3, 4, 4] - assert isinstance(self.pagination.to_html(), type('')) + assert isinstance(self.pagination.to_html(), six.text_type) def test_cursor_pagination_with_page_size(self): (previous, current, next, previous_url, next_url) = self.get_pages('/?page_size=20') diff --git a/tests/test_validation.py b/tests/test_validation.py index 8b71693c5..4132a7b00 100644 --- a/tests/test_validation.py +++ b/tests/test_validation.py @@ -5,6 +5,7 @@ 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 @@ -111,7 +112,7 @@ class TestAvoidValidation(TestCase): assert not serializer.is_valid() assert serializer.errors == { 'non_field_errors': [ - 'Invalid data. Expected a dictionary, but got %s.' % type('').__name__ + 'Invalid data. Expected a dictionary, but got %s.' % six.text_type.__name__ ] } From 9e1e32f678fad5b0222b4cec092abfd34c2d8fa0 Mon Sep 17 00:00:00 2001 From: Asif Saif Uddin Date: Thu, 7 Mar 2019 15:22:00 +0600 Subject: [PATCH 135/185] upgraded pytest dependencies (#6492) --- 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 fbddc4f20..a2a2fa753 100644 --- a/requirements/requirements-testing.txt +++ b/requirements/requirements-testing.txt @@ -1,4 +1,4 @@ # Pytest for running the tests. -pytest==3.6.2 -pytest-django==3.3.2 -pytest-cov==2.5.1 +pytest==4.3.0 +pytest-django==3.4.8 +pytest-cov==2.6.1 From fd32dd7ca4fa584efc31e1d913bbca7ffbd1c586 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Thu, 7 Mar 2019 01:44:20 -0800 Subject: [PATCH 136/185] Explicitly raise exc in 'raise_uncaught_exception' (#6435) --- rest_framework/views.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/rest_framework/views.py b/rest_framework/views.py index 04951ed93..9d5d959e9 100644 --- a/rest_framework/views.py +++ b/rest_framework/views.py @@ -463,7 +463,7 @@ class APIView(View): renderer_format = getattr(request.accepted_renderer, 'format') use_plaintext_traceback = renderer_format not in ('html', 'api', 'admin') request.force_plaintext_errors(use_plaintext_traceback) - raise + raise exc # Note: Views are made CSRF exempt from within `as_view` as to prevent # accidental removal of this exemption in cases where `dispatch` needs to From 86c72bb2268ad06c503de4fb7caa46c9e495f8d8 Mon Sep 17 00:00:00 2001 From: Kevin Brown Date: Thu, 7 Mar 2019 05:26:03 -0500 Subject: [PATCH 137/185] 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 138/185] 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 zcmZ^~1yodD*FQcqgLKyr(jm;y-ObRQ(%m^AC?z?Jq%_i9LxX^HDBU4QNuz*@fP(+= z`@He|pY{G`t(kRa-?Q)DXWtV$J|{s}Ta^Hh77qXb5U8su=>q_0tf=cdTx`@YZnp#u zityA`QBhZ2QISd4&)dn>!w~@BOtrVMnOEoK9JjT#u^FG@;llF^){l>e>)X7W=^tSN zl4m%ks6+YqeDHBE(5|R$gt%{lk|Rl!o-SkM1j1s?7BMS&mad6p?=bI0EF!8IuzbqP zC^;~WW##g-EOiYB`}?yo9C)&_$Rk$CB0N$b7nMewu`vZn#PnheYezNBL@dQ%ies!1 zMR>g2hYyouW3#8+N~o*t9;#jiKSn(1+n24S&aC>CWFHN{mu(Bl#ss2~M#k-wGk@hP9uP-k;6 z4W~H?fIYk&ZBja45*wKH_xFDq>~A^`leg1*Y#L7!pTk=S2KU_b_cQSUgmA_w*9`KV zJTPB7@B7->*!2GV^T$~j8~b_!AO8i%?>~Q@&HefFf(k?UldX+d3J$=l*s1BdIB67R zaiEWynLhyVi0tnd4Un5p4FF)WyBeAXm})^K?7cntY#qGq9Qk0LKB(3JfD}vub?NCC zV9Nya^zibRfJs08r-cOS`Y)OPG1EUy0^Fq^n`-GYDSG=kG70ku@qr)9;4v{VN%=WA zN$4x7{1-dwpY&swfB+u}e*WO#V7_2MK5su~eu%iZI6qi`UqIjqs>Kuk5U&7R*b^^* zmVZ6uzn`Pz=x^`m>J#AV?Zx!>xwdxRfdSHwAO98fKc9c;8Q|*lzmmNC|EpW54)XuK z!w=yD^Z#FLjxg8%2ixB}|4%jt`~T^cPoSU2KYenr=XdmQ^mOzJ@JI1M{!eiz+x`#Z z|4&Jnt<8-i>@DH?ebF>fmxA%p5YyXUX1zTtSegF(Kf)_&(Pc3L*}1uc>ev%B*-Vq zC-g7ge{b<$%u@V+XVSmTtba}0f2gQ=D}#sP{O>hD2G5-6oaw!}FUmlG5u9GI8Vj9az8pIbMEHd^B>;s{g` z(e&VxDA71($fpsj;Swtx#FV8MzSViNbN|PErKYzgXld)0WO!fC&zfJq+?LG$v>7k0 zx2>4Gy?*EuWLe;x`TaJ}(aEWHTw^6PatZ5m{^$I;RudPG3f@}ZqzBDOc$TpH0bL)4 zNw@Xl$|X6QRfRwEcO+jNEFzuYy0XZ`W~3=^((SNDaT>7iTlggcqcr*$te*#xM0=`x zDp&8H_}OCS!0tlo<7rvdKx`?M!R~H zo1G)xC8jAR$FSEI8B~u|ZYjr7&;rIucCo0GTD%PXWljsN*buC=cy-`F-kI zaK>pgRjL(1&S`Y&;**@jq1f4()foFfQ3h~rOT#x z@9j`T+Mal`&6AOuts;fZNjJkJ31ugNIxmv~1dBaqSXCzbI2ve8vR~fP?ClO^#-lpE zc09jn`q5OvS;f$oC zQAJt81#L^|pghnhY$KY{aysZE`Vp`$I+zHzJ9FH9Gk{5Tc~+oRqGp{F7q4#Ao7nJk zL$Kn#@2vX7F-I8$gMQ=GrPg^6-nJB%^xUn8KBcY2X)5t*%+B8uf+=3Los&}Hg{GOG z!+V@vS43;}{F4iQAL>o7%P4ac`oL5}l{6*$v(qOBEa>bx8P%MJQ;m2O?`iEz-NGoM ziXZ9*%S>{t73Sr3Jh5@?p|fJTL-jmU&x7(JawmyC%sDL}%~gRduH=_kmJW`1W`ctn z!)}Cp=fMiIdy7e=R{RlK?&eyIg-(CMUuda3uZPhI!w-W!f~Xm+ia=YbST>^qJ{(O? zrkPUrXd$v*B)sL#U(bNd zqbCg44@@27{2koK^z0974a^9{%VWq@oX1Sv-HY;`U#Q7JRV+H{vTnNqo8ggPH#<0! z9(Br|n`l@&3$qv%e2jOO^vl16GP@&MAk2v}medP!PVH9@Ro2s!0d;GUk+xE`1Qs>n z0^AdtJ;Pq}oW+8LLy`g*FP*Sw$({h+YF-Z{4RW(n?Vm52dnAkBCRHR(Uauk-N|b6D0-pHxjtI0QNg)KjpMvD1djkIJtm=@O1xGl_awa?l;DOw7+G)~Wifw~~aU zO{fK4hzPm5EKq$Lx%=ZjGAdN@G~~~iHfE!0cSU755CmDb&y0-_psdYX?)(Xn0J6Kb z%5a}i0^IONc{sO-Rv&4$1{1r?ByzLmh2K=+mblDfsK}QnELj>68?o#ZmlrEKTzVNRBn4QwGs61hhZg5>3YM+T(SZ`d?ACp+EM=ZNC!I!Xt#S=l* z+qPu|A4Z#S#7roH+DgT@)(>XZrvl+Y#3-b{0!(_2! zFM`|uD?J$*?KuRi`2M{hd9b@n3m&##~S?*|kG@1EfHE-nC|)L3oK)Af7;T4M5A zl4dVd^00k`mIEgO1Ud-k(qh@-0v0c$m{?**l!j^R(c3{osq9}C|9dh^@YTTOjc{}Y zuq!?02R;CNlCq^z&^VfCHy#6Ic`ZsBML))mb@NDkXfiYLQrRqUwmhWhYPZM*fz# zU(&)NR05bVF^&))tKje9BJyrG%g6`z`zCE(3?D@bD5ewU$A(R;n=P=s4Zxnxwd(N& z&?mn{*w$;udO=$@4LCvx54EU0g>4tVal~bb3vwOHA)pX5cl?G#-zfFNG3p+{PYlG@ zvbdyOj9FB$b$h(;#H}XQ#FVB9D=e8Dqsx5*A~aHR?@my*G`x->{?M=CLdwB#o9?g|;zrm?*2H^~2ff zIk;Pb4N-H8W+ zp^5<9?a=1PlW)H=y7}rk15EmF(G}j(T6%H7DL$2d^!n!BIVk}8C z+AJ|=&w>m6Vz?A{N#RC7bW*G}wpjN?5BWtXh2dq%ION{4`i^HO9Z;T2D5DR^PC{~v zvml`7FJB{yIbCy%=&1B1E5X}$R)%BAAyq{4dcL`qoM7e-|dnqe_acsp+=KS}X z1r1^h%`2D36!hog%Lb|9Qn3T_*CWNdE$43GjF{V3 zTvwi8a_~idR#JMM#1-P2aQIm`v@NtXZWgyU?*kfpP5&}y`QYnHV#LO7WO*o=s4l;I)H&Kp(w$PI5${+Kb0N>jg{jtS_X} zho4gCQZGph)JI*hOGciTV0;DB-s4G%Kcg@>=?om8(M$7|hT(h-dWkYuacWGXMJ-m0sTL{)Aey=D?fb{-rrT) zb8BT2b6Pi#6k%CH2*nrLKsh0eLV_>r%=Fw=?TNl{=24_Lr}Mph)jQ#+JXOFT&$B?^O6W(v0fu45PuYTv9PjiwSK+#kpNIh=i~*Om%wb~ z2~!Q&K;}6F1r?|`U>`1SNnY!`hMVI|+2*jeS_elIZdtVtL!vXV+>W+kopZ(@(eQ0vu=_c}1zy)@!`nME8?S z7#7ZFF0fGdq325>EDUT#W4&q!#Sw~OOk3EdhSu|>GLC9lgfTPMD=L`3a{l$2@^zDf z`SNfXnY+y z)RQm%ZFU*UHgai~E*(SV*|1Qd_;_wYW6vL`5>D3sY^1W8>^tjDiO2QqAy@+JTsgA! z^{Js&wad~kCMa<-^Yva{%1uug^=`bzVfUtjY9|Sc(A@H+eTnJEuyp1*!`_KOOddAb zO}!Zt7ws)OHr>Qwh(2E659%{PQxG$HCo+!r5dX_5D7u*W88;(Kf+6T&=CV(894 zhksYP!Os`|^%4FhyF)$H0axXfWXFv5ug)CVH&VUYfhnkA0J*?6(5q=8dmBxSGwc2J zZIB(O5UKAxfT`6#Xkyy5Zk-lvNU#8WQmyvqgI8@lR4W?s@nMt}6!qi66kFJ=K2M(zvx90@W z#5wWkN-$7S1lAomUBx0#O{X%~eU)2`xwhXcU&5Bc;Hc2F5*M{$Wqzy}qP#Q=$aZlih%b>H3vgJY1N_#Z zC!5=0+teX#NNJkuZH^y~F(Ut&Ed+U~+3O^RwTETA_SNAd7aQv*pi1QV@9j`%WILKW zW_0%))(uI^=!AYs#M=icd#U}msqC|?f?xy00Q^GIr#}M<>Emv zdMuP}d>h7?869G^JnlwQX4IReD^2{*V(RShqR`#*pTr5!K_zyE3T7TpF^M17#N&Vj zu7n_wjkR2{l)uHOT;@H*zqu=KVE|nztfp`#gM6pOi&(}&0`L&@i)=x>TlRkg9=A6s zsEPAD!>7V|qGh*1&}j%M(v9H#<}xfAlbpZK8|+W0IGQjPJ7{6&&)=Qx80@;~;Ze*}jCu zqQS-0j4Z$h7_`280too7wVfT7vuBwXVG;ylAkK6loflAY7=wVP4}XKs*g1QlLfm2! z?<$>Q%<=|tqVC>P4pLoLCW+?NLa9Xxucf0q3x*9!s zR&14>uDD33z26lu5x}7KY-v>0f|ilA!9k0oIz_uUAs8zQ8OLscz2bD%0-W%9NVclg zy#IFMgbC}c=51GEIxFN7*@UI%ieoDMZX+EIO`re=_yEpAvi3ZHr`5kb>YE&P zqq0YenefDKaDgcmJ-I1C4|n`>26fbqRI{X8Cv{RcRHG-rVkc_gjknVbTZPg6pze1= zj*9dY4*ch6b#DA``QM7XdRZZfY_C1qRtbYc^|rnL-b_Awnw79+JIMxUeZX( zFee=<@-?b8xzco~omaq}QsDU+Y_y}ILn{>5 zJ2V7z2J;6FKZ*X*@Vw*q7DUzU8;Ltfhl{x#U`Io zSm>_a9%<>1iHy-DxnIi^#4K(|4< zE_<=LjQ?ZFNy?_#>CJ&lPKWyXE4^e`M9axqLLn94jWAjI!G|~WY(4%PX@p1P#xhDq z8Qf=LDK#H|`7?p?2o~+>&$s7ZB}Ox)O7_OkW4Q^jN3ip`C71NVbA$~Hh_ByE(@x+( zJ|B;o17oQYoE)py`r9Qvtuj=^2BtRn{2mI zqYHK8$jvHjd802NvDxgs?QK^a(nwS&N#)EB(l@vTRB`j+;_-e0mB)bkHwDt!W{@piU|1A4X>?Hgx zb0T){FyZrFf7vjjkNpn2sHgi)y_eDg?9DtIU1(!;74$J826>cGq$*=S+~33`f^(S; z{M{zWUZ%JjX5j>Wf{^y2#enhOCCz7;P7P>1fqR?1+ogu5=72?f3)v@st~lg`uA>q_ z71?bb;v5M2&$jwu_}aR4Cl>v{s;Ku?-!J)?YYu9n(lXnhR*bH9p9{y{rQ0a7th$MI zfYk1VgST?Eyz*Uoq;_sc?e1O8-S1E%Zy4^r)EyrT# zVj#DBEUVsdJ_R zU-o8=q2E6OAaiFoU%+WztlfQjy5DvQ>u=D?mGXsX{jrRtw{^L8!)LJ3>IsrsOlFR2 zx@wp@X75fly6L@_uZes~M>slu#Q3>cQg72+4xFgH^Z5V>p(E@z-bdy9psY{^W?%B3 zp&l3QyF2mYrF==CSt-DB1w%UJ{ly4d`LPfs`wP(x#awZ|%e+SgsPYHsN1DpBS?NMk z_gV(prhWLCP>yH#E z!IcwZa-K6|B13-cLF*8^>Jk01G!ka!)^Q)xZ1AzG2jhzCLf@q_hg5*;1WhifJ=H9oUXx?|H>bjKmz>W@nd{e-_ zSfVMs(Nk#knjh;&FBV9lO4N`PF8)4)6rN>-#jx)Z7hHz%J;e}QE@vS)=LgZgVWD+v zbZIr>OH7(6Xxv@rNO3F`8DR>d_OD1*FwLm zNWTi6d!VK2F4VSVcl6t~$&R^6DUZzgIdfC7uW{c3r>WN1mh`WB$YKfs!-Qi@t<#EYMIEd=){ z2jVNY$@HvLMsb;)n=;g(1ye74tHWfZ&Cn5$C8hi8XO;|(5<8_mz%0r%i;ZM3gUSc| zIdxRdOvJK8JqxlzekXUNaSb9`q5RBd+u-d$HKpGKPX{`r6SJHiIB%GYRS)HhXh4P^ z!xl7^*cFMY*Jz?4R} zyjWz>da8a2;J7$L6jB)njEg*F_~Kfbn?g&3iZ!EZMY!=Og2=LKkWu|KSL!VhXU+Ky z48%-QJbD-Cs*(bc7WU9Lu^vhmD*J7M+vD^U8_OJap4LjmEPfV?r$YvrSq_$1kR5Qg z<>s!`uJc>2Z_m7beU-tzu3(4gwT?PU0M#4i=M1o8qaAFcc9S#}L999QDt=A66Fc9S z@^FC~-u8o3F9>vuO5SZNAuGV!VsUKke#I@0k88<#(Gk2u626MYSRjYtXB0XnLMMF% z3QO8X+Zocw7eQ%l>4O+_>jO#h8vEALd4lXUyBJK@6XbY-ODaaXU;(rbcS_&dx-#+% zc(?p|0_WTq!sdJWx2<^}o?G~DDUdujxlvxzcd`TZ?F1QwW#1@e{`Z3!wOQcVxQkPv6{nP~Bk7C;iz7^+fVxQ*(q9M7GV+7*DJ$F|&WH9TZ z-YOmbF};F&k-n4Nsr8I!x##*5o*7_qeq^4IxkGA!;F=ST3b_%epW`5WXo2mi3~mO_ z@09hFk2%~S=NC2CHBktlw9e#LT^HA7QUWAHBj4p{?jga?=zPm}moxqbyKTKp4SncF&K5&R8kw#Ae1gpM}5qw3mtrOz43Rl3S zb!r>z#pb6oG3_4QI{W&v5li8w?@2A^U4(hgDCHzE&Bn;oUBp;Y&xW!*Qm8V?1e7J= zJJLK@qE9l3B0@)c2h+w1ADn%18OXTV$*d!Nrv3ZU+Z7mo#$3Bb~R(J3-NNS5^Z9QLYn+%Jv&Nqii%1Lm zfV0_o+DCT!JsFkV%Gf~pKq@c=eDry*@5l3tDP7Fs1f~KSVHC8jBj14jc|^R^wu+(B zd}HmP7WHNC{!k3Y@i2Oo7esmQ@}@G$0zEztH6cNdsIT2qey4@;K2f7G01GDXN;e?y zg8=nA{q_`DSw)(&s08<#{D(ukk~!)XcY6lRaKvM@Rsw~3eq&YFI1)C!IQl`m7pp#@ z2v$Si!pcw^SRwket?yhOmD}Sr#!oDoC2_4e{**2h0Z_6EbhNKQR&Q9z=FcPp2PHpnoko4qna|nJK=(3v;x^ zdA%k-16eP^Z=+mR!C9s?3J`y}E9o9kRXLE zICRlut5o{`<$%}edp`@It&BJVWGKwz>Skv*n zzaKG1?2n3&W^A1}m+W@A$Tiftyzv~3C-_mhLhGPi4hRtc}Wc@N{&A-aCj3{c! z3r&?_f|w7n)xtQgyH*L7&y{&_6c^$6pR?UxFyCB-kUrXw@=_ti? zY)syv$;*j74OrJYPCI8%Q(My;&xLA)x)+8q3Sl#;SkV`Ym6Or0Y-K zVSDT!JK$;%lB&~v(0x}L#R6Tqb4s6+zf&hxj$y+s0x9=8WpF6#D-t%B2y>d3_A7t_{%Ix|@&6pBRovJz`4^@I#j5G5trfY_o`o@CJuys940^F|52uFBMMk`!b@Q3!(s07ZhER(N} zT{g1A6SWU^3WHK&&QO*O4I@*uryUUCVe>4)+SC@6Vwo+Z(3*A9BPKCYIQ$Udr3ZET zo5t#7;(Xt-MN`3Hn1Fp5HsY{f=Jdghj70J-8osKMnpwy)P?)=Y`~LhjR|XebSzU`+ ziy$F_HhNLhyw5D{7!XITh!6<(`Uv6jWlUnz)1gh48Y3n(q?3Dv7^68KGt=_~<@uvr zl|=t~LUynnW5l^lejo4|B=#qhPTt2Q5YicQy`_X(@(WhkuM0ioNXYBT0l?W}eI{^-nuLvl6kF-p-0-w$)Ukg5Ei4cx#A9 zFQ~`-_)&h>j(h>DoKw0)H@&hIRO5hYv0^N@akvr~J((K{tt$4K zX_Tm~#;<{oK>+$F zTP~KVC*;A}C)Fx_VyGQ9&nPN%N3eU0Spvx7g-vnRO%pgI z!J}tGwCszNr|<%yB$b%T z`u%>Ai9iGw#+sDaM5WPOI}ygb@}>&TS1n)#`KfCrHcsq$eX+;ga7cH>%0K|M@YLb} ztD9RYUfXtA1%)*&bg7aG){Qg_XUt{nt-u>Z=Mm>r?m8{V`Wf@ywe>&~)-tw!q|_D1 z=qo>`^C9g?{)?8pLx*2T3kT`xv1E$_#}&_KHD0B+M#L!O!s zD1;8}C*^ze_ISaAGT4Isd7$(;q)gaHyv6lrb*3=;HYJ?Ol#CiPKmmi{3;(;x>a6rQ zUEzgEAiQ-w;9G8DIQ6tekBHZ1(Zmt>fqees?>djwX6BAo_Hz^xAt+fLSo`Sy+-igK z3kW7sNL+QWGXgcf`!2YVJAl3g^GI7RrF1Y4i8zc_`IJ`{L(GO#U$VERQY$M|SI|`@ zBE7XB{1OF)sB(?^+Qe$rQnwGVZKg!us0un0xB5EXQo4{&vo0>V3)0JF)IPI%7L?j> z=Z~(s>b;61Pa<2b%F62l(rhADEHu**9LImT z<_ar{asFi(tz|lh@Zxe6uiBUy$f98WPoqJS4c|26+3)>E%@e=!TfcMp-=P4VA+s|^ z&|nsf>L-J~yZgOJfi&xBIaXpqe6+p3t@hk~F`x#UZ`?KdZqd<>MQckJ^0sblTl2bV ztW1OKMq3A}AzXJW^rDnq&5M^BV$s#v(aX&ys#?Ft#*uSgyzvVt<=PM1n!XPSDU#-i zYpK6N(`^(ZbDCN%ClhPVlzh+lVvH|si}Lt)bAd)I(wuN0@gbrl)9FkVJ~cg3ib+O%pv@x>z~W8 zBI=&sALp19`-K{Wz-;*fJk#;c$lRbCJAJz;X~-Wen<07fKs9$?1=ZYEg9Vvn_&}~- zlooC55z=I!BNy?$DYV2j4&=m3 zaL2X|`v(qbzTpLi>9K_T`i-u41KPplw4+CvBs*ugPkUI-B$dsqnVg>{>?Ouw9WuQzR(f=k8-I49 zoKDEPeM;1sszVj)-MakyzED#wC_?PHrjk^bc)!@{{0%i0`9djSdKy+kYWr8(*4Z*` z-T`e7$w4J!)!zOlk-K_Xvq2dj{L!DGDhoZ81#bymYx|Hlgnaf6QwUjm_@KCM{&x`{ z!Tl55S21K!yv?pNk5F)n#gsN|v}#v_h3+B?8)0q~?kUd}fDMUN_B5@(d>to}Dk;rv zzFNmFvQn8i&5xTC@AF0IozEN~aA}Al^&~2bl^z`8irxMI)tL}EZ?w&s&$QX{M=Vn$ zPT*z9(lW8<;8(0k9Ws*~U(I`nwbZ=XGqQFN$?f9&+TB5vi=*-?=PQ3;iM1D4Fhx{z zZyeIM3Hf9T3s51WyC_|xSDSDs$~j*SFx&PBM01=j!uxN4RxZK_%j{hw-J|jf+qO}Q ze8rqK?FHNF+PkWxJL0RMyaZgj`EFGuijQo2M1MqO=dqPhdn)4@cOj!v*sX)|E&2Nl zW3{vTWWLibVJ&zj_D|=4&jV=wp9k!&DwcZEaga`dZv#q(H(L8Mzti!Yzdg=LmI1{r zmBrk%I$j!#ec#1Hmx}WSIc3zt#~Gq$7LzpW&)@?$gj|K*BD316iB`u&HP3td7eJ2? zXdg|h7Tm^-xCv3fDam`lP{7qJ?Hh?gC&@7tIN4DM0F5j)+<;N)UYX!+_XUuB9Z>vm zq2do4SxWseg#NTRTb5KY#r@diA1)^JtO{}JE6v^!|Ix0^(-ZVe|Ub?J{7uTKVjnSB`eU~Xz zBu7WlODGAzxn%JqTnB=VMzC!8V}r2K&RzUD4+mFwk-smNmxwZMP4NyZ`e0_UNsRNH zp)!|U%-wUDy2MpN&lVcCll^nwQBJfMc*oR8Etm}*WRRtux_*-5m1#FuFn+o-;^5h) z)WeRsO>OhxX4=YM=q?|-NxqIKWLV3qeT|(m@OL6m^du=9TwX_b_kQZ!d3N<|TLNA< zvD<`zw@WGkMl60o#6S)V4dmeWX1b6!)i3Sb;cMI#+~bzw`7DCE8}!kxb5lq=)9@%r z*IKjrZG*f(7_OH@Q0e5Jq!Z3H-_fhz9dt_{%dlq|Y$i<<4{8l?WRLP55F$U$FW&M6 zEH1}G%B5Mar+;jv_TC@#2bv`?H65Ag=$d?|@d<}%{xB>JS%@~$dyJZC7X1Z4Hmxs# za74JLNcR)RP=&Ajflrf)~n^O_Lf}r z+iS(0vJN~YX;v?&IYsfuhA1c>rPG4)pgCcu;F5i{cocSE#Y~kjnB3+Osfj9dx`%f! zDag;l@@3i>fzwm`EF^`UKrKrwyg$I9gbX=gW?CT3Q%P9okQUaz{DOh-Ee%Ru>3nQh1ZcoNH zE?RfsR3~fVlj5_QtN90pmNOz`xSv~Ra_{Y}xIxctKm*(dIG$wz$p==VtJXj%p~JoQLV7G|4&Ni z$<$u%1h9dfpgo(9JA449n8-**@4tP@>`d`i(JcTHQ~mx?6nZVqOEPM+W50Z7!#Z2q zQnOF4t8knMVaXCEaMzk*IB}M%W@lOM(3?qXvCf#rfNdg0JHo3j=5XK4QpRQ7W&c4M zSyOk_GF-yqQZ zgeH>rbrEei=Xkb@n85rpk=<0~36>NYBl{>`17o1Umh6;grwi|q(({)W_qu9vdU~wS zNYA)0K;J+r#g8bJUJyP|t&&pk)Ag^lTnHN(7iPo0(YbrOb z+753uU_p9g9MI^`97W_#ZtXl9UQ;V!TIz&4dDmdeb}Q@*G&$G^v}ATcf`t2Hf9^H) ztvYxlA7O6$8}V396f^oNZrQ8lZRXFk-<}L*Z&BkT?R^uh=&B%A1*@90^)315ixz(5 zRgqb{o3tmzcrti(h)8Sv80#&vnqd?y>$Az@I-$w-V_NuSKX>ee)A9D>3flFao@NS( zOBeT5muSZ9-*OyNT@wk|@IswCT~-Q(gj$x>(kQa>WF?z*RZATXW{9uPNBj4yzHa;pss>0#Lq9oH%0*gZ6dcYd(|G#=;qf_~oB}&4bM-sHJS@aGAajK2ijLyb*{t$2 zLZeI*EbS12@kk$KqBCtSnpE#bTs|95Fq z@gnE71;LJDICkD{C|QEo9qvQ-29wY1B}oB@1X4gTPZC&NbcUm2j`1@4!WL}xB=X?X z&F4x$I+`&Dt-}(=CsM{At+41(|G*|j@d{@*V^z5TW!kR4OJlwOjqRl_a7yAecbm%|%flB0OUEuo^PM6y7&o9(2d(rEc0E3DD_$euioX}EnzLLiZYjUA~s z@)v6$Asp1FKXQh2qQ1Jw&0p>L9+Mo@l{oi7u%({t33c__4-tyJNcr*oA5gfj64~(|I3f0w~{|;&;wHCn}jb|Hc@)W>`fw=*?%y(;IR{BG) z6yq_=`Pn%!MIk5W&&)mJI&5T{-NcB%_-2^d1>qNW^F#` zw*>ksgAEH0*3=#?ORToL)f2S-eT+~L>A>jJ4S~(7l#dOBwW4SqnUm|r9*4psD^_U9 zqJ6jV|JWI3ufNO2o-`&z|5Ii;wHlg86bhL>o6Ju8HL(#cf*z!c6~PQOvZf%HIA}uf z0t}W{b@h^h&YQ)TkHc7+fv)NgQT+KYd&}f zuS~ZLOIAO$^@{ujLiKnw%Qw9#3M3Bua3g}>OhMM%!l1eE$Zal`E7Q&Cb_lj}<$1bn zmUCE%=W#XDaklx=SvZ?4jB!%sEF!&D5d&VQHRgthOYmbqM9kxW6^}8#(=AB02&QrMbc(!_O4*spr{<0Bd?+KNEYuG$P=sz?Esu zhVA$*`_S*40iyF$yx4D&b%^!8&ydOz9=5mS1_UN9g8ob{Sz_l&Cb+FgLqx|-q>7@u z2?~#N^>94M1n1->^@~qlA=DPI&R)6+`3$iMW$K3&&kLxyX2PFi{HvWvA`Idwrd1%*3Se1&y{ewrf z(+$ZWd)P(loib~rS#KD*cv**7@k@*%tA2}CTg>E?b`$&1n*!{(03og&N*XeudVf4s@x?e1+ z4B{u(6k#$Bm(;;3P7;=*y8ykHb&mNL&n`C$wdjzGSoX3m_vCU40+|O9 z`Z|AVWz5YUFmmzq65{J_$ZCk3)f3*p)H3dpa@ru*YmlGz;J!WN8{tZ))e}8J^iCA2 zg^msP+2{L;r1wV8j3Noz>p3Du9}FsA!xOLjTZe4?YS+l#f7d7Qe>tWl+C1<*8;}&2 z8JbQ$t=h95&gK1aVT)7JI6dU!$r0-K7BYOsmp-^2R>vov*CiL!Gd;?-F+Z4gHlj(y z_qCnmgWcU1HEy1t)t;>4ixs561xL`!ODtRnVj$1%C2~N@fE23;zH91h>Xd6kW0bA*@!jndob8;W>H+rvBuX-ZFLj zo=A5q@n<@CphVtc-wgCQ6B^KPXR}gJxUYy2Jq{|23&`Jr#T@fTzJiW9*aXUcaL+^?g8Ibw`Gv6*hiD*lB3eKKnJ%Qyq%1V%U~(tN+Fh!RB_N4j zvQmdi25W`-h_lkwzUu8Loft_j$SKHL=B4ESLKEpFdK?9(_WtB@)fPa_?()O#DZ25m zV+l=xH)41rbidTQx+3c-wg{A79E!|L(2HzRHRW0iXR%3&v~pBbB}aDP*WL%+Pqqod zmglfH2U5;)hJ#3y zE72>TH1{-!Otf0p`*9`U`Ar>m$N;uxnBJOS{dGXl7Tbc*5 zgM|okK<`lT1H+F`n8R`E)2HKEl5Uto^tiyk()8@82qf`=vVz()K2uVJ8w510B2$G7 z972l?q73kysDw$GpXGLcTqgk)Hf`cpemZnt#!pe{#_Od~n;+SIcaSU6qy$`wwM#Dj z7JKws;Fz1@n^pGFOZ%r#(d8}XY}DyNsp7RMNC_b*)=sJrR(2aDCX?r=TX!R}J=T`} zglI3_hw$m6)d($^mYUOt;P+=LYt)1J6ipyhS_zfSVMjq!P>~Pn5CjQZY1Ae9hqs#D zIkOLF&&eGz`)v+&(dueh7IRZ@ zZRFp&RN6BQ(%E@_@^p6etVbY62P^>agVnAy+$<|vmWJ3)W-a*0^x2r{%X?}oaWv{% zf|MF%t1F`;x2qadqKs_sxP}mO*?Tuc;UxRwIEFQVI?MI9JnzFeCE3L;`pujdD}Cck z>R5Wvxr}foMH9+@{U>NEd5bdjL^jrE^x6&Cg~mnH(Vd>L*Q7k38OXFET>aWwA-OxfU#|z%X<=7)zR|7$DLp-*DB-ECuE| z^o=C+?xv`qwNYQ0|m@S}9-Fa(8~$AZ+(19}RQ)Q}TS|C6ON=FYj*FA6QofsBEdCiuRL0 z-vk+>4R>EGfkp$*9Gn!Dl3Hj0)@wf@x4;AS6UCFgHS$0mU!6{5qp-snT%z$~l=)d; z@818%=?K!1CD@r-gG zAd7TSBclL&G`mPur5{(%ZgD=sqkJdRvnCR_kbEvvQc7?2)0H3!&&lHd1G7L(zk9vH z7B&gxP4Wu&g`rXjy;SCRumvi86ES@iMas8_}D$;PMhUI9oY< zNLCK)!|RYN-}ysXzT+-g-g&Jo-*h=16W<_m?74WI2%%oQIqz^?6J<1ku%!~ zNscu;UWYXM!w*)@1%2iy0804Ie9ev3+Azk;L6%XgqXrt^*+;C3G#T;PzDZ*k4fPY# zO-MeV2zX51;3u2Z8Yd5So%U?fc0gzj0WNN0dmX4~Gk#K`Wpb<49U2?9B6*;3-8Ydi zZb1S%TIL>nmMoonz8pUD0kV19(XwuFvH5uu{_U$ptcb#@XB}5c>k-cN`1|Q|_=N!^ zot3+8lI0t&k;U)-Ko+n4o-BVC$!){wA}8NhWPTBI`#_tFd~mcs)^TgpY8!;r8q6BF zhadFKOoFta8`FUtY0{(~GjXdns)EEt(il_;09Io{WpJJFegFVK07*naRQ42ajo{HY zJx#GCBjZ~gRFeuaeI|_`%*1h(T*Dh5b<=&_s*<+>>G0YTVE%)T>J*va_Si} zbJuM+mPkOZM01WeGlx~x1D-6i51+@1={i}u`fGCd@+)QW>W_+SK3i5!J0E`cAU60F zf-t?JddXlE8sR`nhFF`}*ACjSJtNSb<#m&wI*=n1cx(&;l6fE1lql#HSdC5)ROMzF z0K@cz%Fq!@oiX^1VqlohC=Uc}at_3GUCbz zuOu1i2eEZ%?P}}6+F7Kfr@nnR0{7>YRvQjb zEyOdh2_9{J5^Xp}!0`Rx&Ic6Jo^yLB& zc^N?n^%x-9CY>Y~w0%iT;$YxNMYk%$+br*xA)Z%%4*SxV$)=Y)RW`rsH)Z`f7s=AC zSONX;Mmewr8`7VDkNnOP?k(rM@U`-u7hNE7>7U5n^+)3%;jY@)g2cr=rsdmiz)IY8dTUQiCn52tH8k629d_ewBppVp;6)a2 zoY=e$)+|q?$9USTxHz|B92D*q?Zd|0w?B+avw7L_%Wssq3ontS+prmZ=dG%}f)&lu zHCM^APhOA%xpYGHvjy8mJQE*5H{2Q zNn|G;E7*vu-D*;bqiN$rn}daVPS@}SR&(&YAkdy=`guKc@{h5R+w5x(+MA^BnIkuc zqQv}JtpYSANk+j~oX?4^=&2zRS<+~MMK+muh1F5KliQgC9HcW466FkT(yZi{X|2bp zQPW9CAr|#sy8zTd$$2qq6Wh#MjIFKxL9$^oy5%OE^q<7#*-K^q$A1Pl({7cOz1Y9u zGe@p0;ES)v&Fz&ZJQN$xp)^Tpz5MC#yk0K4`9pHxs%vEB=pC4g`q5*s@ilxd@5ZX^ zhdX7%vtNVc_*^8*kBi)ngt?KI=iaUkqP49je(8*9A%31YF31oVi%%+S<;t&uI$HXv z-{rQPUQ-2Ofz|ZAC}{l{#TXfMAXKKJHT5*Xm~xO>)9OSCjT+zMbZ!EOy&1*pp3Xq$ z)UG$~Xd|swU!j3yaXWNnUnaAg#9h@C>2PD08z*s^g~$6;e+Z8X7Ha<;s=7OE+ALg$QnAhE-8C!#ilV-y#tyZ`&%6} zvsx{n!Nis06O6ec6E9XcKjQOqxvs&jF4}68216cfmsdv=hCb03jB!6p`&C>SSx1W< zvfdtXJ*9+%e(9Yp)HaUT)yjZ!w#Exg*wK7Z+QiOv=tKQ^0ch;YtlWj~(eL~$R!09D zHm)Cy%cX09?R2i`C7&m{>xXjoG1$+UKPvXz2wuG%eg1`V>CZh@!dp6=h$(k)w z>aBIKnjmK%^c30rb1%h8>C;G_cz|*ik0bb^L-XVF!ayft-yn^bXBE^NmIFDm2p^JD zX$;1USFujuNK;GdA-M+|R%>fGfU&HOA~%0bW_83kLJxDZYSAPybXP6fibQM7=9`LK zKP=EpFt!To`0;p{49SRzaz!6{1W)Z3{ObHE@!PH)2{oOBw18l6%zmY$y{rtxvq^^o zr=KLC$i^2w6SwrA*z6Z2Kkwm-0kZ0>~i=wxJg z+L~UOPC`O|`3a!sCdaQ6!~&8H#D!m0?nqAL?%HsVr9DJv?VgAA!-ypBp@-12T{3m4JDfg3o^V{)6 z>)h)1mEdyurW<7bNiUPRN1h>a?H8Ld*hv=rSF1u_8!QA>84)IAZFHkqeIElIX-a)m zu}a^BF6fJa}<|p z>B`8-gSl9hVibjILrf$YGIy-$vf1R`Aa8r~>*Rhnd`y<#|375M z$Noh2EaMrcP57Q$?5x)urdRMQ0n0mg;V$4SW#$Cjbz>6c)8u`H@$>Oa8W1EhZ^(k@ zd1L5~!!b$$Q|(N_hQm6t0K^yp7{cU=#8a;?42eyL?bGpoh=ULQZ8hy*=Mu_;iDf%+ zngMdh#2UV-xrI<(9R-~BhslU{({QJl?A)yP${5`PWjYCo9S;YAU+>UsS@MR)Wb&a+ zY_&~;u9z-aO5<$_mtK3nB^#gm6s$6i#Y58gng$NkVBt6Sw;nAw?!p&ggKco-44 z`^P2-{>IUcljU1?BN^R%UDEARgCBT5`k2SblV9{xa_E>-wl$U4I zC|a516Wr{vF4^<)=m3QAjmLJ*GZ_VDn)PnZM{FG;YR5C{}#F_^~TL1^}&&&}-J^ z-bAL+GzS6g@hIwN%&NH{sLGukJ1L3v^TRRh_|F*0UsL#CPCl95;Uc%xO14P!Wk*^M}VuaeobPr}zS9x2Or-LCc>VvyX3A5>e} za;kjdTh}Xg=(heMCj-hay!uu0r|~=5(0sF>z&Eu%a$S|R{{?eA(^F}>wa<31$>8ov@7I1( z?tRsJW#3)+k)>5WJh_5Z(#-5OnL7_Z@V0v@?Z=yUX0UC_Ru3u!z@&JyJBc2# z0Y9W>a;wc zjCFMs>?bQR*tKK?#s14Q*CB5^I&?(VT_-sra!LuQ(kI4-e;|>2Id;%+xugMe9Lft{_yW0g*FL#@--7(h%kPgT zy5A}Xk6Xnr1i;tI!2=k}Su%Svo~gpvFvDCAd;kLNSq|9-m&__C(P$b2Sc4TYklYa9O_s_&VEl#dT*tR|&-e0PSCh}su*3$mliRqErAJ`ph+T$$2B=$nXxNy>jQ@rl{S~DS5Q-Py|Prv zx=59Dbp#yZ#2;l-bN)}YE2r|N=2IUXB*pgX2#=gG{e)!Wvq5MS(ZJ;yF7ja+z{?EhEq0y@(ZgQ_fw*9%E z{TX@l+ukF;`I2YI#Y@wsLH?#Z5 zM{F-OkdKeSRUYm<%wlhZL1r*HK>Z{!xvObW4~jG9NQz@2j+bay81XNItoCv(+9Ppr zpUghs!SdnDJ|rJ*^x%DC>?sR>!7)ZV7)#0Gk4k z2V5;C(EgDwknoAyidEb3cru=P zdEpbvhG%yp9)I11c-|J@i)X&>fK3+4IpI&j??SQoWWxEvxpEsGa^(qX&TCLADVxp0vIMab(dB=i?8dzpr^xKgx=PGeFbFZo<>`+i-UjV__fJ zUtb94%aUGE1}4YOziP}oVt7Dz<4Iff>q-l^@548{aia!BJtH>lPmF*GcjHz@?3e4i zr#&0}=bbwXGySrx;yzKMIPi`UPpSApk&fd>0~1hxpdTkJmUJZ3^=CbA}z#Kv7W%ihQQr2N7M{zAU?l&8r0Eju*XWYA)h z^ZzlAd9+-A{S9*Izh5bz|Fx&dS#QSIOJ4SW$d<)jdil2D>MzLrwf`YY$DAaG&bd$) zPdZ1|?T2hXHs@g#Qw|gJkj(J6mySI~R_=xjC(VlPB_SZym^9i=#~g?xPjV!ICtq@& z9JhUghMt$2@A=fVO>)>^PpB4#1-;YHK2}cOu|?y+@BH0@g!BC$;CH3wp=Za;RQDc| zGtN0yPILI1fxnJ;`oW2R^l_Wzyoa8m{owrHcVJPj_%3cpu#mz2vgQf;!+r9Ai_Va3 zo9BRUR-&h$xJ~}~t2fH-TlUEMZ5!lAo^UUjWn$4`ugK-!yHgG@=`ooquQ8pxGf7Ye z-{(B=Bsl@U_OPT$EkU7CHo)$E=cYY!$IZLtnBzCg{Vw2mf=!x;YLUnd>lOx2_OD-a zhb*8Ug0C|xMe>hFL}v}e|o1Je)h{nPCs83&bYs9_|8{k7S9=N z`NDf-8NV2L`1Jc@)pVh(;O9ry@45}2?D+FbM;#|C+fS0M*L+Immbc4Y$Kh)wi})0_ z_;fmA0kb+l87Hia&V0y;^0EK%tVC<;?|xj~_D7$?BM&Dw$0(5o{p;_N-+29F=MC&cp`+?OWkoxc+YW&EI^yyz2Q6Hm>~bN4_O5dj;@k0e{mjdE%4K zmiPbu#Zi9CZM)@^r@R$?0E??0n&gV;%3I~9-|#s3oB#6Eh$ZofuU;=7`5>NV-+frN ztkTN>N3Hi$d>>3=QPe(L*j|0ka!2AGzQ`O=cv~HR4{c^0CN6)(pSo*MxJsJed85dW zJzswL6F179tG}wbbgXInWq@CL?JvrPQ_q&?zWkN)ODEqb3t#&TLV=hZ*eeI``$*aI zv|p5c7rj81w;n6=*Ih1KKJ#}n|E$jvxFhzMgVl*>%)~h$Aiw zies$I7#|K?2E6XYZ9=iJyy0aJ)yodSAE?t85haiHJ_J5o0=bhTet6SnZ5n{`la5T&w8cY{+L(clMt6_ zpZ8!@u%$x%=B!$`9}JL^-_fcv)VLJ%;7dB`M?QgXL+uhWxGrGJpOK`PpZ+ zKhLY3!rOh$JXRk0xSYbE(so!~9`;+7EKZ$CpF= z)j}3x`1-~z^7t1%Q2y7SJg4D@cP67JKl5*JlHpPemxNp?(9%KE54dDCo47*5k`eiQ z!QVniEJ1yAwS6=1fF71D+^;%9QN;K4)x~tFFX1 z4{*84e(I^kJvekcu8cSa3pZn@2`D5X*aZi0;E~8W35YTR_@bSAxExv3hB_Mug&-gh z`uKclkU9xqjFX80wD#rQO%R=7d=Ft`MxXlcqB>2W7jsk-m;_7aXws#%d{VP>bdf%x2Kn3pZ&(o^5o~d z1N%al#;4*^j7hF`EPM={he&$4rvua2dPEd5pq2vbg`SJn^yjmNQOne}(kxSKTU?{l`r*zrES0UWenejFrmHJ-A_j zF?|pFXm9`Ux8>9wn`Hwo$*#t{x%K*8GJD2RvV^3mD;e}f@96Q^^87)qhlg~S4;mId zrvSF(uOL9IW=E}L<1=HK{t5Un znMFccmOc1Grc1cAo8ip_&H)`CKG<1X0#aThR=N66Z{;_`m!(tXB9hZA7#UYaj1IFh z17U-;n(j&SWd{R+)Mu2Kl&CutKr_JG6YDqN(*h?bemGwz3GJ_8Sy{q_z@^*1N54{@ z^X7NpjugK9ihlaxjB)o<&wjF8aMWFL=nG$wrAz->e&UB8lz)HjDe@1$`jc|`4Y$c{ z8+OPEXWvgwIqTk*h~(EC)#mv}y8wqNX#$-n3n2fHzUAEuvIQjPv z{FH2DJCtu+w^J^<_-`-%T97DCJvzKV zGmd=WE}xuzJQ5a?$RX_S@RE&5Me(RlgU)fs%9c&Mq-%@X-2l6%5##XuQ06`shsNJ_ z=T-(1-v(ed!^SekJcmakHq#&H9}*WY+4QvlCGMeVR)Ri{Azxa025FGq`bhPAjmLXo z{ixMQ84LtU6N{~MY%ErH?6v~ksAEFni|iQCT&dN;CKPTXZ;_SVdvJ#hcOm%O*lS#P z={B?bPT6?hbLDd_dVPWjPi{f#W{Lci{f{&Ce{E_9A`I#BQh%mm3u4RCJp4})qA z8kbc{uY)aoNGWY|RJ(wN&0p4G)z8laU-$r3z|C(j{GDyX>%(?>BHzHX6n&hdku z=NIQCH>inY^1}ZZ7l^f3f(p%IW!TAuMU6?BYk$US4;UZ>hXKp(cEky50ka;n?F&q3 zQbLfcdrzEHK7b53{@l^>?gL0lc);)kd}85GSg&>ArQ6&c*URD)o-TjF#ZW#5vwz5io!;e|hnJ1FPk z6L6yri+7$lJSIDq+pqkhyzK*@miK+;dimN9kOa3qR#wi~ijxB?nHUHc5J&225zpwH zf=jWdUUU}CY1y^spnT)ArpI26^!_&y&CV?_awNqwK$BE6K zt(`(yM#9~6*Y&dJ*{_tJ|A#-4lm6dGs$Fd*ACpAq*2Y1RJ{@FX_cRu=M*@edr-0hY2#p!ZB_;fLpN7eXTs_(%a;NZ}}tj z#uX8h(Tz9WB=361JLNyW>9^&UTW*mDJ@~=0apOjTa^898%dfuf*W~0=PS#|^ zMC6l^uB>joR-XOSuano^d7kWgz;i^-dNB4HaC>_ONd!-NV^+fF&|$qHJX=|#bB8aR4 zyU7fYVZ!ioOP|GqfB#HSv;P`8#gz|U`n4+t5rJni;@3s&`)hg#ctE&n!UuWtToIC$ zo=Z)SG*NLyMW57VEO}X}HbY|OHa z1AiuuI`1s`!L4`5ojdQuYG{i*>yl^7)mL3D$KwmX*M9eVayp*+e#0Bz82jOqkTEqG z9k@%L{Tu&HK6LU6WaGv7OS`}OdO5s;O;LUR$OqE2Q2Tfoo0Aw%L%;0T9xYpWws|&i>{ecI{PG7Mn{I~A z_SpX3?R(^CJoIPOCft>S*|B3I4;SMA27`B&_0YI~*elR$}r6N5YR2x87 za648dx1uj|d;pQfg`ZQDWjDSeqnp`Hvw3$o&o){w$(R&iL@%xE&KLpIHRDOg!RIk$ zH|_kuvv^l+v&1`C!yE6 z=mf&ELx(mWBZqgx{*_-+7ngqF>vG?t=Va&I`{eOYc!GTQJKvStZo}OoT#oUJwh#Zs z*C>uF28~alV|pV1{CB+VUGkxY2gy9XoI7{LSLD!*ci@f-Hl#Hn+2E~)f+G{N_zsjD zvr*pgLg>13`bpd6&))b%$LW&K`>}K7*oU1eJHLaK(}`S}0fWvT^!qnporo`$sw_7_ zJoV%za({T&Bn z>8i`{4S8&AYZNowYMS^1kSp7cm3>E_itnY)%f8Dllf(b~4tdx&-z~qs;cN2M=N~7( z^U|luj&tuXr=NbhTz=W*^00?LOn&qckC10vd@=ToPSQ&X>>@UA@mg43FB+uy>wn*m2Wjsu^k`SAJjY{_vOly)0nN zUwZGA@^(CA=*uggalSnNR~{|$t=r%)Ok>8N76;Gwv^VPM471E= z925^nJS0w$^Nueb113%G!)fwxjyR9`0;EkAXvYR=D~?X)bil(#lZf!)ZC`SBDrTiq zt8cuqX5swerJnm5NwWeD-Q@A*KGzh=bXG|0D+9sAL>d!QS2uyzNf2X$2An1(U46l@ z9+WIFItg&uvFQvseC0P~?g{v2Jno9EluqKIfHDE$w~7wo$I+Jd;l#S(T0G_adD*;j zw_J4Wiah^er^_k$Gu@}*FO+OP>2$g3<~!ur9Vf~S*Ig$sdFe|M>!r)G1P~g0QkUfo zfBG)D?X<_qrp@U4(mpwi4RM*pM(+$h`QlkOB5;fcCe|B!9)whfJ#WAG{0GTz|LGT+ zpBv$K#qjlr&s>Q_;0m9o`SaiUFplM~Aikl4O|8Seg_cLIKXH@&Bpr-J^FouIj+L?<-5PY+3jvS+Z=5 zY-Ag7z>nAv2aH2-5dR+BAt64* zP?)T`dL6-vi3$pQ+XY;Xom#Bi;WuyawO@WsH{6=ef8@v0`P+Xb9ee5P)5Ux5=~oJ{ zT<|T#iBsvk{bKE7M{GxV&_2O`|Kqj+-f4Ufq%XbViS$jkUY~Bg`Dpr*Yo4C2f5vs` zj(a|np7XLlmfrF6?@X`%(pRJ#?Ps)K_Oh?A_l>-Un@@M`gyEtV8!v|XOK<(>=?6Yy zPx*iA*V%{a*>vuA-eX65ccpaWpR!zdjRzB(7ZIuQ7G(Bbpf7s)4e5=q{o=~>O@H&J z)4leb)Uj)rw|(62 z33}1Z^HJAd{pOdZo9xc+e{0{?-E9}jpJm){vghT#nKAp51ApQ5%Ft@hk#$`Nz_Fl{L zx9m2GBbYneX8p(l+d7{0Lt$u_aNU7b4Ju~>SJ^)(G`?>L2JUum6pq4i3Wv+8I4vwi zNuZfcn!rev4wn0)cpiqhzk;NL;QZoT89N=00&IJ`=!d%mE)1s{y!oP9TLt%{E*v_y z3-CB(J$6HS{N3+LSANCUS^=|93%)wmiqAzH{hYM7HJ&(~j#vRZarV*l;Jxa)@dZg^(;(C>XLed#N|I{nyB{!BW0{R`5k&U`w( z{5dzKx4h*$O9oqygo*4{%{r)^Mn?E-iC zp2a7%j9Eldl@=STomzd@_rA8MAiU!}cc!=F6(jf>8#}&oVCVV7ed(XQ_W9|5`U`)g z`28>6_7&+z|D}E1j%!D_LC@aR^OyeayV7lTfmxSt{G&G~{4Fit@qIsUUys{ff_r)p zZ)t%UMSac#?$s{k1K!m-=!-)@E_Be|L{-Jn?CX*>9%jZIlb@CJwLtoyI-Ha z`Nos!zy6b7o9?kwkB^@_oj!d3W9eSIF%3Tm`A6(X=-d7qyMO3OR@5vc3eiD}5sr*7 zjL+Tvp7b?;=ijD>zu|v0UONhW>eJKN_y24<_x=y3^xUtsPua)v0Ik6y!=4n)zjmsF zyREz zM~;YVzQ1DMzWufT<6RYQt@B;q|IYNE-fq`}5Su%!@$uA#{(3X%G)@EE@F<1%KWc)Bw5hZs9{ju8@*v(2iEBL;>LC7zhHGEGU>o!e9C?_W zmzLMZUCawP7Yvz#w#DSoC`!|1lWA;{j*zs@VhY7w@gYg4+)qJj!}vVg0K9^jkrRbe zIol|Gywqx{DA!!-X8rlyhto&D=C7qI zufHxG#RbL3{~$f~@Bd%B*7Bv((UDI^o``ln+F%&JT{!;UH@`exjT`pz@&|Tvx zjso!96bk~4Z0%ag-M@NQy6rdarpDWU`q#hO)}8UpHIYSBV(FbF`Qk&sFwz0xP6%{EKf( z57;+wy1e}dzbU=q4Yydqw6|>9c67yQ!|u3Tg%`o$Xw0^&r{h+L11#6z8k_k~8+k)u z<9vE^TKN=w`-s!Ive-C%L7Qc&vZXZ8V;V6x_#?gmXg7<0D{95sAHr>+g8&0{7)N7X zf-GCbC9t%vU-!=+v?_D8t9`;C<X&VtgCChm?vm5#3xVWjy&+Bmt2p{|^2QFgU zgSIYz;K$O@*S;V<^&8%3r(_?rXVLCWcq8M{hwrzSp*=Mn|Ln)@od4Q%-%&eK_=UHo z@BgYNr|@4BZ~uT5 z4_u!K3zGSvSlBCOpYy`&($~K1dh^9=VlAw3{>ab$p6x(3w>Xl364ymOdcPI^)9KZ( zyeYl%%bt~VPcy!{#iFDL{Vb-33PA8wZ*VHHMy3ptB zTGMg+p$>bt?W6CopEP8tv1ECXdZ9r@%P>HGfSzf6DoqgEVV|K@bn)i#y~ z?n_5+eqnmzUH>XQ_J98yyLMv5=qkJT>koD!i2-R*3kKJRaPy!aP2>&Fo`Le$xZ+c} z;}QjY?=@e0nVT;#;hN8L?8pimvO_Z-g$b_Ac{eh@f!U|NaVE`~U!sf}$db zSay1uKK;-f3!mhOg{3VjC`$HRp8J$N(Q?62)zj_I-aCY%RjSFv68xL<_ZapMz8yoM z#?b`EjiVhvFm=cqw<_RC`t~vb{egu)c>IV&_`zWX3vXLUxPg+((~xt3=gJWZx_Apc zPEU=u+z43#q@x^`zCW6R4{;Q-_8U0G3dJmDfW7%7efSHhARWy|NS=Ql#Oh!%>ZaeC)aJADmnCvEz>6H<<~VzW6`p(V zPG>*!o9T+b^6lx^8@?@_zw=)IwGTu*V!ywJ<9z&H8aU2e`DMGM6^r`d{Z+%<(TfhAA^qWtyYaf5?4gLtq#WQE@ z$mmPbx!?NP^yuIJ`*zX!YwZ0xH`>@yJZwwy$ruEndM&RZM_>q43{#ScFwh|ntiX9K z&aNYgTx|9FA$^>i9c>xUbVCgB84DbjO16$|e|R_dDJ!Bla>qlg52HY18}xC}F}LdP zs#anBR^>R7sWHo{YQi}e_7SUbiv=m-fX;l6+I>+M@WF&rOpFUlgr6+45f~gHeZdr@ z*YT9iGM|z!Ls}HL0lE+Vu}R{jql=<+^vZO_gLcEC?WA6C?C9v+N&7X9b7#`o(@(dH zk!RESBX-XVzU#E3B&$yLXP=l@b9O|M?t4$V;=lhZ>BKAlY`SpwowlDFjw>T4=Rf3l z&2@IPWS@|~@{{Q~58j^s;)||H-}>s8q%V2RYwR1mr-sAG8HY9~ANkO)r~mLv?@j;o z1NWqNKlaR&UiDwu{Yy_v$Nu0RJCHb*j@|hDbnb({kRJVe-*5N&*f(6ywQqIs3Fb#f zL)zJ}R*Zl|lHn2<0@dW24MV#G*pd_B10M1Ha)vhvNu-i_G zugtHoukUf1_ShLaUBgk27g`1bI4>_3~h5Bej5#rM5ASi!~Jcj zI1;t-`O#9dAJmjW2Js8BAaP@qvDAZXdjh1$4IqDeauGY{5j(`C9fjtC9ReT0#9E8P z;vOFE$Kd zeFC!+aJa^R#XmV@c5(L`O!wSr*C2j1oqXf#(&=w`i#_XRuadprE-c!&aP2Y`Cj0lQ zr=&-4?dtc<_s-w8YbE!l8%~`~H`%>-&%EMTda@nbUwP`JJ>zvY{o&(h(`O&MkbeJ> z3+dxe*l&l~!@kLWYb`zRMd|dDj;G`HuBK!^4vA}0N9`51N3OXtJ^s@_oF4y?AG2?f z?8xZGFUe`xSTG*@e{lh3Z5cuWL!g@I#UNrBdP`1pBp2G~$cT2}RYnJ^S9K}_UzTj( z=78=HTbvA&L1=NbZaZ%&N;snEIH+J7#nB`fE91qDmab(^X7CH!yre2CX!up<^6bp;EG)5W9qDT&8P zPT1olR(R4wcA@hjyHJT=%(Y*f^|w^wolIBS7Z6XrCLOU~8aZvR2svs$V2NL-_2F64 zM~soF zP%{?$jQ6MewICJDC|Cf1%Kos=py^n5 z#QF&^yTCbMkg+htvo368>bL?C?_p5JDkNx<+PZvLJzR!P! z6*2q9rTiMLRa&E1T`=yYWzpOio9;|21`%hwNNf2B)WyPAgc?CLTUxP?>Q36)iSyQs zz$-@O3Y$A_Z$RL{_JpEjM-*O^(D$O$U^TbG?@3#43zkljcssWUjc>~U#o2&B>0P&N zT(hbQ6!>GuEm&c(-kx%t0*klEAT-U-kVWY(`M^4%!Dt6~}I%>BY-2MyciFdxkzRCMNJBoUtJsAt;;Oslx>GZ8!=w`6&7r0LdH7sF0X(XQA)Q_>ImPkTtD|>-|tFq5Ue+by- z>ZqNX;`^Sd(B*jpmF+vY5bpaKsSmN;PeH;!Wejn?G8-bs*sP6kzBW*p%xIrnUYKwc zgrb8x!R;){kCd=M;`Gk(_$V-}{kpBct^r@IU-ztZ{-YmEXYTkH>DWu&olbt`%hR!2 zzseqmyV)*!+o{$=c25)D&+QxbVwRIJ^B=j|?gYQ$3VWrly@UJLe;{0zxiR? zsO>`d^Im7y!mS9|>6>4a-&%}(9{iu>EnQ_)RPWcNyJ6@qX&G8VV(3P?VQ3kU96&mT z1_?>&?q*2o2I(9?8fghdM9_DB|MlL__rqP!UFSLb?7h!9iqRy6Q3&yo_%|c|+q7ZX z?Y=tnLSel=+p5h2)lF8uec3;{q++sBptfAHii}8-iR3Hgfut5D<&^4d5X>z z+_+eVDTu05?)d7|Uo=z}h`gf{Emc9&P-Mb3yycl9+3xOT5`ple;|FPM$S?gAqU@Ox zbMeZWCfp(QX4XT$#eF(b&7x;G4IaSvs6woBe`(+yk;oQqPtIi(;M2>H>in^7u+D0z zM1I%v&W4P9|HtH=+b5rk-!E0i-Mcv$f)PKBMlLo)pJvEHT+l)#v_|%+W|Dq%Zg)gr z`_0MZ3cS8{`9u3pw(_q3SI_BI%y(6)*N#-P>41`RYdh<6HspY-E6(xN5imx>iqiON z6k?We7G1+SS7=y=4bS41ZMfcMEbmZ_H3vSf5*#3Kh9Ot8o>^kQhVD5M_HFcOf{u<= z{xG`1Qm6tZS%*fVb%TN;;i#r4Z*YVoza-Xg5tqn+O=#c^bsSm0h@^s1Dou{ZxH<~% znafyYCHXt0p=%UYMz9OB?t4%$ROs6qe^RZ}kScQ|NP1uQl zpVmO5u&wmHIPEHh?c=W|!9)66Lc$+;=8U34n0NhcDXZpxoN#sO?$lyfH}#}F$cLd( zu&+RLn@Ta*J6E`S{m*wh9%ah_4y_X0ubztnShM_EZundZyWi8Y=-24j+Tau%o9@qb z=)WJRl(Ojg*gI!1xrwQ(W2qf0pcAk6>Ra}Tb9iH5lM(q%3O?;Jcwq@UF9f?*Uq@hb z0|)=c3A&l!!iEaNTNA#{bq>0pcl5VHfBjR{#;)4m}9eo_BG+ z^`_EoG~7R<wXQAu64G=}VBD_g1E{lIO&({1xNQCg-rqSdQPW|lQUYp%Ok?h(tdXSpP?gqyl6{J$%6ja~xByXw@ zETk~d{GPgA5?#7$BTVi*0DN2Pl(?j-O09j~bHA~>kD(K9rY|Guvi^;&(98VKGLz*s zT{IK}cu?|Lt!z{vKg4%^MoDIqQ&9~^Uv|Vtn`ToojQwSOHPSOe#qsn$rm$}#HSI&A z7CX6b5CQw88IYAi#lCZ|gK*_oHE7*kePS$DrM3>`0Qn{yW}j8IWi3A>n%6s%M!2=( zf?Q3UC(bOzDg`uM5l#p1Y~tBXe!P0zJHJV^d!i$RQdrS%C<$s93ZsAZSwlP zJm8Lv&gvZadB@78{soNs0kr=h98xFvuKs(%#%GdZbVw7yvalCslQU6b_}h3a z=V)DKwM$Ek|lnkD6PwPvW-A{r=krTIMc2F=- zH=8t{UY!`dNMERbTE1dO(XARWjXM-lE@};~rI5g`iF32-E&ivjeVq_by3O--i~D>+ zE+b!ik%#h3G|2g#Dv#z$4q7MPziex6^@mriJ$zx-e+ObdzTD_2_n;FLY0B>%3N^=h zWURm`HgBY0CFRX?8&|my6>tcJ_x+ROm=(Nlx@crJoIGAQ>otZ#3FH!W1b-OdaK2fp zxQ{Y3;2UIG$Pws zDZ6$RnH$gmM;MT9;a4*vLTY=;`}eYi1;56DP2U%lieIY&FN8XV4s^Ix`(qU>eUwZ@ z96vHJY+yh7wAy>N-6$PU{^5uX6i^jA;XgP=fetQKzNI0K$uUZ7vVHihTrsXk*2JMq zs;LrSTY_7?-)uKl%#a6S!+nG%Op}l!D?kbZ0@i!noQfHJ=lYC8u(|m;ceUW^-rJ%A zx9Q?LGs~2VFqz6n$vpY`rBQv@&uP39<1>m)!bm@vYuhXFXrxH&u3=HdgldmCN=(i3Q_Xa5t z4C?jho3-rlB{E{8?$C6{Q5>qqX&2K1r5S$39f_9NKOd<$gQ&&n6#mFRcnM70$W0Ht zD-z&!bY2U>XcKIE8$1ldR32wDsDWNg7@;oUhK1Ki%J~N3zr|Y0?deQKqemYv5i90b z|J#{%iqE;vsITKJ;e zSC~Q4q4_m$kZ2dXA;dFxRhXq=RXfwr(4v&k2iKZj3kMg_g!_hGL6Qpu^6cSLP?Nu1 zsOG&FqXX*N_n^3GS@s|3DrFk3km>@5a{DOCPmd?BGRfaGZBu-(fk$2joJ)>lvo`qJ z4ssA*Nu?jRJoOYtL``l5D4@s4iGG=~zXsVv?aPoF0;gVOH$0kAr1#w?%~04seOI?? zwZkI15%%)!i>61SIJGjD?KiezDHu^aSzsYmHg+x1ere zcKVEl;4PY2ZRcGH`tJ-tq{e=-rhlgXeLt9_7_mv~RbM!k6T+{VMb)`HX@99+6);!g zg~QI=v1>6%^aTVWw;R6_Xp4vSc2U!0*Cx_KdVE^L{numG0iV45=xcOM^I2cnb#(4l zp?{}qVSE2lom&5V?Y=anM)=8}e9GQ65B_1dfNgH{rTw|RYt!>oVPQm@gXRJTc-0N| z9ynB%@oq6<(i=%_q~KeJ5#EJ^Jl`HpunfQ{T-~KMM6ICoW8|P+qZk0h&E#s(%^Qd& zwghB?mvRk!Ps_dIuAa)NjbB;krIT`7TsH4HChGaOAuI7wUTLu z)c`)4WlOWoGN;hR#N<7Hf6C|gRUCaWd{%!WmbJ7iV~z3R-mtB2KNo7F|g)Uk&HseFk-it_f_HDp6c6-tsdv56WX zc96A2E%SKIt%OU}{rf$wq%$3cvmt3{f}Z-+b!#x@`N+G7s9rc^&+>qJ{iU^h4VIqo z@iNw1gLj(g)-Q)J1Q_4sGDv6J*nDQ@*A!}UkXHflQ0Y>dY2OfTn*~j;{Qwc!{72oa zx7a#6X`4ERFADDs+$J#V9$v=hVEErQyFE{sUMM-I3L7_LtZR?5FQ+&d0<<|l z0`!`hDK~`#WY$S#zm^|rjGFqQNyT|h&xe~w@>v{_spg!Jm|i1ia`npras+hbB~@<& zI3DL()(K`hn!LwK_v{&%AMWdyEJR?Ji-k@geaR1}9 z6=}k+hsW(TKv=TdCpAc4lND4}lGXYX$xldrK7*_G)>dpW>6*V&%^2{C=pashBt_9L z8){NN%#$TyU~;N!&nu7-YY}T}j#{^LR4bPOtM#aoA+MhDB$%f;-oj(T*l!i`sNF?0 z%Ph$HxCQTKX;!!vqRJQXh`6`XX9{9``)SoM3GX5wr_AHZhQhrle(%v6fh(Xb0)`<^sk_Y#L65 z8Rq@w!tx5trJScUlyaLgl%t@vTjH4dRXAnjOE6Y6%0@DxGD2I0HE~~AgU5$ORc^iK zRVivdwbVFfcHddCjMxm>i?S8cE@eb}L7aUV`Sqo}UFc0|slqD$z-D3L8#DRt-R~3! zAsfRlm0EWqqQVU{DtD!|xiphyu_C}_RE_BU@l^T98mJmwD;`Vo&rnJdgX2JZ)v>m% z{e+W?smM!On4t$No}3~&$*{<%B;}WCe&t;js!fFyKz<*Jq9BRa;0|p8bmm;!8(&3| z?Z-r@2H7<+W#t+*n`Ti*lhwx=5kUD&s{(dKyUVq6-b;&Kc>fCihJ;cpY^_6JUlhK( zu79*nUY}HyE9b+5Ic8ETsQQod%d$VIES|>(Cvzg@-hJGZN#O*C>@8-%fwdXj8g*S_u%9m)>Y#-6sG&R}e-@`ljEjVrFUN0Y zMHS!(2GaTPq97+ORiq|+-J?Sws>JO>;(&bMxKp&)Uy@JZ@l0TE=Jg&=F8NQNq*OCk ziS5Ebgggm>q@u^MtzpI(aSm-(C{Jc*Ra`ER(uzOV=FW#sq4$Fye1(H@nWT*pJ))o# zmCjJ(-)E`IQxou9B&||&l2@+&$~P!-imDN4{FfkUm(oIbkN_*I9>-d#>f%dxZum#D zTeuFrSxU9cbj=(8sQQaV8ZVsaeG=Z^1VCjpI=_7m3+k61x*1bABfl#P_`5XlL1W~@ zaGMsnStF*OD)h;scFsE-D6zShtcQ@a%?Q%0gb$liU3woqw5la@QB$9f#w%iTOroVI+hyPhSm_SqVY<8#=&WC*qk@E2`RbnSMno-cDm2-ca@ z`F=uF zEs&Dk3+JH?HA+L3gj_#gAL@&wKffoP(Kxr-A_i^EH75Hz4np)`gceNbgNhIAW*ReR zClnHHnktEPzIP9t1}U zyZV-qU!EjTn)DFC4t?#v@+|D~ihL2Ow74^tbw)_NtWI})CD)CZz z*Xo)EhLzQ`A)6=Nfb(e3c2dPUT~lJc(OP9PM3!#uPMy^4GweUw-P1Jo?Os%us8(=d z!I#ak%4Ej1=h+A<+3YqjkbIpHf~$HJ2{$Z?W7jpjaJNR~&qYVV$1#Hqu_Gniwa}(| zyZ$)Js^GU;*O!6^UW1+t?v;B#h7$z@EH*JOZZls0s^l7D^bO=ul^=V3Z2{vy^Jy*J zo7yW!4KuaOt5TMSm9jYpb9lf3t7+dtYN1pQwek)}1cwYopZ$;_%-Ij2Mq~t2LGB|p z3=)-ZB#xTybo8qZ37jjthD>7e<^wJMRVsaXo~^@6UogxFWR2xyEh56lR-3wHnaFuA zRPweVFqn;e9!Xg2I;9ip^YuzLVDC?>kxubc5xXaqxgG2SxBWDJj9v+DDQvPK(m2te zL}t8OR@;NN%`ZUlBiP%5*G}3-KRirEA~0?*4!lj0;X>g9ps8XRK{-GbuhpCjrichO zGO$Odql+zDro6xB26SUEv;Lk}9*xyqkMp%$VR<|6$mdl|x49bm{@sR)e3y03f*x!V z!B3G#Lc1Y$g-Og}*Gn1%o6J|bD*@UFOE0#&(aSa-et)Boy71HWxWb$)N5GyA8+F~d zyYUAg;u5#)ztJiOd)DMTKuSX1tMlvY#TQcN zm|wjGXhb_WEatjvXcjS%pL#<~80_yJu6{{CN6rr`~f(Ji3f__LF!H$h_4{4BdM6M_lI$XzZZiv zGWJf|8#YUurBG+H)rUr#i;hG!C2{hKllGLRiAAZG-dM5Ap1$$8^wpDEbmqm4dA{*6 z>#I3(aDulIHSq~N1_CJLBDiP5Vm_q3n;??7h&;z7U9(~zS@1O~gz4fTXgoEI3Shlc zp_1S;4gOOIVBh(-`$4#a9KQL<;%SQ8%<~L$?2138W@Cq&j&qE&L{r%?5lWK});b>X zriI)FzqWj*4wH(;gOf(vj}(<_ZocV>umrvY&WW**dcqS%x=2bLW?z<0IOk?Ebv4#Z~7ik~7HY5Z>eky{&VG&4w|oUXS+wXjB$ z#1NNB6FFu71MGyIQ%k+LmmOk;fV#k}uk3>3%G=O2G40*q?1X5sDKfPW4%)FjVxNE9 z(?=>+gEge_jcY4Eza<=zj&(BME7QMFA~{fnH2oDePMWp!4R#8|;I$o@=;DVflQ`Qo zyCZL&bmY(u=y~U$oj?#MtT1x}b?~NEyS$Z48;ZL1E_y`&(L^_K*QSGEPZ>N%nABL6 zN8#NH)M>l{!p^VX6e#0tEF0%}0L)lm7ED%>S#$?oorpVewl< z=EHmlsw6T!B+Ry<^y5};HU27r?p3qi{lT}Bw#unCPigi+DKUI=MORB8kEV?zq3Dp) z)mS%u9rKK&oi#n6Rj$`2_W@0=DA&&EfHfL9Kh72ra((iRu{pwit@RS^mmRT8L4p6n zjn83xx|mAm@FpHP-tviKVOS=qF=s%uWl7t31bZpDr+#0uHG+8%eD4u6GdPreIYtw) zPcdu)Y+J+fL^Et(1oa3uZeX6V-Z%%el~T9Y7To4;dtxCZM*&Py%;8&gfuezV{QpuS zXCdCP$za$0e7m9)lQt}#+^P50BlbVYuyjBs3jq&H#AXZ4HR+89kLMZ}&HVk=lgXJ+ z_%G%?b^q!^rJjlvn_}3e-d2M{*Wj{LQ`iF*WvERpo8w968Yd zVnV`K$Y}wiFlsoV`RPytHAMq-YT1gO#UA|{qi1s&7Jxa2ebZN@`YM1%D%kA!={1okxc} zPfx1$$yDMYJ%Ss8+51G=upUCSbIx(c^bnVK z=DTq$)=|Z?%|1nM5VK`SYG%q(6xS=MsmVKqCQxlO_9hoToeBlUs=BVZZ^$mIz4}6h zi8J>xGb0Mk;opIydhY-e{#WJGxzEL1?cT*f$zOM5k%G?aFh^KpvMt+Jyf@Fe2x;>k zZ3HXhn9{(MGun=v;V8}}85Z3nt@5r?l#WO{n*gIy(gmP7eBg7m;S4SOS|5jA(okgJ zV#gN!D@(MAD-|#tsH+75ljyOofX(UOp1&t%+BHfEk}2j&C2rQst{eSXj^CNHaiOAp z^O*LNxcf`Jlc*x{z9bwT49iIo-6L;nktcN*R2drg%YzgJi@Gzt_SqN`|F3W~oRiNU ztvgf}an0ly1JP;KBk;*Tir708@p$0u8c}5cR6ln-RKDTz66?y8P(V7FoNEYB2*XE* zF=Og&sJ7Ka_x6L_s}}@qdlgRq~H z>56NS`+TRHlHK$rUWdTZzUgGdw(`f4sH<-pg}$@dECF8gs0$hV;t5oMjI)|p*L%F) zV$kb0vo>?%{i^Ygo(LP)%aH(AWg9@L7tHcZ&}NL!D;wC>5vSVA5~3l!x1mH}7l9HD zp$F&6nZuQQPyM|$>2deCCLg9;avtTeu$-7ef?Xbc&192?*BKecm#XOl9 z*BKx!=F-zp+CmD!ZGi=4`yuU!`m`WW;ZbJZNxL$>)W4G@xGO!gv+F>OPVzKEOB-45 zf$o2R+g-KHQph9L7~TF-+=BO5X(zhIhib?$+j3QkUh1oIcrbRQL)Z0>2hFs~Wu1cy z1ETZCDhB=x1-Pq~gYIV3v`LD6gd%-~scoGd`GGe~J^uxNfdTdDjFG``7#)E^M?51K zS@lhHI2t2G$m4eA(L{UjR2NJNT%)4EZSe z3P9fqRxW7p1l0)oU^yWV;RhFgKtc&=G`*n6ScQ}@lIYqHNc+}`HRTT*{D7%^f}nVj zZZkP(6l~~jY##LjORPhsNVD4}H;-`MmLyC*+XB0!_}$v7s5Ip%nqAQu`n&mymaj1Z zSd(%`DrypE&0Vd3QjFFJE2#f$V_I3K{mHsFcy<49g7d=q#kl=mSOmd0n*CD1k_Xx_|(`1e;xqPH}Vc)9?e z%xT!H&;zm}C2&2wK)MBC`~%BNTw#mO6{T8V69jqDM#(9f)vjKm?a%Y1_~0nf0oW95 zU#$9eEuEeg)rYU%A}valb3n7rx3Yg=SDI1E@Wd`fcat5gEI}y*d(b5=NQ?-$-;BxT zK_ykFz3_e}_(F$EolEc`@|^P*LBw1|WaO(uBbPZ$?#jJ`-7yi>`cEmQ;U!n(ByVOq zg=%%HCGk$_zR_}dMG0Kv8)W>-W!Nn*d6Q}y6XeV$d-B`(cWz6*%I*+{UB-(cco0h# z7cUV9)l7{^D#i(CwdliJT0;3HLbB{NJ?9zqZyO4n?B;uH^c7IXb%K#vdlb>y4Sr8$T5W;7jm1Th#p>-qk?pq!m6?*!=5V7&XZ4~bFu%Q5W|m*rl={d+hDzEfEL zX&ryZxAs4^uDnX4W?k*g`nstv4+hWV1)~03Bx9{%9f}^F=Fr51&kC&XZ{mQGk=GV2 z{8iAx1R+j{%B2Ts>e(K7Z#n zH!sg;x=*1fO|ml`NdJO#@A*CEd_?uUZ?S>ZO!{hlu#s)!&~P27LVHEL`0c@Pc`0pO)%2CIjOZgs6z&OaVp#$KiHH|E=> z%+k_JA$V!TZ*32%u#yJlqUlAxB2rVq zq#$EV2;v>610Jt2u-ppJe?bHUMd~r9uDU-P8AjkTX1C{uOrQ@9P*`!)cPR=#VxX?$laYACuP|-{-`;#ypG`HFKV|``bhGNxDsgQ4+P&B)p#}J9 z$rLTm#qy*rGh1ir!-TV<WBWQq=zKv03wS3+VAjDuE0%_V&hn_U?3?L!+VXl#h{ok=f|JrYxYq^kELF(&!J{ zqYoRgj!}2qZN?wh>ru8buTqKan7jf5@E1MaMCkqbjburQg&qMr0B?Y2EFdyAqtS0> zg29nAOD4{CI=KDCmADxAbQ*s51#91y$<}ZuBp$9E|1&!YZChFNb>8#9vXUd0Z!g@(~84UBkZ$D&-zR!`)l3<;qjOm_(O{W-@C=2cFB_2Ln)>UNn=d_bR@ zSI|G4eoJy$(m%LD2MA@sA2GJh7a+aXvj{zh6ylU*c?|*hLN%=$B!5hDQOXri~eC-7INjz6wjA{||WGj4*>I%gG3u;;ZR7gO2`__~_AA zX4;(dY?BPE4l6blBR8CW-BOgfyGxEr?+9+#OO!;$DU5hTtX>o^MF<^63ehP94tF?I z>QQ-shi$@(wT6U{+nPdTW_Z&f+t(8Z{8F*G4%aq%`c;B*F`hOD1iDxadoj@4S%VT& z%9uPbiKpsuHva(WaQOr6H%C8oFheF)*T!(GdEYi;d9d8`U;H=XEHz<}&>A7aKFjkL zY>_R~`~Gx&L_HIvNCQwZc|6N3K@UYKiw=4FkZBC8c2WE_!Yx7Xa9jahwxgqnzo>wF!j(gJ!a~4e5uL5ZE{ni+nuLJdR|62 zv0@k9O85yXKw{G9i+a6qYN9O-gL-sV6A8oY8eu&sk71RC(1e2P^s|xW)~#G~Dgh9) zH^K!cx1lLJJIR^S^BRGH=3yl{s|~cpKAY;)_h%_9WT1HPc9+m!u;$5W-4?{g`zr9g zk$F<${GzqETVb@kS2H@97WA1=)D{8?QGu>^Cx7bW5RLEwh-E(^cv&?HMBQ1 zo)LAQAQ?3TTP=9IaCbZNL49Pc#V&}ffN60RU(4CdEQ`%$3~fa%IKF~ zQBh@5eV|k1K5tLtVIjmIaY_*ygrX#e^a^z%5t7^|G*ECXOpic7y|51?s&w zE{U!=Y`HW-9L;im<-lVh@tiCzoI^zzE&X5>=OyRT{q!3AL z@i+WN-GTF)=944Rvc7fE ztS3)BUT?4T4~lOyt1{Uo5WAyaOLe+!Gqm<=m|=Sw)gZ0l3X7LEn<0~6#FSp*x25)w zE4*GD&``vQS2q7=ibeSx!eUEjj5CCb2^w`Q+tRu3cXy)M`#@wUaCa4F|M3v6g*! zUtijYu0Kp+y8qfdt5e)OL^7ql7jY{-o({jAzqt{|M47hd{zc>wTnZ8-)!L4S&Gf*! zhfJK1Ji+iWLD4tsY=a{SHmoxm6c^Ms8yjJNo>L>0&; z=az4_DNjlk1jC`wk;743wwv%n%DFEOyA>dXtR7Dk=IQW+RF5iZZN85iMfaQ;ah!I5 z$|oMbY;C(hvV%7 zon-qh5)N;iFee-FH%RA6pZ1(52_%?C!?b078%PE}`b!4hE4=?PI8IRbT$e*N8|y+O zjXMM+7pKD^i~yvrc8j6_sS&FVhajZ(sQ-7us>u-}lNvtCh?7i%f_;|5fi6i;enpV( zT4lt99+my-wnfH+$Y2PbVjLqhO4%|&+#UX1P6oVT+Mf{`HBHs|A+HJhU4T)mH`z21 zl0b=_l>a?z3p>r@Wy*su z@MP3sDN8M7RX49~+7gF3m_Th;jGT<_cTy=a(Rb;u46wZTty(xz7Cg1HR5M2P;FwD9Hn6jSHqDdM-(6n=8tw<3_+`AvC*zDu@&l zpMVms-}ukCYprS2D(ZDuZq2Tsy&X(mT~*;?WN_KG7?MT=9B?zmnnm}uwP+>xpB%+e z)DrZe0}N}`Q!CX05w3Dt#;F-w`$6p@>QXk>YuiT2F>4z-@@Kch6SvA)pT-$w&S57b zYPD?@flo89%(=xLAdOtBViAtBjyuSj#PLblg`cV1RvNzW5c>ivIOt9piPPd<)>Eg@ zb(ioo={koKbf=d365H7yksup(Vhlht1A@BWCG@0bPPx3_nw^=)hs|QgZWb4Vue}Y7?LN%?8|u``(>K{=nKW> zC11Xy_&$Vj&(z9;H)V#U@N~408z({Y{cr&litxXpW|C<+Z+wGy!a!d>a5hw zV^n%`i8c5zS5~q(wQCG+EZhdIL+hY~$*$<M3xf}=$%i1?Hv}+Mr+_q3UtS+dp!wdUy;AFh#jbBb1@ggY zM9XxET5>*AlW0Lk)pUm^ss&$>5MFbWr9F^OwPi4%MJjQinD=3xo`;I_f^rV!_Ut{~#R&)cK@! z(Uq=m@xAIo3gu;kiqs*e3X2;iDzb)|ckD0JBo&nM<>Z+cdPRux3NOvq=bdHS+36Ov zvyS=}gD7EL>7c=0rmyrnh5Vp#F4m3@;MMdeIpMrF=f|}jhK@}&hMa3G9f6MsYvH+; zniBcW;QyE4VaO^*PhBdwR2j`9IevkQ@usbn!)XPvO1=_~XUA~lVG1DZ6xL(mA02D| zPV0expC;(>Rbk))gO|15vZq|PW{FaJv~lv&@7}Z-i1`zR{vqp(1)Iw>T>N&sXy=af z4dY40jXRnf^&*)fIJWa}Z!@^{t5nb^OuKb;xj`sajEc>Z0=V^3wAaoYn)bpVYAFVf;}ZCx)iH7vhg|%gKr;a`!rbC z#G@>Z-?*#809uz-wr(dsh5K$Y@RHmml?_>HztzFL6#C#k$87Bac2zox=xs{_oJ%K_ zoWhIo#I0FnhxEVmOWCKRwpUc;`cU7tT`KP)y0I=<4Uu}JJ`_yS{H6Ct$Dz?cY8bOn ze-tE+@WLn$P5h7I6aH*{+%R~$nZc{4GGaN|k^9`TiC<@zu8OBow5Q=>3V6arWzTqt zF<-Ds-|4kiYmwg%Zq<*9i9?ziNEJq7yD3`>sroWO=@nEr7uE`!(X~}b7O})O-q7Q3*FWgkIakjdT=xdFhlKhGqh%|@1`n1wZ*c5HrdOi@dJ{BhMt2Xr? zPU(ZXJ9vPyYD)=!4M*Se8xe9RH38D$y%bjEcz#?X{Hn8NrDH|&f>n(4+Z95)e}a@6 zJp&`%a|WSnc8Dtz;Y*i-QIq1v+u-~4?7u|utRxkNq07_&_0x;oC00YWrT5ELZx$FvUC_T$WRLS3Gp0c9(_ zlvo`$xz2QQOZlLL|H#?JT+1Sd(S^!7d(;I^9_xdV#aZ}JaXR4uF>oU;JAzjMOLZy7 zAl1RJix(Yd?(G}(k`^!ffKhtwfq4}IRxCZ@3cOe74n?_WV$l^nc?MYD4_jwU>Za6k zHs7LF%cYzNSpI#YC~F7(+Uq2ez;$)U{-UDuS;T3~?p*BL15*fv$B_u^b%Xr_}i`hyiSeH=j1%%IPW&MuwGpiArlu?w% zipp=27sc||oRcT4cF6EZ+ShaW8@~Htn1w#|hey>o<~RL)XLQhpV4HA{AxgNuh6LgS z*{v{|uC5Y{buMj(Fd4qcw5lU=>T$GWA-3Ri3KnKU74f_E$0>v`{U;b zhI`qEGPf{hS-#ZBr-Z*p?tL}N!}@w*2c$S(s*2~N%U!Rb>2{a$;}C1~XEOeWK7qtQ zR7;h7d$nglC8TSyZ&`Wuks;$qWsaW!1zDv~X`<3W{s|YV9eUS255JbbXf0=y^8oE^ z;8lr}CHzWM!M|*RNoAub=2cZq@b~ED@tlhG68NN&zls@D+(5~_BA|$jZT*}Ix1r6_ z+E%gx#&^zaqI|k4dD%4b(rs-dEK$gq1zq=hu#eE*=np}bn2o=o0@tRvff1rXD9A@m 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 139/185] 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 140/185] 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 141/185] 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 142/185] 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 143/185] 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 144/185] 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 145/185] 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 146/185] 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 147/185] 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 148/185] 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 149/185] 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 150/185] 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 151/185] 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 152/185] 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 153/185] 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 154/185] 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 155/185] 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 156/185] 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 157/185] 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 158/185] 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 159/185] 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 160/185] 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 161/185] 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 162/185] 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 163/185] 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 164/185] 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 165/185] 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 166/185] 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 167/185] 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 168/185] 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 169/185] 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 170/185] 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 171/185] 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 172/185] 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 173/185] 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 174/185] 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 175/185] 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 176/185] 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 177/185] 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 178/185] 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 179/185] 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 180/185] 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 181/185] 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 182/185] 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 183/185] 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 184/185] 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 185/185] 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

    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 z 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�{% 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