This release is considered a significant release to improve upstream support with Django and Python. Some of these may change the behaviour of existing features and pre-existing behaviour. Specifically, some fixes were added to around the support ofUniqueConstraint with nullable fields which will improve built-in serializer validation.

Features

• Add official support for Django 5.1 and its newLoginRequiredMiddleware in#9514 and#9657
• Add official Django 5.2a1 support in#9634
• Add support for Python 3.13 in#9527 and#9556
• Support Django 2.1+ test client JSON data automatically serialized in#6511 and fix a regression in#9615

Bug fixes

• Fix unique together validator to respect condition's fields fromUniqueConstraint in#9360
• Fix raising on nullable fields part ofUniqueConstraint in#9531
• Fixunique_together validation with source in#9482
• Added protections toAttributeError raised within properties in#9455
• Fixget_template_context to handle also lists in#9467
• Fix "Converter is already registered" deprecation warning. in#9512
• Fix noisy warning and accept integers as min/max values ofDecimalField in#9515
• Fix usages ofopen() insetup.py in#9661

Translations

• Add some missing Chinese translations in#9505
• Fix spelling mistakes in Farsi language were corrected in#9521
• Fixing and adding missing Brazilian Portuguese translations in#9535

Removals

• Remove support for Python 3.8 in#9670
• Remove long deprecated code from request wrapper in#9441
• Remove deprecatedAutoSchema._get_reference method in#9525

Documentation and internal changes

• Provide tests for hashing ofOperandHolder in#9437
• Update documentation: Addadrf third party package in#9198
• Update tutorials links in Community contributions docs in#9476
• Fix usage of deprecated Django function in example from docs in#9509
• Move path converter docs into a separate section in#9524
• Add test covering update view withoutqueryset attribute in#9528
• Fix Transifex link in#9541
• Fix examplehttpie call in docs in#9543
• Fix example for serializer field with choices in docs in#9563
• Remove extra<> in validators example in#9590
• Updatestrftime link in the docs in#9624
• Switch to codecov GHA in#9618
• Add note regarding availability of theaction attribute in 'Introspecting ViewSet actions' docs section in#9633
• Improved description of allowed throttling rates in documentation in#9640
• Addrest-framework-gm2m-relations package to the list of 3rd party libraries in#9063
• Fix a number of typos in the test suite in the docs in#9662
• Adddjango-pyoidc as a third party authentication library in#9667

New Contributors

• @maerteijn made their first contribution in#9198
• @FraCata00 made their first contribution in#9444
• @AlvaroVega made their first contribution in#9451
• @james-mchugh made their first contribution in#9455
• @ifeanyidavid made their first contribution in#9479
• @p-schlickmann made their first contribution in#9480
• @akkuman made their first contribution in#9505
• @rafaelgramoschi made their first contribution in#9509
• @Sinaatkd made their first contribution in#9521
• @gtkacz made their first contribution in#9535
• @sliverc made their first contribution in#9556
• @gabrielromagnoli1987 made their first contribution in#9543
• @cheehong1030 made their first contribution in#9563
• @amansharma612 made their first contribution in#9590
• @Gluroda made their first contribution in#9616
• @deepakangadi made their first contribution in#9624
• @EXG1O made their first contribution in#9633
• @decadenza made their first contribution in#9640
• @mojtabaakbari221b made their first contribution in#9063
• @mikemanger made their first contribution in#9661
• @gbip made their first contribution in#9667

Full Changelog:3.15.2...3.16.0

What's Changed

• Add @api_view example to caching documentation by@BradWells in#9131
• Update docstring by@jthevos in#9340
• Apply black formatting to caching markdown by@jthevos in#9341
• Update renderers documentation example by@mgaligniana in#9362
• Removing live examples of tutorial code that are no longer hosted by@TGoddessana in#9363
• Docs: Remove an unnecessary step from quickstart.md by@gogowitsch in#9387
• Documentation: Add Python 3.12 to the requirements by@Szaroslav in#9382
• Tweak README.md links. by@tomchristie in#9375
• Revert "Ensure CursorPagination respects nulls in the ordering field" by@max-muoto in#9381
• use warnings rather than logging a warning for DecimalField warnings by@terencehonles in#9367
• 20240426 docs by@peterthomassen in#9392
• Cleanup by@peterthomassen in#9393
• tests: Check urlpatterns after cleanups by@stanislavlevin in#9400
• docs: Correct some evaluation results and a httpie option in Tutorial1 by@wkwkhautbois in#9421
• Add__hash__ method forpermissions.OperandHolder class by@vanya909 in#9417
• Fix potential XSS vulnerability in break_long_headers template filter by@ch4n3-yoon in#9435
• Version 3.15.2. by@tomchristie in#9439

New Contributors

• @BradWells made their first contribution in#9131
• @jthevos made their first contribution in#9340
• @gogowitsch made their first contribution in#9387
• @Szaroslav made their first contribution in#9382
• @wkwkhautbois made their first contribution in#9421
• @ch4n3-yoon made their first contribution in#9435

Full Changelog:3.15.1...3.15.2

Contributors

What's Changed

• Update the message to be consistent with the Django `HttpResponseBa… by @maycuatroi in#9287
• Makeinflection package truly optional by@browniebroke in#9303
• Fix broken links in release notes for 3.15 by@browniebroke in#9305
• TokenAdmin.autocomplete_fields Breaks Some Use Cases, Revert by@alexdlaird in#9301
• Add drf-sendables to third-party-packages.md by@amikrop in#9261
• Revert "feat: Add some changes to ValidationError to support django style vad…" by@auvipy in#9326
• Revert "Re-prefetch related objects after updating" by@auvipy in#9327
• Revert#8863 by@tomchristie in#9330
• Revert#8009 by@tomchristie in#9332
• Revert#9030 by@tomchristie in#9333
• Revert "Fix NamespaceVersioning ignoring DEFAULT_VERSION on non-None namespaces" by@auvipy in#9335
• SearchFilter.get_search_terms returns list. by@tomchristie in#9338
• Version 3.15.1 by@tomchristie in#9339

New Contributors

• @maycuatroi made their first contribution in#9287
• @alexdlaird made their first contribution in#9301

Full Changelog:3.15.0...3.15.1

Contributors

• Django 2.2 is no longer supported.#8662
• Django 4.1 compatibility.#8591
• Add--api-version CLI option togenerateschema management command.#8663
• Enforceis_valid(raise_exception=False) as a keyword-only argument.#7952
• Stop callingset_context on Validators.#8589
• ReturnNotImplemented fromErrorDetails.__ne__.#8538
• Don't evaluateDateTimeField.default_timezone when a custom timezone is set.#8531
• Make relative URLs clickable in Browseable API.#8464
• SupportManyRelatedField falling back to the default value when the attribute specified by dot notation doesn't exist. MatchesManyRelatedField.get_attribute toField.get_attribute.#7574
• Makeschemas.openapi.get_reference public.#7515
• MakeReturnDict supportdict union operators on Python 3.9 and later.#8302
• Update throttling to check ifrequest.user is set before checking if the user is authenticated.#8370

• Revert schema naming changes with function based@api_view.#8297

• Django 4.0 compatability.#8178
• Addmax_length andmin_length options toListSerializer.#8165
• Addget_request_serializer andget_response_serializer hooks toAutoSchema.#7424
• Fix OpenAPI representation of null-able read only fields.#8116
• RespectUNICODE_JSON setting in API schema outputs.#7991
• Fix forRemoteUserAuthentication.#7158
• Make Field constructors keyword-only.#7632

This is the last Django REST Framework release that will support Python 2.
Be sure to upgrade to Python 3 before upgrading to Django REST Framework 3.10.

• Adjusted the compat check for django-guardian to allow the last guardian
  version (v1.4.9) compatible with Python 2.#6613

SeeRelease Notes for details.

Change Notes:
https://www.django-rest-framework.org/community/release-notes/#39x-series