CKTIS / Python
Lista handlerów loggera: odczyt, odłączanie i podłączanie
W Pythonie 3.12 `logger.handlers` pokazuje tylko handlery podłączone bezpośrednio do loggera. Listę odczytuj, a jej zawartość zmieniaj metodami `addHandler()` i `removeHandler()`.
Wersja: Python 3.12
Składnia
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 to atrybut instancji zawierający listę handlerów podłączonych bezpośrednio do danego loggera. Nie zawiera handlerów loggerów nadrzędnych i nie jest modułem logging.handlers. len(logger.handlers) liczy tylko bezpośrednie podłączenia.
Listę traktuj jako przeznaczoną tylko do odczytu. logger.addHandler(handler) podłącza handler, a logger.removeHandler(handler) go odłącza. Nie używaj logger.handlers.clear(), append() ani przypisania nowej listy: omijają one blokady używane przez te metody. Aby opróżnić listę, iteruj po kopii list(logger.handlers) i wywołuj removeHandler() dla każdego elementu. Dzięki kopii nie zmieniasz listy, po której iterujesz, ale cała operacja nie jest atomowa.
Odłączenie nie zamyka handlera. Wywołuj handler.close() osobno dla handlera, którym zarządzasz, gdy nie jest już nigdzie potrzebny. Nie zamykaj handlera tylko dlatego, że został odłączony od jednego loggera: może nadal być współdzielony.
Pusta lista nie oznacza ciszy. logger.hasHandlers() sprawdza także loggery nadrzędne osiągalne przez propagację; sprawdza obecność handlera, a nie to, czy konkretny rekord zostanie wypisany. logger.propagate = False blokuje przekazywanie do loggerów nadrzędnych. Jeśli na tej drodze nie ma żadnego handlera, zastosowanie może mieć logging.lastResort, który domyślnie wypisuje rekordy od poziomu WARNING na standardowe wyjście błędów.
Przykłady
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()Wynik
before: 1 cleared: 0 attached: 1 ready
Uruchom przykład w nowym procesie. Liczniki pokazują kolejno jeden handler bezpośredni, pustą listę i jeden nowy handler. `ready` wypisuje nowy `StreamHandler`, a blok `finally` odłącza go i zamyka.
Powiązane lekcje
- Python · Lekcja 27 · Zaawansowany · Wersja: 5
Źródła
- 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