Merge pull request #11241 from anntzer/deprecate-MATPLOTLIBDATA

tacaswell · web-flow · commit 21b016eb0211 · 2019-02-28T21:48:02.000-05:00
API: Deprecate the MATPLOTLIBDATA environment variable.
diff --git a/doc/api/next_api_changes/2018-08-17-AL-deprecations.rst b/doc/api/next_api_changes/2018-08-17-AL-deprecations.rst
@@ -12,3 +12,6 @@ The following API elements are deprecated:
 - ``cbook.get_label``, ``cbook.iterable``,
 - ``font_manager.OSXInstalledFonts``,
 - ``mlab.demean``,
+
+The following environment variables are deprecated:
+- ``MATPLOTLIBDATA``,
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -606,6 +606,8 @@ def _get_data_path():
         if not os.path.isdir(path):
             raise RuntimeError('Path in environment MATPLOTLIBDATA not a '
                                'directory')
+        cbook.warn_deprecated(
+            "3.1", name="MATPLOTLIBDATA", obj_type="environment variable")
         return path
 
     def get_candidate_paths():
