[Python-checkins] r78246 - python/trunk/Doc/library/logging.rst
vinay.sajip
python-checkins at python.org
Sat Feb 20 00:53:17 CET 2010
Author: vinay.sajip
Date: Sat Feb 20 00:53:17 2010
New Revision: 78246
Log:
logging: Documented warnings module integration.
Modified:
python/trunk/Doc/library/logging.rst
Modified: python/trunk/Doc/library/logging.rst
==============================================================================
--- python/trunk/Doc/library/logging.rst (original)
+++ python/trunk/Doc/library/logging.rst Sat Feb 20 00:53:17 2010
@@ -2477,6 +2477,28 @@
because lock implementations in the :mod:`threading` module are not always
re-entrant, and so cannot be invoked from such signal handlers.
+
+Integration with the warnings module
+------------------------------------
+
+The :func:`captureWarnings` function can be used to integrate :mod:`logging`
+with the :mod:`warnings` module.
+
+.. function:: captureWarnings(capture)
+
+ This function is used to turn the capture of warnings by logging on and
+ off.
+
+ If `capture` is `True`, warnings issued by the :mod:`warnings` module
+ will be redirected to the logging system. Specifically, a warning will be
+ formatted using :func:`warnings.formatwarning` and the resulting string
+ logged to a logger named "py.warnings" with a severity of `WARNING`.
+
+ If `capture` is `False`, the redirection of warnings to the logging system
+ will stop, and warnings will be redirected to their original destinations
+ (i.e. those in effect before `captureWarnings(True)` was called).
+
+
Configuration
-------------
More information about the Python-checkins
mailing list