ENH: set level to INFO and add pyplot.debug()

jklymak · jklymak · commit d7388379bf96 · 2019-01-08T13:28:16.000-08:00
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -1997,15 +1997,15 @@ def colormaps():
     return sorted(cm.cmap_d)
 
 
-def verbose(level='debug'):
+def verbose(level='info'):
     """
     Shortcut to set the debugging level of the logging module.
 
     Parameters
     ----------
-    level : str or bool
-        If True set logging level to "DEBUG" for matplotlib module.
-        If FALSE set logging level to "WARNING" for matplotlib module (this
+    level : str or bool (optional)
+        If *True* (default) set logging level to "INFO" for matplotlib module.
+        If *False* set logging level to "WARNING" for matplotlib module (this
         is the default level if ``verbose`` is not called). If a string, must
         be one of ['warning', 'info', 'debug'], in order of increasing
         verbosity.
@@ -2023,6 +2023,23 @@ def verbose(level='debug'):
     matplotlib.verbose(level=level)
 
 
+def debug():
+    """
+    Shortcut to set the debugging level of the logging module to DEBUG
+
+    Notes
+    -----
+    This is the same as the standard python `logging` module::
+
+        import logging
+
+        _log = logging.getLogger(__name__)
+        _log.setLevel(logging.DEBUG)
+
+    """
+    matplotlib.verbose(level='debug')
+
+
 def _setup_pyplot_info_docstrings():
     """
     Generates the plotting docstring.
