feat!: add support for Django 5.2 (#148)

Adds support for Django 5.2

BREAKING CHANGE: drop support for Python versions less than 3.9 and Django versions less  than 4.2

Author: fgibertoni

.github/workflows/run-tests.yml

@@ -11,38 +11,32 @@ jobs:
   test:
     name: Test
 
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
         include:
-          # Django 3.2
-          - django-version: '>= 3.2, < 3.3'
-            python-version: "3.7"
-          - django-version: '>= 3.2, < 3.3'
-            python-version: "3.8"
-          - django-version: '>= 3.2, < 3.3'
-            python-version: "3.9"
-          - django-version: '>= 3.2, < 3.3'
+          # Django 4.0 - 4.1
+          - django-version: '>= 4.0, <= 4.2'
             python-version: "3.10"
 
-          # Django 4.0 - 4.1
-          - django-version: '>= 4.0, < 4.2'
-            python-version: "3.8"
-          - django-version: '>= 4.0, < 4.2'
-            python-version: "3.9"
-          - django-version: '>= 4.0, < 4.2'
+          # Django 5.0 - 5.2
+          - django-version: '>= 5.0, <= 5.2'
             python-version: "3.10"
+          - django-version: '>= 5.0, <= 5.2'
+            python-version: "3.11"
+          - django-version: '>= 5.0, <= 5.2'
+            python-version: "3.12"
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 
       - name: Install poetry
-        uses: abatilo/actions-poetry@v3
+        uses: abatilo/actions-poetry@v4
 
       - name: Install dependencies
         run: |
@@ -55,6 +49,6 @@ jobs:
           poetry run pytest --cov=rest_email_auth --cov-report=xml
 
       - name: Upload coverage report
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v5
         with:
           token: ${{ secrets.CODECOV_TOKEN }}

README.rst

@@ -38,9 +38,9 @@ Features:
 Compatibility
 *************
 
-| **Python:** 3.6 or later
-| **Django:** Versions 3.2 through 4.1
-| **Django REST Framework:** 3.14 or later
+| **Python:** 3.9 or later
+| **Django:** Versions 4.2 through 5.2
+| **Django REST Framework:** 3.16 or later
 
 ***************
 Adding Features

example_project/example_project/urls.py

@@ -18,10 +18,11 @@
 from django.contrib import admin
 
 from rest_framework.documentation import include_docs_urls
-
+from rest_framework.renderers import DocumentationRenderer
+from rest_framework.schemas import openapi
 
 urlpatterns = [
     path(r"account/", include("rest_email_auth.urls")),
     path(r"admin/", admin.site.urls),
-    path(r"docs/", include_docs_urls(title="Example Project")),
+    path(r"docs/", include_docs_urls(title="Example Project", renderer_classes=[DocumentationRenderer], generator_class=openapi.SchemaGenerator)),
 ]

poetry.lock

@@ -25,10 +25,10 @@ readme = "README.rst"
 packages = [{include = "rest_email_auth"}]
 
 [tool.poetry.dependencies]
-python = "^3.7"
-Django = ">=3.2, <5"
+python = "^3.9"
+Django = ">=4.2, <6"
 django-email-utils = "^1"
-djangorestframework = "^3.10"
+djangorestframework = "^3.16"
 
 [tool.poetry.group.ci]
 optional = true
@@ -38,7 +38,7 @@ optional = true
 coreapi = "~=2.3"
 
 [tool.poetry.group.dev.dependencies]
-factory_boy = "~=3.2"
+factory_boy = "~=3.3"
 pytest = "~=7.4"
 pytest-django = "~=4.5"
 pytest-cov = "~=4.1"

pyproject.toml

@@ -95,7 +95,8 @@ def test_serialize(email_factory):
 
     expected = {
         "id": email.id,
-        "created_at": email.created_at.isoformat(),
+        # DRF truncates last bytes and adds a Z for UTC timestamps
+        "created_at": email.created_at.isoformat()[:-6] + 'Z',
         "email": email.email,
         "is_primary": email.is_primary,
         "is_verified": email.is_verified,

rest_email_auth/tests/serializers/test_email_serializer.py

@@ -21,26 +21,27 @@ def get_description():
         "Development Status :: 5 - Production/Stable",
         # Supported versions of Django
         "Framework :: Django",
-        "Framework :: Django :: 3.2",
-        "Framework :: Django :: 4.0",
-        "Framework :: Django :: 4.1",
+        "Framework :: Django :: 4.2",
+        "Framework :: Django :: 5.2",
         "Intended Audience :: Developers",
         "License :: OSI Approved :: MIT License",
         "Natural Language :: English",
         # Supported versions of Python
         "Programming Language :: Python",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.6",
-        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
     ],
     # Include the actual source code
     include_package_data=True,
     packages=find_packages(),
     # Dependencies
     install_requires=[
-        "Django >= 3.2, <= 4.2",
+        "Django >= 4.2, <= 5.2",
         "django-email-utils >= 1.0, < 2.0",
         # DRF 3.10 is the first to support our minimum Django version of 2.2.
-        "djangorestframework >= 3.14",
+        "djangorestframework >= 3.16",
     ],
 )

setup.py

@@ -22,6 +22,19 @@
 
 ROOT_URLCONF = "test_urls"
 
+# Internationalization
+# https://docs.djangoproject.com/en/1.11/topics/i18n/
+
+LANGUAGE_CODE = "en-us"
+
+TIME_ZONE = "UTC"
+
+USE_I18N = True
+
+USE_L10N = True
+
+USE_TZ = True
+
 
 # Basic settings required for the app
 REST_EMAIL_AUTH = {