matplotlib · kyracho · Sep 19, 2024 · Oct 6, 2023 · Oct 6, 2023 · Oct 6, 2023
diff --git a/.appveyor.yml b/.appveyor.yml
@@ -17,7 +17,7 @@ skip_commits:
 
 clone_depth: 50
 
-image: Visual Studio 2017
+image: Visual Studio 2019
 
 environment:
 
@@ -45,8 +45,9 @@ cache:
 
 init:
   - ps:
+      # Pinned due to https://github.com/mamba-org/mamba/issues/3467
       Invoke-Webrequest
-      -URI https://micro.mamba.pm/api/micromamba/win-64/latest
+      -URI https://github.com/mamba-org/micromamba-releases/releases/download/1.5.10-0/micromamba-win-64.tar.bz2
       -OutFile C:\projects\micromamba.tar.bz2
   - ps: C:\PROGRA~1\7-Zip\7z.exe x C:\projects\micromamba.tar.bz2 -aoa -oC:\projects\
   - ps: C:\PROGRA~1\7-Zip\7z.exe x C:\projects\micromamba.tar -ttar -aoa -oC:\projects\

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
@@ -143,7 +143,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.13
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@f1859528322d7b29d4493ee241a167807661dfb4  # v2.21.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -163,31 +163,31 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@f1859528322d7b29d4493ee241a167807661dfb4  # v2.21.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@f1859528322d7b29d4493ee241a167807661dfb4  # v2.21.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
           CIBW_BUILD: "cp311-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@f1859528322d7b29d4493ee241a167807661dfb4  # v2.21.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
           CIBW_BUILD: "cp310-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@f1859528322d7b29d4493ee241a167807661dfb4  # v2.21.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -231,9 +231,9 @@ jobs:
         run: ls dist
 
       - name: Generate artifact attestation for sdist and wheel
-        uses: actions/attest-build-provenance@310b0a4a3b0b78ef57ecda988ee04b132db73ef8  # v1.4.1
+        uses: actions/attest-build-provenance@1c608d11d69870c2092266b3f9a6f3abbf17002c  # v1.4.3
         with:
           subject-path: dist/matplotlib-*
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@ec4db0b4ddc65acdf4bff5fa45ac92d78b56bdf0  # v1.9.0
+        uses: pypa/gh-action-pypi-publish@f7600683efdcb7656dec5b29656edb7bc586e597  # v1.10.3
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
@@ -29,7 +29,6 @@ on:
     # 5:47 UTC on Saturdays
     - cron: "47 5 * * 6"
   workflow_dispatch:
-    workflow: "*"
 
 permissions:
   contents: read

diff --git a/.github/workflows/nightlies.yml b/.github/workflows/nightlies.yml
@@ -59,7 +59,7 @@ jobs:
           ls -l dist/
 
       - name: Upload wheels to Anaconda Cloud as nightlies
-        uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc  # 0.5.0
+        uses: scientific-python/upload-nightly-action@82396a2ed4269ba06c6b2988bb4fd568ef3c3d6b  # 0.6.1
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -21,7 +21,6 @@ on:
     # 5:47 UTC on Saturdays
     - cron: "47 5 * * 6"
   workflow_dispatch:
-    workflow: "*"
 
 env:
   NO_AT_BRIDGE: 1  # Necessary for GTK3 interactive test.
@@ -124,7 +123,7 @@ jobs:
           allow-prereleases: true
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: deadsnakes/action@6c8b9b82fe0b4344f4b98f2775fcc395df45e494  # v3.1.0
+        uses: deadsnakes/action@e640ac8743173a67cca4d7d77cd837e514bf98e8  # v3.2.0
         if: matrix.python-version == '3.13t'
         with:
           python-version: '3.13'
@@ -261,7 +260,7 @@ jobs:
           # Preinstall build requirements to enable no-build-isolation builds.
           python -m pip install --upgrade $PRE \
             'contourpy>=1.0.1' cycler fonttools kiwisolver importlib_resources \
-            numpy packaging pillow 'pyparsing!=3.1.0' python-dateutil setuptools-scm \
+            packaging pillow 'pyparsing!=3.1.0' python-dateutil setuptools-scm \
             'meson-python>=0.13.1' 'pybind11>=2.6' \
             -r requirements/testing/all.txt \
             ${{ matrix.extra-requirements }}

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -14,7 +14,7 @@ exclude: |
     )
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: check-added-large-files
       - id: check-docstring-first
@@ -28,7 +28,7 @@ repos:
       - id: trailing-whitespace
         exclude_types: [svg]
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.10.1
+    rev: v1.11.2
     hooks:
       - id: mypy
         additional_dependencies:
@@ -42,7 +42,7 @@ repos:
         files: lib/matplotlib  # Only run when files in lib/matplotlib are changed.
         pass_filenames: false
   - repo: https://github.com/pycqa/flake8
-    rev: 7.1.0
+    rev: 7.1.1
     hooks:
       - id: flake8
         additional_dependencies:
@@ -67,7 +67,7 @@ repos:
         name: isort (python)
         files: ^galleries/tutorials/|^galleries/examples/|^galleries/plot_types/
   - repo: https://github.com/rstcheck/rstcheck
-    rev: v6.2.0
+    rev: v6.2.4
     hooks:
       - id: rstcheck
         additional_dependencies:
@@ -79,7 +79,7 @@ repos:
       - id: yamllint
         args: ["--strict", "--config-file=.yamllint.yml"]
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.28.6
+    rev: 0.29.3
     hooks:
       # TODO: Re-enable this when https://github.com/microsoft/azure-pipelines-vscode/issues/567 is fixed.
       # - id: check-azure-pipelines

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
@@ -1,51 +1,51 @@
 # Non-typed (and private) modules/functions
-matplotlib.backends.*
-matplotlib.tests.*
-matplotlib.pylab.*
-matplotlib._.*
-matplotlib.rcsetup._listify_validator
-matplotlib.rcsetup._validate_linestyle
-matplotlib.ft2font.Glyph
-matplotlib.testing.jpl_units.*
-matplotlib.sphinxext.*
+matplotlib\.backends\..*
+matplotlib\.tests(\..*)?
+matplotlib\.pylab\..*
+matplotlib\._.*
+matplotlib\.rcsetup\._listify_validator
+matplotlib\.rcsetup\._validate_linestyle
+matplotlib\.ft2font\.Glyph
+matplotlib\.testing\.jpl_units\..*
+matplotlib\.sphinxext(\..*)?
 
 # set methods have heavy dynamic usage of **kwargs, with differences for subclasses
 # which results in technically inconsistent signatures, but not actually a problem
-matplotlib.*\.set$
+matplotlib\..*\.set$
 
 # Typed inline, inconsistencies largely due to imports
-matplotlib.pyplot.*
-matplotlib.typing.*
+matplotlib\.pyplot\..*
+matplotlib\.typing\..*
 
 # Other decorator modifying signature
 # Backcompat decorator which does not modify runtime reported signature
-matplotlib.offsetbox.*Offset[Bb]ox.get_offset
+matplotlib\.offsetbox\..*Offset[Bb]ox\.get_offset
 
 # Inconsistent super/sub class parameter name (maybe rename for consistency)
-matplotlib.projections.polar.RadialLocator.nonsingular
-matplotlib.ticker.LogLocator.nonsingular
-matplotlib.ticker.LogitLocator.nonsingular
+matplotlib\.projections\.polar\.RadialLocator\.nonsingular
+matplotlib\.ticker\.LogLocator\.nonsingular
+matplotlib\.ticker\.LogitLocator\.nonsingular
 
 # Stdlib/Enum considered inconsistent (no fault of ours, I don't think)
-matplotlib.backend_bases._Mode.__new__
-matplotlib.units.Number.__hash__
+matplotlib\.backend_bases\._Mode\.__new__
+matplotlib\.units\.Number\.__hash__
 
 # 3.6 Pending deprecations
-matplotlib.figure.Figure.set_constrained_layout
-matplotlib.figure.Figure.set_constrained_layout_pads
-matplotlib.figure.Figure.set_tight_layout
+matplotlib\.figure\.Figure\.set_constrained_layout
+matplotlib\.figure\.Figure\.set_constrained_layout_pads
+matplotlib\.figure\.Figure\.set_tight_layout
 
 # Maybe should be abstractmethods, required for subclasses, stubs define once
-matplotlib.tri.*TriInterpolator.__call__
-matplotlib.tri.*TriInterpolator.gradient
+matplotlib\.tri\..*TriInterpolator\.__call__
+matplotlib\.tri\..*TriInterpolator\.gradient
 
 # TypeVar used only in type hints
-matplotlib.backend_bases.FigureCanvasBase._T
-matplotlib.backend_managers.ToolManager._T
-matplotlib.spines.Spine._T
+matplotlib\.backend_bases\.FigureCanvasBase\._T
+matplotlib\.backend_managers\.ToolManager\._T
+matplotlib\.spines\.Spine\._T
 
 # Parameter inconsistency due to 3.10 deprecation
-matplotlib.figure.FigureBase.get_figure
+matplotlib\.figure\.FigureBase\.get_figure
 
 # getitem method only exists for 3.10 deprecation backcompatability
-matplotlib.inset.InsetIndicator.__getitem__
+matplotlib\.inset\.InsetIndicator\.__getitem__
diff --git a/doc/_embedded_plots/figure_subplots_adjust.py b/doc/_embedded_plots/figure_subplots_adjust.py
@@ -0,0 +1,28 @@
+import matplotlib.pyplot as plt
+
+
+def arrow(p1, p2, **props):
+    axs[0, 0].annotate(
+        "", p1, p2,  xycoords='figure fraction',
+        arrowprops=dict(arrowstyle="<->", shrinkA=0, shrinkB=0, **props))
+
+
+fig, axs = plt.subplots(2, 2, figsize=(6.5, 4))
+fig.set_facecolor('lightblue')
+fig.subplots_adjust(0.1, 0.1, 0.9, 0.9, 0.4, 0.4)
+for ax in axs.flat:
+    ax.set(xticks=[], yticks=[])
+
+arrow((0, 0.75), (0.1, 0.75))  # left
+arrow((0.435, 0.75), (0.565, 0.75))  # wspace
+arrow((0.9, 0.75), (1, 0.75))  # right
+fig.text(0.05, 0.7, "left", ha="center")
+fig.text(0.5, 0.7, "wspace", ha="center")
+fig.text(0.95, 0.7, "right", ha="center")
+
+arrow((0.25, 0), (0.25, 0.1))  # bottom
+arrow((0.25, 0.435), (0.25, 0.565))  # hspace
+arrow((0.25, 0.9), (0.25, 1))  # top
+fig.text(0.28, 0.05, "bottom", va="center")
+fig.text(0.28, 0.5, "hspace", va="center")
+fig.text(0.28, 0.95, "top", va="center")
diff --git a/doc/api/axes_api.rst b/doc/api/axes_api.rst
@@ -28,6 +28,17 @@ The Axes class
 
    Axes
 
+Attributes
+----------
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Axes.viewLim
+   Axes.dataLim
+
 Plotting
 ========
 

diff --git a/doc/api/axis_api.rst b/doc/api/axis_api.rst
@@ -73,10 +73,10 @@ Axis Label
    :template: autosummary.rst
    :nosignatures:
 
+   Axis.label
    Axis.set_label_coords
    Axis.set_label_position
    Axis.set_label_text
-   Axis.get_label
    Axis.get_label_position
    Axis.get_label_text
 
@@ -235,6 +235,8 @@ specify a matching series of labels.  Calling ``set_ticks`` makes a
    :template: autosummary.rst
    :nosignatures:
 
+   Axis.get_label
+   Axis.set_label
    Axis.set_ticks
    Axis.set_ticklabels
 

diff --git a/doc/api/next_api_changes/behavior/26000-t.rst b/doc/api/next_api_changes/behavior/26000-t.rst
@@ -0,0 +1,5 @@
+onselect argument to selector widgets made optional
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The *onselect* argument to `.EllipseSelector`, `.LassoSelector`, `.PolygonSelector`, and
+`.RectangleSelector` is no longer required.
diff --git a/doc/api/next_api_changes/deprecations/28843-TH.rst b/doc/api/next_api_changes/deprecations/28843-TH.rst
@@ -0,0 +1,9 @@
+FontProperties initialization
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+`.FontProperties` initialization is limited to the two call patterns:
+
+- single positional parameter, interpreted as fontconfig pattern
+- only keyword parameters for setting individual properties
+
+All other previously supported call patterns are deprecated.
diff --git a/doc/api/next_api_changes/deprecations/28933-AL.rst b/doc/api/next_api_changes/deprecations/28933-AL.rst
@@ -0,0 +1,5 @@
+``AxLine`` ``xy1`` and ``xy2`` setters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+These setters now each take a single argument, ``xy1`` or ``xy2`` as a tuple.
+The old form, where ``x`` and ``y`` were passed as separate arguments, is
+deprecated.