KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

logging.Logger

Een benoemde Logger van getLogger controleert het effectieve niveau en de eigen filters voordat hij het record doorgeeft.

Versie: Python 3.14; repository image, production runtime not attested

Syntax

logging.getLogger('work.sample')

Een benoemde Logger van getLogger controleert het effectieve niveau en de eigen filters voordat hij het record doorgeeft.

disabled=True op de bronlogger blokkeert zijn aanroepen. Op een voorouder verhindert dezelfde vlag niet dat een al geaccepteerd kindrecord bij de handlers van de voorouder aankomt. Bij propagate=True gaat het rechtstreeks naar handlers van voorouders, waarbij de niveaus en filters van hun loggers worden overgeslagen. De drempels en filters van handlers gelden wel.

Een eigen handler met propagate=False geeft True ready zonder verdubbeling bij de ouder.

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 stelt de drempel in, addHandler voegt een handler toe aan handlers en getChild('jobs') geeft een kindlogger. Behandel handlers als alleen-lezen en wijzig via addHandler/removeHandler. debug/info/warning/error gebruiken 10/20/30/40. Het kind erft INFO en stuurt drie records naar de ouder, waar propagate=False verdere doorgifte stopt.

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()

Voorbeelden

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())

Resultaat

True ready

Een eigen handler met propagate=False geeft True ready zonder verdubbeling bij de ouder.

Bronnen