Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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