bpo-37470: Document more clearly the error handling for QueueHandler.emit(). (GH-14532) (GH-14533)

(cherry picked from commit 0f4e813282)
This commit is contained in:
Miss Islington (bot) 2019-07-01 12:53:39 -07:00 committed by Vinay Sajip
parent 6cde61369e
commit 91f9f098fc

View file

@ -980,7 +980,12 @@ possible, while any potentially slow operations (such as sending an email via
.. method:: emit(record) .. method:: emit(record)
Enqueues the result of preparing the LogRecord. Enqueues the result of preparing the LogRecord. Should an exception
occur (e.g. because a bounded queue has filled up), the
:meth:`~logging.Handler.handleError` method is called to handle the
error. This can result in the record silently being dropped (if
:attr:`logging.raiseExceptions` is ``False``) or a message printed to
``sys.stderr`` (if :attr:`logging.raiseExceptions` is ``True``).
.. method:: prepare(record) .. method:: prepare(record)