matplotlib · timhoffm · Oct 30, 2022 · Oct 8, 2022
diff --git a/doc/api/blocking_input_api.rst b/doc/api/blocking_input_api.rst
diff --git a/doc/api/index.rst b/doc/api/index.rst
@@ -105,7 +105,6 @@ Alphabetical list of modules:
    backend_tools_api.rst
    index_backend_api.rst
    bezier_api.rst
-   blocking_input_api.rst
    category_api.rst
    cbook_api.rst
    cm_api.rst

diff --git a/doc/api/next_api_changes/removals/24125-OG.rst b/doc/api/next_api_changes/removals/24125-OG.rst
@@ -0,0 +1,68 @@
+Miscellaneous removals
+~~~~~~~~~~~~~~~~~~~~~~
+
+- ``is_url`` and ``URL_REGEX`` are removed. (They were previously defined in
+  the toplevel :mod:`matplotlib` module.)
+- The ``ArrowStyle.beginarrow`` and ``ArrowStyle.endarrow`` attributes are
+  removed; use the ``arrow`` attribute to define the desired heads and tails
+  of the arrow.
+- ``backend_pgf.LatexManager.str_cache`` is removed.
+- ``backends.qt_compat.ETS`` and ``backends.qt_compat.QT_RC_MAJOR_VERSION`` are
+  removed, with no replacement.
+- The ``blocking_input`` module is removed. Instead, use
+  ``canvas.start_event_loop()`` and ``canvas.stop_event_loop()`` while
+  connecting event callbacks as needed.
+- ``cbook.report_memory`` is removed; use ``psutil.virtual_memory`` instead.
+- ``cm.LUTSIZE`` is removed. Use :rc:`image.lut` instead. This value only
+  affects colormap quantization levels for default colormaps generated at
+  module import time.
+- ``Colorbar.patch`` is removed; this attribute was not correctly updated
+  anymore.
+- ``ContourLabeler.get_label_width`` is removed.
+- ``Dvi.baseline`` is removed (with no replacement).
+- The *format* parameter of ``dviread.find_tex_file`` is removed (with no
+  replacement).
+- ``FancyArrowPatch.get_path_in_displaycoord`` and
+  ``ConnectionPath.get_path_in_displaycoord`` are removed. The path in
+  display coordinates can still be obtained, as for other patches, using
+  ``patch.get_transform().transform_path(patch.get_path())``.
+- The ``font_manager.win32InstalledFonts`` and
+  ``font_manager.get_fontconfig_fonts`` helper functions are removed.
+- All parameters of ``imshow`` starting from *aspect* are keyword-only.
+- ``QuadMesh.convert_mesh_to_paths`` and ``QuadMesh.convert_mesh_to_triangles``
+  are removed. ``QuadMesh.get_paths()`` can be used as an alternative for the
+  former; there is no replacement for the latter.
+- ``ScalarMappable.callbacksSM`` is removed. Use
+  ``ScalarMappable.callbacks`` instead.
+- ``streamplot.get_integrator`` is removed.
+- ``style.core.STYLE_FILE_PATTERN``, ``style.core.load_base_library``, and
+  ``style.core.iter_user_libraries`` are removed.
+- ``SubplotParams.validate`` is removed. Use `.SubplotParams.update` to
+  change `.SubplotParams` while always keeping it in a valid state.
+- The ``grey_arrayd``, ``font_family``, ``font_families``, and ``font_info``
+  attributes of `.TexManager` are removed.
+- ``Text.get_prop_tup`` is removed with no replacements (because the `.Text`
+  class cannot know whether a backend needs to update cache e.g. when the
+  text's color changes).
+- ``Tick.apply_tickdir`` didn't actually update the tick markers on the
+  existing Line2D objects used to draw the ticks and is removed; use
+  `.Axis.set_tick_params` instead.
+- ``tight_layout.auto_adjust_subplotpars`` is removed.
+- The ``grid_info`` attribute of ``axisartist`` classes has been removed.
+- ``axes_grid1.axes_grid.CbarAxes`` and ``axisartist.axes_grid.CbarAxes`` are
+  removed (they are now dynamically generated based on the owning axes
+  class).
+- The ``axes_grid1.Divider.get_vsize_hsize`` and
+  ``axes_grid1.Grid.get_vsize_hsize`` methods are removed.
+- ``AxesDivider.append_axes(..., add_to_figure=False)`` is removed. Use
+  ``ax.remove()`` to remove the Axes from the figure if needed.
+- ``FixedAxisArtistHelper.change_tick_coord`` is removed with no
+  replacement.
+- ``floating_axes.GridHelperCurveLinear.get_boundary`` is removed with no
+  replacement.
+- ``ParasiteAxesBase.get_images_artists`` is removed.
+- The "units finalize" signal (previously emitted by Axis instances) is
+  removed. Connect to "units" instead.
+- Passing formatting parameters positionally to ``stem()`` is no longer
+  possible.
+- ``axisartist.clip_path`` is removed with no replacement.
diff --git a/doc/api/prev_api_changes/api_changes_0.98.0.rst b/doc/api/prev_api_changes/api_changes_0.98.0.rst
@@ -12,7 +12,7 @@ Changes for 0.98.0
   rather than custom callback handling.  Any users of
   ``matplotlib.cm.ScalarMappable.add_observer`` of the
   :class:`~matplotlib.cm.ScalarMappable` should use the
-  :attr:`matplotlib.cm.ScalarMappable.callbacksSM`
+  ``matplotlib.cm.ScalarMappable.callbacksSM``
   :class:`~matplotlib.cbook.CallbackRegistry` instead.
 
 * New axes function and Axes method provide control over the plot

diff --git a/doc/api/prev_api_changes/api_changes_1.3.x.rst b/doc/api/prev_api_changes/api_changes_1.3.x.rst
@@ -192,7 +192,7 @@ Code changes
   by ``self.vline`` for vertical cursors lines and ``self.hline`` is added
   for the horizontal cursors lines.
 
-* On POSIX platforms, the :func:`~matplotlib.cbook.report_memory` function
+* On POSIX platforms, the ``matplotlib.cbook.report_memory`` function
   raises :class:`NotImplementedError` instead of :class:`OSError` if the
   :command:`ps` command cannot be run.
 

diff --git a/doc/api/prev_api_changes/api_changes_3.1.0.rst b/doc/api/prev_api_changes/api_changes_3.1.0.rst
@@ -389,9 +389,9 @@ consistent with the behavior on Py2, where a buffer object was
 returned.
 
 
-`matplotlib.font_manager.win32InstalledFonts` return type
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-`matplotlib.font_manager.win32InstalledFonts` returns an empty list instead
+``matplotlib.font_manager.win32InstalledFonts`` return type
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``matplotlib.font_manager.win32InstalledFonts`` returns an empty list instead
 of None if no fonts are found.
 
 ``Axes.fmt_xdata`` and ``Axes.fmt_ydata`` error handling

diff --git a/doc/api/toolkits/axisartist.rst b/doc/api/toolkits/axisartist.rst
@@ -39,7 +39,6 @@ You can find a tutorial describing usage of axisartist at the
    axisartist.axis_artist
    axisartist.axisline_style
    axisartist.axislines
-   axisartist.clip_path
    axisartist.floating_axes
    axisartist.grid_finder
    axisartist.grid_helper_curvelinear

diff --git a/doc/users/explain/interactive_guide.rst b/doc/users/explain/interactive_guide.rst
@@ -213,9 +213,7 @@ Blocking functions
 ------------------
 
 If you only need to collect points in an Axes you can use
-`.Figure.ginput` or more generally the tools from
-`.blocking_input` the tools will take care of starting and stopping
-the event loop for you.  However if you have written some custom event
+`.Figure.ginput`.  However if you have written some custom event
 handling or are using `.widgets` you will need to manually run the GUI
 event loop using the methods described :ref:`above <cp_block_the_prompt>`.
 

diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -187,9 +187,6 @@ class __getattr__:
     __version__ = property(lambda self: _get_version())
     __version_info__ = property(
         lambda self: _parse_to_version_info(self.__version__))
-    # module-level deprecations
-    URL_REGEX = _api.deprecated("3.5", obj_type="")(property(
-        lambda self: re.compile(r'^http://|^https://|^ftp://|^file:')))
 
 
 def _check_versions():
@@ -732,12 +729,6 @@ def rc_params(fail_on_error=False):
     return rc_params_from_file(matplotlib_fname(), fail_on_error)
 
 
-@_api.deprecated("3.5")
-def is_url(filename):
-    """Return whether *filename* is an http, https, ftp, or file URL path."""
-    return __getattr__("URL_REGEX").match(filename) is not None
-
-
 @functools.lru_cache()
 def _get_ssl_context():
     try:

diff --git a/lib/matplotlib/_tight_layout.py b/lib/matplotlib/_tight_layout.py
@@ -157,48 +157,6 @@ def _auto_adjust_subplotpars(
     return kwargs
 
 
-@_api.deprecated("3.5")
-def auto_adjust_subplotpars(
-        fig, renderer, nrows_ncols, num1num2_list, subplot_list,
-        ax_bbox_list=None, pad=1.08, h_pad=None, w_pad=None, rect=None):
-    """
-    Return a dict of subplot parameters to adjust spacing between subplots
-    or ``None`` if resulting axes would have zero height or width.
-
-    Note that this function ignores geometry information of subplot
-    itself, but uses what is given by the *nrows_ncols* and *num1num2_list*
-    parameters.  Also, the results could be incorrect if some subplots have
-    ``adjustable=datalim``.
-
-    Parameters
-    ----------
-    nrows_ncols : tuple[int, int]
-        Number of rows and number of columns of the grid.
-    num1num2_list : list[tuple[int, int]]
-        List of numbers specifying the area occupied by the subplot
-    subplot_list : list of subplots
-        List of subplots that will be used to calculate optimal subplot_params.
-    pad : float
-        Padding between the figure edge and the edges of subplots, as a
-        fraction of the font size.
-    h_pad, w_pad : float
-        Padding (height/width) between edges of adjacent subplots, as a
-        fraction of the font size.  Defaults to *pad*.
-    rect : tuple
-        (left, bottom, right, top), default: None.
-    """
-    nrows, ncols = nrows_ncols
-    span_pairs = []
-    for n1, n2 in num1num2_list:
-        if n2 is None:
-            n2 = n1
-        span_pairs.append((slice(n1 // ncols, n2 // ncols + 1),
-                           slice(n1 % ncols, n2 % ncols + 1)))
-    return _auto_adjust_subplotpars(
-        fig, renderer, nrows_ncols, num1num2_list, subplot_list,
-        ax_bbox_list, pad, h_pad, w_pad, rect)
-
-
 def get_subplotspec_list(axes_list, grid_spec=None):
     """
     Return a list of subplotspec from the given list of axes.

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -2881,10 +2881,9 @@ def stem(self, *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0,
 
           stem([locs,] heads, linefmt=None, markerfmt=None, basefmt=None)
 
-        The *locs*-positions are optional. The formats may be provided either
-        as positional or as keyword-arguments.
-        Passing *markerfmt* and *basefmt* positionally is deprecated since
-        Matplotlib 3.5.
+        The *locs*-positions are optional. *linefmt* may be provided as
+        positional, but all other formats must be provided as keyword
+        arguments.
 
         Parameters
         ----------
@@ -2957,8 +2956,8 @@ def stem(self, *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0,
             `stem <https://www.mathworks.com/help/matlab/ref/stem.html>`_
             which inspired this method.
         """
-        if not 1 <= len(args) <= 5:
-            raise TypeError('stem expected between 1 and 5 positional '
+        if not 1 <= len(args) <= 3:
+            raise TypeError('stem expected between 1 or 3 positional '
                             'arguments, got {}'.format(args))
         _api.check_in_list(['horizontal', 'vertical'], orientation=orientation)
 
@@ -2971,12 +2970,6 @@ def stem(self, *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0,
             locs = np.arange(len(heads))
         else:
             locs, heads, *args = args
-        if len(args) > 1:
-            _api.warn_deprecated(
-                "3.5",
-                message="Passing the markerfmt parameter positionally is "
-                        "deprecated since Matplotlib %(since)s; the "
-                        "parameter will become keyword-only %(removal)s.")
 
         if orientation == 'vertical':
             locs, heads = self._process_unit_info([("x", locs), ("y", heads)])
@@ -2990,8 +2983,8 @@ def stem(self, *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0,
 
         # resolve marker format
         if markerfmt is None:
-            # if not given as kwarg, check for positional or fall back to 'o'
-            markerfmt = args[1] if len(args) > 1 else "o"
+            # if not given as kwarg, fall back to 'o'
+            markerfmt = "o"
         if markerfmt == '':
             markerfmt = ' '  # = empty line style; '' would resolve rcParams
         markerstyle, markermarker, markercolor = \
@@ -3005,8 +2998,7 @@ def stem(self, *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0,
 
         # resolve baseline format
         if basefmt is None:
-            basefmt = (args[2] if len(args) > 2 else
-                       "C2-" if mpl.rcParams["_internal.classic_mode"] else
+            basefmt = ("C2-" if mpl.rcParams["_internal.classic_mode"] else
                        "C3-")
         basestyle, basemarker, basecolor = _process_plot_format(basefmt)
 
@@ -5428,15 +5420,11 @@ def fill_betweenx(self, y, x1, x2=0, where=None,
 
     #### plotting z(x, y): imshow, pcolor and relatives, contour
 
-    # Once this deprecation elapses, also move vmin, vmax right after norm, to
-    # match the signature of other methods returning ScalarMappables and keep
-    # the documentation for *norm*, *vmax* and *vmin* together.
-    @_api.make_keyword_only("3.5", "aspect")
     @_preprocess_data()
     @_docstring.interpd
-    def imshow(self, X, cmap=None, norm=None, aspect=None,
+    def imshow(self, X, cmap=None, norm=None, *, aspect=None,
                interpolation=None, alpha=None,
-               vmin=None, vmax=None, origin=None, extent=None, *,
+               vmin=None, vmax=None, origin=None, extent=None,
                interpolation_stage=None, filternorm=True, filterrad=4.0,
                resample=None, url=None, **kwargs):
         """

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
@@ -217,11 +217,6 @@ def _apply_tickdir(self, tickdir):
         self._tickdir = tickdir
         self._pad = self._base_pad + self.get_tick_padding()
 
-    @_api.deprecated("3.5", alternative="`.Axis.set_tick_params`")
-    def apply_tickdir(self, tickdir):
-        self._apply_tickdir(tickdir)
-        self.stale = True
-
     def get_tickdir(self):
         return self._tickdir
 
@@ -666,8 +661,7 @@ def __init__(self, axes, pickradius=15):
         self.axes = axes
         self.major = Ticker()
         self.minor = Ticker()
-        self.callbacks = cbook.CallbackRegistry(
-            signals=["units", "units finalize"])
+        self.callbacks = cbook.CallbackRegistry(signals=["units"])
 
         self._autolabelpos = True
 
@@ -880,8 +874,7 @@ def clear(self):
         self._set_scale('linear')
 
         # Clear the callback registry for this axis, or it may "leak"
-        self.callbacks = cbook.CallbackRegistry(
-            signals=["units", "units finalize"])
+        self.callbacks = cbook.CallbackRegistry(signals=["units"])
 
         # whether the grids are on
         self._major_tick_kw['gridOn'] = (
@@ -1698,7 +1691,6 @@ def set_units(self, u):
             axis.units = u
             axis._update_axisinfo()
             axis.callbacks.process('units')
-            axis.callbacks.process('units finalize')
             axis.stale = True
 
     def get_units(self):

diff --git a/lib/matplotlib/backends/backend_pgf.py b/lib/matplotlib/backends/backend_pgf.py
@@ -308,7 +308,6 @@ def __init__(self):
         # Per-instance cache.
         self._get_box_metrics = functools.lru_cache()(self._get_box_metrics)
 
-    str_cache = _api.deprecated("3.5")(property(lambda self: {}))
     texcommand = _api.deprecated("3.6")(
         property(lambda self: mpl.rcParams["pgf.texsystem"]))
     latex_header = _api.deprecated("3.6")(

diff --git a/lib/matplotlib/backends/qt_compat.py b/lib/matplotlib/backends/qt_compat.py
@@ -21,7 +21,6 @@
 from packaging.version import parse as parse_version
 
 import matplotlib as mpl
-from matplotlib import _api
 
 from . import _QT_FORCE_QT5_BINDING
 
@@ -267,11 +266,3 @@ def handle(*args):
             signal.signal(signal.SIGINT, old_sigint_handler)
             if handler_args is not None:
                 old_sigint_handler(*handler_args)
-
-
-@_api.caching_module_getattr
-class __getattr__:
-    ETS = _api.deprecated("3.5")(property(lambda self: dict(
-        pyqt5=(QT_API_PYQT5, 5), pyside2=(QT_API_PYSIDE2, 5))))
-    QT_RC_MAJOR_VERSION = _api.deprecated("3.5")(property(
-        lambda self: int(QtCore.qVersion().split(".")[0])))