CKTIS / Python
Postavljanje praga imenovanog zapisivača metodom setLevel()
Postavi imenovani zapisivač na `logging.INFO`: `DEBUG` se odbacuje, a `INFO` i više razine prolaze provjeru zapisivača. Rukovatelj i dalje odlučuje što stiže do izlaza.
Verzija: Python 3.12
Sintaksa
logger = logging.getLogger(name)
logger.setLevel(level) # e.g. logging.INFO or "INFO"Metoda instance logging.Logger.setLevel postavlja prag zapisivača na kojem je pozoveš. U Pythonu 3.12 logging.getLogger("root") vraća korijenski zapisivač, pa poziv metode setLevel() na njemu postavlja njegov prag. Ponovni dohvat s istim imenom vraća isti objekt. Proslijedi cjelobrojnu konstantu kao što je logging.INFO ili naziv razine kao što je "INFO". Pri tom se pragu DEBUG odbacuje, a INFO, WARNING, ERROR i CRITICAL prolaze provjeru razine zapisivača.
Novi zapisivač koji nije korijenski počinje s razinom logging.NOTSET. Njegov je efektivni prag tada razina najbližeg pretka čija razina nije NOTSET. Ako svi preci, uključujući korijenski zapisivač, također imaju razinu NOTSET, efektivna je razina NOTSET. Zadana razina korijenskog zapisivača je WARNING. Efektivni prag provjeri pozivom logger.getEffectiveLevel().
setLevel() ne dodaje rukovatelj ni ne odabire odredište. Svaki rukovatelj ima vlastiti prag (Handler.setLevel) i može koristiti filtre, pa prihvaćeni zapis ne mora stići do izlaza. Pri prosljeđivanju zapisi idu izravno rukovateljima predaka, bez ponovne provjere razina i filtara tih zapisivača. Postavka logger.propagate = False zaustavlja prosljeđivanje precima.
Primjeri
import logging
import sys
logger = logging.getLogger("cktis.checkout")
logger.setLevel(logging.INFO)
logger.propagate = False
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
logger.addHandler(handler)
logger.debug("Checking cart")
logger.info("Order accepted")
logger.warning("Receipt delayed")Rezultat
INFO: Order accepted WARNING: Receipt delayed
Rukovatelj piše u `sys.stdout`, a njegova zadana razina `NOTSET` ne odbacuje zapise prema ozbiljnosti. Budući da je prosljeđivanje isključeno, u novom procesu zapisivač odbacuje `DEBUG`, a `INFO` i `WARNING` ispisuju se po jednom.
Povezane lekcije
- Python · Lekcija 27 · Napredno · Verzija: 5
- Python · Lekcija 24 · Srednje · Verzija: 3