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

CKTIS / Python

logging.Handler.setFormatter — establecer el formateador de un handler

`logging.Handler.setFormatter` asigna un formateador a un handler o lo quita si se le pasa `None`. Controla la presentación de la salida, no el umbral del nivel de registro.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

handler.setFormatter(fmt)

logging.Handler.setFormatter(fmt) establece el formateador de un handler concreto. El método no comprueba si fmt es una instancia de logging.Formatter. La implementación estándar de Handler.format(record) también puede usar otro objeto si este se evalúa como verdadero en un contexto booleano y ofrece un método format(record) compatible. Una simple cadena de formato no sustituye a un formateador. Por ejemplo, usa handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).

La llamada handler.setFormatter(None) elimina el formateador asignado. Cuando el handler usa Handler.format(record), se utiliza entonces el formateador predeterminado del módulo: un mensaje normal no recibe ningún prefijo de nivel ni de nombre del logger. Esto no desactiva el registro.

Un formateador controla la presentación del registro; los umbrales de nivel y los filtros determinan su procesamiento. El ajuste se aplica a este handler, no a todos los handlers del logger. El patrón de salida del formateador es independiente de la interpolación de los argumentos del mensaje, como en logger.info("Items: %s", 3).

El ejemplo captura la salida en io.StringIO, primero con un formato personalizado y después de eliminarlo. Omite las marcas de tiempo y la configuración del logger raíz para que el resultado sea determinista.

Ejemplos

import io
import logging

stream = io.StringIO()
handler = logging.StreamHandler(stream)
logger = logging.getLogger("demo")
logger.setLevel(logging.INFO)
logger.propagate = False
logger.addHandler(handler)

handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s"))
logger.info("Items: %s", 3)

handler.setFormatter(None)
logger.info("Items: %s", 3)

print(stream.getvalue(), end="")
logger.removeHandler(handler)
handler.close()

Resultado

INFO | Items: 3
Items: 3

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes