Merge pull request #11942 from timhoffm/deprecate-aname

dstansby · web-flow · commit 9857e7c9acbe · 2018-08-27T17:13:25.000+01:00
Deprecate Artist.aname and Axes.aname
diff --git a/doc/api/next_api_changes/2018-07-22-AL-deprecations.rst b/doc/api/next_api_changes/2018-07-22-AL-deprecations.rst
@@ -5,3 +5,6 @@ Support for custom backends that do not provide a ``set_hatch_color`` method is
 deprecated.  We suggest that custom backends let their ``GraphicsContext``
 class inherit from `GraphicsContextBase`, to at least provide stubs for all
 required methods.
+
+The fields ``Artist.aname`` and ``Axes.aname`` are deprecated. Please use
+``isinstance()`` or ``__class__.__name__`` checks instead.
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
@@ -71,8 +71,11 @@ class Artist(object):
     Abstract base class for someone who renders into a
     :class:`FigureCanvas`.
     """
+    @property
+    @cbook.deprecated("3.1")
+    def aname(self):
+        return 'Artist'
 
-    aname = 'Artist'
     zorder = 0
     # order of precedence when bulk setting/updating properties
     # via update.  The keys should be property names and the values
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -131,7 +131,10 @@ class Axes(_AxesBase):
     """
     ### Labelling, legend and texts
 
-    aname = 'Axes'
+    @property
+    @cbook.deprecated("3.1")
+    def aname(self):
+        return 'Axes'
 
     def get_title(self, loc="center"):
         """
