logging: hasHandlers additions documented.

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 7b579f15c51d502bcb8d61cc5a041f81edb2fd66..5d62d508f3abe38872d4060ffb30b398f2d773a4 100644 (file)
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -1129,6 +1129,18 @@ instantiated directly, but always through the module-level function
    This is a factory method which can be overridden in subclasses to create
    specialized :class:`LogRecord` instances.
 
+.. method:: Logger.hasHandlers()
+
+   Checks to see if this logger has any handlers configured. This is done by
+   looking for handlers in this logger and its parents in the logger hierarchy.
+   Returns True if a handler was found, else False. The method stops searching
+   up the hierarchy whenever a logger with the "propagate" attribute set to
+   False is found - that will be the last logger which is checked for the
+   existence of handlers.
+
+.. versionadded:: 3.2
+
+The :meth:`hasHandlers` method was not present in previous versions.
 
 .. _minimal-example:
 

diff --git a/Misc/NEWS b/Misc/NEWS
index 40c4cdd58f1101a27055254f472f2d52ff3845c5..5cac5dcf21a392515772061d678f53315e97b35a 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -55,6 +55,8 @@ Core and Builtins
 Library
 -------
 
+- logging: Added hasHandlers() method to Logger and LoggerAdapter.
+
 - Issue #1686: Fix string.Template when overriding the pattern attribute.
 
 - Issue #9854: SocketIO objects now observe the RawIOBase interface in