Commit e6b64b7
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -992,9 +992,11 @@ possible, while any potentially slow operations (such as sending an email via | |||
| 992 | 992 | .. class:: QueueHandler(queue) | |
| 993 | 993 | ||
| 994 | 994 | Returns a new instance of the :class:`QueueHandler` class. The instance is | |
| 995 | - initialized with the queue to send messages to. The queue can be any | ||
| 996 | - queue-like object; it's used as-is by the :meth:`enqueue` method, which needs | ||
| 997 | - to know how to send messages to it. | ||
| 995 | + initialized with the queue to send messages to. The *queue* can be any | ||
| 996 | + queue-like object; it's used as-is by the :meth:`enqueue` method, which | ||
| 997 | + needs to know how to send messages to it. The queue is not *required* to | ||
| 998 | + have the task tracking API, which means that you can use | ||
| 999 | + :class:`~queue.SimpleQueue` instances for *queue*. | ||
| 998 | 1000 | ||
| 999 | 1001 | ||
| 1000 | 1002 | .. method:: emit(record) | |
@@ -1050,11 +1052,14 @@ possible, while any potentially slow operations (such as sending an email via | |||
| 1050 | 1052 | initialized with the queue to send messages to and a list of handlers which | |
| 1051 | 1053 | will handle entries placed on the queue. The queue can be any queue-like | |
| 1052 | 1054 | object; it's passed as-is to the :meth:`dequeue` method, which needs | |
| 1053 | - to know how to get messages from it. If ``respect_handler_level`` is ``True``, | ||
| 1054 | - a handler's level is respected (compared with the level for the message) when | ||
| 1055 | - deciding whether to pass messages to that handler; otherwise, the behaviour | ||
| 1056 | - is as in previous Python versions - to always pass each message to each | ||
| 1057 | - handler. | ||
| 1055 | + to know how to get messages from it. The queue is not *required* to have the | ||
| 1056 | + task tracking API (though it's used if available), which means that you can | ||
| 1057 | + use :class:`~queue.SimpleQueue` instances for *queue*. | ||
| 1058 | + | ||
| 1059 | + If ``respect_handler_level`` is ``True``, a handler's level is respected | ||
| 1060 | + (compared with the level for the message) when deciding whether to pass | ||
| 1061 | + messages to that handler; otherwise, the behaviour is as in previous Python | ||
| 1062 | + versions - to always pass each message to each handler. | ||
| 1058 | 1063 | ||
| 1059 | 1064 | .. versionchanged:: 3.5 | |
| 1060 | 1065 | The ``respect_handler_levels`` argument was added. | |
0 commit comments