chore: add support for Django 4.2+, and drop support for Django 3.x. (#724)

https://endoflife.date/django

Author: overcat

.github/workflows/test.yml

@@ -11,19 +11,20 @@ on:
 
 jobs:
   test:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.13"]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
-      - name: Install Python
-        run: sudo apt-get update && sudo apt-get install -y python3.10-dev python3.10-venv
-      - name: Install Poetry
-        run: |
-          sudo mkdir -p /usr/local/poetry
-          sudo python3.10 -m venv /usr/local/poetry
-          sudo /usr/local/poetry/bin/pip install poetry
-          sudo ln -s /usr/local/poetry/bin/poetry /bin/poetry
-          export PATH=/bin:$PATH
+        uses: actions/checkout@v4
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install poetry
+        run: pip install poetry
       - name: Install Package
         run: poetry install
       - name: Test Package

README.rst

@@ -2,16 +2,22 @@
 Django Polaris
 ==============
 
-.. image:: https://circleci.com/gh/stellar/django-polaris.svg?style=shield
-    :target: https://circleci.com/gh/stellar/django-polaris
+.. image:: https://img.shields.io/github/actions/workflow/status/stellar/django-polaris/test.yml?branch=master
+    :alt: GitHub Workflow Status
+    :target: https://github.com/stellar/django-polaris/actions
 
 .. image:: https://codecov.io/gh/stellar/django-polaris/branch/master/graph/badge.svg?token=3DaW3jM6Q8
+    :alt: Code Coverage
     :target: https://codecov.io/gh/stellar/django-polaris
 
-.. image:: https://img.shields.io/badge/python-3.7%20%7C%20%7C%203.8%20%7C%203.9%20%7C%203.10-blue?style=shield
+.. image:: https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue?style=shield
     :alt: Python - Version
     :target: https://pypi.python.org/pypi/django-polaris
 
+.. image:: https://img.shields.io/badge/django-%3E=4.2-blue?style=shield
+    :alt: Django - Version
+    :target: https://pypi.python.org/pypi/django-polaris
+
 .. _`email list`: https://groups.google.com/g/stellar-polaris
 .. _Stellar Development Foundation: https://www.stellar.org/
 .. _github: https://github.com/stellar/django-polaris

docs/glossary.rst

@@ -307,7 +307,7 @@ Currently, multisignature asset support is only relevant in the context of SEP-6
 Rate Limiting
 =============
 
-.. _`custom middleware`: https://docs.djangoproject.com/en/3.2/topics/http/middleware/#writing-your-own-middleware
+.. _`custom middleware`: https://docs.djangoproject.com/en/5.1/topics/http/middleware/#writing-your-own-middleware
 
 It is highly encouraged to employ a rate limiting strategy when running Polaris to ensure the service
 remains available for all client applications. Many endpoints retrieve and create database records on

docs/index.rst

@@ -2,20 +2,26 @@
 Django Polaris
 ==============
 
-.. image:: https://circleci.com/gh/stellar/django-polaris.svg?style=shield
-    :target: https://circleci.com/gh/stellar/django-polaris
+.. image:: https://img.shields.io/github/actions/workflow/status/stellar/django-polaris/test.yml?branch=master
+    :alt: GitHub Workflow Status
+    :target: https://github.com/stellar/django-polaris/actions
 
 .. image:: https://codecov.io/gh/stellar/django-polaris/branch/master/graph/badge.svg?token=3DaW3jM6Q8
+    :alt: Code Coverage
     :target: https://codecov.io/gh/stellar/django-polaris
 
-.. image:: https://img.shields.io/badge/python-3.7%20%7C%20%7C%203.8%20%7C%203.9%20%7C%203.10-blue?style=shield
+.. image:: https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue?style=shield
     :alt: Python - Version
     :target: https://pypi.python.org/pypi/django-polaris
 
+.. image:: https://img.shields.io/badge/django-%3E=4.2-blue?style=shield
+    :alt: Django - Version
+    :target: https://pypi.python.org/pypi/django-polaris
+
 .. _`email list`: https://groups.google.com/g/stellar-polaris
 .. _Stellar Development Foundation: https://www.stellar.org/
 .. _github: https://github.com/stellar/django-polaris
-.. _django app: https://docs.djangoproject.com/en/3.0/intro/reusable-apps/
+.. _django app: https://docs.djangoproject.com/en/5.1/intro/reusable-apps/
 .. _`demo wallet`: http://demo-wallet.stellar.org
 
 Polaris is an extendable `django app`_ for Stellar Ecosystem Proposal (SEP) implementations

docs/installation.rst

@@ -100,7 +100,7 @@ Configure the Database
 ======================
 
 .. _Fernet symmetric encryption: https://cryptography.io/en/latest/fernet/
-.. _`supported by Django`: https://docs.djangoproject.com/en/3.2/ref/databases/
+.. _`supported by Django`: https://docs.djangoproject.com/en/5.1/ref/databases/
 .. _`SQLite3`: https://www.sqlite.org/index.html
 
 Polaris works with all databases `supported by Django`_. Django's template code uses `SQLite3`_ by default, but you can install your database driver of choice and update the ``DATABASES`` setting appropriately if you'd like.

docs/requirements.txt

@@ -1,60 +1,60 @@
-aiohttp-sse-client==0.2.1 ; python_version >= "3.8" and python_version < "4.0"
-aiohttp==3.9.5 ; python_version >= "3.8" and python_version < "4.0"
-aiosignal==1.3.1 ; python_version >= "3.8" and python_version < "4.0"
-alabaster==0.7.13 ; python_version >= "3.8" and python_version < "4.0"
-annotated-types==0.7.0 ; python_version >= "3.8" and python_version < "4.0"
-asgiref==3.8.1 ; python_version >= "3.8" and python_version < "4.0"
-async-timeout==4.0.3 ; python_version >= "3.8" and python_version < "3.11"
-attrs==23.2.0 ; python_version >= "3.8" and python_version < "4.0"
-babel==2.15.0 ; python_version >= "3.8" and python_version < "4.0"
-backports-zoneinfo==0.2.1 ; python_version >= "3.8" and python_version < "3.9"
-certifi==2024.6.2 ; python_version >= "3.8" and python_version < "4.0"
-cffi==1.16.0 ; python_version >= "3.8" and python_version < "4.0"
-charset-normalizer==3.3.2 ; python_version >= "3.8" and python_version < "4.0"
-colorama==0.4.6 ; python_version >= "3.8" and python_version < "4.0" and sys_platform == "win32"
-cryptography==41.0.7 ; python_version >= "3.8" and python_version < "4.0"
-django-cors-headers==3.14.0 ; python_version >= "3.8" and python_version < "4.0"
-django-environ==0.11.2 ; python_version >= "3.8" and python_version < "4"
-django-model-utils==4.5.1 ; python_version >= "3.8" and python_version < "4.0"
-django==3.2.25 ; python_version >= "3.8" and python_version < "4.0"
-djangorestframework==3.15.1 ; python_version >= "3.8" and python_version < "4.0"
-docutils==0.17.1 ; python_version >= "3.8" and python_version < "4.0"
-frozenlist==1.4.1 ; python_version >= "3.8" and python_version < "4.0"
-idna==3.7 ; python_version >= "3.8" and python_version < "4.0"
-imagesize==1.4.1 ; python_version >= "3.8" and python_version < "4.0"
-importlib-metadata==7.1.0 ; python_version >= "3.8" and python_version < "3.10"
-jinja2==3.1.4 ; python_version >= "3.8" and python_version < "4.0"
-markupsafe==2.1.5 ; python_version >= "3.8" and python_version < "4.0"
-mnemonic==0.20 ; python_version >= "3.8" and python_version < "4.0"
-multidict==6.0.5 ; python_version >= "3.8" and python_version < "4.0"
-packaging==24.1 ; python_version >= "3.8" and python_version < "4.0"
-pycparser==2.22 ; python_version >= "3.8" and python_version < "4.0"
-pydantic-core==2.18.4 ; python_version >= "3.8" and python_version < "4.0"
-pydantic==2.7.4 ; python_version >= "3.8" and python_version < "4.0"
-pygments==2.18.0 ; python_version >= "3.8" and python_version < "4.0"
-pyjwt==2.8.0 ; python_version >= "3.8" and python_version < "4.0"
-pynacl==1.5.0 ; python_version >= "3.8" and python_version < "4.0"
-pytz==2024.1 ; python_version >= "3.8" and python_version < "4.0"
-readthedocs-sphinx-ext==2.2.5 ; python_version >= "3.8" and python_version < "4.0"
-requests-sse==0.3.2 ; python_version >= "3.8" and python_version < "4.0"
-requests==2.32.3 ; python_version >= "3.8" and python_version < "4.0"
-snowballstemmer==2.2.0 ; python_version >= "3.8" and python_version < "4.0"
-sphinx-autodoc-typehints==1.19.1 ; python_version >= "3.8" and python_version < "4.0"
-sphinx-rtd-theme==1.3.0 ; python_version >= "3.8" and python_version < "4.0"
-sphinx==4.5.0 ; python_version >= "3.8" and python_version < "4.0"
-sphinxcontrib-applehelp==1.0.4 ; python_version >= "3.8" and python_version < "4.0"
-sphinxcontrib-devhelp==1.0.2 ; python_version >= "3.8" and python_version < "4.0"
-sphinxcontrib-htmlhelp==2.0.1 ; python_version >= "3.8" and python_version < "4.0"
-sphinxcontrib-jquery==4.1 ; python_version >= "3.8" and python_version < "4.0"
-sphinxcontrib-jsmath==1.0.1 ; python_version >= "3.8" and python_version < "4.0"
-sphinxcontrib-qthelp==1.0.3 ; python_version >= "3.8" and python_version < "4.0"
-sphinxcontrib-serializinghtml==1.1.5 ; python_version >= "3.8" and python_version < "4.0"
-sqlparse==0.4.4 ; python_version >= "3.8" and python_version < "4.0"
-stellar-sdk[aiohttp]==10.0.0 ; python_version >= "3.8" and python_version < "4.0"
-toml==0.10.2 ; python_version >= "3.8" and python_version < "4.0"
-typing-extensions==4.12.2 ; python_version >= "3.8" and python_version < "4.0"
-urllib3==2.2.1 ; python_version >= "3.8" and python_version < "4.0"
-whitenoise==5.3.0 ; python_version >= "3.8" and python_version < "4"
-xdrlib3==0.1.1 ; python_version >= "3.8" and python_version < "4.0"
-yarl==1.9.4 ; python_version >= "3.8" and python_version < "4.0"
-zipp==3.19.2 ; python_version >= "3.8" and python_version < "3.10"
+aiohappyeyeballs==2.4.6 ; python_version >= "3.10" and python_version < "4.0"
+aiohttp-sse-client==0.2.1 ; python_version >= "3.10" and python_version < "4.0"
+aiohttp==3.11.12 ; python_version >= "3.10" and python_version < "4.0"
+aiosignal==1.3.2 ; python_version >= "3.10" and python_version < "4.0"
+alabaster==0.7.16 ; python_version >= "3.10" and python_version < "4.0"
+annotated-types==0.7.0 ; python_version >= "3.10" and python_version < "4.0"
+asgiref==3.8.1 ; python_version >= "3.10" and python_version < "4.0"
+async-timeout==5.0.1 ; python_version >= "3.10" and python_version < "3.11"
+attrs==25.1.0 ; python_version >= "3.10" and python_version < "4.0"
+babel==2.17.0 ; python_version >= "3.10" and python_version < "4.0"
+certifi==2025.1.31 ; python_version >= "3.10" and python_version < "4.0"
+cffi==1.17.1 ; python_version >= "3.10" and python_version < "4.0"
+charset-normalizer==3.4.1 ; python_version >= "3.10" and python_version < "4.0"
+colorama==0.4.6 ; python_version >= "3.10" and python_version < "4.0" and sys_platform == "win32"
+cryptography==44.0.1 ; python_version >= "3.10" and python_version < "4.0"
+django-cors-headers==4.7.0 ; python_version >= "3.10" and python_version < "4.0"
+django-environ==0.12.0 ; python_version >= "3.10" and python_version < "4"
+django-model-utils==5.0.0 ; python_version >= "3.10" and python_version < "4.0"
+django==5.1.6 ; python_version >= "3.10" and python_version < "4.0"
+djangorestframework==3.15.2 ; python_version >= "3.10" and python_version < "4.0"
+docutils==0.17.1 ; python_version >= "3.10" and python_version < "4.0"
+frozenlist==1.5.0 ; python_version >= "3.10" and python_version < "4.0"
+idna==3.10 ; python_version >= "3.10" and python_version < "4.0"
+imagesize==1.4.1 ; python_version >= "3.10" and python_version < "4.0"
+jinja2==3.1.5 ; python_version >= "3.10" and python_version < "4.0"
+markupsafe==3.0.2 ; python_version >= "3.10" and python_version < "4.0"
+mnemonic==0.20 ; python_version >= "3.10" and python_version < "4.0"
+multidict==6.1.0 ; python_version >= "3.10" and python_version < "4.0"
+packaging==24.2 ; python_version >= "3.10" and python_version < "4.0"
+propcache==0.2.1 ; python_version >= "3.10" and python_version < "4.0"
+pycparser==2.22 ; python_version >= "3.10" and python_version < "4.0"
+pydantic-core==2.27.2 ; python_version >= "3.10" and python_version < "4.0"
+pydantic==2.10.6 ; python_version >= "3.10" and python_version < "4.0"
+pygments==2.19.1 ; python_version >= "3.10" and python_version < "4.0"
+pyjwt==2.10.1 ; python_version >= "3.10" and python_version < "4.0"
+pynacl==1.5.0 ; python_version >= "3.10" and python_version < "4.0"
+pytz==2025.1 ; python_version >= "3.10" and python_version < "4.0"
+readthedocs-sphinx-ext==2.2.5 ; python_version >= "3.10" and python_version < "4.0"
+requests-sse==0.3.2 ; python_version >= "3.10" and python_version < "4.0"
+requests==2.32.3 ; python_version >= "3.10" and python_version < "4.0"
+snowballstemmer==2.2.0 ; python_version >= "3.10" and python_version < "4.0"
+sphinx-autodoc-typehints==1.19.1 ; python_version >= "3.10" and python_version < "4.0"
+sphinx-rtd-theme==1.3.0 ; python_version >= "3.10" and python_version < "4.0"
+sphinx==4.5.0 ; python_version >= "3.10" and python_version < "4.0"
+sphinxcontrib-applehelp==2.0.0 ; python_version >= "3.10" and python_version < "4.0"
+sphinxcontrib-devhelp==2.0.0 ; python_version >= "3.10" and python_version < "4.0"
+sphinxcontrib-htmlhelp==2.1.0 ; python_version >= "3.10" and python_version < "4.0"
+sphinxcontrib-jquery==4.1 ; python_version >= "3.10" and python_version < "4.0"
+sphinxcontrib-jsmath==1.0.1 ; python_version >= "3.10" and python_version < "4.0"
+sphinxcontrib-qthelp==2.0.0 ; python_version >= "3.10" and python_version < "4.0"
+sphinxcontrib-serializinghtml==2.0.0 ; python_version >= "3.10" and python_version < "4.0"
+sqlparse==0.5.3 ; python_version >= "3.10" and python_version < "4.0"
+stellar-sdk[aiohttp]==12.1.0 ; python_version >= "3.10" and python_version < "4.0"
+toml==0.10.2 ; python_version >= "3.10" and python_version < "4.0"
+typing-extensions==4.12.2 ; python_version >= "3.10" and python_version < "4.0"
+tzdata==2025.1 ; python_version >= "3.10" and python_version < "4.0" and sys_platform == "win32"
+urllib3==2.3.0 ; python_version >= "3.10" and python_version < "4.0"
+whitenoise==6.9.0 ; python_version >= "3.10" and python_version < "4.0"
+xdrlib3==0.1.1 ; python_version >= "3.10" and python_version < "4.0"
+yarl==1.18.3 ; python_version >= "3.10" and python_version < "4.0"

docs/sep-24.rst

@@ -12,7 +12,7 @@ SEP-24 is the `hosted` version of this solution, meaning the user's application
 Configure Settings
 ==================
 
-.. _`SessionMiddleware`: https://docs.djangoproject.com/en/3.2/ref/middleware/#module-django.contrib.sessions.middleware
+.. _`SessionMiddleware`: https://docs.djangoproject.com/en/5.1/ref/middleware/#module-django.contrib.sessions.middleware
 
 Activate SEP-24
 ---------------
@@ -69,7 +69,7 @@ Polaris requires this setting to be ``True`` for SEP-24 deployments if not in ``
 Configure Static Assets
 -----------------------
 
-.. _serving static files: https://docs.djangoproject.com/en/3.0/howto/static-files/
+.. _serving static files: https://docs.djangoproject.com/en/5.1/howto/static-files/
 
 Polaris comes with a UI for displaying forms and transaction information. This UI will be rendered in a webview by the user's application when they initiate a deposit or withdrawal.
 
@@ -200,7 +200,7 @@ However, the values assigned to the :class:`~polaris.models.Asset` are fixed. If
 Defining Django Forms
 ---------------------
 
-.. _`Django form objects`: https://docs.djangoproject.com/en/3.2/topics/forms/#building-a-form-in-django
+.. _`Django form objects`: https://docs.djangoproject.com/en/5.1/topics/forms/#building-a-form-in-django
 
 SEP-24 anchors must implement a user web-based interface that collects KYC and transaction information from the user of the client application. Because the information necessary to complete transactions differs for each business, Polaris expects the anchor to provide `Django form objects`_ that can be rendered as HTML to the user.
 
@@ -369,9 +369,9 @@ Once you've implemented the integration functions, you need to register them via
 Working with Templates
 ----------------------
 
-.. _`Django's template system`: https://docs.djangoproject.com/en/3.1/ref/templates/
-.. _`template syntax documentation`: https://docs.djangoproject.com/en/3.1/ref/templates/language/#
-.. _`block documentation`: https://docs.djangoproject.com/en/3.1/ref/templates/language/#template-inheritance
+.. _`Django's template system`: https://docs.djangoproject.com/en/5.1/ref/templates/
+.. _`template syntax documentation`: https://docs.djangoproject.com/en/5.1/ref/templates/language/#the-django-template-language
+.. _`block documentation`: https://docs.djangoproject.com/en/5.1/ref/templates/language/#template-inheritance
 
 Polaris uses `Django's template system`_ for defining the UI content rendered to users. If you're interested in customizing Polaris' UI, read Django's template documentation before continuing.
 
@@ -463,7 +463,7 @@ Simply include a `template_name` key in the dictionary returned by :meth:`~polar
 Providing Context to Templates
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. _`context`: https://docs.djangoproject.com/en/3.1/ref/templates/api/#rendering-a-context
+.. _`context`: https://docs.djangoproject.com/en/5.1/ref/templates/api/#rendering-a-context
 
 Whenever a template is rendered and displayed to the user, its rendered using a `context`_, which is a Python dictionary containing key-value pairs that can be used to alter the content rendered.