Jun 2, 2022 · Nov 10, 2021
diff --git a/doc/api/next_api_changes/deprecations/21584-AL.rst b/doc/api/next_api_changes/deprecations/21584-AL.rst
 Modifications to the Groupers returned by ``get_shared_x_axes`` and ``get_shared_y_axes``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ... are deprecated.  In the future, these methods will return immutable views
 on the grouper structures.  Note that previously, calling e.g. ``join()``
 would already fail to set up the correct structures for sharing axes; use
 `.Axes.sharex` or `.Axes.sharey` instead.
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
        return ax2

    def get_shared_x_axes(self):
        """Returna reference tothe shared axes Grouper object for x axes."""
        return self._shared_axes["x"]
        """Returnan immutable view onthe sharedx-axes Grouper."""
        returncbook.GrouperView(self._shared_axes["x"])

    def get_shared_y_axes(self):
        """Returna reference tothe shared axes Grouper object for y axes."""
        return self._shared_axes["y"]
        """Returnan immutable view onthe sharedy-axes Grouper."""
        returncbook.GrouperView(self._shared_axes["y"])
diff --git a/lib/matplotlib/cbook/__init__.py b/lib/matplotlib/cbook/__init__.py
        return [x() for x in siblings]


 class GrouperView:
    """Immutable view over a `.Grouper`."""

    def __init__(self, grouper):
        self._grouper = grouper

    class _GrouperMethodForwarder:
        def __init__(self, deprecated_kw=None):
            self._deprecated_kw = deprecated_kw

        def __set_name__(self, owner, name):
            wrapped = getattr(Grouper, name)
            forwarder = functools.wraps(wrapped)(
                lambda self, *args, **kwargs: wrapped(
                    self._grouper, *args, **kwargs))
            if self._deprecated_kw:
                forwarder = _api.deprecated(**self._deprecated_kw)(forwarder)
            setattr(owner, name, forwarder)

    __contains__ = _GrouperMethodForwarder()
    __iter__ = _GrouperMethodForwarder()
    joined = _GrouperMethodForwarder()
    get_siblings = _GrouperMethodForwarder()
    clean = _GrouperMethodForwarder(deprecated_kw=dict(since="3.6"))
    join = _GrouperMethodForwarder(deprecated_kw=dict(since="3.6"))
    remove = _GrouperMethodForwarder(deprecated_kw=dict(since="3.6"))


 def simple_linear_interpolation(a, steps):
    """
    Resample an array with ``steps - 1`` points between original point pairs.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,6 @@
		Modifications to the Groupers returned by ``get_shared_x_axes`` and ``get_shared_y_axes``
		~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
		... are deprecated. In the future, these methods will return immutable views
		on the grouper structures. Note that previously, calling e.g. ``join()``
		would already fail to set up the correct structures for sharing axes; use
		`.Axes.sharex` or `.Axes.sharey` instead.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -4595,9 +4595,9 @@ def twiny(self):
		return ax2

		def get_shared_x_axes(self):
		"""Returna reference tothe shared axes Grouper object for x axes."""
		return self._shared_axes["x"]
		"""Returnan immutable view onthe sharedx-axes Grouper."""
		returncbook.GrouperView(self._shared_axes["x"])

		def get_shared_y_axes(self):
		"""Returna reference tothe shared axes Grouper object for y axes."""
		return self._shared_axes["y"]
		"""Returnan immutable view onthe sharedy-axes Grouper."""
		returncbook.GrouperView(self._shared_axes["y"])
Original file line number	Diff line number	Diff line change
Expand Up		@@ -907,6 +907,34 @@ def get_siblings(self, a):
		return [x() for x in siblings]


		class GrouperView:
		"""Immutable view over a `.Grouper`."""

		def __init__(self, grouper):
		self._grouper = grouper

		class _GrouperMethodForwarder:
		def __init__(self, deprecated_kw=None):
		self._deprecated_kw = deprecated_kw

		def __set_name__(self, owner, name):
		wrapped = getattr(Grouper, name)
		forwarder = functools.wraps(wrapped)(
		lambda self, args, *kwargs: wrapped(
		self._grouper, args, *kwargs))
		if self._deprecated_kw:
		forwarder = _api.deprecated(**self._deprecated_kw)(forwarder)
		setattr(owner, name, forwarder)

		__contains__ = _GrouperMethodForwarder()
		__iter__ = _GrouperMethodForwarder()
		joined = _GrouperMethodForwarder()
		get_siblings = _GrouperMethodForwarder()
		clean = _GrouperMethodForwarder(deprecated_kw=dict(since="3.6"))
		join = _GrouperMethodForwarder(deprecated_kw=dict(since="3.6"))
		remove = _GrouperMethodForwarder(deprecated_kw=dict(since="3.6"))


		def simple_linear_interpolation(a, steps):
		"""
		Resample an array with ``steps - 1`` points between original point pairs.
Expand Down