Merge branch 'main' into improve-many-true-validation-guidance

zainnadeem786 · web-flow · commit 781cf7ea77b5 · 2026-03-27T22:30:42.000+05:00
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -23,6 +23,7 @@ env:
 jobs:
   build:
     name: Build distribution 📦
+    if: github.repository == 'encode/django-rest-framework'
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v6
diff --git a/docs/community/release-notes.md b/docs/community/release-notes.md
@@ -36,6 +36,105 @@ You can determine your currently installed version using `pip show`:
 
 ---
 
+## 3.17.x series
+
+### 3.17.1
+
+**Date**: 24th March 2026
+
+#### Bug fixes
+
+* Fix `HTMLFormRenderer` with empty `datetime` values by [@p-r-a-v-i-n](https://github.com/p-r-a-v-i-n) in [#9928](https://github.com/encode/django-rest-framework/pull/9928)
+
+**Full Changelog**: [3.17.0...3.17.1](https://github.com/encode/django-rest-framework/compare/3.17.0...3.17.1)
+
+### 3.17.0
+
+**Date**: 18th March 2026
+
+#### Breaking changes
+
+* Drop support for Python 3.9 by [@auvipy](https://github.com/auvipy) in [#9781](https://github.com/encode/django-rest-framework/pull/9781)
+* Drop deprecated coreapi support by [@browniebroke](https://github.com/browniebroke) in [#9895](https://github.com/encode/django-rest-framework/pull/9895)
+
+#### Features
+
+* Add Django 6.0 support by [@MehrazRumman](https://github.com/MehrazRumman) in [#9819](https://github.com/encode/django-rest-framework/pull/9819)
+* Add support for Python 3.14 by [@cclauss](https://github.com/cclauss) in [#9780](https://github.com/encode/django-rest-framework/pull/9780)
+* Add ability to specify output format for `DurationField` by [@sevdog](https://github.com/sevdog) in [#8532](https://github.com/encode/django-rest-framework/pull/8532)
+* Add missing decorators: `@versioning_class()`, `@content_negotiation_class()`, `@metadata_class()` for function-based views by [@qqii](https://github.com/qqii) in [#9719](https://github.com/encode/django-rest-framework/pull/9719)
+* Support `violation_error_code` and `violation_error_message` from `UniqueConstraint` in `UniqueTogetherValidator` by [@s-aleshin](https://github.com/s-aleshin) in [#9766](https://github.com/encode/django-rest-framework/pull/9766)
+* Add support for `ipaddress` objects in `JSONEncoder` by [@corenting](https://github.com/corenting) in [#9087](https://github.com/encode/django-rest-framework/pull/9087)
+* Add optional support to serialize `BigInteger` to string by [@HoodyH](https://github.com/HoodyH) in [#9775](https://github.com/encode/django-rest-framework/pull/9775)
+
+#### Bug fixes
+
+* Prevent small risk of `Token` overwrite by [@mahdirahimi1999](https://github.com/mahdirahimi1999) in [#9754](https://github.com/encode/django-rest-framework/pull/9754)
+* Fix `UniqueTogetherValidator` validation when condition references a read-only field by [@ticosax](https://github.com/ticosax) in [#9764](https://github.com/encode/django-rest-framework/pull/9764)
+* Fix validation on many to many field when `default=None` by [@Genarito](https://github.com/Genarito) in [#9790](https://github.com/encode/django-rest-framework/pull/9790)
+* Fix invalid SPDX license expression in `__init__.py` by [@TheFunctionalGuy](https://github.com/TheFunctionalGuy) in [#9799](https://github.com/encode/django-rest-framework/pull/9799)
+* Fix `HTMLFormRenderer` to ensure a valid `datetime-local` format by [@mgaligniana](https://github.com/mgaligniana) in [#9365](https://github.com/encode/django-rest-framework/pull/9365)
+* Fix mutable default arguments in OrderingFilter methods by [@killerdevildog](https://github.com/killerdevildog) in [#9742](https://github.com/encode/django-rest-framework/pull/9742)
+* Update TokenAdmin to respect USERNAME_FIELD of the user model by [@m000](https://github.com/m000) in [#9836](https://github.com/encode/django-rest-framework/pull/9836)
+* Preserve ordering in `MultipleChoiceField` by [@fbozhang](https://github.com/fbozhang) in [#9735](https://github.com/encode/django-rest-framework/pull/9735)
+
+#### Translations
+
+* Update French translation by [@SebCorbin](https://github.com/SebCorbin) in [#9770](https://github.com/encode/django-rest-framework/pull/9770)
+* Update Brazilian Portuguese translations by [@JVPinheiroReis](https://github.com/JVPinheiroReis) in [#9828](https://github.com/encode/django-rest-framework/pull/9828)
+* Fix and improve French translations by [@deronnax](https://github.com/deronnax) in [#9896](https://github.com/encode/django-rest-framework/pull/9896)
+* Add missing Russian translation by [@minorytanaka](https://github.com/minorytanaka) in [#9903](https://github.com/encode/django-rest-framework/pull/9903)
+
+#### Packaging
+
+* Migrate packaging to `pyproject.toml` by [@deronnax](https://github.com/deronnax) in [#9056](https://github.com/encode/django-rest-framework/pull/9056)
+* Move package data rules from `MANIFEST.in` to `pyproject.toml` by [@p-r-a-v-i-n](https://github.com/p-r-a-v-i-n) in [#9825](https://github.com/encode/django-rest-framework/pull/9825)
+* Set up release workflow with trusted publisher by [@browniebroke](https://github.com/browniebroke) in [#9852](https://github.com/encode/django-rest-framework/pull/9852)
+
+#### Other changes
+
+* Refactor token generation to use the `secrets` module by [@mahdirahimi1999](https://github.com/mahdirahimi1999) in [#9760](https://github.com/encode/django-rest-framework/pull/9760)
+* Add validation for decorator out-of-order with `@api_view` by [@kernelshard](https://github.com/kernelshard) in [#9821](https://github.com/encode/django-rest-framework/pull/9821)
+* Switch to mkdocs material theme for documentation by [@browniebroke](https://github.com/browniebroke) in [#9849](https://github.com/encode/django-rest-framework/pull/9849)
+
+#### New Contributors
+
+* [@khaledsukkar2](https://github.com/khaledsukkar2) made their first contribution in [#9717](https://github.com/encode/django-rest-framework/pull/9717)
+* [@qqii](https://github.com/qqii) made their first contribution in [#9719](https://github.com/encode/django-rest-framework/pull/9719)
+* [@zankoAn](https://github.com/zankoAn) made their first contribution in [#9788](https://github.com/encode/django-rest-framework/pull/9788)
+* [@uche-wealth](https://github.com/uche-wealth) made their first contribution in [#9795](https://github.com/encode/django-rest-framework/pull/9795)
+* [@s-aleshin](https://github.com/s-aleshin) made their first contribution in [#9766](https://github.com/encode/django-rest-framework/pull/9766)
+* [@Infamous003](https://github.com/Infamous003) made their first contribution in [#9794](https://github.com/encode/django-rest-framework/pull/9794)
+* [@Genarito](https://github.com/Genarito) made their first contribution in [#9790](https://github.com/encode/django-rest-framework/pull/9790)
+* [@TheFunctionalGuy](https://github.com/TheFunctionalGuy) made their first contribution in [#9799](https://github.com/encode/django-rest-framework/pull/9799)
+* [@mahdighadiriii](https://github.com/mahdighadiriii) made their first contribution in [#9800](https://github.com/encode/django-rest-framework/pull/9800)
+* [@p-r-a-v-i-n](https://github.com/p-r-a-v-i-n) made their first contribution in [#9801](https://github.com/encode/django-rest-framework/pull/9801)
+* [@itssimon](https://github.com/itssimon) made their first contribution in [#9718](https://github.com/encode/django-rest-framework/pull/9718)
+* [@huynguyengl99](https://github.com/huynguyengl99) made their first contribution in [#9785](https://github.com/encode/django-rest-framework/pull/9785)
+* [@corenting](https://github.com/corenting) made their first contribution in [#9087](https://github.com/encode/django-rest-framework/pull/9087)
+* [@killerdevildog](https://github.com/killerdevildog) made their first contribution in [#9742](https://github.com/encode/django-rest-framework/pull/9742)
+* [@dayandavid](https://github.com/dayandavid) made their first contribution in [#9820](https://github.com/encode/django-rest-framework/pull/9820)
+* [@abhishektiwari](https://github.com/abhishektiwari) made their first contribution in [#9826](https://github.com/encode/django-rest-framework/pull/9826)
+* [@HoodyH](https://github.com/HoodyH) made their first contribution in [#9775](https://github.com/encode/django-rest-framework/pull/9775)
+* [@Shrikantgiri25](https://github.com/Shrikantgiri25) made their first contribution in [#9808](https://github.com/encode/django-rest-framework/pull/9808)
+* [@JVPinheiroReis](https://github.com/JVPinheiroReis) made their first contribution in [#9828](https://github.com/encode/django-rest-framework/pull/9828)
+* [@m000](https://github.com/m000) made their first contribution in [#9836](https://github.com/encode/django-rest-framework/pull/9836)
+* [@Nabute](https://github.com/Nabute) made their first contribution in [#9767](https://github.com/encode/django-rest-framework/pull/9767)
+* [@therealjozber](https://github.com/therealjozber) made their first contribution in [#9845](https://github.com/encode/django-rest-framework/pull/9845)
+* [@nexapytech](https://github.com/nexapytech) made their first contribution in [#9867](https://github.com/encode/django-rest-framework/pull/9867)
+* [@RispaJoseph](https://github.com/RispaJoseph) made their first contribution in [#9874](https://github.com/encode/django-rest-framework/pull/9874)
+* [@LorenzoGuideri](https://github.com/LorenzoGuideri) made their first contribution in [#9875](https://github.com/encode/django-rest-framework/pull/9875)
+* [@maldoinc](https://github.com/maldoinc) made their first contribution in [#9893](https://github.com/encode/django-rest-framework/pull/9893)
+* [@0Nafi0](https://github.com/0Nafi0) made their first contribution in [#9861](https://github.com/encode/django-rest-framework/pull/9861)
+* [@MoeSalah1999](https://github.com/MoeSalah1999) made their first contribution in [#9870](https://github.com/encode/django-rest-framework/pull/9870)
+* [@kelsonbrito50](https://github.com/kelsonbrito50) made their first contribution in [#9901](https://github.com/encode/django-rest-framework/pull/9901)
+* [@fbozhang](https://github.com/fbozhang) made their first contribution in [#9735](https://github.com/encode/django-rest-framework/pull/9735)
+* [@minorytanaka](https://github.com/minorytanaka) made their first contribution in [#9903](https://github.com/encode/django-rest-framework/pull/9903)
+* [@kosbemrunal](https://github.com/kosbemrunal) made their first contribution in [#9904](https://github.com/encode/django-rest-framework/pull/9904)
+* [@htvictoire](https://github.com/htvictoire) made their first contribution in [#9916](https://github.com/encode/django-rest-framework/pull/9916)
+
+**Full Changelog**: [3.16.1...3.17.0](https://github.com/encode/django-rest-framework/compare/3.16.1...3.17.0)
+
 ## 3.16.x series
 
 ### 3.16.1
diff --git a/docs/community/tutorials-and-resources.md b/docs/community/tutorials-and-resources.md
@@ -6,16 +6,13 @@ There are a wide range of resources available for learning and using Django REST
 
 <div class="book-covers">
   <a class="book-cover" href="https://hellowebapp.com/order/">
-    <img src="../../img/books/hwa-cover.png"/>
+    <img src="../../img/books/hwa-cover.png" style="height: 300px"/>
   </a>
   <a class="book-cover" href="https://www.twoscoopspress.com/products/two-scoops-of-django-1-11">
-    <img src="../../img/books/tsd-cover.png"/>
+    <img src="../../img/books/tsd-cover.png" style="height: 300px"/>
   </a>
   <a class="book-cover" href="https://djangoforapis.com">
-    <img src="../../img/books/dfa-40-cover.jpg"/>
-  </a>
-  <a class="book-cover" href="https://books.agiliq.com/projects/django-api-polls-tutorial/en/latest/">
-    <img src="../../img/books/bda-cover.png"/>
+    <img src="../../img/books/dfa-40-cover.jpg" style="height: 300px"/>
   </a>
 </div>
 
@@ -43,7 +40,7 @@ There are a wide range of resources available for learning and using Django REST
 * [Django Polls Tutorial API][django-polls-api]
 * [Django REST Framework Tutorial: Todo API][django-rest-framework-todo-api]
 * [Tutorial: Django REST with React (Django 2.0)][django-rest-react-valentinog]
-
+* [Building APIs with Django and Django REST framework](https://books.agiliq.com/projects/django-api-polls-tutorial/en/latest/)
 
 ## Videos
 
@@ -137,4 +134,4 @@ Want your Django REST Framework talk/tutorial/article to be added to our website
 [django-rest-react-valentinog]: https://www.valentinog.com/blog/tutorial-api-django-rest-react/
 [doordash-implementing-rest-apis]: https://doordash.engineering/2013/10/07/implementing-rest-apis-with-embedded-privacy/
 [developing-restful-apis-with-django-rest-framework]: https://testdriven.io/courses/django-rest-framework/
-[django-con-2018]: https://youtu.be/pY-oje5b5Qk?si=AOU6tLi0IL1_pVzq
+[django-con-2018]: https://youtu.be/pY-oje5b5Qk?si=AOU6tLi0IL1_pVzq
diff --git a/docs/index.md b/docs/index.md
@@ -65,7 +65,7 @@ Some reasons you might want to use REST framework:
 
 REST framework requires the following:
 
-* Django (4.2, 5.0, 5.1, 5.2)
+* Django (4.2, 5.0, 5.1, 5.2, 6.0)
 * Python (3.10, 3.11, 3.12, 3.13, 3.14)
 
 We **highly recommend** and only officially support the latest patch release of
diff --git a/pyproject.toml b/pyproject.toml
@@ -56,7 +56,7 @@ test = [
 docs = [
   # MkDocs to build our documentation.
   "mkdocs==1.6.1",
-  "mkdocs-material[imaging]==9.7.4",
+  "mkdocs-material[imaging]==9.7.5",
   # pylinkvalidator to check for broken links in documentation.
   "pylinkvalidator==0.3",
 ]
diff --git a/rest_framework/__init__.py b/rest_framework/__init__.py
@@ -8,7 +8,7 @@
 """
 
 __title__ = 'Django REST framework'
-__version__ = '3.16.1'
+__version__ = '3.17.1'
 __author__ = 'Tom Christie'
 __license__ = 'BSD-3-Clause'
 __copyright__ = 'Copyright 2011-2023 Encode OSS Ltd'
diff --git a/rest_framework/renderers.py b/rest_framework/renderers.py
@@ -345,7 +345,7 @@ def render_field(self, field, parent_style):
             except AttributeError:
                 format_ = api_settings.DATETIME_FORMAT
 
-            if format_ is not None:
+            if format_ is not None and field.value not in (None, ''):
                 # field.value is expected to be a string
                 # https://www.django-rest-framework.org/api-guide/fields/#datetimefield
                 field_value = field.value
@@ -358,10 +358,11 @@ def render_field(self, field, parent_style):
                     else datetime.datetime.strptime(field_value, format_)
                 )
 
-            # The format of an input type="datetime-local" is "yyyy-MM-ddThh:mm"
-            # followed by optional ":ss" or ":ss.SSS", so keep only the first three
-            # digits of milliseconds to avoid browser console error.
-            field.value = field.value.replace(tzinfo=None).isoformat(timespec="milliseconds")
+            if isinstance(field.value, datetime.datetime):
+                # The format of an input type="datetime-local" is "yyyy-MM-ddThh:mm"
+                # followed by optional ":ss" or ":ss.SSS", so keep only the first three
+                # digits of milliseconds to avoid browser console error.
+                field.value = field.value.replace(tzinfo=None).isoformat(timespec="milliseconds")
 
         if 'template' in style:
             template_name = style['template']
diff --git a/tests/test_renderers.py b/tests/test_renderers.py
@@ -566,6 +566,22 @@ def test_datetime_field_rendering_timezone_aware_datetime(self):
             "2024-12-23T09:55:30.345"  # Rendered in -06:00
         )
 
+    def test_datetime_field_rendering_empty_string_raises_no_error(self):
+        """
+        Regression test for #9927 (issue):
+        Ensures that an empty string value doesn't cause a ValueError
+        when the HTMLFormRenderer tries to parse it via fromisoformat.
+        """
+        self._assert_datetime_rendering("", "")
+
+    def test_datetime_field_rendering_none_value_raises_no_error(self):
+        """
+        Additional regression coverage for #9927:
+        Ensures that a None value, which is converted to an empty string
+        by as_form_field(), doesn't cause a ValueError when rendered.
+        """
+        self._assert_datetime_rendering(None, "")
+
 
 class TestHTMLFormRenderer(TestCase):
     def setUp(self):

Original file line number	Diff line number	Diff line change
`@@ -56,7 +56,7 @@ test = [`
`56`	`56`	`docs = [`
`57`	`57`	`# MkDocs to build our documentation.`
`58`	`58`	`"mkdocs==1.6.1",`
`59`		`- "mkdocs-material[imaging]==9.7.4",`
	`59`	`+ "mkdocs-material[imaging]==9.7.5",`
`60`	`60`	`# pylinkvalidator to check for broken links in documentation.`
`61`	`61`	`"pylinkvalidator==0.3",`
`62`	`62`	`]`