From 3a6f2364b2d57c8346e02058b2247434cf0d2d47 Mon Sep 17 00:00:00 2001 From: "vinay.sajip" Date: Thu, 20 Aug 2009 22:04:32 +0000 Subject: [PATCH] Added section on exceptions raised during logging. git-svn-id: http://svn.python.org/projects/python/trunk@74531 6015fed2-1504-0410-9fe1-9d1591cc4771 --- Doc/library/logging.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index d458bfece3..bb5078a29a 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -1211,6 +1211,28 @@ are sent to both destinations. This example uses console and file handlers, but you can use any number and combination of handlers you choose. +.. _logging-exceptions: + +Exceptions raised during logging +-------------------------------- + +The logging package is designed to swallow exceptions which occur while logging +in production. This is so that errors which occur while handling logging events +- such as logging misconfiguration, network or other similar errors - do not +cause the application using logging to terminate prematurely. + +:class:`SystemExit` and :class:`KeyboardInterrupt` exceptions are never +swallowed. Other exceptions which occur during the :meth:`emit` method of a +:class:`Handler` subclass are passed to its :meth:`handleError` method. + +The default implementation of :meth:`handleError` in :class:`Handler` checks +to see if a module-level variable, `raiseExceptions`, is set. If set, a +traceback is printed to `sys.stderr`. If not set, the exception is swallowed. + +**Note:** The default value of `raiseExceptions` is `True`. This is because +during development, you typically want to be notified of any exceptions that +occur. It's advised that you set `raiseExceptions` to `False` for production +usage. .. _context-info: -- 2.11.4.GIT