Merge pull request matplotlib#31740 from rcomer/bump-python

MNT: bump minimum python to 3.12 and minimum numpy to 2.0

Author: tacaswell

.appveyor.yml

@@ -28,7 +28,7 @@ environment:
                  --cov-report= --cov=lib --log-level=DEBUG
 
   matrix:
-    - PYTHON_VERSION: "3.11"
+    - PYTHON_VERSION: "3.12"
 
 # We always use a 64-bit machine, but can build x86 distributions
 # with the PYTHON_ARCH variable

.github/workflows/cibuildwheel.yml

@@ -50,7 +50,7 @@ jobs:
       - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         name: Install Python
         with:
-          python-version: '3.11'
+          python-version: '3.12'
 
       # Something changed somewhere that prevents the downloaded-at-build-time
       # licenses from being included in built wheels, so pre-download them so
@@ -176,24 +176,6 @@ jobs:
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
-      - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084  # v3.4.1
-        with:
-          package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
-        env:
-          CIBW_BUILD: "cp311-*"
-          CIBW_ARCHS: ${{ matrix.cibw_archs }}
-
-      - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084  # v3.4.1
-        with:
-          package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
-        env:
-          CIBW_BUILD: "pp311-*"
-          CIBW_ARCHS: ${{ matrix.cibw_archs }}
-          CIBW_ENABLE: pypy
-        if: matrix.cibw_archs != 'aarch64' && matrix.os != 'windows-latest' && matrix.os != 'windows-11-arm'
-
       - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
         with:
           name: cibw-wheels-${{ runner.os }}-${{ matrix.cibw_archs }}

.github/workflows/cygwin.yml

@@ -186,10 +186,6 @@ jobs:
              python -c 'import PyQt5.QtCore' &&
              echo 'PyQt5 is available' ||
              echo 'PyQt5 is not available'
-          python -mpip install --upgrade pyside2 &&
-              python -c 'import PySide2.QtCore' &&
-              echo 'PySide2 is available' ||
-              echo 'PySide2 is not available'
           python -m pip uninstall --yes wxpython || echo 'wxPython already uninstalled'
 
       - name: Install Matplotlib

.github/workflows/linting.yml

@@ -36,7 +36,7 @@ jobs:
       - name: Set up Python 3
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
-          python-version: '3.11'
+          python-version: '3.12'
 
       - name: Install ruff
         run: pip3 install ruff
@@ -66,7 +66,7 @@ jobs:
       - name: Set up Python 3
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
-          python-version: '3.11'
+          python-version: '3.12'
 
       - name: Install mypy
         run: pip3 install --group build --group typing

.github/workflows/mypy-stubtest.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Set up Python 3
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
-          python-version: '3.11'
+          python-version: '3.12'
 
       - name: Set up reviewdog
         uses: reviewdog/action-setup@d8a7baabd7f3e8544ee4dbde3ee41d0011c3a93f  # v1.5.0
@@ -33,7 +33,7 @@ jobs:
         run: |
           set -o pipefail
           tox -e stubtest | \
-              sed -e "s!.tox/stubtest/lib/python3.11/site-packages!lib!g" | \
+              sed -e "s!.tox/stubtest/lib/python3.12/site-packages!lib!g" | \
               reviewdog \
                 -efm '%Eerror: %m' \
                 -efm '%CStub: in file %f:%l' \

.github/workflows/tests.yml

@@ -51,13 +51,13 @@ jobs:
         include:
           - name-suffix: "(Minimum Versions)"
             os: ubuntu-22.04
-            python-version: '3.11'
+            python-version: '3.12'
             extra-requirements: '-c ci/minver-requirements.txt'
             delete-font-cache: true
             # https://github.com/matplotlib/matplotlib/issues/29844
             pygobject-ver: '<3.52.0'
           - os: ubuntu-22.04
-            python-version: '3.11'
+            python-version: '3.12'
             CFLAGS: "-fno-lto"  # Ensure that disabling LTO works.
             extra-requirements: '--group test-extra'
             # https://github.com/matplotlib/matplotlib/issues/29844
@@ -73,16 +73,10 @@ jobs:
             python-version: '3.13t'
             # https://github.com/matplotlib/matplotlib/issues/29844
             pygobject-ver: '<3.52.0'
-          - os: ubuntu-24.04
-            python-version: '3.12'
           - os: ubuntu-24.04
             python-version: '3.14'
           - os: ubuntu-24.04-arm
             python-version: '3.12'
-          - os: macos-14  # This runner is on M1 (arm64) chips.
-            python-version: '3.11'
-            # https://github.com/matplotlib/matplotlib/issues/29732
-            pygobject-ver: '<3.52.0'
           - os: macos-14  # This runner is on M1 (arm64) chips.
             python-version: '3.12'
             # https://github.com/matplotlib/matplotlib/issues/29732
@@ -267,16 +261,6 @@ jobs:
               echo 'PyQt5 is available' ||
               echo 'PyQt5 is not available'
           fi
-          # Even though PySide2 wheels can be installed on Python 3.12+, they are broken and since PySide2 is
-          # deprecated, they are unlikely to be fixed. For the same deprecation reason, there are no wheels
-          # on M1 macOS, so don't bother there either.
-          if [[ "${{ matrix.os }}" != 'macos-14' && "${{ matrix.python-version }}" == '3.11'
-                ]]; then
-            python -mpip install --upgrade pyside2 &&
-              python -c 'import PySide2.QtCore' &&
-              echo 'PySide2 is available' ||
-              echo 'PySide2 is not available'
-          fi
           python -mpip install --upgrade --only-binary :all: pyqt6 &&
             python -c 'import PyQt6.QtCore' &&
             echo 'PyQt6 is available' ||

azure-pipelines.yml

@@ -49,11 +49,8 @@ stages:
       - job: Pytest
         strategy:
           matrix:
-            Windows_py311:
-              vmImage: 'windows-2022'  # Keep one job pinned to the oldest image
-              python.version: '3.11'
             Windows_py312:
-              vmImage: 'windows-latest'
+              vmImage: 'windows-2022'  # Keep one job pinned to the oldest image
               python.version: '3.12'
             Windows_py313:
               vmImage: 'windows-latest'

ci/minver-requirements.txt

@@ -1,13 +1,13 @@
 # Extra pip requirements for the minimum-version CI run
 
-contourpy==1.0.1
+contourpy==1.2.1
 cycler==0.10
 fonttools==4.22.0
 importlib-resources==3.2.0
 kiwisolver==1.3.2
 meson-python==0.13.2
 meson==1.1.0
-numpy==1.25.0
+numpy==2.0.0
 packaging==20.0
 pillow==9.0.1
 pyparsing==3.0.0

doc/api/backend_qt_api.rst

@@ -22,10 +22,9 @@ a dependency to building the docs.
 Qt Bindings
 -----------
 
-There are currently 2 actively supported Qt versions, Qt5 and Qt6, and two
-supported Python bindings per version -- `PyQt5
-<https://www.riverbankcomputing.com/static/Docs/PyQt5/>`_ and `PySide2
-<https://doc.qt.io/qtforpython-5/contents.html>`_ for Qt5 and `PyQt6
+There are currently 2 actively supported Qt versions, Qt5 and Qt6. `PyQt5
+<https://www.riverbankcomputing.com/static/Docs/PyQt5/>`_ is the supported
+Python binding for Qt5 and there are both `PyQt6
 <https://www.riverbankcomputing.com/static/Docs/PyQt6/>`_ and `PySide6
 <https://doc.qt.io/qtforpython/contents.html>`_ for Qt6 [#]_.  Matplotlib's
 qtagg and qtcairo backends (``matplotlib.backends.backend_qtagg`` and
@@ -35,13 +34,12 @@ parts factored out in the ``matplotlib.backends.backend_qt`` module.
 At runtime, these backends select the actual binding used as follows:
 
 1. If a binding's ``QtCore`` subpackage is already imported, that binding is
-   selected (the order for the check is ``PyQt6``, ``PySide6``, ``PyQt5``,
-   ``PySide2``).
+   selected (the order for the check is ``PyQt6``, ``PySide6``, ``PyQt5``).
 2. If the :envvar:`QT_API` environment variable is set to one of "PyQt6",
-   "PySide6", "PyQt5", "PySide2" (case-insensitive), that binding is selected.
+   "PySide6", "PyQt5" (case-insensitive), that binding is selected.
    (See also the documentation on :ref:`environment-variables`.)
 3. Otherwise, the first available backend in the order ``PyQt6``, ``PySide6``,
-   ``PyQt5``, ``PySide2`` is selected.
+   ``PyQt5`` is selected.
 
 In the past, Matplotlib used to have separate backends for each version of Qt
 (e.g. qt4agg/``matplotlib.backends.backend_qt4agg`` and
@@ -62,8 +60,9 @@ change without warning [#]_.
 
 .. [#] There is also `PyQt4
        <https://www.riverbankcomputing.com/static/Docs/PyQt4/>`_ and `PySide
-       <https://srinikom.github.io/pyside-docs/>`_ for Qt4 but these are no
-       longer supported by Matplotlib and upstream support for Qt4 ended
+       <https://srinikom.github.io/pyside-docs/>`_ for Qt4 and `PySide2
+       <https://doc.qt.io/qtforpython-5/contents.html>`_ for Qt5 but these are
+       no longer supported by Matplotlib. Upstream support for Qt4 ended
        in 2015.
 .. [#] Despite the slight API differences, the more important distinction
        between the PyQt and Qt for Python series of bindings is licensing.

doc/api/next_api_changes/development/31740_REC.rst

@@ -0,0 +1,25 @@
+Increase to minimum supported versions of dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For Matplotlib 3.12, the :ref:`minimum supported versions <dependencies>` are being
+bumped:
+
++-------------+-----------------+----------------+
+| Dependency  |  min in mpl3.11 | min in mpl3.12 |
++=============+=================+================+
+|   Python    |       3.11      |      3.12      |
++-------------+-----------------+----------------+
+|   NumPy     |       1.25      |      2.0.0     |
++-------------+-----------------+----------------+
+|  Contourpy  |       1.0.1     |      1.2.1     |
++-------------+-----------------+----------------+
+
+This is consistent with our :ref:`min_deps_policy` and `SPEC0
+<https://scientific-python.org/specs/spec-0000/>`__
+
+
+PySide2 support
+~~~~~~~~~~~~~~~
+
+Support for the `PySide2 <https://doc.qt.io/qtforpython-5/contents.html>`_ Qt5 Python
+binding has been dropped because PySide2 does not support Python 3.12+.