Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

logging.Handler.setFormatter — impostare il formatter di un handler

`logging.Handler.setFormatter` assegna un formatter a un handler o lo rimuove se si passa `None`. Controlla la presentazione dell’output, non la soglia del livello di registrazione.

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

Sintassi

handler.setFormatter(fmt)

logging.Handler.setFormatter(fmt) imposta il formatter per un handler specifico. Il metodo non verifica se fmt è un’istanza di logging.Formatter. L’implementazione standard di Handler.format(record) può usare anche un altro oggetto, purché sia valutato come vero in un contesto booleano e offra un metodo format(record) compatibile. Una semplice stringa di formato non può sostituire un formatter. Per esempio, usa handler.setFormatter(logging.Formatter("%(levelname)s | %(message)s")).

La chiamata handler.setFormatter(None) rimuove il formatter assegnato. Quando l’handler usa Handler.format(record), viene quindi utilizzato il formatter predefinito del modulo: un messaggio normale non riceve alcun prefisso con il livello o il nome del logger. Questo non disattiva la registrazione.

Un formatter controlla la presentazione del record; le soglie di livello e i filtri ne determinano l’elaborazione. L’impostazione si applica a questo handler, non a tutti gli handler del logger. Il modello di output del formatter è distinto dall’interpolazione degli argomenti del messaggio, come in logger.info("Items: %s", 3).

L’esempio acquisisce l’output in io.StringIO, prima con un formato personalizzato e poi dopo averlo rimosso. Omette i timestamp e la configurazione del logger radice per mantenere deterministico il risultato.

Esempi

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

Risultato

INFO | Items: 3
Items: 3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti