Drop support for Python 3.11 (#14153)

Author: AA-Turner

.github/workflows/main.yml

@@ -36,7 +36,6 @@ jobs:
       fail-fast: false
       matrix:
         python:
-        - "3.11"
         - "3.12"
         - "3.13"
         - "3.13t"

.ruff.toml

@@ -1,4 +1,4 @@
-target-version = "py311"  # Pin Ruff to Python 3.11
+target-version = "py312"  # Pin Ruff to Python 3.12
 line-length = 88
 output-format = "full"
 
@@ -9,9 +9,6 @@ extend-exclude = [
     "tests/roots/test-pycode/cp_1251_coded.py",  # Not UTF-8
 ]
 
-[per-file-target-version]
-"tests/roots/test-ext-autodoc/target/pep695.py" = "py312"
-
 [format]
 preview = true
 quote-style = "single"

CHANGES.rst

@@ -4,6 +4,8 @@ Release 9.1.0 (in development)
 Dependencies
 ------------
 
+* #14153: Drop Python 3.11 support.
+
 Incompatible changes
 --------------------
 

doc/internals/contributing.rst

@@ -201,18 +201,18 @@ of targets and allows testing against multiple different Python environments:
 
      tox -av
 
-* To run unit tests for a specific Python version, such as Python 3.13:
+* To run unit tests for a specific Python version, such as Python 3.14:
 
   .. code-block:: shell
 
-     tox -e py313
+     tox -e py314
 
 * Arguments to :program:`pytest` can be passed via :program:`tox`,
   e.g., in order to run a particular test:
 
   .. code-block:: shell
 
-     tox -e py313 tests/test_module.py::test_new_feature
+     tox -e py314 tests/test_module.py::test_new_feature
 
 You can also test by installing dependencies in your local environment:
 

doc/tutorial/deploying.rst

@@ -249,7 +249,7 @@ After you have published your sources on GitLab, create a file named
 
    pages:
      stage: deploy
-     image: python:3.12-slim
+     image: python:3.14-slim
      before_script:
        - apt-get update && apt-get install make --no-install-recommends -y
        - python -m pip install sphinx furo

doc/usage/extensions/doctest.rst

@@ -116,10 +116,10 @@ a comma-separated list of group names.
 
       Specify the required Python version for the example to be tested. For instance,
       in the following case the example will be tested only for Python versions greater
-      than 3.12::
+      than 3.14::
 
          .. doctest::
-            :pyversion: > 3.12
+            :pyversion: > 3.14
 
       The following operands are supported:
 

doc/usage/installation.rst

@@ -152,18 +152,18 @@ Install either ``python3x-sphinx`` using :command:`port`:
 
 ::
 
-   $ sudo port install py313-sphinx
+   $ sudo port install py314-sphinx
 
 To set up the executable paths, use the ``port select`` command:
 
 ::
 
-   $ sudo port select --set python python313
-   $ sudo port select --set sphinx py313-sphinx
+   $ sudo port select --set python python314
+   $ sudo port select --set sphinx py314-sphinx
 
 For more information, refer to the `package overview`__.
 
-__ https://www.macports.org/ports.php?by=library&substr=py313-sphinx
+__ https://www.macports.org/ports.php?by=library&substr=py314-sphinx
 
 Windows
 ~~~~~~~

pyproject.toml

@@ -17,7 +17,7 @@ license = "BSD-2-Clause"
 license-files = [
     "LICENSE.rst",
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 
 # Classifiers list: https://pypi.org/classifiers/
 classifiers = [
@@ -35,7 +35,6 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
@@ -180,7 +179,7 @@ files = [
 exclude = [
     "tests/roots",
 ]
-python_version = "3.11"
+python_version = "3.12"
 strict = true
 show_column_numbers = true
 show_error_context = true

pyrefly.toml

@@ -15,7 +15,7 @@ project_includes = [
 project_excludes = [
     "**/tests/roots*",
 ]
-python_version = "3.11"
+python_version = "3.12"
 replace_imports_with_any = [
     "imagesize",
     "pyximport",

sphinx/_cli/__init__.py

@@ -36,12 +36,10 @@
 
 if TYPE_CHECKING:
     from collections.abc import Callable, Iterable, Iterator, Sequence
-    from typing import NoReturn, TypeAlias
+    from typing import NoReturn
 
-    _PARSER_SETUP: TypeAlias = Callable[
-        [argparse.ArgumentParser], argparse.ArgumentParser
-    ]
-    _RUNNER: TypeAlias = Callable[[argparse.Namespace], int]
+    type _PARSER_SETUP = Callable[[argparse.ArgumentParser], argparse.ArgumentParser]
+    type _RUNNER = Callable[[argparse.Namespace], int]
 
     from typing import Protocol