CKTIS / Python
logging.Logger
Именуваният Logger от getLogger проверява ефективното си ниво и филтрите си преди предаване на записа.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
logging.getLogger('work.sample')Именуваният Logger от getLogger проверява ефективното си ниво и филтрите си преди предаване на записа.
disabled=True върху изходния регистратор блокира неговите извиквания. Върху предшественик същият флаг не спира доставянето на вече приет от дете запис до обработчиците на предшественика. При propagate=True записът стига директно до обработчиците на предците, пропускайки нивата и филтрите на самите им регистратори. Праговете и филтрите на обработчиците остават в сила.
Със собствен обработчик и propagate=False примерът извежда True ready без дублиране при родителя.
import logging,io
out=io.StringIO()
parent=logging.getLogger('ref.logger')
parent.propagate=False
parent.setLevel(logging.CRITICAL)
handler=logging.StreamHandler(out)
handler.setLevel(logging.WARNING)
parent.addHandler(handler)
child=logging.getLogger('ref.logger.child')
child.setLevel(logging.INFO)
child.info('filtered')
child.warning('delivered')
assert out.getvalue()=='delivered\n'
child.propagate=False
child.addHandler(logging.NullHandler())
child.warning('private')
assert out.getvalue()=='delivered\n'
child.propagate=True
parent.disabled=True
child.warning('child')
child.disabled=True
child.warning('blocked')
assert out.getvalue().splitlines()==['delivered','child']
logging.Logger.setLevel · logging.Logger.addHandler · logging.Logger.propagate · logging.Logger.getChild · logging.Logger.debug · logging.Logger.info · logging.Logger.warning · logging.Logger.error · logging.Logger.handlers
setLevel задава прага, addHandler добавя обработчик в handlers, а getChild('jobs') връща дъщерен регистратор. Четете handlers и го променяйте чрез addHandler/removeHandler. debug/info/warning/error използват нива 10/20/30/40. Детето наследява INFO и предава три записа на родителя, чийто propagate=False спира по-нататъшното предаване.
import io,logging
out=io.StringIO()
log=logging.getLogger('app')
log.setLevel(logging.INFO)
log.propagate=False
h=logging.StreamHandler(out)
log.addHandler(h)
child=log.getChild('jobs')
assert child.name=='app.jobs' and h in log.handlers
for method in (child.debug,child.info,child.warning,child.error):
method(method.__name__)
assert out.getvalue().splitlines()==['info','warning','error']
log.removeHandler(h)
h.close()
Примери
import logging
from io import StringIO
out = StringIO()
log = logging.getLogger("private")
log.setLevel(logging.INFO)
log.propagate = False
log.addHandler(logging.StreamHandler(out))
log.info("ready")
print(isinstance(log, logging.Logger), out.getvalue().strip())
Резултат
True ready
Със собствен обработчик и propagate=False примерът извежда True ready без дублиране при родителя.
Източници
- Python 3.14 documentation — logging.Logger
- Python 3.14 — logging.Logger.setLevel
- Python 3.14 — logging.Logger.addHandler
- Python 3.14 — logging.Logger.propagate
- Python 3.14 — logging.Logger.getChild
- Python 3.14 — logging.Logger.debug
- Python 3.14 — logging.Logger.info
- Python 3.14 — logging.Logger.warning
- Python 3.14 — logging.Logger.error
- Python 3.14 — logging.Logger.handlers