CKTIS / Python
Manejadores del logger: consultar, desvincular y añadir
En Python 3.12, `logger.handlers` muestra solo los manejadores asociados directamente al logger. Consulta la lista y usa `addHandler()` y `removeHandler()` para modificarla.
Versión: Python 3.12
Sintaxis
logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)
# Detach every handler in the snapshot of this logger's direct attachments.
for handler in list(logger.handlers):
logger.removeHandler(handler)logging.Logger.handlers es un atributo de instancia que contiene la lista de manejadores asociados directamente a ese logger. No incluye los de los loggers antecesores ni es el módulo logging.handlers. len(logger.handlers) solo cuenta los manejadores asociados directamente.
Trata la lista como de solo lectura. Usa logger.addHandler(handler) para añadir un manejador y logger.removeHandler(handler) para desvincularlo. No uses logger.handlers.clear(), append() ni una asignación: esas operaciones eluden los bloqueos que usan los métodos. Para vaciar la lista, recorre una copia, list(logger.handlers), y llama a removeHandler() para cada elemento. La copia evita modificar la lista que estás recorriendo, pero la operación completa no es atómica.
Desvincular un manejador no lo cierra. Llama a handler.close() por separado si el manejador está a tu cargo y ya no se necesita en ningún sitio. No lo cierres solo por haberlo desvinculado de un logger: puede seguir compartido.
Una lista vacía no significa que no haya salida. logger.hasHandlers() también busca en los loggers antecesores alcanzables por propagación; comprueba si hay un manejador, no si se emitirá un registro concreto. logger.propagate = False impide el envío a los antecesores. Si no se encuentra ningún manejador en ese recorrido, puede intervenir logging.lastResort, que por defecto escribe los registros de nivel WARNING o superior en la salida de error estándar.
Ejemplos
import logging
import sys
logger = logging.getLogger('cktis.lesson27')
logger.setLevel(logging.INFO)
logger.propagate = False
old_handler = logging.NullHandler()
logger.addHandler(old_handler)
print('before:', len(logger.handlers))
for handler in list(logger.handlers):
logger.removeHandler(handler)
old_handler.close()
print('cleared:', len(logger.handlers))
new_handler = logging.StreamHandler(sys.stdout)
new_handler.setFormatter(logging.Formatter('%(message)s'))
logger.addHandler(new_handler)
try:
print('attached:', len(logger.handlers))
logger.info('ready')
finally:
logger.removeHandler(new_handler)
new_handler.close()Resultado
before: 1 cleared: 0 attached: 1 ready
Ejecuta el ejemplo en un proceso nuevo. Los recuentos muestran un manejador directo, una lista vacía y un manejador de reemplazo. El nuevo `StreamHandler` escribe `ready` y el bloque `finally` lo desvincula y lo cierra.
Lecciones relacionadas
- Python · Lección 27 · Avanzado · Versión: 5
Fuentes
- Python 3.12 logging reference: Logger.handlers
- Python 3.12 logging reference: Logger.addHandler
- Python 3.12 logging reference: Logger.removeHandler
- Python 3.12 logging reference: Logger.propagate
- Python 3.12 logging reference: Logger.hasHandlers
- Python 3.12 logging reference: Handler.close
- Python 3.12 logging reference: logging.lastResort
- Python 3.12 logging handlers reference: StreamHandler
- Python 3.12 logging handlers reference: NullHandler