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