ENH: add a user-freindly verbose interface

jklymak · jklymak · commit 1bcf4f4762b9 · 2019-01-08T09:09:47.000-08:00
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -207,14 +207,35 @@ def _check_versions():
     sys.argv = ['modpython']
 
 
-_verbose_msg = """\
-matplotlib.verbose is deprecated;
-Command line argument --verbose-LEVEL is deprecated.
-This functionality is now provided by the standard
-python logging library.  To get more (or less) logging output:
-    import logging
-    logger = logging.getLogger('matplotlib')
-    logger.set_level(logging.INFO)"""
+def verbose(level='debug'):
+    """
+    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
+        is the default level if ``verbose`` is not called). If a string, must
+        be one of ['warning', 'info', 'debug'], in order of increasing
+        verbosity.
+
+    Notes
+    -----
+    This is the same as the standard python `logging` module::
+
+        import logging
+
+        _log = logging.getLogger(__name__)
+        _log.setLevel(logging.DEBUG)  # or logging.WARNING, logging.INFO
+
+    """
+
+    if level is True:
+        level = 'debug'
+    if level is False:
+        level = 'warning'
+    _set_logger_verbose_level(level_str=level)
 
 
 def _set_logger_verbose_level(level_str='silent', file_str='sys.stdout'):
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -1997,6 +1997,32 @@ def colormaps():
     return sorted(cm.cmap_d)
 
 
+def verbose(level='debug'):
+    """
+    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
+        is the default level if ``verbose`` is not called). If a string, must
+        be one of ['warning', 'info', 'debug'], in order of increasing
+        verbosity.
+
+    Notes
+    -----
+    This is the same as the standard python `logging` module::
+
+        import logging
+
+        _log = logging.getLogger(__name__)
+        _log.setLevel(logging.DEBUG)  # or logging.WARNING, logging.INFO
+
+    """
+    matplotlib.verbose(level=level)
+
+
 def _setup_pyplot_info_docstrings():
     """
     Generates the plotting docstring.
