New submission from Chris Jerdonek <chris.jerdo...@gmail.com>:

Currently, the logging docs are a bit ambiguous or at least not completely 
clear as to when events are propagated when Logger.propagate is true. The docs 
currently say [1]--

"If [the `propagate`] attribute evaluates to true, events logged to this logger 
will be passed to the handlers of higher level (ancestor) loggers, in addition 
to any handlers attached to this logger."

But it's not clear if "logged to this logger" means (1) a log method like 
info() or error() was called on the logger, or (2) the event was passed to the 
logger's handlers (i.e. satisfied the logger's log level threshold and any 
filters).

Empirically, I found that the meaning is (2).

[1]: https://docs.python.org/3/library/logging.html#logging.Logger.propagate

----------
assignee: docs@python
components: Documentation
messages: 334320
nosy: chris.jerdonek, docs@python
priority: normal
severity: normal
stage: needs patch
status: open
title: Clarify when logging events are propagated when propagate is true
type: enhancement
versions: Python 3.7

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue35821>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to