Merge branch 'matplotlib:main' into logo_guide

Author: jeromefv

.github/workflows/pr_welcome.yml

@@ -11,8 +11,8 @@ jobs:
     steps:
       - uses: actions/first-interaction@753c925c8d1ac6fede23781875376600628d9b5d  # v3.0.0
         with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          pr-message: >+
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          pr_message: >+
             Thank you for opening your first PR into Matplotlib!
 
 

README.md

@@ -2,6 +2,7 @@
 [![Conda](https://img.shields.io/conda/vn/conda-forge/matplotlib)](https://anaconda.org/conda-forge/matplotlib)
 [![Downloads](https://img.shields.io/pypi/dm/matplotlib)](https://pypi.org/project/matplotlib)
 [![NUMFocus](https://img.shields.io/badge/powered%20by-NumFOCUS-orange.svg?style=flat&colorA=E1523D&colorB=007D8A)](https://numfocus.org)
+[![LFX Health Score](https://insights.linuxfoundation.org/api/badge/health-score?project=matplotlib)](https://insights.linuxfoundation.org/project/matplotlib)
 
 [![Discourse help forum](https://img.shields.io/badge/help_forum-discourse-blue.svg)](https://discourse.matplotlib.org)
 [![Gitter](https://badges.gitter.im/matplotlib/matplotlib.svg)](https://gitter.im/matplotlib/matplotlib)

doc/_static/switcher.json

@@ -1,7 +1,7 @@
 [
     {
         "name": "3.10 (stable)",
-        "version": "3.10.5",
+        "version": "3.10.6",
         "url": "https://matplotlib.org/stable/",
         "preferred": true
     },

doc/_static/zenodo_cache/16999430.svg

@@ -0,0 +1,4 @@
+Parameters ``Axes3D.set_aspect(..., anchor=..., share=...)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The parameters *anchor* and *share* of `.Axes3D.set_aspect` are deprecated.
+They had no effect on 3D axes and will be removed in a future version.

doc/api/next_api_changes/deprecations/30364-AS.rst

@@ -377,7 +377,7 @@ them will be skipped by pytest.
 .. _pandas: https://pypi.org/project/pandas/
 .. _pikepdf: https://pypi.org/project/pikepdf/
 .. _psutil: https://pypi.org/project/psutil/
-.. _pytz: https://fonts.google.com/noto/use#faq
+.. _pytz: https://pypi.org/project/pytz/
 .. _pytest-cov: https://pytest-cov.readthedocs.io/en/latest/
 .. _pytest-timeout: https://pypi.org/project/pytest-timeout/
 .. _pytest-xdist: https://pypi.org/project/pytest-xdist/

doc/install/dependencies.rst

@@ -28,11 +28,20 @@ precompiled wheel for your OS and Python.
 
 .. note::
 
-   The following backends work out of the box: Agg, ps, pdf, svg
-
-   Python is typically shipped with tk bindings which are used by
-   TkAgg. Notably, python-build-standalone – used by ``uv`` – does
-   not include tk bindings that are usable by Matplotlib.
+   The following non-interactive backends work out of the box: Agg,
+   ps, pdf, svg
+
+   The TkAgg interactive backend also typically works out of the box.
+   It requires Tk bindings, which are usually provided via the Python
+   standard library's ``tkinter`` module. On some OSes, you may need
+   to install a separate package like ``python3-tk`` to add this
+   component of the standard library.
+
+   Some tools like ``uv`` make use of Python builds from the
+   python-build-standalone project, which only gained usable Tk
+   bindings recently (August 2025). If you are having trouble with the
+   TkAgg backend, ensure you have an up-to-date build, e.g. ``uv self
+   update && uv python upgrade --reinstall``.
 
    For support of other GUI frameworks, LaTeX rendering, saving
    animations and a larger selection of file formats, you can

doc/install/index.rst

@@ -29,20 +29,19 @@
 
         .. warning::
 
-           If you install Python with ``uv`` then the ``tkagg`` backend
-           will not be available because python-build-standalone (used by uv
-           to distribute Python) does not contain tk bindings that are usable by
-           Matplotlib (see `this issue`_ for details).  If you want Matplotlib
-           to be able to display plots in a window, you should install one of
-           the other :ref:`supported GUI frameworks <optional_dependencies>`,
-           e.g.
+           uv usually installs its own versions of Python from the
+           python-build-standalone project, and only recent versions of those
+           Python builds (August 2025) work properly with the ``tkagg`` backend
+           for displaying plots in a window. Please make sure you are using uv
+           0.8.7 or newer (update with e.g. ``uv self update``) and that your
+           bundled Python installs are up to date (with ``uv python upgrade
+           --reinstall``).  Alternatively, you can use one of the other
+           :ref:`supported GUI frameworks <optional_dependencies>`, e.g.
 
            .. code-block:: bash
 
                uv add matplotlib pyside6
 
-           .. _this issue: https://github.com/astral-sh/uv/issues/6893#issuecomment-2565965851
-
     .. tab-item:: other
 
         :ref:`install-official`

doc/install/quick_install.inc.rst

@@ -32,6 +32,9 @@ By version
 .. START OF AUTOGENERATED
 
 
+v3.10.6
+   .. image:: ../_static/zenodo_cache/16999430.svg
+      :target:  https://doi.org/10.5281/zenodo.16999430
 v3.10.5
    .. image:: ../_static/zenodo_cache/16644850.svg
       :target:  https://doi.org/10.5281/zenodo.16644850

doc/project/citing.rst

@@ -2,34 +2,30 @@
 
 .. _github-stats:
 
-GitHub statistics for 3.10.5 (Jul 31, 2025)
+GitHub statistics for 3.10.6 (Aug 29, 2025)
 ===========================================
 
-GitHub statistics for 2024/12/14 (tag: v3.10.0) - 2025/07/31
+GitHub statistics for 2024/12/14 (tag: v3.10.0) - 2025/08/29
 
 These lists are automatically generated, and may be incomplete or contain duplicates.
 
-We closed 18 issues and merged 67 pull requests.
-The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/102?closed=1>`__
+We closed 4 issues and merged 19 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/103?closed=1>`__
 
-The following 36 authors contributed 371 commits.
+The following 31 authors contributed 380 commits.
 
+* Alan Burlot
 * Antony Lee
-* Brian Christian
-* chrisjbillington
 * Christine P. Chai
-* Clément Robert
 * David Stansby
 * dependabot[bot]
+* Doron Behar
 * Elliott Sales de Andrade
 * G.D. McBain
 * Greg Lucas
 * hannah
 * hu-xiaonan
 * Ian Thomas
-* ianlv
-* IdiotCoffee
-* Ines Cachola
 * Inês Cachola
 * Jody Klymak
 * Jouni K. Seppänen
@@ -43,7 +39,6 @@ The following 36 authors contributed 371 commits.
 * Qian Zhang
 * Raphael Erik Hviding
 * Roman
-* Roman A
 * Ruth Comer
 * saikarna913
 * Scott Shambaugh
@@ -53,95 +48,34 @@ The following 36 authors contributed 371 commits.
 
 GitHub issues and pull requests:
 
-Pull Requests (67):
-
-* :ghpull:`30357`: CIBW updates: fix pypy sections, update cibw version
-* :ghpull:`30356`: Manual Backport PR #30195 on branch v3.10.x (ci: Enable wheel builds on Python 3.14)
-* :ghpull:`30352`: Backport PR #28554 on branch v3.10.x (BLD: Enable wheels on Windows-on-ARM)
-* :ghpull:`30353`: Backport PR #30345 on branch v3.10.x (qt: Use better devicePixelRatio event to refresh scaling)
-* :ghpull:`30350`: Backport PR #30344 on branch v3.10.x (Support fractional HiDPI in GTK4 backend)
-* :ghpull:`30277`: Backport PR #30271 on branch v3.10.x (Reduce pause time in interactive timer test)
-* :ghpull:`30351`: Backport PR #30327 on branch v3.10.x (FIX Update Axes limits from Axes.add_collection(... autolim=True))
-* :ghpull:`30345`: qt: Use better devicePixelRatio event to refresh scaling
-* :ghpull:`28554`: BLD: Enable wheels on Windows-on-ARM
-* :ghpull:`30292`: Backport PR #30237: Add explicit ``**options: Any`` for ``add_subplot`` m…
-* :ghpull:`29935`: Backport PR #29908 on branch v3.10.x (TST: Use text placeholders for empty legends)
-* :ghpull:`30327`: FIX Update Axes limits from Axes.add_collection(... autolim=True)
-* :ghpull:`30344`: Support fractional HiDPI in GTK4 backend
-* :ghpull:`30326`: Backport PR #30321 on branch v3.10.x (Fix type annotation for Axes.get_legend() to include None)
-* :ghpull:`30321`: Fix type annotation for Axes.get_legend() to include None
-* :ghpull:`30287`: Backport PR #30286 on branch v3.10.x (Fix whitespace in _axes.py error message)
-* :ghpull:`30288`: Backport PR #30283 on branch v3.10.x (changed the FAQ link to point to the correct path)
-* :ghpull:`30293`: Backport PR #30289 on branch v3.10.x (DOC: Fix build with pybind11 3)
-* :ghpull:`30283`: changed the FAQ link to point to the correct path
-* :ghpull:`30286`: Fix whitespace in _axes.py error message
-* :ghpull:`30271`: Reduce pause time in interactive timer test
-* :ghpull:`30269`: Backport PR #30186 on branch v3.10.x (Fix figure legend when drawing stackplots)
-* :ghpull:`30186`: Fix figure legend when drawing stackplots
-* :ghpull:`30268`: Backport PR #30233 on branch v3.10.x (Check that stem input is 1D)
-* :ghpull:`30233`: Check that stem input is 1D
-* :ghpull:`30259`: Backport PR #30256 on branch v3.10.x (Time out in _get_executable_info)
-* :ghpull:`30256`: Time out in _get_executable_info
-* :ghpull:`30237`: Add explicit ``**options: Any`` for ``add_subplot`` method
-* :ghpull:`30253`: Backport PR #30243 on branch v3.10.x (Fix FancyArrow rendering for zero-length arrows)
-* :ghpull:`30243`: Fix FancyArrow rendering for zero-length arrows
-* :ghpull:`30250`: Backport PR #30244 on branch v3.10.x (DOC: Recommend to use bare Figure instances for saving to file)
-* :ghpull:`30247`: Backport PR #30246 on branch v3.10.x (chore: remove redundant words in comment)
-* :ghpull:`30246`: chore: remove redundant words in comment
-* :ghpull:`30240`: Backport PR #30236 on branch v3.10.x (Copy-edit the docstring of AuxTransformBox.)
-* :ghpull:`30236`: Copy-edit the docstring of AuxTransformBox.
-* :ghpull:`30234`: Backport PR #30209 on branch v3.10.x (Clean up Qt socket notifier to avoid spurious interrupt handler calls)
-* :ghpull:`30209`: Clean up Qt socket notifier to avoid spurious interrupt handler calls
-* :ghpull:`30195`: ci: Enable wheel builds on Python 3.14
-* :ghpull:`30229`: Backport PR #30221 on branch v3.10.x (BUG: fix future incompatibility with Pillow 13)
-* :ghpull:`30221`: BUG: fix future incompatibility with Pillow 13
-* :ghpull:`30228`: Backport PR #30098 on branch v3.10.x (Fix label_outer in the presence of colorbars.)
-* :ghpull:`30227`: Backport PR #30223 on branch v3.10.x (Polar log scale: fix inner patch boundary and spine location)
-* :ghpull:`30098`: Fix label_outer in the presence of colorbars.
-* :ghpull:`30223`: Polar log scale: fix inner patch boundary and spine location
-* :ghpull:`30217`: Backport PR #30198 on branch v3.10.x (Implement Path.__deepcopy__ avoiding infinite recursion)
-* :ghpull:`30198`: Implement Path.__deepcopy__ avoiding infinite recursion
-* :ghpull:`30213`: Backport PR #30212 on branch v3.10.x ([Doc]: fix bug in release notes for matplotlib v3.5.0 and v3.7.0)
-* :ghpull:`30189`: Backport PR #30180 on branch v3.10.x (DOC: expand polar example)
-* :ghpull:`30167`: Backport PR #30162 on branch v3.10.x (TST: Fix runtime error checking NaN input to format_cursor_data)
-* :ghpull:`30162`: TST: Fix runtime error checking NaN input to format_cursor_data
-* :ghpull:`30146`: Backport PR #30144 on branch v3.10.x (js: Fix externally-controlled format strings)
-* :ghpull:`30144`: js: Fix externally-controlled format strings
-* :ghpull:`30140`: Backport PR #30118 on branch v3.10.x (CI: Skip jobs on forks)
-* :ghpull:`30120`: Backport PR #30114 on branch v3.10.x (Fix _is_tensorflow_array.)
-* :ghpull:`30122`: Backport PR #30119 on branch v3.10.x (Add some types to _mathtext.py)
-* :ghpull:`30119`: Add some types to _mathtext.py
-* :ghpull:`30114`: Fix _is_tensorflow_array.
-* :ghpull:`30106`: Backport PR #30089 on branch v3.10.x (FIX: fix submerged margins algorithm being applied twice)
-* :ghpull:`30089`: FIX: fix submerged margins algorithm being applied twice
-* :ghpull:`30101`: Backport PR #30096 on branch v3.10.x (Fix OffsetBox custom picker)
-* :ghpull:`30096`: Fix OffsetBox custom picker
-* :ghpull:`30081`: Backport PR #30079 on branch v3.10.x (FIX: cast legend handles to list)
-* :ghpull:`30079`: FIX: cast legend handles to list
-* :ghpull:`30057`: Backport PR #29895 on branch v3.10.x (The 'lines.markeredgecolor' now doesn't interfere on the color of errorbar caps)"
-* :ghpull:`29895`: The 'lines.markeredgecolor' now doesn't interfere on the color of errorbar caps
-* :ghpull:`30033`: Backport PR #30029 on branch v3.10.x (Update diagram in subplots_adjust documentation to clarify parameters)
-
-Issues (18):
-
-* :ghissue:`30370`: [Bug]: matplotlib simple example fails in Python 3.14
-* :ghissue:`30218`: [Bug]: Rendering on Wayland with fractional scaling looks bad
-* :ghissue:`30318`: [Bug]: type annotation of ``Axes.get_legend()`` misses ``None``
-* :ghissue:`30169`: [Doc]: Incorrect FAQ Link on Tutorials Page
-* :ghissue:`30285`: [Bug]: Missing whitespace in _axes.py error message
-* :ghissue:`30280`: [Bug]: Pillow 11.3 raises a deprecation warning when using TkAgg
-* :ghissue:`30158`: [Bug]: Stackplot in SubFigure raises when drawing Legend
-* :ghissue:`30216`: [Bug]: stem complaining about PyTorch's Tensor
-* :ghissue:`30242`: [Bug]: Cannot create empty FancyArrow (expired numpy deprecation)
-* :ghissue:`30249`: [Bug]: DeprecationWarning from Pillow 11.3.0 about 'mode' parameter of PIL.Image.fromarray()
-* :ghissue:`29688`: [Bug]: "Bad file descriptor" raised repeatedly when plt.pause() interrupted in IPython
-* :ghissue:`27305`: [Bug]: Axes.label_outer() does not work when there is a colorbar
-* :ghissue:`30179`: [Bug]: Inner border is not rendered correctly when using log-scale and polar projection.
-* :ghissue:`29157`: FUTURE BUG: reconsider how we deep-copy path objects
-* :ghissue:`30152`: [Bug]: Test pipeline failure on windows
-* :ghissue:`30076`: [Bug]:  Layout Managers are confused by complex arrangement of sub-figures and  gridspec's
-* :ghissue:`30078`: [Bug]: legend no longer works with itertools.chain
-* :ghissue:`29780`: [Bug]: Setting 'lines.markeredgecolor' affects color of errorbar caps.
+Pull Requests (19):
+
+* :ghpull:`30487`: Backport PR #30484 on branch v3.10.x (FIX: be more cautious about checking widget size)
+* :ghpull:`30484`: FIX: be more cautious about checking widget size
+* :ghpull:`30481`: Backport PR #30394 on branch v3.10.x (ENH: Gracefully handle python-build-standalone ImportError with Tk)
+* :ghpull:`30477`: Backport PR #30476 on branch v3.10.x (ci: Remove cibuildwheel override for win_arm64/Py3.14)
+* :ghpull:`30394`: ENH: Gracefully handle python-build-standalone ImportError with Tk
+* :ghpull:`30476`: ci: Remove cibuildwheel override for win_arm64/Py3.14
+* :ghpull:`30461`: Backport PR #30451 on branch v3.10.x (doc: factor out quick install tab for reuse)
+* :ghpull:`30448`: Backport PR #30412 on branch v3.10.x ({Check,Radio}Buttons: Improve docs of label_props)
+* :ghpull:`30412`: {Check,Radio}Buttons: Improve docs of label_props
+* :ghpull:`30445`: Backport PR #30444 on branch v3.10.x (Small correction of a typo in the galleries: axis instead of axes)
+* :ghpull:`30444`: Small correction of a typo in the galleries: axis instead of axes
+* :ghpull:`30430`: Backport PR #30426 on branch v3.10.x (Fix a race condition in TexManager.make_dvi.)
+* :ghpull:`30434`: Backport PR #30426: Fix a race condition in TexManager.make_dvi & make_png.
+* :ghpull:`30431`: Use pathlib in texmanager.
+* :ghpull:`30428`: Backport PR #30399 on branch v3.10.x (Qt: Fix HiDPI handling on X11/Windows)
+* :ghpull:`30426`: Fix a race condition in TexManager.make_dvi.
+* :ghpull:`30399`: Qt: Fix HiDPI handling on X11/Windows
+* :ghpull:`30415`: Backport PR #30414 on branch v3.10.x (DOC: update Cartopy url)
+* :ghpull:`30414`: DOC: update Cartopy url
+
+Issues (4):
+
+* :ghissue:`29618`: [Bug]: FigureCanvasQT is seemingly prematurely freed under certain conditions
+* :ghissue:`30390`: [ENH]: Gracefully handle python-build-standalone ImportError
+* :ghissue:`30420`: [ENH]: Support parallel plotting
+* :ghissue:`30386`: BUG: Qt hi-dpi regression on windows and X11 with mpl 3.10.5
 
 
 Previous GitHub statistics