[Python-checkins] bpo-37469: Document usability of SimpleQueue with QueueHandler and QueueListener. (GH-14521) (GH-14526)
Vinay Sajip
webhook-mailer at python.org
Mon Jul 1 14:53:02 EDT 2019
https://github.com/python/cpython/commit/b0ab95bbe792b38e952688f8fa1657a78b35410e
commit: b0ab95bbe792b38e952688f8fa1657a78b35410e
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: Vinay Sajip <vinay_sajip at yahoo.co.uk>
date: 2019-07-01T19:52:57+01:00
summary:
bpo-37469: Document usability of SimpleQueue with QueueHandler and QueueListener. (GH-14521) (GH-14526)
(cherry picked from commit e6b64b756f940147728ea7808fb686ffcae89176)
files:
M Doc/library/logging.handlers.rst
diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst
index b2ebafa83b2e..d5944ec87d2d 100644
--- a/Doc/library/logging.handlers.rst
+++ b/Doc/library/logging.handlers.rst
@@ -971,9 +971,11 @@ possible, while any potentially slow operations (such as sending an email via
.. class:: QueueHandler(queue)
Returns a new instance of the :class:`QueueHandler` class. The instance is
- initialized with the queue to send messages to. The queue can be any
- queue-like object; it's used as-is by the :meth:`enqueue` method, which needs
- to know how to send messages to it.
+ initialized with the queue to send messages to. The *queue* can be any
+ queue-like object; it's used as-is by the :meth:`enqueue` method, which
+ needs to know how to send messages to it. The queue is not *required* to
+ have the task tracking API, which means that you can use
+ :class:`~queue.SimpleQueue` instances for *queue*.
.. method:: emit(record)
@@ -1029,11 +1031,14 @@ possible, while any potentially slow operations (such as sending an email via
initialized with the queue to send messages to and a list of handlers which
will handle entries placed on the queue. The queue can be any queue-like
object; it's passed as-is to the :meth:`dequeue` method, which needs
- to know how to get messages from it. If ``respect_handler_level`` is ``True``,
- a handler's level is respected (compared with the level for the message) when
- deciding whether to pass messages to that handler; otherwise, the behaviour
- is as in previous Python versions - to always pass each message to each
- handler.
+ to know how to get messages from it. The queue is not *required* to have the
+ task tracking API (though it's used if available), which means that you can
+ use :class:`~queue.SimpleQueue` instances for *queue*.
+
+ If ``respect_handler_level`` is ``True``, a handler's level is respected
+ (compared with the level for the message) when deciding whether to pass
+ messages to that handler; otherwise, the behaviour is as in previous Python
+ versions - to always pass each message to each handler.
.. versionchanged:: 3.5
The ``respect_handler_levels`` argument was added.
More information about the Python-checkins
mailing list