Add Python 3.14 support

Replace deprecated datetime.utcnow() and datetime.utcfromtimestamp()
with timezone-aware equivalents using datetime.now(tz=timezone.utc) and
datetime.fromtimestamp(tz=timezone.utc) to avoid DeprecationWarnings
on Python 3.14.

Guard locale.getdefaultlocale() with hasattr check for its removal in
Python 3.15+.

Add monkey-patch for Django 3.2's BaseContext.__copy__ which breaks on
Python 3.14 because super() objects no longer support __dict__ attribute
setting. Guard the import with try/except ImportError so pip install
succeeds before Django is installed.

Update CI matrices, tox.ini, and setup.py to include Python 3.14 with
upper bound extended to <3.15.

Fixes #13823

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rtibblesbot

.github/workflows/morango_integration.yml

@@ -30,7 +30,7 @@ jobs:
       INTEGRATION_TEST: 'true'
     strategy:
       matrix:
-        python-version: [3.9, '3.10', '3.11', '3.12', '3.13']
+        python-version: [3.9, '3.10', '3.11', '3.12', '3.13', '3.14']
 
     steps:
       - name: Checkout repository

.github/workflows/pr_build_kolibri.yml

@@ -105,7 +105,7 @@ jobs:
     needs: whl
     strategy:
       matrix:
-        python-version: [3.9, '3.10', '3.11', '3.12', '3.13']
+        python-version: [3.9, '3.10', '3.11', '3.12', '3.13', '3.14']
         cext: [true, false]
     runs-on: ubuntu-latest
     steps:

.github/workflows/tox.yml

@@ -30,7 +30,7 @@ jobs:
     strategy:
       max-parallel: 5
       matrix:
-        python-version: [3.9, '3.10', '3.11', '3.12', '3.13']
+        python-version: [3.9, '3.10', '3.11', '3.12', '3.13', '3.14']
 
     steps:
     - uses: actions/checkout@v6

kolibri/core/auth/api.py

@@ -2,6 +2,7 @@
 import time
 from datetime import datetime
 from datetime import timedelta
+from datetime import timezone
 from itertools import groupby
 from uuid import UUID
 from uuid import uuid4
@@ -1358,7 +1359,7 @@ def get_session_response(self, request):
             }
         )
 
-        visitor_cookie_expiry = datetime.utcnow() + timedelta(days=365)
+        visitor_cookie_expiry = datetime.now(tz=timezone.utc) + timedelta(days=365)
 
         if isinstance(user, AnonymousUser):
             response = Response(session)

kolibri/core/tasks/test/taskrunner/test_scheduler.py

@@ -93,7 +93,7 @@ def test_schedule_a_function_gives_value_error_repeat_zero_interval(
     def test_schedule_a_function_gives_value_error_not_timezone_aware_datetime(
         self, job_storage, job
     ):
-        now = datetime.datetime.utcnow()
+        now = datetime.datetime.now()
         with pytest.raises(ValueError) as error:
             job_storage.schedule(now, job)
             assert "timezone aware datetime object" in str(error.value)

kolibri/plugins/facility/views.py

@@ -1,6 +1,7 @@
 import json
 import logging
 from datetime import datetime as dt
+from datetime import timezone
 
 from django.core.exceptions import PermissionDenied
 from django.core.files.storage import default_storage
@@ -82,7 +83,9 @@ def first_log_date(request, facility_id):
         .order_by("start_timestamp")
         .first()
     )
-    first_log_date = first_log.start_timestamp if first_log is not None else dt.utcnow()
+    first_log_date = (
+        first_log.start_timestamp if first_log is not None else dt.now(tz=timezone.utc)
+    )
     response = {
         "first_log_date": first_log_date.isoformat(),
     }

kolibri/utils/env.py

@@ -143,6 +143,29 @@ def forward_port_cgi_module():
     sys.modules["cgi"] = module
 
 
+def monkey_patch_base_context():
+    """
+    Monkey patch Django's BaseContext.__copy__ for Python 3.14 compatibility.
+    In Python 3.14, super() objects no longer support __dict__ attribute setting,
+    which breaks Django 3.2's BaseContext.__copy__ that does copy(super()).
+    This can be removed when we upgrade to Django 4.2+.
+    """
+    if sys.version_info < (3, 14):
+        return
+    try:
+        from django.template.context import BaseContext
+    except ImportError:
+        return
+
+    def __copy__(self):
+        duplicate = object.__new__(self.__class__)
+        duplicate.__dict__.update(self.__dict__)
+        duplicate.dicts = self.dicts[:]
+        return duplicate
+
+    BaseContext.__copy__ = __copy__
+
+
 def set_env():
     """
     Sets the Kolibri environment for the CLI or other application worker
@@ -166,6 +189,7 @@ def set_env():
 
     # Depends on Django, so we need to wait until our dist has been registered.
     forward_port_cgi_module()
+    monkey_patch_base_context()
 
     # Set default env
     for key, value in ENVIRONMENT_VARIABLES.items():

kolibri/utils/i18n.py

@@ -80,7 +80,12 @@ def _get_language_info():
 
 
 def get_system_default_language():
-    for loc in (locale.getlocale()[0], locale.getdefaultlocale()[0]):
+    if hasattr(locale, "getdefaultlocale"):
+        default_locale = locale.getdefaultlocale()[0]
+    else:
+        # locale.getdefaultlocale() removed in Python 3.15+
+        default_locale = None
+    for loc in (locale.getlocale()[0], default_locale):
         if loc:
             lang = to_language(loc)
             for lang_code in (lang, lang.split("-")[0]):

kolibri/utils/version.py

@@ -133,7 +133,9 @@ def get_git_changeset():
         # This does not fail if git is not available or current dir isn't a git
         # repo - it's safe.
         timestamp = git_log.communicate()[0]
-        timestamp = datetime.datetime.utcfromtimestamp(int(timestamp))
+        timestamp = datetime.datetime.fromtimestamp(
+            int(timestamp), tz=datetime.timezone.utc
+        )
         # We have some issues because something normalizes separators to "."
         # From PEP440: With a local version, in addition to the use of . as a
         # separator of segments, the use of - and _ is also acceptable. The

setup.py

@@ -100,8 +100,9 @@ def run(self):
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
         "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
         "Programming Language :: Python :: Implementation :: PyPy",
     ],
     cmdclass={"install_scripts": gen_windows_batch_files},
-    python_requires=">=3.6,  <3.14",
+    python_requires=">=3.6,  <3.15",
 )