From 90ed2c1ef7c652ce0a98075c422d25a632d62507 Mon Sep 17 00:00:00 2001 From: Craig Johnson Date: Mon, 13 Aug 2018 15:02:17 +0530 Subject: [PATCH 01/50] Small grammar correction in quickstart. (#6121) Just felt the sentence could use some improving. --- docs/tutorial/quickstart.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorial/quickstart.md b/docs/tutorial/quickstart.md index 466baeebc..13152edae 100644 --- a/docs/tutorial/quickstart.md +++ b/docs/tutorial/quickstart.md @@ -56,7 +56,7 @@ We'll also create an initial user named `admin` with a password of `password123` python manage.py createsuperuser --email admin@example.com --username admin -Once you've set up a database and initial user created and ready to go, open up the app's directory and we'll get coding... +Once you've set up a database and the initial user is created and ready to go, open up the app's directory and we'll get coding... ## Serializers From c4b068cfd3885a5a34a26fca293987b861526a66 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Fri, 24 Aug 2018 15:57:45 -0700 Subject: [PATCH 02/50] Fix dist build (#6139) * Use tox-venv to reduce warnings in output * Remove .egg-info/ to allow wheel installation tox now invokes pip as a python module instead of through its entry point. "python -m" adds the current directory to the PYTHONPATH, picking up the .egg-info/ metadata directory, tricking pip into thinking that the package is already installed (and thus not installing the wheel). Deleting the metadata directory fixes this. --- .travis.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.travis.yml b/.travis.yml index 76adf1a60..b8c5b385c 100644 --- a/.travis.yml +++ b/.travis.yml @@ -29,6 +29,7 @@ matrix: env: TOXENV=dist script: - python setup.py bdist_wheel + - rm -r djangorestframework.egg-info # see #6139 - tox --installpkg ./dist/djangorestframework-*.whl - tox # test sdist @@ -44,7 +45,7 @@ matrix: - env: DJANGO=2.1 install: - - pip install tox tox-travis + - pip install tox tox-venv tox-travis script: - tox From 468cdd16edabbb327c7dde877f3b0a18bea082b9 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 28 Aug 2018 00:51:28 -0700 Subject: [PATCH 03/50] Remove unnecessary models.py file (#6142) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Since Django 1.7, an empty models.py file is not required. See https://docs.djangoproject.com/en/dev/releases/1.7/#app-loading-refactor > It is possible to omit models.py entirely if an application doesn’t > have any models. --- rest_framework/models.py | 1 - 1 file changed, 1 deletion(-) delete mode 100644 rest_framework/models.py diff --git a/rest_framework/models.py b/rest_framework/models.py deleted file mode 100644 index 5b53a5264..000000000 --- a/rest_framework/models.py +++ /dev/null @@ -1 +0,0 @@ -# Just to keep things like ./manage.py test happy From 2c992f09dada037904efe076029cd7355118d37f Mon Sep 17 00:00:00 2001 From: Michael Date: Tue, 4 Sep 2018 18:33:42 +0000 Subject: [PATCH 04/50] Mention Django 2.1 compat where missing (#6158) --- README.md | 2 +- docs/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index eebcfe13f..b9c5d449d 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) -* Django (1.11, 2.0) +* Django (1.11, 2.0, 2.1) # Installation diff --git a/docs/index.md b/docs/index.md index f709502d7..a3ae88ede 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) -* Django (1.11, 2.0) +* Django (1.11, 2.0, 2.1) The following packages are optional: From bcc565f387842aba8157d0457de31ae864aed65f Mon Sep 17 00:00:00 2001 From: oliver Date: Thu, 6 Sep 2018 15:25:20 +0900 Subject: [PATCH 05/50] Clean up unnecessary if statement (#6163) --- rest_framework/pagination.py | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/rest_framework/pagination.py b/rest_framework/pagination.py index 1c57f17d3..c3494e3c5 100644 --- a/rest_framework/pagination.py +++ b/rest_framework/pagination.py @@ -544,12 +544,11 @@ class CursorPagination(BasePagination): has_following_position = False following_position = None - # If we have a reverse queryset, then the query ordering was in reverse - # so we need to reverse the items again before returning them to the user. if reverse: + # If we have a reverse queryset, then the query ordering was in reverse + # so we need to reverse the items again before returning them to the user. self.page = list(reversed(self.page)) - if reverse: # Determine next and previous positions for reverse cursors. self.has_next = (current_position is not None) or (offset > 0) self.has_previous = has_following_position From bc573d8096f97608c7fd3a8d80a5a96fa8742ed7 Mon Sep 17 00:00:00 2001 From: Timothy Allen Date: Thu, 6 Sep 2018 06:01:57 -0400 Subject: [PATCH 06/50] Add drf-renderer-xlsx package. (#6147) * Add drf-renderer-xlsx package. * Gah, tabs creeped in; never leave your default editor environment. :) --- docs/api-guide/renderers.md | 40 +++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/docs/api-guide/renderers.md b/docs/api-guide/renderers.md index d547a7bbf..d720dffc5 100644 --- a/docs/api-guide/renderers.md +++ b/docs/api-guide/renderers.md @@ -457,6 +457,43 @@ Modify your REST framework settings. [MessagePack][messagepack] is a fast, efficient binary serialization format. [Juan Riaza][juanriaza] maintains the [djangorestframework-msgpack][djangorestframework-msgpack] package which provides MessagePack renderer and parser support for REST framework. +## XLSX (Binary Spreadsheet Endpoints) + +XLSX is the world's most popular binary spreadsheet format. [Tim Allen][flipperpa] of [The Wharton School][wharton] maintains [drf-renderer-xlsx][drf-renderer-xlsx], which renders an endpoint as an XLSX spreadsheet using OpenPyXL, and allows the client to download it. Spreadsheets can be styled on a per-view basis. + +#### Installation & configuration + +Install using pip. + + $ pip install drf-renderer-xlsx + +Modify your REST framework settings. + + REST_FRAMEWORK = { + ... + + 'DEFAULT_RENDERER_CLASSES': ( + 'rest_framework.renderers.JSONRenderer', + 'rest_framework.renderers.BrowsableAPIRenderer', + 'drf_renderer_xlsx.renderers.XLSXRenderer', + ), + } + +To avoid having a file streamed without a filename (which the browser will often default to the filename "download", with no extension), we need to use a mixin to override the `Content-Disposition` header. If no filename is provided, it will default to `export.xlsx`. For example: + + from rest_framework.viewsets import ReadOnlyModelViewSet + from drf_renderer_xlsx.mixins import XLSXFileMixin + from drf_renderer_xlsx.renderers import XLSXRenderer + + from .models import MyExampleModel + from .serializers import MyExampleSerializer + + class MyExampleViewSet(XLSXFileMixin, ReadOnlyModelViewSet): + queryset = MyExampleModel.objects.all() + serializer_class = MyExampleSerializer + renderer_classes = (XLSXRenderer,) + filename = 'my_export.xlsx' + ## CSV Comma-separated values are a plain-text tabular data format, that can be easily imported into spreadsheet applications. [Mjumbe Poe][mjumbewu] maintains the [djangorestframework-csv][djangorestframework-csv] package which provides CSV renderer support for REST framework. @@ -497,6 +534,9 @@ Comma-separated values are a plain-text tabular data format, that can be easily [messagepack]: https://msgpack.org/ [juanriaza]: https://github.com/juanriaza [mjumbewu]: https://github.com/mjumbewu +[flipperpa]: https://githuc.com/flipperpa +[wharton]: https://github.com/wharton +[drf-renderer-xlsx]: https://github.com/wharton/drf-renderer-xlsx [vbabiy]: https://github.com/vbabiy [rest-framework-yaml]: https://jpadilla.github.io/django-rest-framework-yaml/ [rest-framework-xml]: https://jpadilla.github.io/django-rest-framework-xml/ From 69f605f30e271b5ca8efbf0638143fdf88877969 Mon Sep 17 00:00:00 2001 From: David Sanders Date: Thu, 6 Sep 2018 18:16:06 -0700 Subject: [PATCH 07/50] Fix validate_my_field signature --- 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 07921f2d9..7cf7a6974 100644 --- a/docs/api-guide/serializers.md +++ b/docs/api-guide/serializers.md @@ -1030,7 +1030,7 @@ Similar to Django forms, you can extend and reuse serializers through inheritanc class MyBaseSerializer(Serializer): my_field = serializers.CharField() - def validate_my_field(self): + def validate_my_field(self, value): ... class MySerializer(MyBaseSerializer): From 4d57d46bf89f54f276909219ee06f0a2bf112f9f Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Sun, 9 Sep 2018 03:53:41 -0700 Subject: [PATCH 08/50] Prefer io.BytesIO over six; available on all supported Pythons (#6168) On all supported Pythons, the io.BytesIO is always a stream implementation using an in-memory bytes buffer. Makes code slightly more forward compatible by reducing use of the six module and promotes more forward compatible practices in the docs. --- docs/api-guide/serializers.md | 4 ++-- docs/tutorial/1-serialization.md | 4 ++-- rest_framework/request.py | 3 ++- tests/test_parsers.py | 7 ++++--- 4 files changed, 10 insertions(+), 8 deletions(-) diff --git a/docs/api-guide/serializers.md b/docs/api-guide/serializers.md index 7cf7a6974..19501718e 100644 --- a/docs/api-guide/serializers.md +++ b/docs/api-guide/serializers.md @@ -57,10 +57,10 @@ At this point we've translated the model instance into Python native datatypes. Deserialization is similar. First we parse a stream into Python native datatypes... - from django.utils.six import BytesIO + import io from rest_framework.parsers import JSONParser - stream = BytesIO(json) + stream = io.BytesIO(json) data = JSONParser().parse(stream) ...then we restore those native datatypes into a dictionary of validated data. diff --git a/docs/tutorial/1-serialization.md b/docs/tutorial/1-serialization.md index aa94eeb0e..630c3da0a 100644 --- a/docs/tutorial/1-serialization.md +++ b/docs/tutorial/1-serialization.md @@ -154,9 +154,9 @@ At this point we've translated the model instance into Python native datatypes. Deserialization is similar. First we parse a stream into Python native datatypes... - from django.utils.six import BytesIO + import io - stream = BytesIO(content) + stream = io.BytesIO(content) data = JSONParser().parse(stream) ...then we restore those native datatypes into a fully populated object instance. diff --git a/rest_framework/request.py b/rest_framework/request.py index 9d4f73d30..a6d92e2bd 100644 --- a/rest_framework/request.py +++ b/rest_framework/request.py @@ -10,6 +10,7 @@ The wrapped request then offers a richer API, in particular : """ from __future__ import unicode_literals +import io import sys from contextlib import contextmanager @@ -301,7 +302,7 @@ class Request(object): elif not self._request._read_started: self._stream = self._request else: - self._stream = six.BytesIO(self.body) + self._stream = io.BytesIO(self.body) def _supports_form_parsing(self): """ diff --git a/tests/test_parsers.py b/tests/test_parsers.py index d1287ecd6..e793948e3 100644 --- a/tests/test_parsers.py +++ b/tests/test_parsers.py @@ -1,6 +1,7 @@ # -*- coding: utf-8 -*- from __future__ import unicode_literals +import io import math import pytest @@ -10,7 +11,7 @@ from django.core.files.uploadhandler import ( ) from django.http.request import RawPostDataException from django.test import TestCase -from django.utils.six import BytesIO, StringIO +from django.utils.six import StringIO from rest_framework.exceptions import ParseError from rest_framework.parsers import ( @@ -43,7 +44,7 @@ class TestFileUploadParser(TestCase): def setUp(self): class MockRequest(object): pass - self.stream = BytesIO( + self.stream = io.BytesIO( "Test text file".encode('utf-8') ) request = MockRequest() @@ -131,7 +132,7 @@ class TestFileUploadParser(TestCase): class TestJSONParser(TestCase): def bytes(self, value): - return BytesIO(value.encode('utf-8')) + return io.BytesIO(value.encode('utf-8')) def test_float_strictness(self): parser = JSONParser() From 612a7b989f94aaedf12a7bfc3362a2d43537aca4 Mon Sep 17 00:00:00 2001 From: Jerome Leclanche Date: Tue, 11 Sep 2018 07:12:32 +0300 Subject: [PATCH 09/50] Fix Python 3.8 compatibility (#6154) --- rest_framework/compat.py | 7 +++++++ rest_framework/serializers.py | 4 ++-- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 28e1f1f59..2f4729214 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -10,6 +10,13 @@ from django.core import validators from django.utils import six from django.views.generic import View +try: + # Python 3 (required for 3.8+) + from collections.abc import Mapping # noqa +except ImportError: + # Python 2.7 + from collections import Mapping # noqa + try: from django.urls import ( # noqa URLPattern, diff --git a/rest_framework/serializers.py b/rest_framework/serializers.py index fb4b8d393..110ffbfa9 100644 --- a/rest_framework/serializers.py +++ b/rest_framework/serializers.py @@ -15,7 +15,7 @@ from __future__ import unicode_literals import copy import inspect import traceback -from collections import Mapping, OrderedDict +from collections import OrderedDict from django.core.exceptions import ImproperlyConfigured from django.core.exceptions import ValidationError as DjangoValidationError @@ -27,7 +27,7 @@ from django.utils import six, timezone from django.utils.functional import cached_property from django.utils.translation import ugettext_lazy as _ -from rest_framework.compat import postgres_fields, unicode_to_repr +from rest_framework.compat import Mapping, postgres_fields, unicode_to_repr from rest_framework.exceptions import ErrorDetail, ValidationError from rest_framework.fields import get_error_detail, set_value from rest_framework.settings import api_settings From 7f77340b331e68357535a83e90eb0f8e1002b943 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Mon, 10 Sep 2018 21:44:23 -0700 Subject: [PATCH 10/50] Add Python 3.7 support (#6141) --- .travis.yml | 6 +++++- README.md | 18 +++++++++--------- docs/index.md | 2 +- tests/test_model_serializer.py | 5 +++++ tox.ini | 6 +++--- 5 files changed, 23 insertions(+), 14 deletions(-) diff --git a/.travis.yml b/.travis.yml index b8c5b385c..2620e079d 100644 --- a/.travis.yml +++ b/.travis.yml @@ -21,6 +21,11 @@ matrix: - { python: "3.6", env: DJANGO=1.11 } - { python: "3.6", env: DJANGO=2.0 } - { python: "3.6", env: DJANGO=2.1 } + + - { python: "3.7", env: DJANGO=2.0, dist: xenial, sudo: true } + - { python: "3.7", env: DJANGO=2.1, dist: xenial, sudo: true } + - { python: "3.7", env: DJANGO=master, dist: xenial, sudo: true } + - { python: "3.6", env: TOXENV=base } - { python: "2.7", env: TOXENV=lint } - { python: "2.7", env: TOXENV=docs } @@ -42,7 +47,6 @@ matrix: allow_failures: - env: DJANGO=master - - env: DJANGO=2.1 install: - pip install tox tox-venv tox-travis diff --git a/README.md b/README.md index b9c5d449d..06e43ae3a 100644 --- a/README.md +++ b/README.md @@ -52,7 +52,7 @@ There is a live example API for testing purposes, [available here][sandbox]. # Requirements -* Python (2.7, 3.4, 3.5, 3.6) +* Python (2.7, 3.4, 3.5, 3.6, 3.7) * Django (1.11, 2.0, 2.1) # Installation @@ -142,14 +142,14 @@ You can now open the API in your browser at `http://127.0.0.1:8000/`, and view y You can also interact with the API using command line tools such as [`curl`](https://curl.haxx.se/). For example, to list the users endpoint: $ curl -H 'Accept: application/json; indent=4' -u admin:password http://127.0.0.1:8000/users/ - [ - { - "url": "http://127.0.0.1:8000/users/1/", - "username": "admin", - "email": "admin@example.com", - "is_staff": true, - } - ] + [ + { + "url": "http://127.0.0.1:8000/users/1/", + "username": "admin", + "email": "admin@example.com", + "is_staff": true, + } + ] Or to create a new user: diff --git a/docs/index.md b/docs/index.md index a3ae88ede..9c34133cd 100644 --- a/docs/index.md +++ b/docs/index.md @@ -83,7 +83,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) +* Python (2.7, 3.4, 3.5, 3.6, 3.7) * Django (1.11, 2.0, 2.1) The following packages are optional: diff --git a/tests/test_model_serializer.py b/tests/test_model_serializer.py index 7e801badb..1bd1fd053 100644 --- a/tests/test_model_serializer.py +++ b/tests/test_model_serializer.py @@ -9,6 +9,7 @@ from __future__ import unicode_literals import datetime import decimal +import sys from collections import OrderedDict import pytest @@ -381,6 +382,10 @@ class TestDurationFieldMapping(TestCase): TestSerializer(): id = IntegerField(label='ID', read_only=True) duration_field = DurationField(max_value=datetime.timedelta(3), min_value=datetime.timedelta(1)) + """) if sys.version_info < (3, 7) else dedent(""" + TestSerializer(): + 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) diff --git a/tox.ini b/tox.ini index 59aa38623..968ec1ef1 100644 --- a/tox.ini +++ b/tox.ini @@ -1,9 +1,9 @@ [tox] envlist = {py27,py34,py35,py36}-django111, - {py34,py35,py36}-django20, - {py35,py36}-django21 - {py35,py36}-djangomaster, + {py34,py35,py36,py37}-django20, + {py35,py36,py37}-django21 + {py35,py36,py37}-djangomaster, base,dist,lint,docs, [travis:env] From 4033f0c6b3b432e203d37788ea68143fb6681da9 Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Tue, 11 Sep 2018 11:40:47 +0100 Subject: [PATCH 11/50] Add Load Impact to premium sponsors (#6176) --- README.md | 8 ++++---- docs/img/premium/load-impact-readme.png | Bin 0 -> 23967 bytes docs/index.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) create mode 100644 docs/img/premium/load-impact-readme.png diff --git a/README.md b/README.md index 06e43ae3a..817d0d939 100644 --- a/README.md +++ b/README.md @@ -22,11 +22,11 @@ The initial aim is to provide a single full-time position on REST framework. [![][rover-img]][rover-url] [![][sentry-img]][sentry-url] [![][stream-img]][stream-url] -[![][machinalis-img]][machinalis-url] [![][rollbar-img]][rollbar-url] [![][cadre-img]][cadre-url] +[![][load-impact-img]][load-impact-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], [Machinalis][machinalis-url], [Rollbar][rollbar-url], and [Cadre][cadre-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], and [Load Impact][load-impact-url]. --- @@ -191,16 +191,16 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [rover-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/rover-readme.png [sentry-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/sentry-readme.png [stream-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/stream-readme.png -[machinalis-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/machinalis-readme.png [rollbar-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/rollbar-readme.png [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-imapct-readme.png [rover-url]: http://jobs.rover.com/ [sentry-url]: https://getsentry.com/welcome/ [stream-url]: https://getstream.io/try-the-api/?utm_source=drf&utm_medium=banner&utm_campaign=drf -[machinalis-url]: https://hello.machinalis.co.uk/ [rollbar-url]: https://rollbar.com/ [cadre-url]: https://cadre.com/ +[load-imapct-url]: https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf [oauth1-section]: http://www.django-rest-framework.org/api-guide/authentication/#django-rest-framework-oauth [oauth2-section]: http://www.django-rest-framework.org/api-guide/authentication/#django-oauth-toolkit diff --git a/docs/img/premium/load-impact-readme.png b/docs/img/premium/load-impact-readme.png new file mode 100644 index 0000000000000000000000000000000000000000..5dc6b9069ef63a6feb3fd88d94ee0275e45b7ccd GIT binary patch literal 23967 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 literal 0 HcmV?d00001 diff --git a/docs/index.md b/docs/index.md index 9c34133cd..1599a9bef 100644 --- a/docs/index.md +++ b/docs/index.md @@ -69,13 +69,13 @@ continued development by **[signing up for a paid plan][funding]**.
  • Rover.com
  • Sentry
  • Stream
    • -
  • Machinalis
  • Rollbar
  • Cadre
    • +
  • Load Impact
    • -*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), [Machinalis](https://hello.machinalis.co.uk/), [Rollbar](https://rollbar.com), and [Cadre](https://cadre.com).* +*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), [Rollbar](https://rollbar.com), [Cadre](https://cadre.com), and [Load Impact](https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf).* --- From 9140629c45a866fffa64805dfc1bd7467a6a2448 Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Tue, 11 Sep 2018 11:41:49 +0100 Subject: [PATCH 12/50] Fix Load Impact URL --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 817d0d939..f84f1110a 100644 --- a/README.md +++ b/README.md @@ -200,7 +200,7 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [stream-url]: https://getstream.io/try-the-api/?utm_source=drf&utm_medium=banner&utm_campaign=drf [rollbar-url]: https://rollbar.com/ [cadre-url]: https://cadre.com/ -[load-imapct-url]: https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf +[load-impact-url]: https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf [oauth1-section]: http://www.django-rest-framework.org/api-guide/authentication/#django-rest-framework-oauth [oauth2-section]: http://www.django-rest-framework.org/api-guide/authentication/#django-oauth-toolkit From 4e093b0e25bd0f4635b0dd03a4c9bfd9f082f8cf Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Tue, 11 Sep 2018 11:53:03 +0100 Subject: [PATCH 13/50] Add Load Impact to README --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f84f1110a..b54d1a200 100644 --- a/README.md +++ b/README.md @@ -193,7 +193,7 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [stream-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/stream-readme.png [rollbar-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/rollbar-readme.png [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-imapct-readme.png +[load-impact-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/load-impact-readme.png [rover-url]: http://jobs.rover.com/ [sentry-url]: https://getsentry.com/welcome/ From 5f1f2b100353970ac0dec672154fedd3df9d0a9f Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Tue, 11 Sep 2018 12:55:53 +0100 Subject: [PATCH 14/50] Higher res. load impact logo --- docs/img/premium/load-impact-readme.png | Bin 23967 -> 22333 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/docs/img/premium/load-impact-readme.png b/docs/img/premium/load-impact-readme.png index 5dc6b9069ef63a6feb3fd88d94ee0275e45b7ccd..c46d36adaf85dfa0950c26b6a2fbbac4b5a1d1e5 100644 GIT binary patch delta 21400 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 delta 23047 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 a`2PXp+me-MpuKqj0000 Date: Thu, 13 Sep 2018 09:25:03 -0700 Subject: [PATCH 15/50] Allow nullable BooleanField in Django 2.1 (#6183) * Add tests for BooleanField when nullable * Allow nullable BooleanField in Django 2.1 * Drop 'BooleanField.allow_null' check * Remove conflicting false/null values --- rest_framework/fields.py | 11 ++++++----- tests/test_fields.py | 12 +++++++++++- tests/test_model_serializer.py | 20 ++++++++++++++++++++ 3 files changed, 37 insertions(+), 6 deletions(-) diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 3278cf51c..3378de368 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -674,10 +674,7 @@ class BooleanField(Field): '0', 0, 0.0, False } - - def __init__(self, **kwargs): - assert 'allow_null' not in kwargs, '`allow_null` is not a valid option. Use `NullBooleanField` instead.' - super(BooleanField, self).__init__(**kwargs) + NULL_VALUES = {'null', 'Null', 'NULL', '', None} def to_internal_value(self, data): try: @@ -685,6 +682,8 @@ class BooleanField(Field): return True elif data in self.FALSE_VALUES: return False + elif data in self.NULL_VALUES and self.allow_null: + return None except TypeError: # Input is an unhashable type pass self.fail('invalid', input=data) @@ -694,6 +693,8 @@ class BooleanField(Field): return True elif value in self.FALSE_VALUES: return False + if value in self.NULL_VALUES and self.allow_null: + return None return bool(value) @@ -718,7 +719,7 @@ class NullBooleanField(Field): '0', 0, 0.0, False } - NULL_VALUES = {'n', 'N', 'null', 'Null', 'NULL', '', None} + NULL_VALUES = {'null', 'Null', 'NULL', '', None} def __init__(self, **kwargs): assert 'allow_null' not in kwargs, '`allow_null` is not a valid option.' diff --git a/tests/test_fields.py b/tests/test_fields.py index aa3391a72..1b8f596e2 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -657,7 +657,7 @@ class TestBooleanField(FieldValues): class TestNullBooleanField(TestBooleanField): """ - Valid and invalid values for `BooleanField`. + Valid and invalid values for `NullBooleanField`. """ valid_inputs = { 'true': True, @@ -682,6 +682,16 @@ class TestNullBooleanField(TestBooleanField): field = serializers.NullBooleanField() +class TestNullableBooleanField(TestNullBooleanField): + """ + Valid and invalid values for `BooleanField` when `allow_null=True`. + """ + + @property + def field(self): + return serializers.BooleanField(allow_null=True) + + # String types... class TestCharField(FieldValues): diff --git a/tests/test_model_serializer.py b/tests/test_model_serializer.py index 1bd1fd053..e9ed9957f 100644 --- a/tests/test_model_serializer.py +++ b/tests/test_model_serializer.py @@ -12,6 +12,7 @@ import decimal import sys from collections import OrderedDict +import django import pytest from django.core.exceptions import ImproperlyConfigured from django.core.validators import ( @@ -220,6 +221,25 @@ class TestRegularFieldMappings(TestCase): ) self.assertEqual(unicode_repr(TestSerializer()), expected) + # merge this into test_regular_fields / RegularFieldsModel when + # Django 2.1 is the minimum supported version + @pytest.mark.skipif(django.VERSION < (2, 1), reason='Django version < 2.1') + def test_nullable_boolean_field(self): + class NullableBooleanModel(models.Model): + field = models.BooleanField(null=True, default=False) + + class NullableBooleanSerializer(serializers.ModelSerializer): + class Meta: + model = NullableBooleanModel + fields = ['field'] + + expected = dedent(""" + NullableBooleanSerializer(): + field = BooleanField(allow_null=True, required=False) + """) + + self.assertEqual(unicode_repr(NullableBooleanSerializer()), expected) + def test_method_field(self): """ Properties and methods on the model should be allowed as `Meta.fields` From ed6340ee7619d7e8c3419ffacb973f7ca0c329d3 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Mon, 17 Sep 2018 01:39:59 -0700 Subject: [PATCH 16/50] Remove unnecessary use of compat shim six.binary_type (#6189) The type bytes is available on all supported Pythons. On Python 2.7, it is an alias for str, same as six.binary_type. Makes the code more forward compatible with Python 3. --- rest_framework/compat.py | 2 +- rest_framework/fields.py | 2 +- rest_framework/utils/encoders.py | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/rest_framework/compat.py b/rest_framework/compat.py index 2f4729214..d6559d5f5 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -96,7 +96,7 @@ def unicode_to_repr(value): def unicode_http_header(value): # Coerce HTTP header value to unicode. - if isinstance(value, six.binary_type): + if isinstance(value, bytes): return value.decode('iso-8859-1') return value diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 3378de368..61f3451b0 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -1780,7 +1780,7 @@ class JSONField(Field): def to_internal_value(self, data): try: if self.binary or getattr(data, 'is_json_string', False): - if isinstance(data, six.binary_type): + if isinstance(data, bytes): data = data.decode('utf-8') return json.loads(data) else: diff --git a/rest_framework/utils/encoders.py b/rest_framework/utils/encoders.py index fe8f76dd5..d8f4aeb4e 100644 --- a/rest_framework/utils/encoders.py +++ b/rest_framework/utils/encoders.py @@ -47,7 +47,7 @@ class JSONEncoder(json.JSONEncoder): return six.text_type(obj) elif isinstance(obj, QuerySet): return tuple(obj) - elif isinstance(obj, six.binary_type): + elif isinstance(obj, bytes): # Best-effort for binary blobs. See #4187. return obj.decode('utf-8') elif hasattr(obj, 'tolist'): From 5174a26ec9d50c7b1e934ee2613de4ae2e2c8c6a Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Mon, 17 Sep 2018 01:41:55 -0700 Subject: [PATCH 17/50] Simplify job matrix on Travis (#6174) * Move to explicit Travis matrix * Cleanup Python 3.6 matrix --- .travis.yml | 30 +++++++++++------------------- 1 file changed, 11 insertions(+), 19 deletions(-) diff --git a/.travis.yml b/.travis.yml index 2620e079d..a0d72e3d6 100644 --- a/.travis.yml +++ b/.travis.yml @@ -1,26 +1,25 @@ language: python cache: pip -python: - - "2.7" - - "3.4" - - "3.5" - sudo: false -env: - - DJANGO=1.11 - - DJANGO=2.0 - - DJANGO=2.1 - - DJANGO=master - matrix: fast_finish: true include: - - { python: "3.6", env: DJANGO=master } + - { python: "2.7", env: DJANGO=1.11 } + + - { 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 } + - { 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=master } - { python: "3.7", env: DJANGO=2.0, dist: xenial, sudo: true } - { python: "3.7", env: DJANGO=2.1, dist: xenial, sudo: true } @@ -38,13 +37,6 @@ matrix: - tox --installpkg ./dist/djangorestframework-*.whl - tox # test sdist - exclude: - - { python: "2.7", env: DJANGO=master } - - { python: "2.7", env: DJANGO=2.0 } - - { python: "2.7", env: DJANGO=2.1 } - - { python: "3.4", env: DJANGO=master } - - { python: "3.4", env: DJANGO=2.1 } - allow_failures: - env: DJANGO=master From b090ae9d30f26117f474479b853289a46c6ca615 Mon Sep 17 00:00:00 2001 From: Melissa Lewis Date: Tue, 18 Sep 2018 15:32:32 -0700 Subject: [PATCH 18/50] Fix docs typos (#6195) --- docs/api-guide/schemas.md | 4 ++-- docs/topics/documenting-your-api.md | 6 +++--- docs/topics/html-and-forms.md | 2 +- docs/topics/internationalization.md | 2 +- docs/topics/writable-nested-serializers.md | 2 +- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/api-guide/schemas.md b/docs/api-guide/schemas.md index 6ad259588..8144f3eee 100644 --- a/docs/api-guide/schemas.md +++ b/docs/api-guide/schemas.md @@ -146,7 +146,7 @@ example above. Automatic schema generation is provided by the `SchemaGenerator` class. -`SchemaGenerator` processes a list of routed URL pattterns and compiles the +`SchemaGenerator` processes a list of routed URL patterns and compiles the appropriately structured Core API Document. Basic usage is just to provide the title for your schema and call @@ -818,7 +818,7 @@ A short description of the meaning and intended usage of the input field. ## drf-yasg - Yet Another Swagger Generator -[drf-yasg][drf-yasg] generates [OpenAPI][open-api] documents suitable for code generation - nested schemas, +[drf-yasg][drf-yasg] generates [OpenAPI][open-api] documents suitable for code generation - nested schemas, named models, response bodies, enum/pattern/min/max validators, form parameters, etc. diff --git a/docs/topics/documenting-your-api.md b/docs/topics/documenting-your-api.md index d57f9d6e4..71db39930 100644 --- a/docs/topics/documenting-your-api.md +++ b/docs/topics/documenting-your-api.md @@ -16,11 +16,11 @@ The built-in API documentation includes: ### Installation -The `coreapi` library is required as a dependancy for the API docs. Make sure +The `coreapi` library is required as a dependency for the API docs. Make sure 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 projects URLconf: +To install the API documentation, you'll need to include it in your project's URLconf: from rest_framework.documentation import include_docs_urls @@ -39,7 +39,7 @@ This will include two different views: **Note**: By default `include_docs_urls` configures the underlying `SchemaView` to generate _public_ schemas. This means that views will not be instantiated with a `request` instance. i.e. Inside the view `self.request` will be `None`. -To be compatible with this behaviour methods (such as `get_serializer` or `get_serializer_class` etc.) which inspect `self.request` or, particularly, `self.request.user` may need to be adjusted to handle this case. +To be compatible with this behaviour, methods (such as `get_serializer` or `get_serializer_class` etc.) which inspect `self.request` or, particularly, `self.request.user` may need to be adjusted to handle this case. You may ensure views are given a `request` instance by calling `include_docs_urls` with `public=False`: diff --git a/docs/topics/html-and-forms.md b/docs/topics/html-and-forms.md index 0b4afca12..18774926b 100644 --- a/docs/topics/html-and-forms.md +++ b/docs/topics/html-and-forms.md @@ -4,7 +4,7 @@ REST framework is suitable for returning both API style responses, and regular H ## Rendering HTML -In order to return HTML responses you'll need to either `TemplateHTMLRenderer`, or `StaticHTMLRenderer`. +In order to return HTML responses you'll need to use either `TemplateHTMLRenderer`, or `StaticHTMLRenderer`. The `TemplateHTMLRenderer` class expects the response to contain a dictionary of context data, and renders an HTML page based on a template that must be specified either in the view or on the response. diff --git a/docs/topics/internationalization.md b/docs/topics/internationalization.md index ed8b85836..7cfc6e247 100644 --- a/docs/topics/internationalization.md +++ b/docs/topics/internationalization.md @@ -43,7 +43,7 @@ REST framework includes these built-in translations both for standard exception Note that the translations only apply to the error strings themselves. The format of error messages, and the keys of field names will remain the same. An example `400 Bad Request` response body might look like this: - {"detail": {"username": ["Esse campo deve ser unico."]}} + {"detail": {"username": ["Esse campo deve ser Ăşnico."]}} If you want to use different string for parts of the response such as `detail` and `non_field_errors` then you can modify this behavior by using a [custom exception handler][custom-exception-handler]. diff --git a/docs/topics/writable-nested-serializers.md b/docs/topics/writable-nested-serializers.md index a39feb18c..9ba719f4e 100644 --- a/docs/topics/writable-nested-serializers.md +++ b/docs/topics/writable-nested-serializers.md @@ -27,7 +27,7 @@ Nested data structures are easy enough to work with if they're read-only - simpl Some example output from our serializer. { - 'title': 'Leaving party preperations', + 'title': 'Leaving party preparations', 'items': [ {'text': 'Compile playlist', 'is_completed': True}, {'text': 'Send invites', 'is_completed': False}, From d976ac56b0b108a65eeb67eb812e700df4addc72 Mon Sep 17 00:00:00 2001 From: Anish Shrestha Date: Fri, 21 Sep 2018 12:40:32 +0545 Subject: [PATCH 19/50] Fix spelling error (#6198) --- 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 83a38d1c3..35b976c66 100644 --- a/docs/api-guide/requests.md +++ b/docs/api-guide/requests.md @@ -90,7 +90,7 @@ You won't typically need to access this property. --- -**Note:** You may see a `WrappedAttributeError` raised when calling the `.user` or `.auth` properties. These errors originate from an authenticator as a standard `AttributeError`, however it's necessary that they be re-raised as a different exception type in order to prevent them from being suppressed by the outer property access. Python will not recognize that the `AttributeError` orginates from the authenticator and will instaed assume that the request object does not have a `.user` or `.auth` property. The authenticator will need to be fixed. +**Note:** You may see a `WrappedAttributeError` raised when calling the `.user` or `.auth` properties. These errors originate from an authenticator as a standard `AttributeError`, however it's necessary that they be re-raised as a different exception type in order to prevent them from being suppressed by the outer property access. Python will not recognize that the `AttributeError` orginates from the authenticator and will instead assume that the request object does not have a `.user` or `.auth` property. The authenticator will need to be fixed. --- From 2e8ccfd883ea2c4e304a03b3585e1fa7f9fe3d0a Mon Sep 17 00:00:00 2001 From: Anish Shrestha Date: Wed, 26 Sep 2018 00:56:13 +0545 Subject: [PATCH 20/50] Fix typo in docs (#6212) --- docs/api-guide/viewsets.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/viewsets.md b/docs/api-guide/viewsets.md index d98f518b3..819b6cec3 100644 --- a/docs/api-guide/viewsets.md +++ b/docs/api-guide/viewsets.md @@ -158,7 +158,7 @@ A more complete example of extra actions: @action(detail=False) def recent_users(self, request): - recent_users = User.objects.all().order('-last_login') + recent_users = User.objects.all().order_by('-last_login') page = self.paginate_queryset(recent_users) if page is not None: From d1514d1f9c4ead98a4a5d2ff817951e03ca0808d Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Mon, 1 Oct 2018 17:12:03 +0100 Subject: [PATCH 21/50] Update codecov.yml (#6224) --- codecov.yml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/codecov.yml b/codecov.yml index edccd5c35..db6f6873f 100644 --- a/codecov.yml +++ b/codecov.yml @@ -4,5 +4,4 @@ coverage: patch: true changes: true -comment: - layout: "diff" +comment: off From 878f9d2783838801adcd9f551d6f229839d885a3 Mon Sep 17 00:00:00 2001 From: Jon Dufresne Date: Tue, 2 Oct 2018 01:28:58 -0500 Subject: [PATCH 22/50] Prefer https:// for URLs when available throughout project (#6208) --- ISSUE_TEMPLATE.md | 2 +- LICENSE.md | 2 +- README.md | 28 +++++++++---------- docs/api-guide/format-suffixes.md | 2 +- docs/api-guide/metadata.md | 2 +- docs/api-guide/pagination.md | 2 +- docs/api-guide/relations.md | 2 +- docs/api-guide/renderers.md | 4 +-- docs/api-guide/routers.md | 2 +- docs/api-guide/schemas.md | 6 ++-- docs/api-guide/validators.md | 2 +- docs/api-guide/viewsets.md | 2 +- docs/community/3.0-announcement.md | 2 +- docs/community/3.2-announcement.md | 2 +- docs/community/3.4-announcement.md | 6 ++-- docs/community/funding.md | 10 +++---- docs/community/kickstarter-announcement.md | 6 ++-- docs/community/mozilla-grant.md | 4 +-- docs/community/project-management.md | 10 +++---- docs/community/tutorials-and-resources.md | 4 +-- docs/topics/api-clients.md | 4 +-- docs/topics/browser-enhancements.md | 2 +- docs/topics/documenting-your-api.md | 2 +- docs/topics/rest-hypermedia-hateoas.md | 2 +- .../7-schemas-and-client-libraries.md | 6 ++-- docs_theme/404.html | 2 +- docs_theme/css/bootstrap-responsive.css | 2 +- docs_theme/css/bootstrap.css | 2 +- docs_theme/nav.html | 2 +- mkdocs.yml | 2 +- rest_framework/pagination.py | 2 +- rest_framework/settings.py | 2 +- .../templates/rest_framework/admin.html | 2 +- .../templates/rest_framework/base.html | 2 +- setup.py | 2 +- 35 files changed, 68 insertions(+), 68 deletions(-) diff --git a/ISSUE_TEMPLATE.md b/ISSUE_TEMPLATE.md index 55b3e531b..8f2391d29 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](http://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/topics/third-party-resources/#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.) diff --git a/LICENSE.md b/LICENSE.md index 03213cbd6..3dea39c36 100644 --- a/LICENSE.md +++ b/LICENSE.md @@ -1,6 +1,6 @@ # License -Copyright © 2011-present, [Encode OSS Ltd](http://www.encode.io/). +Copyright © 2011-present, [Encode OSS Ltd](https://www.encode.io/). All rights reserved. Redistribution and use in source and binary forms, with or without diff --git a/README.md b/README.md index b54d1a200..919f85d00 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ **Awesome web-browsable Web APIs.** -Full documentation for the project is available at [http://www.django-rest-framework.org][docs]. +Full documentation for the project is available at [https://www.django-rest-framework.org/][docs]. --- @@ -163,7 +163,7 @@ Or to create a new user: # Documentation & Support -Full documentation for the project is available at [http://www.django-rest-framework.org][docs]. +Full documentation for the project is available at [https://www.django-rest-framework.org/][docs]. For questions and support, use the [REST framework discussion group][group], or `#restframework` on freenode IRC. @@ -202,17 +202,17 @@ 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 -[oauth1-section]: http://www.django-rest-framework.org/api-guide/authentication/#django-rest-framework-oauth -[oauth2-section]: http://www.django-rest-framework.org/api-guide/authentication/#django-oauth-toolkit -[serializer-section]: http://www.django-rest-framework.org/api-guide/serializers/#serializers -[modelserializer-section]: http://www.django-rest-framework.org/api-guide/serializers/#modelserializer -[functionview-section]: http://www.django-rest-framework.org/api-guide/views/#function-based-views -[generic-views]: http://www.django-rest-framework.org/api-guide/generic-views/ -[viewsets]: http://www.django-rest-framework.org/api-guide/viewsets/ -[routers]: http://www.django-rest-framework.org/api-guide/routers/ -[serializers]: http://www.django-rest-framework.org/api-guide/serializers/ -[authentication]: http://www.django-rest-framework.org/api-guide/authentication/ -[image]: http://www.django-rest-framework.org/img/quickstart.png +[oauth1-section]: https://www.django-rest-framework.org/api-guide/authentication/#django-rest-framework-oauth +[oauth2-section]: https://www.django-rest-framework.org/api-guide/authentication/#django-oauth-toolkit +[serializer-section]: https://www.django-rest-framework.org/api-guide/serializers/#serializers +[modelserializer-section]: https://www.django-rest-framework.org/api-guide/serializers/#modelserializer +[functionview-section]: https://www.django-rest-framework.org/api-guide/views/#function-based-views +[generic-views]: https://www.django-rest-framework.org/api-guide/generic-views/ +[viewsets]: https://www.django-rest-framework.org/api-guide/viewsets/ +[routers]: https://www.django-rest-framework.org/api-guide/routers/ +[serializers]: https://www.django-rest-framework.org/api-guide/serializers/ +[authentication]: https://www.django-rest-framework.org/api-guide/authentication/ +[image]: https://www.django-rest-framework.org/img/quickstart.png -[docs]: http://www.django-rest-framework.org/ +[docs]: https://www.django-rest-framework.org/ [security-mail]: mailto:rest-framework-security@googlegroups.com diff --git a/docs/api-guide/format-suffixes.md b/docs/api-guide/format-suffixes.md index 05dde47f2..629f003f3 100644 --- a/docs/api-guide/format-suffixes.md +++ b/docs/api-guide/format-suffixes.md @@ -90,4 +90,4 @@ It is actually a misconception. For example, take the following quote from Roy The quote does not mention Accept headers, but it does make it clear that format suffixes should be considered an acceptable pattern. [cite]: http://tech.groups.yahoo.com/group/rest-discuss/message/5857 -[cite2]: http://tech.groups.yahoo.com/group/rest-discuss/message/14844 +[cite2]: https://groups.yahoo.com/neo/groups/rest-discuss/conversations/topics/14844 diff --git a/docs/api-guide/metadata.md b/docs/api-guide/metadata.md index affeea61c..a3ba9ac20 100644 --- a/docs/api-guide/metadata.md +++ b/docs/api-guide/metadata.md @@ -117,5 +117,5 @@ If you wish to do so, it also provides an exporter that can export those schema [cite]: https://tools.ietf.org/html/rfc7231#section-4.3.7 [no-options]: https://www.mnot.net/blog/2012/10/29/NO_OPTIONS -[json-schema]: http://json-schema.org/ +[json-schema]: https://json-schema.org/ [drf-schema-adapter]: https://github.com/drf-forms/drf-schema-adapter diff --git a/docs/api-guide/pagination.md b/docs/api-guide/pagination.md index c1e487c67..97590a785 100644 --- a/docs/api-guide/pagination.md +++ b/docs/api-guide/pagination.md @@ -319,5 +319,5 @@ The [`django-rest-framework-link-header-pagination` package][drf-link-header-pag [paginate-by-max-mixin]: https://chibisov.github.io/drf-extensions/docs/#paginatebymaxmixin [drf-proxy-pagination]: https://github.com/tuffnatty/drf-proxy-pagination [drf-link-header-pagination]: https://github.com/tbeadle/django-rest-framework-link-header-pagination -[disqus-cursor-api]: http://cra.mr/2011/03/08/building-cursors-for-the-disqus-api +[disqus-cursor-api]: https://cra.mr/2011/03/08/building-cursors-for-the-disqus-api [float_cursor_pagination_example]: https://gist.github.com/keturn/8bc88525a183fd41c73ffb729b8865be#file-fpcursorpagination-py diff --git a/docs/api-guide/relations.md b/docs/api-guide/relations.md index 02ecf5b12..6a865b7d1 100644 --- a/docs/api-guide/relations.md +++ b/docs/api-guide/relations.md @@ -594,7 +594,7 @@ The [rest-framework-generic-relations][drf-nested-relations] library provides re [cite]: https://lwn.net/Articles/193245/ [reverse-relationships]: https://docs.djangoproject.com/en/stable/topics/db/queries/#following-relationships-backward -[routers]: http://www.django-rest-framework.org/api-guide/routers#defaultrouter +[routers]: https://www.django-rest-framework.org/api-guide/routers#defaultrouter [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 diff --git a/docs/api-guide/renderers.md b/docs/api-guide/renderers.md index d720dffc5..a43f4be8a 100644 --- a/docs/api-guide/renderers.md +++ b/docs/api-guide/renderers.md @@ -521,13 +521,13 @@ Comma-separated values are a plain-text tabular data format, that can be easily [browser-accept-headers]: http://www.gethifi.com/blog/browser-rest-http-accept-headers [testing]: testing.md [HATEOAS]: http://timelessrepo.com/haters-gonna-hateoas -[quote]: http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven +[quote]: https://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven [application/vnd.github+json]: https://developer.github.com/v3/media/ [application/vnd.collection+json]: http://www.amundsen.com/media-types/collection/ [django-error-views]: https://docs.djangoproject.com/en/stable/topics/http/views/#customizing-error-views [rest-framework-jsonp]: https://jpadilla.github.io/django-rest-framework-jsonp/ [cors]: https://www.w3.org/TR/cors/ -[cors-docs]: http://www.django-rest-framework.org/topics/ajax-csrf-cors/ +[cors-docs]: https://www.django-rest-framework.org/topics/ajax-csrf-cors/ [jsonp-security]: https://stackoverflow.com/questions/613962/is-jsonp-safe-to-use [rest-framework-yaml]: https://jpadilla.github.io/django-rest-framework-yaml/ [rest-framework-xml]: https://jpadilla.github.io/django-rest-framework-xml/ diff --git a/docs/api-guide/routers.md b/docs/api-guide/routers.md index d3ebd6866..09c6c39cb 100644 --- a/docs/api-guide/routers.md +++ b/docs/api-guide/routers.md @@ -325,7 +325,7 @@ The [wq.db package][wq.db] provides an advanced [ModelRouter][wq.db-router] clas The [`DRF-extensions` package][drf-extensions] provides [routers][drf-extensions-routers] for creating [nested viewsets][drf-extensions-nested-viewsets], [collection level controllers][drf-extensions-collection-level-controllers] with [customizable endpoint names][drf-extensions-customizable-endpoint-names]. -[cite]: http://guides.rubyonrails.org/routing.html +[cite]: https://guides.rubyonrails.org/routing.html [route-decorators]: viewsets.md#marking-extra-actions-for-routing [drf-nested-routers]: https://github.com/alanjds/drf-nested-routers [wq.db]: https://wq.io/wq.db diff --git a/docs/api-guide/schemas.md b/docs/api-guide/schemas.md index 8144f3eee..b1b6ae63e 100644 --- a/docs/api-guide/schemas.md +++ b/docs/api-guide/schemas.md @@ -829,12 +829,12 @@ in [OpenAPI][open-api] format. [cite]: https://blog.heroku.com/archives/2014/1/8/json_schema_for_heroku_platform_api -[coreapi]: http://www.coreapi.org/ -[corejson]: http://www.coreapi.org/specification/encoding/#core-json-encoding +[coreapi]: https://www.coreapi.org/ +[corejson]: https://www.coreapi.org/specification/encoding/#core-json-encoding [drf-yasg]: https://github.com/axnsan12/drf-yasg/ [open-api]: https://openapis.org/ [drf-openapi]: https://github.com/limdauto/drf_openapi -[json-hyperschema]: http://json-schema.org/latest/json-schema-hypermedia.html +[json-hyperschema]: https://json-schema.org/latest/json-schema-hypermedia.html [api-blueprint]: https://apiblueprint.org/ [static-files]: https://docs.djangoproject.com/en/stable/howto/static-files/ [named-arguments]: https://docs.djangoproject.com/en/stable/topics/http/urls/#named-groups diff --git a/docs/api-guide/validators.md b/docs/api-guide/validators.md index 925f67206..3b50442cc 100644 --- a/docs/api-guide/validators.md +++ b/docs/api-guide/validators.md @@ -275,7 +275,7 @@ A validator may be any callable that raises a `serializers.ValidationError` on f You can specify custom field-level validation by adding `.validate_` methods to your `Serializer` subclass. This is documented in the -[Serializer docs](http://www.django-rest-framework.org/api-guide/serializers/#field-level-validation) +[Serializer docs](https://www.django-rest-framework.org/api-guide/serializers/#field-level-validation) ## Class-based diff --git a/docs/api-guide/viewsets.md b/docs/api-guide/viewsets.md index 819b6cec3..b912e0dac 100644 --- a/docs/api-guide/viewsets.md +++ b/docs/api-guide/viewsets.md @@ -314,5 +314,5 @@ To create a base viewset class that provides `create`, `list` and `retrieve` ope By creating your own base `ViewSet` classes, you can provide common behavior that can be reused in multiple viewsets across your API. -[cite]: http://guides.rubyonrails.org/routing.html +[cite]: https://guides.rubyonrails.org/routing.html [routers]: routers.md diff --git a/docs/community/3.0-announcement.md b/docs/community/3.0-announcement.md index 66a035380..83aec9e60 100644 --- a/docs/community/3.0-announcement.md +++ b/docs/community/3.0-announcement.md @@ -960,6 +960,6 @@ The 3.2 release is planned to introduce an alternative admin-style interface to You can follow development on the GitHub site, where we use [milestones to indicate planning timescales](https://github.com/encode/django-rest-framework/milestones). [kickstarter]: https://www.kickstarter.com/projects/tomchristie/django-rest-framework-3 -[sponsors]: http://www.django-rest-framework.org/topics/kickstarter-announcement/#sponsors +[sponsors]: https://www.django-rest-framework.org/topics/kickstarter-announcement/#sponsors [mixins.py]: https://github.com/encode/django-rest-framework/blob/master/rest_framework/mixins.py [django-localization]: https://docs.djangoproject.com/en/stable/topics/i18n/translation/#localization-how-to-create-language-files diff --git a/docs/community/3.2-announcement.md b/docs/community/3.2-announcement.md index c022231a0..a6db0e54b 100644 --- a/docs/community/3.2-announcement.md +++ b/docs/community/3.2-announcement.md @@ -10,7 +10,7 @@ We've also fixed a huge number of issues, and made numerous cleanups and improve Over the course of the 3.1.x series we've [resolved nearly 600 tickets](https://github.com/encode/django-rest-framework/issues?utf8=%E2%9C%93&q=closed%3A%3E2015-03-05) on our GitHub issue tracker. This means we're currently running at a rate of **closing around 100 issues or pull requests per month**. -None of this would have been possible without the support of our wonderful Kickstarter backers. If you're looking for a job in Django development we'd strongly recommend taking [a look through our sponsors](http://www.django-rest-framework.org/topics/kickstarter-announcement/#sponsors) and finding out who's hiring. +None of this would have been possible without the support of our wonderful Kickstarter backers. If you're looking for a job in Django development we'd strongly recommend taking [a look through our sponsors](https://www.django-rest-framework.org/topics/kickstarter-announcement/#sponsors) and finding out who's hiring. ## AdminRenderer diff --git a/docs/community/3.4-announcement.md b/docs/community/3.4-announcement.md index 73ec3f2a2..44270fd85 100644 --- a/docs/community/3.4-announcement.md +++ b/docs/community/3.4-announcement.md @@ -178,12 +178,12 @@ The full set of itemized release notes [are available here][release-notes]. [sponsors]: https://fund.django-rest-framework.org/topics/funding/#our-sponsors [moss]: mozilla-grant.md [funding]: funding.md -[core-api]: http://www.coreapi.org/ +[core-api]: https://www.coreapi.org/ [command-line-client]: api-clients#command-line-client [client-library]: api-clients#python-client-library -[core-json]: http://www.coreapi.org/specification/encoding/#core-json-encoding +[core-json]: https://www.coreapi.org/specification/encoding/#core-json-encoding [swagger]: https://openapis.org/specification -[hyperschema]: http://json-schema.org/latest/json-schema-hypermedia.html +[hyperschema]: https://json-schema.org/latest/json-schema-hypermedia.html [api-blueprint]: https://apiblueprint.org/ [tut-7]: ../tutorial/7-schemas-and-client-libraries/ [schema-generation]: ../api-guide/schemas/ diff --git a/docs/community/funding.md b/docs/community/funding.md index 0faf2164b..8f0e02515 100644 --- a/docs/community/funding.md +++ b/docs/community/funding.md @@ -123,10 +123,10 @@ REST framework continues to be open-source and permissively licensed, but we fir ## What funding has enabled so far -* The [3.4](http://www.django-rest-framework.org/topics/3.4-announcement/) and [3.5](http://www.django-rest-framework.org/topics/3.5-announcement/) releases, including schema generation for both Swagger and RAML, a Python client library, a Command Line client, and addressing of a large number of outstanding issues. -* The [3.6](http://www.django-rest-framework.org/topics/3.6-announcement/) release, including JavaScript client library, and API documentation, complete with auto-generated code samples. -* The [3.7 release](http://www.django-rest-framework.org/topics/3.7-announcement/), made possible due to our collaborative funding model, focuses on improvements to schema generation and the interactive API documentation. -* The recent [3.8 release](http://www.django-rest-framework.org/topics/3.8-announcement/). +* The [3.4](https://www.django-rest-framework.org/topics/3.4-announcement/) and [3.5](https://www.django-rest-framework.org/topics/3.5-announcement/) releases, including schema generation for both Swagger and RAML, a Python client library, a Command Line client, and addressing of a large number of outstanding issues. +* The [3.6](https://www.django-rest-framework.org/topics/3.6-announcement/) release, including JavaScript client library, and API documentation, complete with auto-generated code samples. +* The [3.7 release](https://www.django-rest-framework.org/topics/3.7-announcement/), made possible due to our collaborative funding model, focuses on improvements to schema generation and the interactive API documentation. +* The recent [3.8 release](https://www.django-rest-framework.org/topics/3.8-announcement/). * Tom Christie, the creator of Django REST framework, working on the project full-time. * Around 80-90 issues and pull requests closed per month since Tom Christie started working on the project full-time. * A community & operations manager position part-time for 4 months, helping mature the business and grow sponsorship. @@ -341,7 +341,7 @@ For further enquires please contact diff --git a/docs/community/kickstarter-announcement.md b/docs/community/kickstarter-announcement.md index e2a283e29..0e5d95b2c 100644 --- a/docs/community/kickstarter-announcement.md +++ b/docs/community/kickstarter-announcement.md @@ -78,7 +78,7 @@ Our gold sponsors include companies large and small. Many thanks for their signi
  • Mirus Research
  • Hipo
  • Byte
    • -
  • Lightning Kite
    • +
  • Lightning Kite
  • Opbeat
  • Koordinates
  • Pulsecode Inc.
    • @@ -116,7 +116,7 @@ The serious financial contribution that our silver sponsors have made is very mu
  • Garfo
  • Shippo
  • Gizmag
    • -
  • Tivix
    • +
  • Tivix
  • Safari
  • Bright Loop
  • ABA Systems
    • @@ -131,7 +131,7 @@ The serious financial contribution that our silver sponsors have made is very mu
  • Fluxility
  • Teonite
  • TrackMaven
    • -
  • Phurba
    • +
  • Phurba
  • Nephila
  • Aditium
  • OpenEye Scientific Software
    • diff --git a/docs/community/mozilla-grant.md b/docs/community/mozilla-grant.md index 4d9b1d438..5248f5cc0 100644 --- a/docs/community/mozilla-grant.md +++ b/docs/community/mozilla-grant.md @@ -4,7 +4,7 @@ We have recently been [awarded a Mozilla grant](https://blog.mozilla.org/blog/20 Additionally, we will be building on the realtime support that Django Channels provides, supporting and documenting how to build realtime APIs with REST framework. Again, this will include supporting work in the associated client libraries, making it easier to build richly interactive applications. -The [Core API](http://www.coreapi.org) project will provide the foundations for our client library support, and will allow us to support interaction using a wide range of schemas and hypermedia formats. It's worth noting that these client libraries won't be tightly coupled to solely REST framework APIs either, and will be able to interact with *any* API that exposes a supported schema or hypermedia format. +The [Core API](https://www.coreapi.org/) project will provide the foundations for our client library support, and will allow us to support interaction using a wide range of schemas and hypermedia formats. It's worth noting that these client libraries won't be tightly coupled to solely REST framework APIs either, and will be able to interact with *any* API that exposes a supported schema or hypermedia format. Specifically, the work includes: @@ -34,7 +34,7 @@ In order to ensure that I can be fully focused on trying to secure a sustainable & well-funded open source business I will be leaving my current role at [DabApps](https://www.dabapps.com/) at the end of May 2016. -I have formed a UK limited company, [Encode](http://www.encode.io), which will +I have formed a UK limited company, [Encode](https://www.encode.io/), which will act as the business entity behind REST framework. I will be issuing monthly reports from Encode on progress both towards the Mozilla grant, and for development time funded via the [REST framework paid plans](funding.md). diff --git a/docs/community/project-management.md b/docs/community/project-management.md index c7f064e13..21f93b380 100644 --- a/docs/community/project-management.md +++ b/docs/community/project-management.md @@ -39,7 +39,7 @@ The following template should be used for the description of the issue, and serv This issue is for determining the maintenance team for the *** period. - Please see the [Project management](http://www.django-rest-framework.org/topics/project-management/) section of our documentation for more details. + Please see the [Project management](https://www.django-rest-framework.org/topics/project-management/) section of our documentation for more details. --- @@ -59,7 +59,7 @@ The following template should be used for the description of the issue, and serv If you wish to be considered for this or a future date, please comment against this or subsequent issues. - To modify this process for future maintenance cycles make a pull request to the [project management](http://www.django-rest-framework.org/topics/project-management/) documentation. + To modify this process for future maintenance cycles make a pull request to the [project management](https://www.django-rest-framework.org/topics/project-management/) documentation. #### Responsibilities of team members @@ -99,7 +99,7 @@ The following template should be used for the description of the issue, and serv During development cycle: - - [ ] Upload the new content to be translated to [transifex](http://www.django-rest-framework.org/topics/project-management/#translations). + - [ ] Upload the new content to be translated to [transifex](https://www.django-rest-framework.org/topics/project-management/#translations). Checklist: @@ -110,7 +110,7 @@ The following template should be used for the description of the issue, and serv - [ ] `setup.py` Python & Django version trove classifiers - [ ] `README` Python & Django versions - [ ] `docs` Python & Django versions - - [ ] Update the translations from [transifex](http://www.django-rest-framework.org/topics/project-management/#translations). + - [ ] Update the translations from [transifex](https://www.django-rest-framework.org/topics/project-management/#translations). - [ ] Ensure the pull request increments the version to `*.*.*` in [`restframework/__init__.py`](https://github.com/encode/django-rest-framework/blob/master/rest_framework/__init__.py). - [ ] Confirm with @tomchristie that release is finalized and ready to go. - [ ] Ensure that release date is included in pull request. @@ -122,7 +122,7 @@ The following template should be used for the description of the issue, and serv - [ ] Make a release announcement on twitter. - [ ] Close the milestone on GitHub. - To modify this process for future releases make a pull request to the [project management](http://www.django-rest-framework.org/topics/project-management/) documentation. + To modify this process for future releases make a pull request to the [project management](https://www.django-rest-framework.org/topics/project-management/) documentation. When pushing the release to PyPI ensure that your environment has been installed from our development `requirement.txt`, so that documentation and PyPI installs are consistently being built against a pinned set of packages. diff --git a/docs/community/tutorials-and-resources.md b/docs/community/tutorials-and-resources.md index 8c30bbeaa..a03d63a3c 100644 --- a/docs/community/tutorials-and-resources.md +++ b/docs/community/tutorials-and-resources.md @@ -85,8 +85,8 @@ Want your Django REST Framework talk/tutorial/article to be added to our website [beginners-guide-to-the-django-rest-framework]: https://code.tutsplus.com/tutorials/beginners-guide-to-the-django-rest-framework--cms-19786 -[getting-started-with-django-rest-framework-and-angularjs]: http://blog.kevinastone.com/getting-started-with-django-rest-framework-and-angularjs.html -[end-to-end-web-app-with-django-rest-framework-angularjs]: http://mourafiq.com/2013/07/01/end-to-end-web-app-with-django-angular-1.html +[getting-started-with-django-rest-framework-and-angularjs]: https://blog.kevinastone.com/getting-started-with-django-rest-framework-and-angularjs.html +[end-to-end-web-app-with-django-rest-framework-angularjs]: https://mourafiq.com/2013/07/01/end-to-end-web-app-with-django-angular-1.html [start-your-api-django-rest-framework-part-1]: https://godjango.com/41-start-your-api-django-rest-framework-part-1/ [permissions-authentication-django-rest-framework-part-2]: https://godjango.com/43-permissions-authentication-django-rest-framework-part-2/ [viewsets-and-routers-django-rest-framework-part-3]: https://godjango.com/45-viewsets-and-routers-django-rest-framework-part-3/ diff --git a/docs/topics/api-clients.md b/docs/topics/api-clients.md index ec0b4272c..3fd560634 100644 --- a/docs/topics/api-clients.md +++ b/docs/topics/api-clients.md @@ -521,7 +521,7 @@ You'll either want to include the API schema in your codebase directly, by copyi }) [heroku-api]: https://devcenter.heroku.com/categories/platform-api -[heroku-example]: http://www.coreapi.org/tools-and-resources/example-services/#heroku-json-hyper-schema -[core-api]: http://www.coreapi.org/ +[heroku-example]: https://www.coreapi.org/tools-and-resources/example-services/#heroku-json-hyper-schema +[core-api]: https://www.coreapi.org/ [schema-generation]: ../api-guide/schemas.md [transport-adaptors]: http://docs.python-requests.org/en/master/user/advanced/#transport-adapters diff --git a/docs/topics/browser-enhancements.md b/docs/topics/browser-enhancements.md index 32eab43a8..0e79a66e1 100644 --- a/docs/topics/browser-enhancements.md +++ b/docs/topics/browser-enhancements.md @@ -82,6 +82,6 @@ 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 -[rails]: http://guides.rubyonrails.org/form_helpers.html#how-do-forms-with-put-or-delete-methods-work +[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/ diff --git a/docs/topics/documenting-your-api.md b/docs/topics/documenting-your-api.md index 71db39930..f57b51ee0 100644 --- a/docs/topics/documenting-your-api.md +++ b/docs/topics/documenting-your-api.md @@ -313,7 +313,7 @@ In this approach, rather than documenting the available API endpoints up front, To implement a hypermedia API you'll need to decide on an appropriate media type for the API, and implement a custom renderer and parser for that media type. The [REST, Hypermedia & HATEOAS][hypermedia-docs] section of the documentation includes pointers to background reading, as well as links to various hypermedia formats. -[cite]: http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven +[cite]: https://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven [drf-yasg]: https://github.com/axnsan12/drf-yasg/ [image-drf-yasg]: ../img/drf-yasg.png [drf-openapi]: https://github.com/limdauto/drf_openapi/ diff --git a/docs/topics/rest-hypermedia-hateoas.md b/docs/topics/rest-hypermedia-hateoas.md index aa889f62b..d48319a26 100644 --- a/docs/topics/rest-hypermedia-hateoas.md +++ b/docs/topics/rest-hypermedia-hateoas.md @@ -36,7 +36,7 @@ What REST framework doesn't do is give you machine readable hypermedia formats s [cite]: https://vimeo.com/channels/restfest/page:2 [dissertation]: https://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm -[hypertext-driven]: http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven +[hypertext-driven]: https://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven [restful-web-apis]: http://restfulwebapis.org/ [building-hypermedia-apis]: https://www.amazon.com/Building-Hypermedia-APIs-HTML5-Node/dp/1449306578 [designing-hypermedia-apis]: http://designinghypermediaapis.com/ diff --git a/docs/tutorial/7-schemas-and-client-libraries.md b/docs/tutorial/7-schemas-and-client-libraries.md index f8060ac29..412759834 100644 --- a/docs/tutorial/7-schemas-and-client-libraries.md +++ b/docs/tutorial/7-schemas-and-client-libraries.md @@ -89,7 +89,7 @@ Now check that it is available on the command line... Command line client for interacting with CoreAPI services. - Visit http://www.coreapi.org for more information. + Visit https://www.coreapi.org/ for more information. Options: --version Display the package version number. @@ -220,8 +220,8 @@ We've reached the end of our tutorial. If you want to get more involved in the **Now go build awesome things.** -[coreapi]: http://www.coreapi.org -[corejson]: http://www.coreapi.org/specification/encoding/#core-json-encoding +[coreapi]: https://www.coreapi.org/ +[corejson]: https://www.coreapi.org/specification/encoding/#core-json-encoding [openapi]: https://openapis.org/ [repo]: https://github.com/encode/rest-framework-tutorial [sandbox]: https://restframework.herokuapp.com/ diff --git a/docs_theme/404.html b/docs_theme/404.html index 078b9f5ae..a89c0a418 100644 --- a/docs_theme/404.html +++ b/docs_theme/404.html @@ -4,6 +4,6 @@

    404

    Page not found

    -

    Try the homepage, or search the documentation.

    +

    Try the homepage, or search the documentation.

    {% endblock %} diff --git a/docs_theme/css/bootstrap-responsive.css b/docs_theme/css/bootstrap-responsive.css index a8caf451d..ec0b51947 100755 --- a/docs_theme/css/bootstrap-responsive.css +++ b/docs_theme/css/bootstrap-responsive.css @@ -3,7 +3,7 @@ * * Copyright 2012 Twitter, Inc * Licensed under the Apache License v2.0 - * http://www.apache.org/licenses/LICENSE-2.0 + * https://www.apache.org/licenses/LICENSE-2.0 * * Designed and built with all the love in the world @twitter by @mdo and @fat. */ diff --git a/docs_theme/css/bootstrap.css b/docs_theme/css/bootstrap.css index 53df68595..a48bbbecf 100755 --- a/docs_theme/css/bootstrap.css +++ b/docs_theme/css/bootstrap.css @@ -3,7 +3,7 @@ * * Copyright 2012 Twitter, Inc * Licensed under the Apache License v2.0 - * http://www.apache.org/licenses/LICENSE-2.0 + * https://www.apache.org/licenses/LICENSE-2.0 * * Designed and built with all the love in the world @twitter by @mdo and @fat. */ diff --git a/docs_theme/nav.html b/docs_theme/nav.html index 914d80a27..f093178d3 100644 --- a/docs_theme/nav.html +++ b/docs_theme/nav.html @@ -14,7 +14,7 @@ - Django REST framework + Django REST framework
    {% if nav|length>1 %} diff --git a/mkdocs.yml b/mkdocs.yml index 70b8c02ad..fbdb8d779 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,5 +1,5 @@ site_name: Django REST framework -site_url: http://www.django-rest-framework.org/ +site_url: https://www.django-rest-framework.org/ site_description: Django REST framework - Web APIs for Django repo_url: https://github.com/encode/django-rest-framework diff --git a/rest_framework/pagination.py b/rest_framework/pagination.py index c3494e3c5..b11d7cdf3 100644 --- a/rest_framework/pagination.py +++ b/rest_framework/pagination.py @@ -472,7 +472,7 @@ class CursorPagination(BasePagination): """ The cursor pagination implementation is necessarily complex. For an overview of the position/offset style we use, see this post: - http://cra.mr/2011/03/08/building-cursors-for-the-disqus-api + https://cra.mr/2011/03/08/building-cursors-for-the-disqus-api """ cursor_query_param = 'cursor' cursor_query_description = _('The pagination cursor value.') diff --git a/rest_framework/settings.py b/rest_framework/settings.py index 6c581f8e8..8db9c81ed 100644 --- a/rest_framework/settings.py +++ b/rest_framework/settings.py @@ -232,7 +232,7 @@ class APISettings(object): return val def __check_user_settings(self, user_settings): - SETTINGS_DOC = "http://www.django-rest-framework.org/api-guide/settings/" + SETTINGS_DOC = "https://www.django-rest-framework.org/api-guide/settings/" for setting in REMOVED_SETTINGS: if setting in user_settings: raise RuntimeError("The '%s' setting has been removed. Please refer to '%s' for available settings." % (setting, SETTINGS_DOC)) diff --git a/rest_framework/templates/rest_framework/admin.html b/rest_framework/templates/rest_framework/admin.html index faa37a586..66d8431f1 100644 --- a/rest_framework/templates/rest_framework/admin.html +++ b/rest_framework/templates/rest_framework/admin.html @@ -34,7 +34,7 @@
    {% block branding %} - + Django REST framework {% endblock %} diff --git a/rest_framework/templates/rest_framework/base.html b/rest_framework/templates/rest_framework/base.html index eb7a96995..5b489ee1a 100644 --- a/rest_framework/templates/rest_framework/base.html +++ b/rest_framework/templates/rest_framework/base.html @@ -38,7 +38,7 @@
    {% block branding %} - + Django REST framework {% endblock %} diff --git a/setup.py b/setup.py index 90582e078..341f33990 100755 --- a/setup.py +++ b/setup.py @@ -42,7 +42,7 @@ if sys.argv[-1] == 'publish': setup( name='djangorestframework', version=version, - url='http://www.django-rest-framework.org', + url='https://www.django-rest-framework.org/', license='BSD', description='Web APIs for Django, made easy.', long_description=read('README.md'), From 9ecce21044d14b66a9e41f156eda0f13754c756e Mon Sep 17 00:00:00 2001 From: Matheus Cansian Date: Tue, 2 Oct 2018 03:43:45 -0300 Subject: [PATCH 23/50] Update JWT docs. (#6138) * Remove mentions to djangorestframework-jwt in docs * Remove links for blimp and djangorestframework-jwt --- docs/api-guide/authentication.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/api-guide/authentication.md b/docs/api-guide/authentication.md index e10e3109a..139458ad4 100644 --- a/docs/api-guide/authentication.md +++ b/docs/api-guide/authentication.md @@ -397,7 +397,7 @@ HTTP digest authentication is a widely implemented scheme that was intended to r ## JSON Web Token Authentication -JSON Web Token is a fairly new standard which can be used for token-based authentication. Unlike the built-in TokenAuthentication scheme, JWT Authentication doesn't need to use a database to validate a token. [Blimp][blimp] maintains the [djangorestframework-jwt][djangorestframework-jwt] package which provides a JWT Authentication class as well as a mechanism for clients to obtain a JWT given the username and password. An alternative package for JWT authentication is [djangorestframework-simplejwt][djangorestframework-simplejwt] which provides different features as well as a pluggable token blacklist app. +JSON Web Token is a fairly new standard which can be used for token-based authentication. Unlike the built-in TokenAuthentication scheme, JWT Authentication doesn't need to use a database to validate a token. A package for JWT authentication is [djangorestframework-simplejwt][djangorestframework-simplejwt] which provides some features as well as a pluggable token blacklist app. ## Hawk HTTP Authentication @@ -445,8 +445,6 @@ HTTP Signature (currently a [IETF draft][http-signature-ietf-draft]) provides a [django-oauth-toolkit]: https://github.com/evonove/django-oauth-toolkit [evonove]: https://github.com/evonove/ [oauthlib]: https://github.com/idan/oauthlib -[blimp]: https://github.com/GetBlimp -[djangorestframework-jwt]: https://github.com/GetBlimp/django-rest-framework-jwt [djangorestframework-simplejwt]: https://github.com/davesque/django-rest-framework-simplejwt [etoccalino]: https://github.com/etoccalino/ [djangorestframework-httpsignature]: https://github.com/etoccalino/django-rest-framework-httpsignature From d0995fac70549bd8a4bba4510ab89b95f59ba622 Mon Sep 17 00:00:00 2001 From: "Lewis M. Kabui" Date: Tue, 2 Oct 2018 09:49:31 +0300 Subject: [PATCH 24/50] Remove dot character from "pagination_class" (#6137) --- 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 97590a785..7ae351a7f 100644 --- a/docs/api-guide/pagination.md +++ b/docs/api-guide/pagination.md @@ -46,7 +46,7 @@ If you want to modify particular aspects of the pagination style, you'll want to page_size_query_param = 'page_size' max_page_size = 1000 -You can then apply your new style to a view using the `.pagination_class` attribute: +You can then apply your new style to a view using the `pagination_class` attribute: class BillingRecordsView(generics.ListAPIView): queryset = Billing.objects.all() From 20a7734dce836053686d585cff54888ac69fa3a5 Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Tue, 2 Oct 2018 11:12:31 +0100 Subject: [PATCH 25/50] Bring docs license text up to date --- docs/index.md | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/docs/index.md b/docs/index.md index 1599a9bef..8079bff15 100644 --- a/docs/index.md +++ b/docs/index.md @@ -200,17 +200,22 @@ Send a description of the issue via email to [rest-framework-security@googlegrou ## License -Copyright (c) 2011-2017, Tom Christie +Copyright © 2011-present, [Encode OSS Ltd](https://www.encode.io/). All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: -Redistributions of source code must retain the above copyright notice, this -list of conditions and the following disclaimer. -Redistributions in binary form must reproduce the above copyright notice, this -list of conditions and the following disclaimer in the documentation and/or -other materials provided with the distribution. +* Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +* Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED From 903204cd7926e9e6ceaaec1bfbf1ba3ed3330ca4 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Tue, 2 Oct 2018 07:22:21 -0700 Subject: [PATCH 26/50] Fix action support for ViewSet suffixes (#6081) * Add suffix support for actions Removes the newly introduced `action.name` in favor of leveraging the View's `.get_view_name()` method, which supports both name and suffix. * Fix view description func docstrings * Test action decorator name & suffix kwargs * Adjust 'extra action' docs --- docs/api-guide/viewsets.md | 6 ++--- rest_framework/decorators.py | 16 ++++++++----- rest_framework/views.py | 4 ++-- rest_framework/viewsets.py | 3 ++- tests/test_decorators.py | 44 ++++++++++++++++++++++++++++++++++-- tests/test_utils.py | 26 +++++++++++++++++++++ tests/test_viewsets.py | 32 ++++++++++++++++++++++++++ 7 files changed, 117 insertions(+), 14 deletions(-) diff --git a/docs/api-guide/viewsets.md b/docs/api-guide/viewsets.md index b912e0dac..e7cf4d48f 100644 --- a/docs/api-guide/viewsets.md +++ b/docs/api-guide/viewsets.md @@ -127,7 +127,7 @@ You may inspect these attributes to adjust behaviour based on the current action ## Marking extra actions for routing -If you have ad-hoc methods that should be routable, you can mark them as such with the `@action` decorator. Like regular actions, extra actions may be intended for either a list of objects, or a single instance. To indicate this, set the `detail` argument to `True` or `False`. The router will configure its URL patterns accordingly. e.g., the `DefaultRouter` will configure detail actions to contain `pk` in their URL patterns. +If you have ad-hoc methods that should be routable, you can mark them as such with the `@action` decorator. Like regular actions, extra actions may be intended for either a single object, or an entire collection. To indicate this, set the `detail` argument to `True` or `False`. The router will configure its URL patterns accordingly. e.g., the `DefaultRouter` will configure detail actions to contain `pk` in their URL patterns. A more complete example of extra actions: @@ -174,7 +174,7 @@ The decorator can additionally take extra arguments that will be set for the rou def set_password(self, request, pk=None): ... -These decorator will route `GET` requests by default, but may also accept other HTTP methods by setting the `methods` argument. For example: +The `action` decorator will route `GET` requests by default, but may also accept other HTTP methods by setting the `methods` argument. For example: @action(detail=True, methods=['post', 'delete']) def unset_password(self, request, pk=None): @@ -186,7 +186,7 @@ To view all extra actions, call the `.get_extra_actions()` method. ### Routing additional HTTP methods for extra actions -Extra actions can be mapped to different `ViewSet` methods. For example, the above password set/unset methods could be consolidated into a single route. Note that additional mappings do not accept arguments. +Extra actions can map additional HTTP methods to separate `ViewSet` methods. For example, the above password set/unset methods could be consolidated into a single route. Note that additional mappings do not accept arguments. ```python @action(detail=True, methods=['put'], name='Change Password') diff --git a/rest_framework/decorators.py b/rest_framework/decorators.py index 60078947f..2d3bbe46f 100644 --- a/rest_framework/decorators.py +++ b/rest_framework/decorators.py @@ -131,7 +131,7 @@ def schema(view_inspector): return decorator -def action(methods=None, detail=None, name=None, url_path=None, url_name=None, **kwargs): +def action(methods=None, detail=None, url_path=None, url_name=None, **kwargs): """ Mark a ViewSet method as a routable action. @@ -145,18 +145,22 @@ def action(methods=None, detail=None, name=None, url_path=None, url_name=None, * "@action() missing required argument: 'detail'" ) + # name and suffix are mutually exclusive + if 'name' in kwargs and 'suffix' in kwargs: + raise TypeError("`name` and `suffix` are mutually exclusive arguments.") + def decorator(func): func.mapping = MethodMapper(func, methods) func.detail = detail - func.name = name if name else pretty_name(func.__name__) func.url_path = url_path if url_path else func.__name__ func.url_name = url_name if url_name else func.__name__.replace('_', '-') func.kwargs = kwargs - func.kwargs.update({ - 'name': func.name, - 'description': func.__doc__ or None - }) + + # Set descriptive arguments for viewsets + if 'name' not in kwargs and 'suffix' not in kwargs: + func.kwargs['name'] = pretty_name(func.__name__) + func.kwargs['description'] = func.__doc__ or None return func return decorator diff --git a/rest_framework/views.py b/rest_framework/views.py index 70af84816..04951ed93 100644 --- a/rest_framework/views.py +++ b/rest_framework/views.py @@ -23,7 +23,7 @@ from rest_framework.utils import formatting def get_view_name(view): """ - Given a view class, return a textual name to represent the view. + Given a view instance, return a textual name to represent the view. This name is used in the browsable API, and in OPTIONS responses. This function is the default for the `VIEW_NAME_FUNCTION` setting. @@ -48,7 +48,7 @@ def get_view_name(view): def get_view_description(view, html=False): """ - Given a view class, return a textual description to represent the view. + Given a view instance, return a textual description to represent the view. This name is used in the browsable API, and in OPTIONS responses. This function is the default for the `VIEW_DESCRIPTION_FUNCTION` setting. diff --git a/rest_framework/viewsets.py b/rest_framework/viewsets.py index 412475351..7146828d2 100644 --- a/rest_framework/viewsets.py +++ b/rest_framework/viewsets.py @@ -183,7 +183,8 @@ class ViewSetMixin(object): try: url_name = '%s-%s' % (self.basename, action.url_name) url = reverse(url_name, self.args, self.kwargs, request=self.request) - action_urls[action.name] = url + view = self.__class__(**action.kwargs) + action_urls[view.get_view_name()] = url except NoReverseMatch: pass # URL requires additional arguments, ignore diff --git a/tests/test_decorators.py b/tests/test_decorators.py index 7568513f3..77c488c34 100644 --- a/tests/test_decorators.py +++ b/tests/test_decorators.py @@ -179,7 +179,6 @@ class ActionDecoratorTestCase(TestCase): assert test_action.mapping == {'get': 'test_action'} assert test_action.detail is True - assert test_action.name == 'Test action' assert test_action.url_path == 'test_action' assert test_action.url_name == 'test-action' assert test_action.kwargs == { @@ -213,6 +212,47 @@ class ActionDecoratorTestCase(TestCase): for name in APIView.http_method_names: assert test_action.mapping[name] == name + def test_view_name_kwargs(self): + """ + 'name' and 'suffix' are mutually exclusive kwargs used for generating + a view's display name. + """ + # by default, generate name from method + @action(detail=True) + def test_action(request): + raise NotImplementedError + + assert test_action.kwargs == { + 'description': None, + 'name': 'Test action', + } + + # name kwarg supersedes name generation + @action(detail=True, name='test name') + def test_action(request): + raise NotImplementedError + + assert test_action.kwargs == { + 'description': None, + 'name': 'test name', + } + + # suffix kwarg supersedes name generation + @action(detail=True, suffix='Suffix') + def test_action(request): + raise NotImplementedError + + assert test_action.kwargs == { + 'description': None, + 'suffix': 'Suffix', + } + + # name + suffix is a conflict. + with pytest.raises(TypeError) as excinfo: + action(detail=True, name='test name', suffix='Suffix') + + assert str(excinfo.value) == "`name` and `suffix` are mutually exclusive arguments." + def test_method_mapping(self): @action(detail=False) def test_action(request): @@ -223,7 +263,7 @@ class ActionDecoratorTestCase(TestCase): raise NotImplementedError # The secondary handler methods should not have the action attributes - for name in ['mapping', 'detail', 'name', 'url_path', 'url_name', 'kwargs']: + for name in ['mapping', 'detail', 'url_path', 'url_name', 'kwargs']: assert hasattr(test_action, name) and not hasattr(test_action_post, name) def test_method_mapping_already_mapped(self): diff --git a/tests/test_utils.py b/tests/test_utils.py index a29ae2fa6..28b06b173 100644 --- a/tests/test_utils.py +++ b/tests/test_utils.py @@ -52,6 +52,14 @@ class ResourceViewSet(ModelViewSet): def detail_action(self, request, *args, **kwargs): raise NotImplementedError + @action(detail=True, name='Custom Name') + def named_action(self, request, *args, **kwargs): + raise NotImplementedError + + @action(detail=True, suffix='Custom Suffix') + def suffixed_action(self, request, *args, **kwargs): + raise NotImplementedError + router = SimpleRouter() router.register(r'resources', ResourceViewSet) @@ -145,6 +153,24 @@ class BreadcrumbTests(TestCase): ('Detail action', '/resources/1/detail_action/'), ] + def test_modelviewset_action_name_kwarg(self): + url = '/resources/1/named_action/' + assert get_breadcrumbs(url) == [ + ('Root', '/'), + ('Resource List', '/resources/'), + ('Resource Instance', '/resources/1/'), + ('Custom Name', '/resources/1/named_action/'), + ] + + def test_modelviewset_action_suffix_kwarg(self): + url = '/resources/1/suffixed_action/' + assert get_breadcrumbs(url) == [ + ('Root', '/'), + ('Resource List', '/resources/'), + ('Resource Instance', '/resources/1/'), + ('Resource Custom Suffix', '/resources/1/suffixed_action/'), + ] + class JsonFloatTests(TestCase): """ diff --git a/tests/test_viewsets.py b/tests/test_viewsets.py index 54b691e22..eac36f095 100644 --- a/tests/test_viewsets.py +++ b/tests/test_viewsets.py @@ -63,9 +63,28 @@ class ActionViewSet(GenericViewSet): raise NotImplementedError +class ActionNamesViewSet(GenericViewSet): + + def retrieve(self, request, *args, **kwargs): + return Response() + + @action(detail=True) + def unnamed_action(self, request, *args, **kwargs): + raise NotImplementedError + + @action(detail=True, name='Custom Name') + def named_action(self, request, *args, **kwargs): + raise NotImplementedError + + @action(detail=True, suffix='Custom Suffix') + def suffixed_action(self, request, *args, **kwargs): + raise NotImplementedError + + router = SimpleRouter() router.register(r'actions', ActionViewSet) router.register(r'actions-alt', ActionViewSet, basename='actions-alt') +router.register(r'names', ActionNamesViewSet, basename='names') urlpatterns = [ @@ -172,6 +191,19 @@ class GetExtraActionUrlMapTests(TestCase): def test_uninitialized_view(self): self.assertEqual(ActionViewSet().get_extra_action_url_map(), OrderedDict()) + def test_action_names(self): + # Action 'name' and 'suffix' kwargs should be respected + response = self.client.get('/api/names/1/') + view = response.renderer_context['view'] + + expected = OrderedDict([ + ('Custom Name', 'http://testserver/api/names/1/named_action/'), + ('Action Names Custom Suffix', 'http://testserver/api/names/1/suffixed_action/'), + ('Unnamed action', 'http://testserver/api/names/1/unnamed_action/'), + ]) + + self.assertEqual(view.get_extra_action_url_map(), expected) + @override_settings(ROOT_URLCONF='tests.test_viewsets') class ReverseActionTests(TestCase): From 66183389f6e4bdf8242650580117d15df713fb7a Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Tue, 2 Oct 2018 07:34:25 -0700 Subject: [PATCH 27/50] Deprecate DjangoObjectPermissionsFilter (#6075) --- docs/api-guide/filtering.md | 7 +++++++ docs/api-guide/permissions.md | 5 ++--- docs/community/release-notes.md | 2 ++ rest_framework/filters.py | 6 ++++++ tests/test_permissions.py | 22 ++++++++++++++++++++-- 5 files changed, 37 insertions(+), 5 deletions(-) diff --git a/docs/api-guide/filtering.md b/docs/api-guide/filtering.md index e405535ba..84c6d8d63 100644 --- a/docs/api-guide/filtering.md +++ b/docs/api-guide/filtering.md @@ -285,6 +285,12 @@ The `ordering` attribute may be either a string or a list/tuple of strings. The `DjangoObjectPermissionsFilter` is intended to be used together with the [`django-guardian`][guardian] package, with custom `'view'` permissions added. The filter will ensure that querysets only returns objects for which the user has the appropriate view permission. +--- + +**Note:** This filter has been deprecated as of version 3.9 and moved to the 3rd-party [`djangorestframework-guardian` package][django-rest-framework-guardian]. + +--- + If you're using `DjangoObjectPermissionsFilter`, you'll probably also want to add an appropriate object permissions class, to ensure that users can only operate on instances if they have the appropriate object permissions. The easiest way to do this is to subclass `DjangoObjectPermissions` and add `'view'` permissions to the `perms_map` attribute. A complete example using both `DjangoObjectPermissionsFilter` and `DjangoObjectPermissions` might look something like this. @@ -388,6 +394,7 @@ The [djangorestframework-word-filter][django-rest-framework-word-search-filter] [view-permissions-blogpost]: https://blog.nyaruka.com/adding-a-view-permission-to-django-models [search-django-admin]: https://docs.djangoproject.com/en/stable/ref/contrib/admin/#django.contrib.admin.ModelAdmin.search_fields [django-rest-framework-filters]: https://github.com/philipn/django-rest-framework-filters +[django-rest-framework-guardian]: https://github.com/rpkilby/django-rest-framework-guardian [django-rest-framework-word-search-filter]: https://github.com/trollknurr/django-rest-framework-word-search-filter [django-url-filter]: https://github.com/miki725/django-url-filter [drf-url-filter]: https://github.com/manjitkumar/drf-url-filters diff --git a/docs/api-guide/permissions.md b/docs/api-guide/permissions.md index f5fc214cd..0fef12a59 100644 --- a/docs/api-guide/permissions.md +++ b/docs/api-guide/permissions.md @@ -168,9 +168,7 @@ As with `DjangoModelPermissions` you can use custom model permissions by overrid --- -**Note**: If you need object level `view` permissions for `GET`, `HEAD` and `OPTIONS` requests, you'll want to consider also adding the `DjangoObjectPermissionsFilter` class to ensure that list endpoints only return results including objects for which the user has appropriate view permissions. - ---- +**Note**: If you need object level `view` permissions for `GET`, `HEAD` and `OPTIONS` requests and are using django-guardian for your object-level permissions backend, you'll want to consider using the `DjangoObjectPermissionsFilter` class provided by the [`djangorestframework-guardian` package][django-rest-framework-guardian]. It ensures that list endpoints only return results including objects for which the user has appropriate view permissions. --- @@ -287,3 +285,4 @@ The [Django Rest Framework Role Filters][django-rest-framework-role-filters] pac [django-rest-framework-roles]: https://github.com/computer-lab/django-rest-framework-roles [django-rest-framework-api-key]: https://github.com/manosim/django-rest-framework-api-key [django-rest-framework-role-filters]: https://github.com/allisson/django-rest-framework-role-filters +[django-rest-framework-guardian]: https://github.com/rpkilby/django-rest-framework-guardian diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index e9f8d5abc..700d1d97f 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -46,6 +46,7 @@ You can determine your currently installed version using `pip show`: * Deprecate the `Router.register` `base_name` argument in favor of `basename`. [#5990][gh5990] * Deprecate the `Router.get_default_base_name` method in favor of `Router.get_default_basename`. [#5990][gh5990] +* Deprecate the `DjangoObjectPermissionsFilter` class, moved to the `djangorestframework-guardian` package. [#6075][gh6075] ## 3.8.x series @@ -1974,3 +1975,4 @@ For older release notes, [please see the version 2.x documentation][old-release- [gh5990]: https://github.com/encode/django-rest-framework/issues/5990 +[gh6075]: https://github.com/encode/django-rest-framework/issues/6075 diff --git a/rest_framework/filters.py b/rest_framework/filters.py index ab2ce68b4..0627bd8c4 100644 --- a/rest_framework/filters.py +++ b/rest_framework/filters.py @@ -5,6 +5,7 @@ returned by list views. from __future__ import unicode_literals import operator +import warnings from functools import reduce from django.core.exceptions import ImproperlyConfigured @@ -284,6 +285,11 @@ class DjangoObjectPermissionsFilter(BaseFilterBackend): has read object level permissions. """ def __init__(self): + warnings.warn( + "`DjangoObjectPermissionsFilter` has been deprecated and moved to " + "the 3rd-party django-rest-framework-guardian package.", + DeprecationWarning, stacklevel=2 + ) assert is_guardian_installed(), 'Using DjangoObjectPermissionsFilter, but django-guardian is not installed' perm_format = '%(app_label)s.view_%(model_name)s' diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 37540eb8e..31ee75b34 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -2,6 +2,7 @@ from __future__ import unicode_literals import base64 import unittest +import warnings import django from django.contrib.auth.models import Group, Permission, User @@ -417,17 +418,34 @@ class ObjectPermissionsIntegrationTests(TestCase): self.assertEqual(response.status_code, status.HTTP_200_OK) # Read list + def test_django_object_permissions_filter_deprecated(self): + with warnings.catch_warnings(record=True) as w: + warnings.simplefilter("always") + DjangoObjectPermissionsFilter() + + message = ("`DjangoObjectPermissionsFilter` has been deprecated and moved " + "to the 3rd-party django-rest-framework-guardian package.") + self.assertEqual(len(w), 1) + self.assertIs(w[-1].category, DeprecationWarning) + self.assertEqual(str(w[-1].message), message) + def test_can_read_list_permissions(self): request = factory.get('/', HTTP_AUTHORIZATION=self.credentials['readonly']) object_permissions_list_view.cls.filter_backends = (DjangoObjectPermissionsFilter,) - response = object_permissions_list_view(request) + # TODO: remove in version 3.10 + with warnings.catch_warnings(record=True): + warnings.simplefilter("always") + response = object_permissions_list_view(request) self.assertEqual(response.status_code, status.HTTP_200_OK) self.assertEqual(response.data[0].get('id'), 1) def test_cannot_read_list_permissions(self): request = factory.get('/', HTTP_AUTHORIZATION=self.credentials['writeonly']) object_permissions_list_view.cls.filter_backends = (DjangoObjectPermissionsFilter,) - response = object_permissions_list_view(request) + # TODO: remove in version 3.10 + with warnings.catch_warnings(record=True): + warnings.simplefilter("always") + response = object_permissions_list_view(request) self.assertEqual(response.status_code, status.HTTP_200_OK) self.assertListEqual(response.data, []) From 0eb2dc1137189027cc8d638630fb1754b02d6cfa Mon Sep 17 00:00:00 2001 From: Jerome Leclanche Date: Tue, 2 Oct 2018 17:54:15 +0300 Subject: [PATCH 28/50] Prohibit null characters in CharField by default (#6073) * Implement an allow_null_bytes argument to CharField (default True) * Switch to using native ProhibitNullCharactersValidator instead --- rest_framework/compat.py | 5 +++++ rest_framework/fields.py | 9 +++++++-- tests/test_fields.py | 12 ++++++++++++ 3 files changed, 24 insertions(+), 2 deletions(-) diff --git a/rest_framework/compat.py b/rest_framework/compat.py index d6559d5f5..d28055a3a 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -29,6 +29,11 @@ except ImportError: RegexURLResolver as URLResolver, ) +try: + from django.core.validators import ProhibitNullCharactersValidator # noqa +except ImportError: + ProhibitNullCharactersValidator = None + def get_original_route(urlpattern): """ diff --git a/rest_framework/fields.py b/rest_framework/fields.py index 61f3451b0..70c210c16 100644 --- a/rest_framework/fields.py +++ b/rest_framework/fields.py @@ -34,7 +34,8 @@ from pytz.exceptions import InvalidTimeError from rest_framework import ISO_8601 from rest_framework.compat import ( MaxLengthValidator, MaxValueValidator, MinLengthValidator, - MinValueValidator, unicode_repr, unicode_to_repr + MinValueValidator, ProhibitNullCharactersValidator, unicode_repr, + unicode_to_repr ) from rest_framework.exceptions import ErrorDetail, ValidationError from rest_framework.settings import api_settings @@ -755,7 +756,7 @@ class CharField(Field): 'invalid': _('Not a valid string.'), 'blank': _('This field may not be blank.'), 'max_length': _('Ensure this field has no more than {max_length} characters.'), - 'min_length': _('Ensure this field has at least {min_length} characters.') + 'min_length': _('Ensure this field has at least {min_length} characters.'), } initial = '' @@ -778,6 +779,10 @@ class CharField(Field): self.validators.append( MinLengthValidator(self.min_length, message=message)) + # ProhibitNullCharactersValidator is None on Django < 2.0 + if ProhibitNullCharactersValidator is not None: + self.validators.append(ProhibitNullCharactersValidator()) + def run_validation(self, data=empty): # Test for the empty string here so that it does not get validated, # and so that subclasses do not need to handle it explicitly diff --git a/tests/test_fields.py b/tests/test_fields.py index 1b8f596e2..9a1d04979 100644 --- a/tests/test_fields.py +++ b/tests/test_fields.py @@ -15,6 +15,7 @@ from django.utils.timezone import activate, deactivate, override, utc import rest_framework from rest_framework import exceptions, serializers +from rest_framework.compat import ProhibitNullCharactersValidator from rest_framework.fields import DjangoImageField, is_simple_callable try: @@ -728,6 +729,17 @@ class TestCharField(FieldValues): field.run_validation(' ') assert exc_info.value.detail == ['This field may not be blank.'] + @pytest.mark.skipif(ProhibitNullCharactersValidator is None, reason="Skipped on Django < 2.0") + def test_null_bytes(self): + field = serializers.CharField() + + for value in ('\0', 'foo\0', '\0foo', 'foo\0foo'): + with pytest.raises(serializers.ValidationError) as exc_info: + field.run_validation(value) + assert exc_info.value.detail == [ + 'Null characters are not allowed.' + ] + class TestEmailField(FieldValues): """ From c9d2bbcead2cf102111d96d466b3ca4dcc60ae0e Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Tue, 2 Oct 2018 16:57:49 +0100 Subject: [PATCH 29/50] Update codecov.yml --- codecov.yml | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/codecov.yml b/codecov.yml index db6f6873f..c2336342e 100644 --- a/codecov.yml +++ b/codecov.yml @@ -1,7 +1,11 @@ coverage: + precision: 2 + round: down + range: "80...100" + status: - project: false - patch: true - changes: true + project: yes + patch: no + changes: no comment: off From 8908934928f448c1ec5f00bae754aacd6dbc0cfc Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Wed, 3 Oct 2018 15:28:04 +0100 Subject: [PATCH 30/50] Add `OpenAPIRenderer` and `generate_schema` management command. (#6229) * Add OpenAPIRenderer and generate_schema command * Add both OpenAPIRenderer and JSONOpenAPIRenderer * Add flags to generate_schema command * Fix syntax error * Pull coreschema references into method, so they are only used if 'OpenAPIRenderer' is in use. * generate_schema -> generateschema, and fix to OpenAPIRenderer * Ensure that renderers generate bytes and generateschema outputs text * Drop unused import --- rest_framework/compat.py | 16 ++- rest_framework/management/__init__.py | 0 .../management/commands/__init__.py | 0 .../management/commands/generateschema.py | 39 ++++++ rest_framework/renderers.py | 120 +++++++++++++++++- 5 files changed, 172 insertions(+), 3 deletions(-) create mode 100644 rest_framework/management/__init__.py create mode 100644 rest_framework/management/commands/__init__.py create mode 100644 rest_framework/management/commands/generateschema.py diff --git a/rest_framework/compat.py b/rest_framework/compat.py index d28055a3a..1d34828bd 100644 --- a/rest_framework/compat.py +++ b/rest_framework/compat.py @@ -11,12 +11,19 @@ from django.utils import six from django.views.generic import View try: - # Python 3 (required for 3.8+) + # Python 3 from collections.abc import Mapping # noqa except ImportError: # Python 2.7 from collections import Mapping # noqa +try: + # Python 3 + import urllib.parse as urlparse # noqa +except ImportError: + # Python 2.7 + from urlparse import urlparse # noqa + try: from django.urls import ( # noqa URLPattern, @@ -136,6 +143,13 @@ except ImportError: coreschema = None +# pyyaml is optional +try: + import yaml +except ImportError: + yaml = None + + # django-crispy-forms is optional try: import crispy_forms diff --git a/rest_framework/management/__init__.py b/rest_framework/management/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/rest_framework/management/commands/__init__.py b/rest_framework/management/commands/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/rest_framework/management/commands/generateschema.py b/rest_framework/management/commands/generateschema.py new file mode 100644 index 000000000..214b66775 --- /dev/null +++ b/rest_framework/management/commands/generateschema.py @@ -0,0 +1,39 @@ +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 + + +class Command(BaseCommand): + help = "Generates configured API schema for project." + + def add_arguments(self, parser): + parser.add_argument('--title', dest="title", default=None, 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) + + def handle(self, *args, **options): + assert coreapi is not None, 'coreapi must be installed.' + + generator = SchemaGenerator( + 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('utf-8')) + + def get_renderer(self, format): + return { + 'corejson': CoreJSONRenderer(), + 'openapi': OpenAPIRenderer(), + 'openapi-json': JSONOpenAPIRenderer() + }[format] diff --git a/rest_framework/renderers.py b/rest_framework/renderers.py index a9645cc89..375c38a85 100644 --- a/rest_framework/renderers.py +++ b/rest_framework/renderers.py @@ -24,8 +24,8 @@ from django.utils.html import mark_safe from rest_framework import VERSION, exceptions, serializers, status from rest_framework.compat import ( - INDENT_SEPARATORS, LONG_SEPARATORS, SHORT_SEPARATORS, coreapi, - pygments_css + INDENT_SEPARATORS, LONG_SEPARATORS, SHORT_SEPARATORS, coreapi, coreschema, + pygments_css, urlparse, yaml ) from rest_framework.exceptions import ParseError from rest_framework.request import is_form_media_type, override_method @@ -932,3 +932,119 @@ class CoreJSONRenderer(BaseRenderer): indent = bool(renderer_context.get('indent', 0)) codec = coreapi.codecs.CoreJSONCodec() return codec.dump(data, indent=indent) + + +class _BaseOpenAPIRenderer: + def get_schema(self, instance): + CLASS_TO_TYPENAME = { + coreschema.Object: 'object', + coreschema.Array: 'array', + coreschema.Number: 'number', + coreschema.Integer: 'integer', + coreschema.String: 'string', + coreschema.Boolean: 'boolean', + } + + schema = {} + if instance.__class__ in CLASS_TO_TYPENAME: + schema['type'] = CLASS_TO_TYPENAME[instance.__class__] + schema['title'] = instance.title, + schema['description'] = instance.description + if hasattr(instance, 'enum'): + schema['enum'] = instance.enum + return schema + + def get_parameters(self, link): + parameters = [] + for field in link.fields: + if field.location not in ['path', 'query']: + continue + parameter = { + 'name': field.name, + 'in': field.location, + } + if field.required: + parameter['required'] = True + if field.description: + parameter['description'] = field.description + if field.schema: + parameter['schema'] = self.get_schema(field.schema) + parameters.append(parameter) + return parameters + + def get_operation(self, link, name, tag): + operation_id = "%s_%s" % (tag, name) if tag else name + parameters = self.get_parameters(link) + + operation = { + 'operationId': operation_id, + } + if link.title: + operation['summary'] = link.title + if link.description: + operation['description'] = link.description + if parameters: + operation['parameters'] = parameters + if tag: + operation['tags'] = [tag] + return operation + + def get_paths(self, document): + paths = {} + + tag = None + for name, link in document.links.items(): + path = urlparse.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 + method = link.action.lower() + paths.setdefault(path, {}) + paths[path][method] = self.get_operation(link, name, tag=tag) + + return paths + + def get_structure(self, data): + return { + 'openapi': '3.0.0', + 'info': { + 'version': '', + 'title': data.title, + 'description': data.description + }, + 'servers': [{ + 'url': data.url + }], + 'paths': self.get_paths(data) + } + + +class OpenAPIRenderer(_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.' + + 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') + + +class JSONOpenAPIRenderer(_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.' + + def render(self, data, media_type=None, renderer_context=None): + structure = self.get_structure(data) + return json.dumps(structure, indent=4).encode('utf-8') From b41a6cfa38b3a4e8b6fb4bde987d8910d5faee3f Mon Sep 17 00:00:00 2001 From: Xavier Ordoquy Date: Wed, 3 Oct 2018 14:36:24 +0000 Subject: [PATCH 31/50] permissions: Allow permissions to be composed (#5753) * permissions: Allow permissions to be composed Implement a system to compose permissions with and / or. This is performed by returning an `OperationHolder` instance that keeps the permission classes and type of composition (and / or). When called it will return a AND/OR instance that will then delegate the permission check to the operands. * permissions: Add documentation about composed permissions * Fix documentation typo in permissions --- docs/api-guide/permissions.md | 21 ++++++++++++ rest_framework/permissions.py | 64 +++++++++++++++++++++++++++++++++++ tests/test_permissions.py | 42 +++++++++++++++++++++++ 3 files changed, 127 insertions(+) diff --git a/docs/api-guide/permissions.md b/docs/api-guide/permissions.md index 0fef12a59..102c6ea98 100644 --- a/docs/api-guide/permissions.md +++ b/docs/api-guide/permissions.md @@ -102,6 +102,27 @@ Or, if you're using the `@api_view` decorator with function based views. __Note:__ when you set new permission classes through class attribute or decorators you're telling the view to ignore the default list set over the __settings.py__ file. +Provided they inherit from `rest_framework.permissions.BasePermission`, permissions can be composed using standard Python bitwise operators. For example, `IsAuthenticatedOrReadOnly` could be written: + + from rest_framework.permissions import BasePermission, IsAuthenticated + from rest_framework.response import Response + from rest_framework.views import APIView + + class ReadOnly(BasePermission): + def has_permission(self, request, view): + return request.method in SAFE_METHODS + + class ExampleView(APIView): + permission_classes = (IsAuthenticated|ReadOnly) + + def get(self, request, format=None): + content = { + 'status': 'request was permitted' + } + return Response(content) + +__Note:__ it only supports & -and- and | -or-. + --- # API Reference diff --git a/rest_framework/permissions.py b/rest_framework/permissions.py index a48058e66..dfe89ed2a 100644 --- a/rest_framework/permissions.py +++ b/rest_framework/permissions.py @@ -4,12 +4,76 @@ 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 SAFE_METHODS = ('GET', 'HEAD', 'OPTIONS') +class OperandHolder: + def __init__(self, operator_class, op1_class, op2_class): + self.operator_class = operator_class + self.op1_class = op1_class + self.op2_class = op2_class + + def __call__(self, *args, **kwargs): + op1 = self.op1_class(*args, **kwargs) + op2 = self.op2_class(*args, **kwargs) + return self.operator_class(op1, op2) + + +class AND: + def __init__(self, op1, op2): + self.op1 = op1 + self.op2 = op2 + + def has_permission(self, request, view): + return ( + self.op1.has_permission(request, view) & + self.op2.has_permission(request, view) + ) + + def has_object_permission(self, request, view, obj): + return ( + self.op1.has_object_permission(request, view, obj) & + self.op2.has_object_permission(request, view, obj) + ) + + +class OR: + def __init__(self, op1, op2): + self.op1 = op1 + self.op2 = op2 + + def has_permission(self, request, view): + return ( + self.op1.has_permission(request, view) | + self.op2.has_permission(request, view) + ) + + def has_object_permission(self, request, view, obj): + return ( + self.op1.has_object_permission(request, view, obj) | + self.op2.has_object_permission(request, view, obj) + ) + + +class BasePermissionMetaclass(type): + def __and__(cls, other): + return OperandHolder(AND, cls, other) + + def __or__(cls, other): + return OperandHolder(OR, cls, other) + + def __rand__(cls, other): + return OperandHolder(AND, other, cls) + + def __ror__(cls, other): + return OperandHolder(OR, other, cls) + + +@six.add_metaclass(BasePermissionMetaclass) class BasePermission(object): """ A base class from which all permission classes should inherit. diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 31ee75b34..15fd9303c 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -540,3 +540,45 @@ class CustomPermissionsTests(TestCase): detail = response.data.get('detail') self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN) self.assertEqual(detail, self.custom_message) + + +class FakeUser: + def __init__(self, auth=False): + self.is_authenticated = auth + + +class PermissionsCompositionTests(TestCase): + def test_and_false(self): + request = factory.get('/1', format='json') + request.user = FakeUser(auth=False) + composed_perm = permissions.IsAuthenticated & permissions.AllowAny + assert composed_perm().has_permission(request, None) is False + + def test_and_true(self): + request = factory.get('/1', format='json') + request.user = FakeUser(auth=True) + composed_perm = permissions.IsAuthenticated & permissions.AllowAny + assert composed_perm().has_permission(request, None) is True + + def test_or_false(self): + request = factory.get('/1', format='json') + request.user = FakeUser(auth=False) + composed_perm = permissions.IsAuthenticated | permissions.AllowAny + assert composed_perm().has_permission(request, None) is True + + def test_or_true(self): + request = factory.get('/1', format='json') + request.user = FakeUser(auth=True) + composed_perm = permissions.IsAuthenticated | permissions.AllowAny + assert composed_perm().has_permission(request, None) is True + + def test_several_levels(self): + request = factory.get('/1', format='json') + request.user = FakeUser(auth=True) + composed_perm = ( + permissions.IsAuthenticated & + permissions.IsAuthenticated & + permissions.IsAuthenticated & + permissions.IsAuthenticated + ) + assert composed_perm().has_permission(request, None) is True From 18ad3290ef228dce8bb9d0feb5903f650f0ebc9f Mon Sep 17 00:00:00 2001 From: Jufe Brown-Tsai Date: Wed, 3 Oct 2018 10:16:52 -0500 Subject: [PATCH 32/50] Documentation fix for django-admin commands (#6232) * fix django-admin commands on quickstart doc * fix django-admin commands on tutorial/1-serialization doc * fix django-admin command on readme * fix django-admin command on docs/community/project-management.md --- README.md | 2 +- docs/community/project-management.md | 4 ++-- docs/tutorial/1-serialization.md | 2 +- docs/tutorial/quickstart.md | 4 ++-- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 919f85d00..42edadd19 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ Startup up a new project like so... pip install django pip install djangorestframework - django-admin.py startproject example . + django-admin startproject example . ./manage.py migrate ./manage.py createsuperuser diff --git a/docs/community/project-management.md b/docs/community/project-management.md index 21f93b380..5d7dab561 100644 --- a/docs/community/project-management.md +++ b/docs/community/project-management.md @@ -152,7 +152,7 @@ When any user visible strings are changed, they should be uploaded to Transifex # 1. Update the source django.po file, which is the US English version. cd rest_framework - django-admin.py makemessages -l en_US + django-admin makemessages -l en_US # 2. Push the source django.po file to Transifex. cd .. tx push -s @@ -173,7 +173,7 @@ When a translator has finished translating their work needs to be downloaded fro tx pull -a --minimum-perc 10 cd rest_framework # 4. Compile the binary .mo files for all supported languages. - django-admin.py compilemessages + django-admin compilemessages --- diff --git a/docs/tutorial/1-serialization.md b/docs/tutorial/1-serialization.md index 630c3da0a..387f99eda 100644 --- a/docs/tutorial/1-serialization.md +++ b/docs/tutorial/1-serialization.md @@ -33,7 +33,7 @@ Okay, we're ready to get coding. To get started, let's create a new project to work with. cd ~ - django-admin.py startproject tutorial + django-admin startproject tutorial cd tutorial Once that's done we can create an app that we'll use to create a simple Web API. diff --git a/docs/tutorial/quickstart.md b/docs/tutorial/quickstart.md index 13152edae..108e5742a 100644 --- a/docs/tutorial/quickstart.md +++ b/docs/tutorial/quickstart.md @@ -19,9 +19,9 @@ Create a new Django project named `tutorial`, then start a new app called `quick pip install djangorestframework # Set up a new project with a single application - django-admin.py startproject tutorial . # Note the trailing '.' character + django-admin startproject tutorial . # Note the trailing '.' character cd tutorial - django-admin.py startapp quickstart + django-admin startapp quickstart cd .. The project layout should look like: From 6522d4ae2058c6de39c9818d53cc5c45fec70762 Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Thu, 4 Oct 2018 14:05:55 +0100 Subject: [PATCH 33/50] Add OpenAPIRenderer by default, and add schema docs. (#6233) * Add OpenAPIRenderer as a default for get_schema_view, and start adding schema docs * Add optional pyyaml * Updating schema docs --- docs/api-guide/schemas.md | 106 +++++++++++++----------- requirements/requirements-optionals.txt | 1 + rest_framework/schemas/views.py | 11 ++- 3 files changed, 62 insertions(+), 56 deletions(-) diff --git a/docs/api-guide/schemas.md b/docs/api-guide/schemas.md index b1b6ae63e..8a6688378 100644 --- a/docs/api-guide/schemas.md +++ b/docs/api-guide/schemas.md @@ -10,12 +10,50 @@ API schemas are a useful tool that allow for a range of use cases, including generating reference documentation, or driving dynamic client libraries that can interact with your API. -## Install Core API +## Install Core API & PyYAML You'll need to install the `coreapi` package in order to add schema support -for REST framework. +for REST framework. You probably also want to install `pyyaml`, so that you +can render the schema into the commonly used YAML-based OpenAPI format. - pip install coreapi + pip install coreapi pyyaml + +## Quickstart + +There are two different ways you can serve a schema description for you API. + +### Generating a schema with the `generateschema` management command + +To generate a static API schema, use the `generateschema` management command. + +```shell +$ python manage.py generateschema > schema.yml +``` + +Once you've generated a schema in this way you can annotate it with any +additional information that cannot be automatically inferred by the schema +generator. + +You might want to check your API schema into version control and update it +with each new release, or serve the API schema from your site's static media. + +### Adding a view with `get_schema_view` + +To add a dynamically generated schema view to your API, use `get_schema_view`. + +```python +from rest_framework.schemas import get_schema_view + +schema_view = get_schema_view(title="Example API") + +urlpatterns = [ + url('^schema$', schema_view), + ... +] +``` + +See below [for more details](#the-get_schema_view-shortcut) on customizing a +dynamically generated schema view. ## Internal schema representation @@ -71,38 +109,19 @@ endpoint: In order to be presented in an HTTP response, the internal representation has to be rendered into the actual bytes that are used in the response. +REST framework includes a few different renderers that you can use for +encoding the API schema. + +* `renderers.OpenAPIRenderer` - Renders into YAML-based [OpenAPI][openapi], the most widely used API schema format. +* `renderers.JSONOpenAPIRenderer` - Renders into JSON-based [OpenAPI][openapi]. +* `renderers.CoreJSONRenderer` - Renders into [Core JSON][corejson], a format designed for +use with the `coreapi` client library. + + [Core JSON][corejson] is designed as a canonical format for use with Core API. REST framework includes a renderer class for handling this media type, which is available as `renderers.CoreJSONRenderer`. -### Alternate schema formats - -Other schema formats such as [Open API][open-api] ("Swagger"), -[JSON HyperSchema][json-hyperschema], or [API Blueprint][api-blueprint] can also -be supported by implementing a custom renderer class that handles converting a -`Document` instance into a bytestring representation. - -If there is a Core API codec package that supports encoding into the format you -want to use then implementing the renderer class can be done by using the codec. - -#### Example - -For example, the `openapi_codec` package provides support for encoding or decoding -to the Open API ("Swagger") format: - - from rest_framework import renderers - from openapi_codec import OpenAPICodec - - class SwaggerRenderer(renderers.BaseRenderer): - media_type = 'application/openapi+json' - format = 'swagger' - - def render(self, data, media_type=None, renderer_context=None): - codec = OpenAPICodec() - return codec.dump(data) - - - ## Schemas vs Hypermedia @@ -325,13 +344,12 @@ ROOT_URLCONF setting. May be used to pass the set of renderer classes that can be used to render the API root endpoint. from rest_framework.schemas import get_schema_view - from rest_framework.renderers import CoreJSONRenderer - from my_custom_package import APIBlueprintRenderer + from rest_framework.renderers import JSONOpenAPIRenderer schema_view = get_schema_view( title='Server Monitoring API', url='https://www.example.org/api/', - renderer_classes=[CoreJSONRenderer, APIBlueprintRenderer] + renderer_classes=[JSONOpenAPIRenderer] ) #### `patterns` @@ -364,7 +382,6 @@ Defaults to `settings.DEFAULT_AUTHENTICATION_CLASSES` May be used to specify the list of permission classes that will apply to the schema endpoint. Defaults to `settings.DEFAULT_PERMISSION_CLASSES` - ## Using an explicit schema view If you need a little more control than the `get_schema_view()` shortcut gives you, @@ -386,7 +403,7 @@ return the schema. generator = schemas.SchemaGenerator(title='Bookings API') @api_view() - @renderer_classes([renderers.CoreJSONRenderer]) + @renderer_classes([renderers.OpenAPIRenderer]) def schema_view(request): schema = generator.get_schema(request) return response.Response(schema) @@ -408,7 +425,7 @@ In order to present a schema with endpoints filtered by user permissions, you need to pass the `request` argument to the `get_schema()` method, like so: @api_view() - @renderer_classes([renderers.CoreJSONRenderer]) + @renderer_classes([renderers.OpenAPIRenderer]) def schema_view(request): generator = schemas.SchemaGenerator(title='Bookings API') return response.Response(generator.get_schema(request=request)) @@ -432,21 +449,10 @@ representation. ) @api_view() - @renderer_classes([renderers.CoreJSONRenderer]) + @renderer_classes([renderers.OpenAPIRenderer]) def schema_view(request): return response.Response(schema) -## Static schema file - -A final option is to write your API schema as a static file, using one -of the available formats, such as Core JSON or Open API. - -You could then either: - -* Write a schema definition as a static file, and [serve the static file directly][static-files]. -* Write a schema definition that is loaded using `Core API`, and then - rendered to one of many available formats, depending on the client request. - --- # Schemas as documentation @@ -535,7 +541,7 @@ Arguments: Returns a `coreapi.Document` instance that represents the API schema. @api_view - @renderer_classes([renderers.CoreJSONRenderer]) + @renderer_classes([renderers.OpenAPIRenderer]) def schema_view(request): generator = schemas.SchemaGenerator(title='Bookings API') return Response(generator.get_schema()) diff --git a/requirements/requirements-optionals.txt b/requirements/requirements-optionals.txt index 87cdb82da..cd0f1f62b 100644 --- a/requirements/requirements-optionals.txt +++ b/requirements/requirements-optionals.txt @@ -5,3 +5,4 @@ django-guardian==1.4.9 django-filter==1.1.0 coreapi==2.3.1 coreschema==0.0.4 +pyyaml diff --git a/rest_framework/schemas/views.py b/rest_framework/schemas/views.py index b13eadea9..845b68ea6 100644 --- a/rest_framework/schemas/views.py +++ b/rest_framework/schemas/views.py @@ -19,13 +19,12 @@ class SchemaView(APIView): def __init__(self, *args, **kwargs): super(SchemaView, self).__init__(*args, **kwargs) if self.renderer_classes is None: + self.renderer_classes = [ + renderers.OpenAPIRenderer, + renderers.CoreJSONRenderer + ] if renderers.BrowsableAPIRenderer in api_settings.DEFAULT_RENDERER_CLASSES: - self.renderer_classes = [ - renderers.CoreJSONRenderer, - renderers.BrowsableAPIRenderer, - ] - else: - self.renderer_classes = [renderers.CoreJSONRenderer] + self.renderer_classes += [renderers.BrowsableAPIRenderer] def get(self, request, *args, **kwargs): schema = self.schema_generator.get_schema(request, self.public) From 5feb835929214b2d656f64d5aea6f169e2df59d7 Mon Sep 17 00:00:00 2001 From: Daniel Bate Date: Wed, 10 Oct 2018 09:29:29 +0100 Subject: [PATCH 34/50] Feature/action docs sections (#6060) * added ability to add sections to custom action documentation * added tests to cover docs sections in custom actions * added method specific docs test for action mapping * added docs for custom action documentation --- docs/topics/documenting-your-api.md | 22 +++++++++++ rest_framework/schemas/inspectors.py | 7 ++-- tests/test_schemas.py | 59 ++++++++++++++++++++++++++++ 3 files changed, 85 insertions(+), 3 deletions(-) diff --git a/docs/topics/documenting-your-api.md b/docs/topics/documenting-your-api.md index f57b51ee0..778ebb042 100644 --- a/docs/topics/documenting-your-api.md +++ b/docs/topics/documenting-your-api.md @@ -90,6 +90,28 @@ When using viewsets, you should use the relevant action names as delimiters. Create a new user instance. """ +Custom actions on viewsets can also be documented in a similar way using the method names +as delimiters or by attaching the documentation to action mapping methods. + + class UserViewSet(viewsets.ModelViewset): + ... + + @action(detail=False, methods=['get', 'post']) + def some_action(self, request, *args, **kwargs): + """ + get: + A description of the get method on the custom action. + + post: + A description of the post method on the custom action. + """ + + @some_action.mapping.put + def put_some_action(): + """ + A description of the put method on the custom action. + """ + ### `documentation` API Reference diff --git a/rest_framework/schemas/inspectors.py b/rest_framework/schemas/inspectors.py index b90f60e08..02a38f351 100644 --- a/rest_framework/schemas/inspectors.py +++ b/rest_framework/schemas/inspectors.py @@ -247,9 +247,11 @@ class AutoSchema(ViewInspector): method_docstring = getattr(view, method_name, None).__doc__ if method_docstring: # An explicit docstring on the method or action. - return formatting.dedent(smart_text(method_docstring)) + 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()) - description = view.get_view_description() + def _get_description_section(self, view, header, description): lines = [line for line in description.splitlines()] current_section = '' sections = {'': ''} @@ -263,7 +265,6 @@ class AutoSchema(ViewInspector): # TODO: SCHEMA_COERCE_METHOD_NAMES appears here and in `SchemaGenerator.get_keys` coerce_method_names = api_settings.SCHEMA_COERCE_METHOD_NAMES - header = getattr(view, 'action', method.lower()) if header in sections: return sections[header].strip() if header in coerce_method_names: diff --git a/tests/test_schemas.py b/tests/test_schemas.py index 6d7091da2..ad2e34a4b 100644 --- a/tests/test_schemas.py +++ b/tests/test_schemas.py @@ -114,6 +114,24 @@ class ExampleViewSet(ModelViewSet): assert self.action return super(ExampleViewSet, self).get_serializer(*args, **kwargs) + @action(methods=['get', 'post'], detail=False) + def documented_custom_action(self, request): + """ + get: + A description of the get method on the custom action. + + post: + A description of the post method on the custom action. + """ + pass + + @documented_custom_action.mapping.put + def put_documented_custom_action(self, request, *args, **kwargs): + """ + A description of the put method on the custom action from mapping. + """ + pass + if coreapi: schema_view = get_schema_view(title='Example API') @@ -161,6 +179,13 @@ class TestRouterGeneratedSchema(TestCase): description='Custom description.', ) }, + 'documented_custom_action': { + 'read': coreapi.Link( + url='/example/documented_custom_action/', + action='get', + description='A description of the get method on the custom action.', + ) + }, 'read': coreapi.Link( url='/example/{id}/', action='get', @@ -263,6 +288,33 @@ class TestRouterGeneratedSchema(TestCase): description='Deletion description.', ), }, + 'documented_custom_action': { + 'read': coreapi.Link( + url='/example/documented_custom_action/', + action='get', + description='A description of the get method on the custom action.', + ), + 'create': coreapi.Link( + url='/example/documented_custom_action/', + action='post', + description='A description of the post method on the custom action.', + encoding='application/json', + fields=[ + coreapi.Field('a', required=True, location='form', schema=coreschema.String(title='A', description='A field description')), + coreapi.Field('b', required=False, location='form', schema=coreschema.String(title='B')) + ] + ), + 'update': coreapi.Link( + url='/example/documented_custom_action/', + action='put', + description='A description of the put method on the custom action from mapping.', + encoding='application/json', + fields=[ + coreapi.Field('a', required=True, location='form', schema=coreschema.String(title='A', description='A field description')), + coreapi.Field('b', required=False, location='form', schema=coreschema.String(title='B')) + ] + ), + }, 'update': coreapi.Link( url='/example/{id}/', action='put', @@ -548,6 +600,13 @@ class TestSchemaGeneratorWithMethodLimitedViewSets(TestCase): description='Custom description.', ) }, + 'documented_custom_action': { + 'read': coreapi.Link( + url='/example1/documented_custom_action/', + action='get', + description='A description of the get method on the custom action.', + ), + }, 'read': coreapi.Link( url='/example1/{id}/', action='get', From dd19a44583e30bdb325da23583f2a934399155e1 Mon Sep 17 00:00:00 2001 From: Dennis Kliban Date: Wed, 10 Oct 2018 04:36:04 -0400 Subject: [PATCH 35/50] Problem: autoescape not getting passed to urlize_quoted_links filter (#6191) Solution: set needs_autoescape=True when registering the filter Without this patch, the disabling autoescape in the template does not work. --- rest_framework/templatetags/rest_framework.py | 2 +- tests/test_templatetags.py | 11 +++++++++++ 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/rest_framework/templatetags/rest_framework.py b/rest_framework/templatetags/rest_framework.py index 36aa9e8b3..392338973 100644 --- a/rest_framework/templatetags/rest_framework.py +++ b/rest_framework/templatetags/rest_framework.py @@ -314,7 +314,7 @@ def smart_urlquote_wrapper(matched_url): return None -@register.filter +@register.filter(needs_autoescape=True) def urlize_quoted_links(text, trim_url_limit=None, nofollow=True, autoescape=True): """ Converts any URLs in text into clickable links. diff --git a/tests/test_templatetags.py b/tests/test_templatetags.py index dfbd5d9de..5d4f6a4e3 100644 --- a/tests/test_templatetags.py +++ b/tests/test_templatetags.py @@ -3,6 +3,7 @@ from __future__ import unicode_literals import unittest +from django.template import Context, Template from django.test import TestCase from rest_framework.compat import coreapi, coreschema @@ -304,6 +305,16 @@ class URLizerTests(TestCase): '"foo_set": [\n "http://api/foos/1/"\n], ' self._urlize_dict_check(data) + def test_template_render_with_noautoescape(self): + """ + Test if the autoescape value is getting passed to urlize_quoted_links filter. + """ + template = Template("{% load rest_framework %}" + "{% autoescape off %}{{ content|urlize_quoted_links }}" + "{% endautoescape %}") + rendered = template.render(Context({'content': '"http://example.com"'})) + assert rendered == '"http://example.com"' + @unittest.skipUnless(coreapi, 'coreapi is not installed') class SchemaLinksTests(TestCase): From 317d2489e4a75b9fb108963b8b44ca266fdb0ed4 Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Thu, 11 Oct 2018 14:03:02 +0100 Subject: [PATCH 36/50] Add Kloudless logo --- docs/img/premium/kloudless-readme.png | Bin 0 -> 30212 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/img/premium/kloudless-readme.png diff --git a/docs/img/premium/kloudless-readme.png b/docs/img/premium/kloudless-readme.png new file mode 100644 index 0000000000000000000000000000000000000000..ec0102083a559efff87cd1c2971cedaffc31eb2c GIT binary patch literal 30212 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 literal 0 HcmV?d00001 From ebc5393776266e6c72f2a00bf5e633b08528f221 Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Thu, 11 Oct 2018 14:06:24 +0100 Subject: [PATCH 37/50] Add spacing around kloudless logo --- docs/img/premium/kloudless-readme.png | Bin 30212 -> 30722 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/docs/img/premium/kloudless-readme.png b/docs/img/premium/kloudless-readme.png index ec0102083a559efff87cd1c2971cedaffc31eb2c..63fabec1b90eb6607883d45c9a1aa94a38ebea44 100644 GIT binary patch delta 29902 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 Y15QY$vMa#mGynhq07*qoM6N<$f|1%=tN;K2 From 1c3f796219e7794306bb2db81d4910c0cb7c932a Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Thu, 11 Oct 2018 14:48:05 +0100 Subject: [PATCH 38/50] Add kloudless as a new premium sponsor (#6241) --- README.md | 5 ++++- docs/index.md | 3 ++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 42edadd19..c17b9921e 100644 --- a/README.md +++ b/README.md @@ -25,8 +25,9 @@ The initial aim is to provide a single full-time position on REST framework. [![][rollbar-img]][rollbar-url] [![][cadre-img]][cadre-url] [![][load-impact-img]][load-impact-url] +[![][kloudless-img]][kloudless-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], and [Load Impact][load-impact-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], and [Kloudless][kloudless-url]. --- @@ -194,6 +195,7 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [rollbar-img]: https://raw.githubusercontent.com/encode/django-rest-framework/master/docs/img/premium/rollbar-readme.png [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 [rover-url]: http://jobs.rover.com/ [sentry-url]: https://getsentry.com/welcome/ @@ -201,6 +203,7 @@ Send a description of the issue via email to [rest-framework-security@googlegrou [rollbar-url]: https://rollbar.com/ [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 [oauth1-section]: https://www.django-rest-framework.org/api-guide/authentication/#django-rest-framework-oauth [oauth2-section]: https://www.django-rest-framework.org/api-guide/authentication/#django-oauth-toolkit diff --git a/docs/index.md b/docs/index.md index 8079bff15..eddebeccf 100644 --- a/docs/index.md +++ b/docs/index.md @@ -72,10 +72,11 @@ continued development by **[signing up for a paid plan][funding]**.
  • Rollbar
  • Cadre
  • Load Impact
    • +
  • Kloudless
    • -*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), [Rollbar](https://rollbar.com), [Cadre](https://cadre.com), and [Load Impact](https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf).* +*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), [Rollbar](https://rollbar.com), [Cadre](https://cadre.com), [Load Impact](https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf), and [Kloudless](https://hubs.ly/H0f30Lf0).* --- From 28040b3bda5651967a28c9c921dfae6afe6a0c3d Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Mon, 15 Oct 2018 17:31:36 +0100 Subject: [PATCH 39/50] Upgrade Auklet to premium (#6244) --- README.md | 5 ++++- docs/img/premium/auklet-readme.png | Bin 0 -> 48745 bytes docs/index.md | 3 ++- 3 files changed, 6 insertions(+), 2 deletions(-) create mode 100644 docs/img/premium/auklet-readme.png diff --git a/README.md b/README.md index c17b9921e..f49593bbd 100644 --- a/README.md +++ b/README.md @@ -26,8 +26,9 @@ The initial aim is to provide a single full-time position on REST framework. [![][cadre-img]][cadre-url] [![][load-impact-img]][load-impact-url] [![][kloudless-img]][kloudless-url] +[![][auklet-img]][auklet-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], and [Kloudless][kloudless-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], and [Auklet][auklet-url]. --- @@ -196,6 +197,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 [rover-url]: http://jobs.rover.com/ [sentry-url]: https://getsentry.com/welcome/ @@ -204,6 +206,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/ [oauth1-section]: https://www.django-rest-framework.org/api-guide/authentication/#django-rest-framework-oauth [oauth2-section]: https://www.django-rest-framework.org/api-guide/authentication/#django-oauth-toolkit diff --git a/docs/img/premium/auklet-readme.png b/docs/img/premium/auklet-readme.png new file mode 100644 index 0000000000000000000000000000000000000000..f55f7a70ea7e8a5b9ec6a9de62246606c21f1136 GIT binary patch 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{ literal 0 HcmV?d00001 diff --git a/docs/index.md b/docs/index.md index eddebeccf..c250aa0af 100644 --- a/docs/index.md +++ b/docs/index.md @@ -69,6 +69,7 @@ continued development by **[signing up for a paid plan][funding]**.
  • Rover.com
  • Sentry
  • Stream
    • +
  • Auklet
  • Rollbar
  • Cadre
  • Load Impact
    • @@ -76,7 +77,7 @@ continued development by **[signing up for a paid plan][funding]**.
    -*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), [Rollbar](https://rollbar.com), [Cadre](https://cadre.com), [Load Impact](https://loadimpact.com/?utm_campaign=Sponsorship%20links&utm_source=drf&utm_medium=drf), and [Kloudless](https://hubs.ly/H0f30Lf0).* +*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), and [Kloudless](https://hubs.ly/H0f30Lf0).* --- From 2c9c0f1b7f24e2fbedacbb85e6b56eb244a2353c Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Thu, 18 Oct 2018 10:38:46 +0100 Subject: [PATCH 40/50] Version 3.9 (#6247) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Release notes to 5174a26ec9d50c7b1e934ee2613de4ae2e2c * Update version for v3.9.0 * Removed exclude_from_schema per deprecation policy. * Updated list_route() and detail_route() deprecations. * Weakened to PendingDeprecationWarning for `base_name` cc @rpkilby. * Add (beginning of) 3.9 release announcement. @tomchristie: Input on OpenAPI and What’s Next very welcome! :) * Add announcement section for Extra Actions in Browsable API * Update release notes and add deprecation note for Django Guardian backend. * Add release note for #6073 * Add release notes to dd19a44583e30bdb325da23583f2a934399155e1 * Adding release notes * Update 3.9 announcement * Add Oct 18 release date --- docs/community/3.9-announcement.md | 212 +++++++++++++++++++++++++++ docs/community/release-notes.md | 78 +++++++++- mkdocs.yml | 1 + rest_framework/__init__.py | 2 +- rest_framework/decorators.py | 19 +-- rest_framework/routers.py | 14 +- rest_framework/schemas/generators.py | 9 -- tests/test_decorators.py | 10 +- tests/test_routers.py | 8 +- tests/test_schemas.py | 32 ---- 10 files changed, 313 insertions(+), 72 deletions(-) create mode 100644 docs/community/3.9-announcement.md diff --git a/docs/community/3.9-announcement.md b/docs/community/3.9-announcement.md new file mode 100644 index 000000000..3cd9b1a54 --- /dev/null +++ b/docs/community/3.9-announcement.md @@ -0,0 +1,212 @@ + + +# Django REST framework 3.9 + +The 3.9 release gives access to _extra actions_ in the Browsable API, introduces composable permissions and built-in [OpenAPI][openapi] schema support. (Formerly known as Swagger) + +--- + +## Funding + +If you use REST framework commercially and would like to see this work continue, we strongly encourage you to invest in its continued development by +**[signing up for a paid plan][funding]**. + + + +
    + +*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), and [Kloudless](https://hubs.ly/H0f30Lf0).* + +--- + +## Built-in OpenAPI schema support + +REST framework now has a first-pass at directly including OpenAPI schema support. (Formerly known as Swagger) + +Specifically: + +* There are now `OpenAPIRenderer`, and `JSONOpenAPIRenderer` classes that deal with encoding `coreapi.Document` instances into OpenAPI YAML or OpenAPI JSON. +* The `get_schema_view(...)` method now defaults to OpenAPI YAML, with CoreJSON as a secondary +option if it is selected via HTTP content negotiation. +* There is a new management command `generateschema`, which you can use to dump +the schema into your repository. + +Here's an example of adding an OpenAPI schema to the URL conf: + +```python +from rest_framework.schemas import get_schema_view +from rest_framework.renderers import JSONOpenAPIRenderer + +schema_view = get_schema_view( + title='Server Monitoring API', + url='https://www.example.org/api/', + renderer_classes=[JSONOpenAPIRenderer] +) + +urlpatterns = [ + url('^schema.json$', schema_view), + ... +] +``` + +And here's how you can use the `generateschema` management command: + +```shell +$ python manage.py generateschema --format openapi > schema.yml +``` + +There's lots of different tooling that you can use for working with OpenAPI +schemas. One option that we're working on is the [API Star](https://docs.apistar.com/) +command line tool. + +You can use `apistar` to validate your API schema: + +```shell +$ apistar validate --path schema.json --format openapi +âś“ Valid OpenAPI schema. +``` + +Or to build API documentation: + +```shell +$ apistar docs --path schema.json --format openapi +âś“ Documentation built at "build/index.html". +``` + +API Star also includes a [dynamic client library](https://docs.apistar.com/client-library/) +that uses an API schema to automatically provide a client library interface for making requests. + +## Composable permission classes + +You can now compose permission classes using the and/or operators, `&` and `|`. + +For example... + +```python +permission_classes = [IsAuthenticated & (ReadOnly | IsAdmin)] +``` + +If you're using custom permission classes then make sure that you are subclassing +from `BasePermission` in order to enable this support. + +## ViewSet _Extra Actions_ available in the Browsable API + +Following the introduction of the `action` decorator in v3.8, _extra actions_ defined on a ViewSet are now available +from the Browsable API. + +![Extra Actions displayed in the Browsable API](https://user-images.githubusercontent.com/2370209/32976956-1ca9ab7e-cbf1-11e7-981a-a20cb1e83d63.png) + +When defined, a dropdown of "Extra Actions", appropriately filtered to detail/non-detail actions, is displayed. + +--- + +## Supported Versions + +REST framework 3.9 supports Django versions 1.11, 2.0, and 2.1. + +--- + +## Deprecations + +### `DjangoObjectPermissionsFilter` moved to third-party package. + +The `DjangoObjectPermissionsFilter` class is pending deprecation, will be deprecated in 3.10 and removed entirely in 3.11. + +It has been moved to the third-party [`djangorestframework-guardian`](https://github.com/rpkilby/django-rest-framework-guardian) +package. Please use this instead. + +### Router argument/method renamed to use `basename` for consistency. + +* The `Router.register` `base_name` argument has been renamed in favor of `basename`. +* The `Router.get_default_base_name` method has been renamed in favor of `Router.get_default_basename`. [#5990][gh5990] + +See [#5990][gh5990]. + +[gh5990]: https://github.com/encode/django-rest-framework/pull/5990 + +`base_name` and `get_default_base_name()` are pending deprecation. They will be deprecated in 3.10 and removed entirely in 3.11. + +### `action` decorator replaces `list_route` and `detail_route` + +Both `list_route` and `detail_route` are now deprecated in favour of the single `action` decorator. +They will be removed entirely in 3.10. + +The `action` decorator takes a boolean `detail` argument. + +* Replace `detail_route` uses with `@action(detail=True)`. +* Replace `list_route` uses with `@action(detail=False)`. + +### `exclude_from_schema` + +Both `APIView.exclude_from_schema` and the `exclude_from_schema` argument to the `@api_view` have now been removed. + +For `APIView` you should instead set a `schema = None` attribute on the view class. + +For function based views the `@schema` decorator can be used to exclude the view from the schema, by using `@schema(None)`. + +--- + +## Minor fixes and improvements + +There are a large number of minor fixes and improvements in this release. See the [release notes](release-notes.md) page for a complete listing. + + +## What's next + +We're planning to iteratively working towards OpenAPI becoming the standard schema +representation. This will mean that the `coreapi` dependency will gradually become +removed, and we'll instead generate the schema directly, rather than building +a CoreAPI `Document` object. + +OpenAPI has clearly become the standard for specifying Web APIs, so there's not +much value any more in our schema-agnostic document model. Making this change +will mean that we'll more easily be able to take advantage of the full set of +OpenAPI functionality. + +This will also make a wider range of tooling available. + +We'll focus on continuing to develop the [API Star](https://docs.apistar.com/) +library and client tool into a recommended option for generating API docs, +validating API schemas, and providing a dynamic client library. + +There's also a huge amount of ongoing work on maturing the ASGI landscape, +with the possibility that some of this work will eventually [feed back into +Django](https://www.aeracode.org/2018/06/04/django-async-roadmap/). + +There will be further work on the [Uvicorn](https://www.uvicorn.org/) +webserver, as well as lots of functionality planned for the [Starlette](https://www.starlette.io/) +web framework, which is building a foundational set of tooling for working with +ASGI. + + +[funding]: funding.md +[gh5886]: https://github.com/encode/django-rest-framework/issues/5886 +[gh5705]: https://github.com/encode/django-rest-framework/issues/5705 +[openapi]: https://www.openapis.org/ +[sponsors]: https://fund.django-rest-framework.org/topics/funding/#our-sponsors diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md index 700d1d97f..ac415c9b8 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -42,11 +42,52 @@ You can determine your currently installed version using `pip show`: ### 3.9.0 -**Date**: Unreleased +**Date**: [18st October 2018][3.9.0-milestone] +* Improvements to ViewSet extra actions [#5605][gh5605] +* Fix `action` support for ViewSet suffixes [#6081][gh6081] +* Allow `action` docs sections [#6060][gh6060] * Deprecate the `Router.register` `base_name` argument in favor of `basename`. [#5990][gh5990] * Deprecate the `Router.get_default_base_name` method in favor of `Router.get_default_basename`. [#5990][gh5990] +* Change `CharField` to disallow null bytes. [#6073][gh6073] + To revert to the old behavior, subclass `CharField` and remove `ProhibitNullCharactersValidator` from the validators. + ```python + class NullableCharField(serializers.CharField): + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + self.validators = [v for v in self.validators if not isinstance(v, ProhibitNullCharactersValidator)] + ``` +* Add `OpenAPIRenderer` and `generate_schema` management command. [#6229][gh6229] +* Add OpenAPIRenderer by default, and add schema docs. [#6233][gh6233] +* Allow permissions to be composed [#5753][gh5753] +* Allow nullable BooleanField in Django 2.1 [#6183][gh6183] +* Add testing of Python 3.7 support [#6141][gh6141] +* Test using Django 2.1 final release. [#6109][gh6109] +* Added djangorestframework-datatables to third-party packages [#5931][gh5931] +* Change ISO 8601 date format to exclude year/month [#5936][gh5936] +* Update all pypi.python.org URLs to pypi.org [#5942][gh5942] +* Ensure that html forms (multipart form data) respect optional fields [#5927][gh5927] +* Allow hashing of ErrorDetail. [#5932][gh5932] +* Correct schema parsing for JSONField [#5878][gh5878] +* Render descriptions (from help_text) using safe [#5869][gh5869] +* Removed input value from deault_error_message [#5881][gh5881] +* Added min_value/max_value support in DurationField [#5643][gh5643] +* Fixed instance being overwritten in pk-only optimization try/except block [#5747][gh5747] +* Fixed AttributeError from items filter when value is None [#5981][gh5981] +* Fixed Javascript `e.indexOf` is not a function error [#5982][gh5982] +* Fix schemas for extra actions [#5992][gh5992] +* Improved get_error_detail to use error_dict/error_list [#5785][gh5785] +* Imprvied URLs in Admin renderer [#5988][gh5988] +* Add "Community" section to docs, minor cleanup [#5993][gh5993] +* Moved guardian imports out of compat [#6054][gh6054] * Deprecate the `DjangoObjectPermissionsFilter` class, moved to the `djangorestframework-guardian` package. [#6075][gh6075] +* Drop Django 1.10 support [#5657][gh5657] +* Only catch TypeError/ValueError for object lookups [#6028][gh6028] +* Handle models without .objects manager in ModelSerializer. [#6111][gh6111] +* Improve ModelSerializer.create() error message. [#6112][gh6112] +* Fix CSRF cookie check failure when using session auth with django 1.11.6+ [#6113][gh6113] +* Updated JWT docs. [#6138][gh6138] +* Fix autoescape not getting passed to urlize_quoted_links filter [#6191][gh6191] ## 3.8.x series @@ -1093,6 +1134,7 @@ For older release notes, [please see the version 2.x documentation][old-release- [3.8.0-milestone]: https://github.com/encode/django-rest-framework/milestone/61?closed=1 [3.8.1-milestone]: https://github.com/encode/django-rest-framework/milestone/67?closed=1 [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 [gh2013]: https://github.com/encode/django-rest-framework/issues/2013 @@ -1974,5 +2016,39 @@ For older release notes, [please see the version 2.x documentation][old-release- [gh5920]: https://github.com/encode/django-rest-framework/issues/5920 +[gh6109]: https://github.com/encode/django-rest-framework/issues/6109 +[gh6141]: https://github.com/encode/django-rest-framework/issues/6141 +[gh6113]: https://github.com/encode/django-rest-framework/issues/6113 +[gh6112]: https://github.com/encode/django-rest-framework/issues/6112 +[gh6111]: https://github.com/encode/django-rest-framework/issues/6111 +[gh6028]: https://github.com/encode/django-rest-framework/issues/6028 +[gh5657]: https://github.com/encode/django-rest-framework/issues/5657 +[gh6054]: https://github.com/encode/django-rest-framework/issues/6054 +[gh5993]: https://github.com/encode/django-rest-framework/issues/5993 [gh5990]: https://github.com/encode/django-rest-framework/issues/5990 +[gh5988]: https://github.com/encode/django-rest-framework/issues/5988 +[gh5785]: https://github.com/encode/django-rest-framework/issues/5785 +[gh5992]: https://github.com/encode/django-rest-framework/issues/5992 +[gh5605]: https://github.com/encode/django-rest-framework/issues/5605 +[gh5982]: https://github.com/encode/django-rest-framework/issues/5982 +[gh5981]: https://github.com/encode/django-rest-framework/issues/5981 +[gh5747]: https://github.com/encode/django-rest-framework/issues/5747 +[gh5643]: https://github.com/encode/django-rest-framework/issues/5643 +[gh5881]: https://github.com/encode/django-rest-framework/issues/5881 +[gh5869]: https://github.com/encode/django-rest-framework/issues/5869 +[gh5878]: https://github.com/encode/django-rest-framework/issues/5878 +[gh5932]: https://github.com/encode/django-rest-framework/issues/5932 +[gh5927]: https://github.com/encode/django-rest-framework/issues/5927 +[gh5942]: https://github.com/encode/django-rest-framework/issues/5942 +[gh5936]: https://github.com/encode/django-rest-framework/issues/5936 +[gh5931]: https://github.com/encode/django-rest-framework/issues/5931 +[gh6183]: https://github.com/encode/django-rest-framework/issues/6183 [gh6075]: https://github.com/encode/django-rest-framework/issues/6075 +[gh6138]: https://github.com/encode/django-rest-framework/issues/6138 +[gh6081]: https://github.com/encode/django-rest-framework/issues/6081 +[gh6073]: https://github.com/encode/django-rest-framework/issues/6073 +[gh6191]: https://github.com/encode/django-rest-framework/issues/6191 +[gh6060]: https://github.com/encode/django-rest-framework/issues/6060 +[gh6233]: https://github.com/encode/django-rest-framework/issues/6233 +[gh5753]: https://github.com/encode/django-rest-framework/issues/5753 +[gh6229]: https://github.com/encode/django-rest-framework/issues/6229 diff --git a/mkdocs.yml b/mkdocs.yml index fbdb8d779..83b3c8141 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -65,6 +65,7 @@ pages: - 'Contributing to REST framework': 'community/contributing.md' - 'Project management': 'community/project-management.md' - 'Release Notes': 'community/release-notes.md' + - '3.9 Announcement': 'community/3.9-announcement.md' - '3.8 Announcement': 'community/3.8-announcement.md' - '3.7 Announcement': 'community/3.7-announcement.md' - '3.6 Announcement': 'community/3.6-announcement.md' diff --git a/rest_framework/__init__.py b/rest_framework/__init__.py index fa92ab801..1a9a6527a 100644 --- a/rest_framework/__init__.py +++ b/rest_framework/__init__.py @@ -8,7 +8,7 @@ ______ _____ _____ _____ __ """ __title__ = 'Django REST framework' -__version__ = '3.8.2' +__version__ = '3.9.0' __author__ = 'Tom Christie' __license__ = 'BSD 2-Clause' __copyright__ = 'Copyright 2011-2018 Tom Christie' diff --git a/rest_framework/decorators.py b/rest_framework/decorators.py index 2d3bbe46f..f6d557d11 100644 --- a/rest_framework/decorators.py +++ b/rest_framework/decorators.py @@ -17,7 +17,7 @@ from django.utils import six from rest_framework.views import APIView -def api_view(http_method_names=None, exclude_from_schema=False): +def api_view(http_method_names=None): """ Decorator that converts a function-based view into an APIView subclass. Takes a list of allowed methods for the view as an argument. @@ -77,15 +77,8 @@ def api_view(http_method_names=None, exclude_from_schema=False): WrappedAPIView.schema = getattr(func, 'schema', APIView.schema) - if exclude_from_schema: - warnings.warn( - "The `exclude_from_schema` argument to `api_view` is deprecated. " - "Use the `schema` decorator instead, passing `None`.", - DeprecationWarning - ) - WrappedAPIView.exclude_from_schema = exclude_from_schema - return WrappedAPIView.as_view() + return decorator @@ -230,9 +223,9 @@ def detail_route(methods=None, **kwargs): Used to mark a method on a ViewSet that should be routed for detail requests. """ warnings.warn( - "`detail_route` is pending deprecation and will be removed in 3.10 in favor of " + "`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.", - PendingDeprecationWarning, stacklevel=2 + DeprecationWarning, stacklevel=2 ) def decorator(func): @@ -248,9 +241,9 @@ def list_route(methods=None, **kwargs): Used to mark a method on a ViewSet that should be routed for list requests. """ warnings.warn( - "`list_route` is pending deprecation and will be removed in 3.10 in favor of " + "`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.", - PendingDeprecationWarning, stacklevel=2 + DeprecationWarning, stacklevel=2 ) def decorator(func): diff --git a/rest_framework/routers.py b/rest_framework/routers.py index 392d43f79..de04cb674 100644 --- a/rest_framework/routers.py +++ b/rest_framework/routers.py @@ -40,10 +40,10 @@ DynamicRoute = namedtuple('DynamicRoute', ['url', 'name', 'detail', 'initkwargs' class DynamicDetailRoute(object): def __new__(cls, url, name, initkwargs): warnings.warn( - "`DynamicDetailRoute` is pending deprecation and will be removed in 3.10 " + "`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.", - PendingDeprecationWarning, stacklevel=2 + DeprecationWarning, stacklevel=2 ) return DynamicRoute(url, name, True, initkwargs) @@ -51,10 +51,10 @@ class DynamicDetailRoute(object): class DynamicListRoute(object): def __new__(cls, url, name, initkwargs): warnings.warn( - "`DynamicListRoute` is pending deprecation and will be removed in 3.10 in " + "`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.", - PendingDeprecationWarning, stacklevel=2 + DeprecationWarning, stacklevel=2 ) return DynamicRoute(url, name, False, initkwargs) @@ -77,7 +77,7 @@ def flatten(list_of_lists): class RenameRouterMethods(RenameMethodsBase): renamed_methods = ( - ('get_default_base_name', 'get_default_basename', DeprecationWarning), + ('get_default_base_name', 'get_default_basename', PendingDeprecationWarning), ) @@ -87,8 +87,8 @@ 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 has been deprecated in favor of `basename`." - warnings.warn(msg, DeprecationWarning, 2) + msg = "The `base_name` argument is pending deprecation in favor of `basename`." + warnings.warn(msg, PendingDeprecationWarning, 2) assert not (basename and base_name), ( "Do not provide both the `basename` and `base_name` arguments.") diff --git a/rest_framework/schemas/generators.py b/rest_framework/schemas/generators.py index 8794c9967..c5bda1f1f 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 -import warnings from collections import Counter, OrderedDict from importlib import import_module @@ -207,14 +206,6 @@ class EndpointEnumerator(object): if not is_api_view(callback): return False # Ignore anything except REST framework views. - if hasattr(callback.cls, 'exclude_from_schema'): - fmt = ("The `{}.exclude_from_schema` attribute is deprecated. " - "Set `schema = None` instead.") - msg = fmt.format(callback.cls.__name__) - warnings.warn(msg, DeprecationWarning) - if getattr(callback.cls, 'exclude_from_schema', False): - return False - if callback.cls.schema is None: return False diff --git a/tests/test_decorators.py b/tests/test_decorators.py index 77c488c34..9c6a899bf 100644 --- a/tests/test_decorators.py +++ b/tests/test_decorators.py @@ -290,34 +290,34 @@ class ActionDecoratorTestCase(TestCase): raise NotImplementedError def test_detail_route_deprecation(self): - with pytest.warns(PendingDeprecationWarning) as record: + with pytest.warns(DeprecationWarning) as record: @detail_route() def view(request): raise NotImplementedError assert len(record) == 1 assert str(record[0].message) == ( - "`detail_route` is pending deprecation and will be removed in " + "`detail_route` is deprecated and will be removed in " "3.10 in favor of `action`, which accepts a `detail` bool. Use " "`@action(detail=True)` instead." ) def test_list_route_deprecation(self): - with pytest.warns(PendingDeprecationWarning) as record: + with pytest.warns(DeprecationWarning) as record: @list_route() def view(request): raise NotImplementedError assert len(record) == 1 assert str(record[0].message) == ( - "`list_route` is pending deprecation and will be removed in " + "`list_route` is deprecated and will be removed in " "3.10 in favor of `action`, which accepts a `detail` bool. Use " "`@action(detail=False)` instead." ) def test_route_url_name_from_path(self): # pre-3.8 behavior was to base the `url_name` off of the `url_path` - with pytest.warns(PendingDeprecationWarning): + with pytest.warns(DeprecationWarning): @list_route(url_path='foo_bar') def view(request): raise NotImplementedError diff --git a/tests/test_routers.py b/tests/test_routers.py index 1dd2d2b0a..eae3f5458 100644 --- a/tests/test_routers.py +++ b/tests/test_routers.py @@ -495,18 +495,18 @@ class TestBaseNameRename(TestCase): warnings.simplefilter('always') router.register('mock', MockViewSet, 'mock', base_name='mock') - msg = "The `base_name` argument has been deprecated in favor of `basename`." + msg = "The `base_name` argument is pending deprecation in favor of `basename`." assert len(w) == 1 assert str(w[0].message) == msg def test_base_name_argument_deprecation(self): router = SimpleRouter() - with warnings.catch_warnings(record=True) as w: + with pytest.warns(PendingDeprecationWarning) as w: warnings.simplefilter('always') router.register('mock', MockViewSet, base_name='mock') - msg = "The `base_name` argument has been deprecated in favor of `basename`." + msg = "The `base_name` argument is pending deprecation in favor of `basename`." assert len(w) == 1 assert str(w[0].message) == msg assert router.registry == [ @@ -529,7 +529,7 @@ class TestBaseNameRename(TestCase): msg = "`CustomRouter.get_default_base_name` method should be renamed `get_default_basename`." # Class definition should raise a warning - with warnings.catch_warnings(record=True) as w: + with pytest.warns(PendingDeprecationWarning) as w: warnings.simplefilter('always') class CustomRouter(SimpleRouter): diff --git a/tests/test_schemas.py b/tests/test_schemas.py index ad2e34a4b..8e097f9f4 100644 --- a/tests/test_schemas.py +++ b/tests/test_schemas.py @@ -1032,38 +1032,6 @@ class SchemaGenerationExclusionTests(TestCase): assert should_include == expected - def test_deprecations(self): - with pytest.warns(DeprecationWarning) as record: - @api_view(["GET"], exclude_from_schema=True) - def view(request): - pass - - assert len(record) == 1 - assert str(record[0].message) == ( - "The `exclude_from_schema` argument to `api_view` is deprecated. " - "Use the `schema` decorator instead, passing `None`." - ) - - class OldFashionedExcludedView(APIView): - exclude_from_schema = True - - def get(self, request, *args, **kwargs): - pass - - patterns = [ - url('^excluded-old-fashioned/$', OldFashionedExcludedView.as_view()), - ] - - inspector = EndpointEnumerator(patterns) - with pytest.warns(DeprecationWarning) as record: - inspector.get_api_endpoints() - - assert len(record) == 1 - assert str(record[0].message) == ( - "The `OldFashionedExcludedView.exclude_from_schema` attribute is " - "deprecated. Set `schema = None` instead." - ) - @api_view(["GET"]) def simple_fbv(request): From 9d001cd84c1239d708b1528587c183ef30e38c31 Mon Sep 17 00:00:00 2001 From: Tano Abeleyra Date: Thu, 18 Oct 2018 19:42:52 -0300 Subject: [PATCH 41/50] Fix typo in testing.md (#6257) --- docs/api-guide/testing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api-guide/testing.md b/docs/api-guide/testing.md index a6ecc7557..9134bd08e 100644 --- a/docs/api-guide/testing.md +++ b/docs/api-guide/testing.md @@ -119,7 +119,7 @@ Extends [Django's existing `Client` class][client]. ## Making requests -The `APIClient` class supports the same request interface as Django's standard `Client` class. This means the that standard `.get()`, `.post()`, `.put()`, `.patch()`, `.delete()`, `.head()` and `.options()` methods are all available. For example: +The `APIClient` class supports the same request interface as Django's standard `Client` class. This means that the standard `.get()`, `.post()`, `.put()`, `.patch()`, `.delete()`, `.head()` and `.options()` methods are all available. For example: from rest_framework.test import APIClient From 6f2c0dbf4d9180641febdf42c3f3f0c39bcb0e5a Mon Sep 17 00:00:00 2001 From: Mark Davidoff Date: Sun, 28 Oct 2018 14:12:39 -0700 Subject: [PATCH 42/50] permissions must return a boolean `x and y` actually returns object y when both are true. the means P & IsAuthenticated will fail with TypeError: unsupported operand type(s) for &: 'instance' and 'bool' as IsAuthenticated now returns a CallableBool which does not overload __ror__ --- rest_framework/permissions.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/rest_framework/permissions.py b/rest_framework/permissions.py index dfe89ed2a..d1e84e088 100644 --- a/rest_framework/permissions.py +++ b/rest_framework/permissions.py @@ -110,7 +110,7 @@ class IsAuthenticated(BasePermission): """ def has_permission(self, request, view): - return request.user and request.user.is_authenticated + return bool(request.user and request.user.is_authenticated) class IsAdminUser(BasePermission): @@ -119,7 +119,7 @@ class IsAdminUser(BasePermission): """ def has_permission(self, request, view): - return request.user and request.user.is_staff + return bool(request.user and request.user.is_staff) class IsAuthenticatedOrReadOnly(BasePermission): @@ -128,7 +128,7 @@ class IsAuthenticatedOrReadOnly(BasePermission): """ def has_permission(self, request, view): - return ( + return bool( request.method in SAFE_METHODS or request.user and request.user.is_authenticated From fc08e0189fb8af568a453c31313e4ef276d22ae5 Mon Sep 17 00:00:00 2001 From: Mark Davidoff Date: Mon, 29 Oct 2018 08:26:20 -0700 Subject: [PATCH 43/50] update tests to reflect that django now returns a callable for is_authenticated --- tests/test_permissions.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 15fd9303c..0888262d6 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -9,6 +9,7 @@ from django.contrib.auth.models import Group, Permission, User from django.db import models from django.test import TestCase from django.urls import ResolverMatch +from django.utils.deprecation import CallableBool from rest_framework import ( HTTP_HEADER_ENCODING, authentication, generics, permissions, serializers, @@ -544,7 +545,7 @@ class CustomPermissionsTests(TestCase): class FakeUser: def __init__(self, auth=False): - self.is_authenticated = auth + self.is_authenticated = CallableBool(auth) class PermissionsCompositionTests(TestCase): From 67e99a29b814af86c7c2544b42d83cdf9cb2d647 Mon Sep 17 00:00:00 2001 From: Zach Wernberg Date: Mon, 29 Oct 2018 12:03:34 -0500 Subject: [PATCH 44/50] Fix typo in release-notes.md (#6285) --- 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 ac415c9b8..55e63daff 100644 --- a/docs/community/release-notes.md +++ b/docs/community/release-notes.md @@ -42,7 +42,7 @@ You can determine your currently installed version using `pip show`: ### 3.9.0 -**Date**: [18st October 2018][3.9.0-milestone] +**Date**: [18th October 2018][3.9.0-milestone] * Improvements to ViewSet extra actions [#5605][gh5605] * Fix `action` support for ViewSet suffixes [#6081][gh6081] From 1f13b6f6b2adfd58fff2a11803bc660aea46f2b4 Mon Sep 17 00:00:00 2001 From: Mark Davidoff Date: Mon, 29 Oct 2018 09:14:35 -0700 Subject: [PATCH 45/50] use actual user instead of fake user in permission composition test --- tests/test_permissions.py | 30 ++++++++++++++++++------------ 1 file changed, 18 insertions(+), 12 deletions(-) diff --git a/tests/test_permissions.py b/tests/test_permissions.py index 0888262d6..46ca166c2 100644 --- a/tests/test_permissions.py +++ b/tests/test_permissions.py @@ -5,11 +5,10 @@ import unittest import warnings import django -from django.contrib.auth.models import Group, Permission, User +from django.contrib.auth.models import AnonymousUser, Group, Permission, User from django.db import models from django.test import TestCase from django.urls import ResolverMatch -from django.utils.deprecation import CallableBool from rest_framework import ( HTTP_HEADER_ENCODING, authentication, generics, permissions, serializers, @@ -543,39 +542,46 @@ class CustomPermissionsTests(TestCase): self.assertEqual(detail, self.custom_message) -class FakeUser: - def __init__(self, auth=False): - self.is_authenticated = CallableBool(auth) - - class PermissionsCompositionTests(TestCase): + + def setUp(self): + self.username = 'john' + self.email = 'lennon@thebeatles.com' + self.password = 'password' + self.user = User.objects.create_user( + self.username, + self.email, + self.password + ) + self.client.login(username=self.username, password=self.password) + def test_and_false(self): request = factory.get('/1', format='json') - request.user = FakeUser(auth=False) + request.user = AnonymousUser() composed_perm = permissions.IsAuthenticated & permissions.AllowAny assert composed_perm().has_permission(request, None) is False def test_and_true(self): request = factory.get('/1', format='json') - request.user = FakeUser(auth=True) + request.user = self.user composed_perm = permissions.IsAuthenticated & permissions.AllowAny assert composed_perm().has_permission(request, None) is True def test_or_false(self): request = factory.get('/1', format='json') - request.user = FakeUser(auth=False) + request.user = AnonymousUser() composed_perm = permissions.IsAuthenticated | permissions.AllowAny assert composed_perm().has_permission(request, None) is True def test_or_true(self): request = factory.get('/1', format='json') - request.user = FakeUser(auth=True) + request.user = self.user composed_perm = permissions.IsAuthenticated | permissions.AllowAny assert composed_perm().has_permission(request, None) is True def test_several_levels(self): request = factory.get('/1', format='json') - request.user = FakeUser(auth=True) + request.user = self.user composed_perm = ( permissions.IsAuthenticated & permissions.IsAuthenticated & From 40da2a21ef08f9394eb03d018d560516f940a1b2 Mon Sep 17 00:00:00 2001 From: ilmucio <34142385+ilmucio@users.noreply.github.com> Date: Mon, 29 Oct 2018 23:43:06 +0100 Subject: [PATCH 46/50] Update authentication.md (#6291) --- 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 139458ad4..0776b6340 100644 --- a/docs/api-guide/authentication.md +++ b/docs/api-guide/authentication.md @@ -137,7 +137,7 @@ You'll also need to create tokens for your users. from rest_framework.authtoken.models import Token token = Token.objects.create(user=...) - print token.key + print(token.key) For clients to authenticate, the token key should be included in the `Authorization` HTTP header. The key should be prefixed by the string literal "Token", with whitespace separating the two strings. For example: From d59a130168858afe58d6db26f76f7cfe8ccb42a7 Mon Sep 17 00:00:00 2001 From: Tom Snee <351700+tsnee@users.noreply.github.com> Date: Fri, 2 Nov 2018 11:48:39 -0400 Subject: [PATCH 47/50] Fixes an import statement in chapter 5 of the tutorial. (#6267) --- docs/tutorial/5-relationships-and-hyperlinked-apis.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorial/5-relationships-and-hyperlinked-apis.md b/docs/tutorial/5-relationships-and-hyperlinked-apis.md index ae24ffeb8..0177afce1 100644 --- a/docs/tutorial/5-relationships-and-hyperlinked-apis.md +++ b/docs/tutorial/5-relationships-and-hyperlinked-apis.md @@ -106,7 +106,7 @@ If we're going to have a hyperlinked API, we need to make sure we name our URL p After adding all those names into our URLconf, our final `snippets/urls.py` file should look like this: - from django.conf.urls import url, include + from django.urls import path from rest_framework.urlpatterns import format_suffix_patterns from snippets import views From fae7e91728615cd321de22cab71dff21b1519e3c Mon Sep 17 00:00:00 2001 From: Stephen Finucane Date: Sat, 3 Nov 2018 14:57:47 +0000 Subject: [PATCH 48/50] docs: Remove references to drf-openapi (#6272) This has been EOL'd in favour of drf-yasg [1]. [1] https://github.com/limdauto/drf_openapi/commit/1673c6e0 Signed-off-by: Stephen Finucane --- docs/img/drf-openapi.png | Bin 75416 -> 0 bytes docs/topics/documenting-your-api.md | 18 ------------------ 2 files changed, 18 deletions(-) delete mode 100644 docs/img/drf-openapi.png diff --git a/docs/img/drf-openapi.png b/docs/img/drf-openapi.png deleted file mode 100644 index 7a37e19d6136301b5ff43bea160db7e32d3a9b96..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 75416 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 jem7vu7tb~Bf{=`4mg7QE_2QS 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 diff --git a/docs/topics/documenting-your-api.md b/docs/topics/documenting-your-api.md index 778ebb042..7eab08ecf 100644 --- a/docs/topics/documenting-your-api.md +++ b/docs/topics/documenting-your-api.md @@ -193,22 +193,6 @@ This also translates into a very useful interactive documentation viewer in the ![Screenshot - drf-yasg][image-drf-yasg] - -#### DRF OpenAPI - -[DRF OpenAPI][drf-openapi] bridges the gap between OpenAPI specification and tool chain with the schema exposed -out-of-the-box by Django Rest Framework. Its goals are: - - * To be dropped into any existing DRF project without any code change necessary. - * Provide clear disctinction between request schema and response schema. - * Provide a versioning mechanism for each schema. Support defining schema by version range syntax, e.g. >1.0, <=2.0 - * Support multiple response codes, not just 200 - * All this information should be bound to view methods, not view classes. - -It also tries to stay current with the maturing schema generation mechanism provided by DRF. - -![Screenshot - DRF OpenAPI][image-drf-openapi] - --- #### DRF Docs @@ -338,8 +322,6 @@ To implement a hypermedia API you'll need to decide on an appropriate media type [cite]: https://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven [drf-yasg]: https://github.com/axnsan12/drf-yasg/ [image-drf-yasg]: ../img/drf-yasg.png -[drf-openapi]: https://github.com/limdauto/drf_openapi/ -[image-drf-openapi]: ../img/drf-openapi.png [drfdocs-repo]: https://github.com/ekonstantinidis/django-rest-framework-docs [drfdocs-website]: https://www.drfdocs.com/ [drfdocs-demo]: http://demo.drfdocs.com/ From 9dfee6cd7beb8d3493d7f39d2f590ed98e761b2b Mon Sep 17 00:00:00 2001 From: Basil Dubyk Date: Mon, 5 Nov 2018 19:22:33 +0200 Subject: [PATCH 49/50] Add test for `NullBooleanField` with choices Author: @preston-wagner in PR #6116 --- tests/test_model_serializer.py | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/tests/test_model_serializer.py b/tests/test_model_serializer.py index e9ed9957f..72cfa1e47 100644 --- a/tests/test_model_serializer.py +++ b/tests/test_model_serializer.py @@ -363,6 +363,27 @@ class TestRegularFieldMappings(TestCase): ExampleSerializer() + def test_null_boolean_field_choices(self): + + class Trivial(models.Model): + CHECKLIST_OPTIONS = ( + (None, 'none'), + (True, 'checked'), + (False, 'N/A'), + ) + + name = models.CharField(max_length=255) + theoretically_nullable_field = models.NullBooleanField(choices=CHECKLIST_OPTIONS) + + class TrivialSerializer(serializers.ModelSerializer): + class Meta: + model = Trivial + fields = '__all__' + + trivial_serialized = TrivialSerializer(data=dict(name='test', theoretically_nullable_field=None)) + self.assertTrue(trivial_serialized.is_valid()) + self.assertEqual(trivial_serialized.errors, {}) + class TestDurationFieldMapping(TestCase): def test_duration_field(self): From 527411ce9255a255640ee04306cf7eadd47fa5c4 Mon Sep 17 00:00:00 2001 From: Basil Dubyk Date: Mon, 5 Nov 2018 19:38:05 +0200 Subject: [PATCH 50/50] Fix issue with validation of `NullBooleanField` with choices `get_field_kwargs` function will not set `allow_null` kwarg to `True` for `models.NullBooleanField`. But in case choices provided for this field we need to set `allow_null` to `True`, since all fields with provided choices will be validated as `ChoiceField` (see `ModelSerializer.build_standard_field(...)`). --- rest_framework/utils/field_mapping.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/rest_framework/utils/field_mapping.py b/rest_framework/utils/field_mapping.py index 50de3f125..483d8375f 100644 --- a/rest_framework/utils/field_mapping.py +++ b/rest_framework/utils/field_mapping.py @@ -100,7 +100,8 @@ def get_field_kwargs(field_name, model_field): if model_field.has_default() or model_field.blank or model_field.null: kwargs['required'] = False - if model_field.null and not isinstance(model_field, models.NullBooleanField): + is_null_boolean_field = isinstance(model_field, models.NullBooleanField) + if (model_field.null and not is_null_boolean_field) or (model_field.choices and is_null_boolean_field): kwargs['allow_null'] = True if model_field.blank and (isinstance(model_field, models.CharField) or