chore: drop Python 3.11 support by feanil · Pull Request #38125 · openedx/openedx-platform

feanil · 2026-03-08T12:30:44Z

Summary

Drop Python 3.11 support: remove from CI test matrix, tox envlist, and package classifiers
Regenerate pinned requirements using Python 3.12

Context

Python 3.11 is being dropped across the Open edX ecosystem as part of the move
to standardize on Python 3.12. See the tracking issue for the full list of repos:
openedx/public-engineering#499

Test plan

CI passes with Python 3.12 only

feanil · 2026-03-12T16:51:46Z

cms/envs/devstack.py

    Please see separately provided documentation.
    \n - How to test: You must be logged in as course author for whatever course you want to test with.
-    You can use the [Swagger UI](https://{CMS_BASE}/authoring-api/ui/) to "Try out" the API with your test course. To do this, you must select the "Local" server.
+    You can use the [Swagger UI](https://{CMS_BASE}/authoring-api/ui/) to "Try out" the API


Note for Reviews: Fix due to a newer version of pylint getting pulled in which is stricter about line lenght and better at detecting this violation.

feanil · 2026-03-13T13:59:15Z

The two checks that are yellow are the old 3.11 required checks which we don't need because equivalent 3.12 checks are now running. I'll update the required checks list before merging this.

Agrendalath

@feanil, Python 3.11 is still used in the following places:

openedx-platform/.readthedocs.yaml

Line 6 in 4c07b49

python: "3.11"
openedx-platform/README.rst

Line 81 in 4c07b49

* Python 3.11 or 3.12

openedx-platform/scripts/structures_pruning/README.rst

Lines 32 to 37 in 4c07b49

    
           Create a Python virtual environment using Python 3.11: 
        
           .. code-block:: bash 
        
               python3.11 -m venv ../venv 
        
               source ../venv/bin/activate

openedx-platform/scripts/user_retirement/README.rst

Lines 31 to 36 in 4c07b49

    
           Create a Python virtual environment using Python 3.11: 
        
           .. code-block:: bash 
        
               python3.11 -m venv ../venv 
        
               source ../venv/bin/activate

openedx-platform/tox.ini

Line 2 in 4c07b49

envlist = py{311} quality

(Do we even use tox in this repo?)

Agrendalath · 2026-03-13T15:04:41Z

.github/workflows/unit-tests.yml

        # It's useful to run some subset of the tests on the older version of Ubuntu
        # so that we don't spend too many resources on this but can find major issues quickly
        # while we're in a situation where we support two versions.  This section may be commented
        # out when not in use to easily add/drop future support for any given major dependency.
        #
        # We're testing the older version of Ubuntu and running the xmodule tests since those rely on many
        # dependent complex libraries and will hopefully catch most issues quickly.
-        include:
-          - shard_name: "xmodule-with-cms"
-            python-version: "3.11"
-            django-version: "pinned"
-            mongo-version: "7.0"
-            os-version: "ubuntu-22.04"
-          - shard_name: "xmodule-with-lms"
-            python-version: "3.11"
-            django-version: "pinned"
-            mongo-version: "7.0"
-            os-version: "ubuntu-22.04"
-


Should we comment it out instead of removing (like described in the comment)? Or should we remove the comment as well?

Ah good catch, I'll add this back. We'll want it for future upgrades.

@feanil, tiny nit - you have restored this code between the comment lines (instead of adding it below them).

Remove Python 3.11 from all CI workflow matrices and update requires-python to >=3.12 in pyproject.toml. Also remove ubuntu-22.04 compatibility include entries from unit-tests.yml that were tied to Python 3.11 testing. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

pylint was upgraded from 3.x to 4.x by make upgrade, which now enforces the 120-char line limit more strictly. - cms/envs/devstack.py, production.py: split long lines in triple-quoted string literals (Markdown text, so Python newlines become spaces — no content change) - test_containers.py: add pylint disable/enable around OLX assertion block where XML attribute strings cannot be split Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

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

setuptools 82+ removed pkg_resources, which pyfilesystem2 (fs) still uses for namespace package declarations. The constraints.txt pin handles this for full installs, but the static-assets-check workflow only installs requirements/edx/assets.txt. Pre-installing pip-tools.txt ensures setuptools 81.x is in place before the assets install runs. See: PyFilesystem/pyfilesystem2#577 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Agrendalath · 2026-03-16T19:04:42Z

.github/workflows/unit-tests.yml

        # It's useful to run some subset of the tests on the older version of Ubuntu
        # so that we don't spend too many resources on this but can find major issues quickly
        # while we're in a situation where we support two versions.  This section may be commented
        # out when not in use to easily add/drop future support for any given major dependency.
        #
        # We're testing the older version of Ubuntu and running the xmodule tests since those rely on many
        # dependent complex libraries and will hopefully catch most issues quickly.
-        include:
-          - shard_name: "xmodule-with-cms"
-            python-version: "3.11"
-            django-version: "pinned"
-            mongo-version: "7.0"
-            os-version: "ubuntu-22.04"
-          - shard_name: "xmodule-with-lms"
-            python-version: "3.11"
-            django-version: "pinned"
-            mongo-version: "7.0"
-            os-version: "ubuntu-22.04"
-


@feanil, tiny nit - you have restored this code between the comment lines (instead of adding it below them).

And add back and comment the old 3.11 tests for when we drop future major dependencies.

sameeramin

LGTM 👍🏼

feanil mentioned this pull request Mar 8, 2026

Drop Python 3.11 Testing openedx/public-engineering#499

Open

64 tasks

feanil force-pushed the feanil/drop_python_3.11 branch 2 times, most recently from 221ae18 to 620567e Compare March 12, 2026 16:50

feanil commented Mar 12, 2026

View reviewed changes

feanil marked this pull request as ready for review March 13, 2026 13:48

feanil requested a review from kdmccormick as a code owner March 13, 2026 13:48

feanil requested a review from a team March 13, 2026 14:01

Agrendalath reviewed Mar 13, 2026

View reviewed changes

feanil and others added 4 commits March 16, 2026 13:50

chore: regenerate requirements with Python 3.12

949e6e9

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

feanil force-pushed the feanil/drop_python_3.11 branch from 4c07b49 to 81bbeaa Compare March 16, 2026 17:58

feanil requested a review from Agrendalath March 16, 2026 17:58

Agrendalath approved these changes Mar 16, 2026

View reviewed changes

fix: Update more mentions of Python 3.11

ba8b7e4

And add back and comment the old 3.11 tests for when we drop future major dependencies.

feanil force-pushed the feanil/drop_python_3.11 branch from 81bbeaa to ba8b7e4 Compare March 17, 2026 00:45

sameeramin approved these changes Mar 17, 2026

View reviewed changes

feanil merged commit 875a38b into master Mar 17, 2026
51 checks passed

feanil deleted the feanil/drop_python_3.11 branch March 17, 2026 14:38

feanil linked an issue Mar 17, 2026 that may be closed by this pull request

[DEPR]: Python 3.11 Support #38171

Closed

feanil mentioned this pull request Mar 17, 2026

[DEPR]: Python 3.11 Support #38171

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore: drop Python 3.11 support#38125

chore: drop Python 3.11 support#38125
feanil merged 5 commits intomasterfrom
feanil/drop_python_3.11

feanil commented Mar 8, 2026 •

edited

Loading

Uh oh!

feanil Mar 12, 2026

Uh oh!

feanil commented Mar 13, 2026

Uh oh!

Agrendalath left a comment

Uh oh!

Agrendalath Mar 13, 2026

Uh oh!

feanil Mar 16, 2026

Uh oh!

Agrendalath Mar 16, 2026

Uh oh!

Agrendalath Mar 16, 2026

Uh oh!

sameeramin left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

	Create a Python virtual environment using Python 3.11:

	.. code-block:: bash

	python3.11 -m venv ../venv
	source ../venv/bin/activate

Conversation

feanil commented Mar 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Context

Test plan

Uh oh!

feanil Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

feanil commented Mar 13, 2026

Uh oh!

Agrendalath left a comment

Choose a reason for hiding this comment

Uh oh!

Agrendalath Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

feanil Mar 16, 2026

Choose a reason for hiding this comment

Uh oh!

Agrendalath Mar 16, 2026

Choose a reason for hiding this comment

Uh oh!

Agrendalath Mar 16, 2026

Choose a reason for hiding this comment

Uh oh!

sameeramin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

feanil commented Mar 8, 2026 •

edited

Loading