Merge pull request #14144 from anntzer/useless

timhoffm · web-flow · commit 7422347d2746 · 2019-05-26T21:38:10.000+02:00
Deprecate the 'warn' parameter to matplotlib.use().
diff --git a/doc/api/next_api_changes/2019-05-06-AL.rst b/doc/api/next_api_changes/2019-05-06-AL.rst
@@ -0,0 +1,6 @@
+Deprecations
+````````````
+
+The ``warn`` parameter to `matplotlib.use()` is deprecated (catch the
+`ImportError` emitted on backend switch failure and reemit a warning yourself
+if so desired).
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -1170,6 +1170,7 @@ def __exit__(self, exc_type, exc_value, exc_tb):
 
 
 @cbook._rename_parameter("3.1", "arg", "backend")
+@cbook._delete_parameter("3.1", "warn")
 def use(backend, warn=False, force=True):
     """
     Select the backend used for rendering and GUI integration.
@@ -1192,7 +1193,7 @@ def use(backend, warn=False, force=True):
 
     warn : bool, optional, default: False
         If True and not *force*, emit a warning if a failure-to-switch
-        `ImportError` has been suppressed.
+        `ImportError` has been suppressed.  This parameter is deprecated.
 
     force : bool, optional, default: True
         If True (the default), raise an `ImportError` if the backend cannot be
diff --git a/lib/matplotlib/testing/__init__.py b/lib/matplotlib/testing/__init__.py
@@ -42,7 +42,7 @@ def setup():
                 "Could not set locale to English/United States. "
                 "Some date-related tests may fail.")
 
-    mpl.use('Agg', force=True, warn=False)  # use Agg backend for these tests
+    mpl.use('Agg')
 
     with cbook._suppress_matplotlib_deprecation_warning():
         mpl.rcdefaults()  # Start with all defaults
