Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

logging.StreamHandler

StreamHandler zapisuje tekst rekordu i terminator do przekazanego strumienia, domyślnie sys.stderr, po czym go opróżnia przez flush.

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

Składnia

logging.StreamHandler(stream=None)

StreamHandler zapisuje tekst rekordu i terminator do przekazanego strumienia, domyślnie sys.stderr, po czym go opróżnia przez flush.

Domyślny terminator to nowa linia. Po zmianie na | dwa rekordy dają a|b|. setStream opróżnia i zwraca poprzedni strumień przy zmianie, a dla tego samego zwraca None.

Zamknięcie handlera nie zamyka przekazanego strumienia.

import logging,io,sys
a,b=io.StringIO(),io.StringIO()
h=logging.StreamHandler(a)
assert logging.StreamHandler().stream is sys.stderr
r=logging.LogRecord('app',20,'',0,'one',(),None)
h.emit(r)
assert a.getvalue()=='one\n' and h.setStream(b) is a and h.setStream(b) is None
h.terminator='|'
h.emit(r)
h.close()
assert b.getvalue()=='one|' and not b.closed

Przykłady

import logging
from io import StringIO

out = StringIO()
h = logging.StreamHandler(out)
h.terminator = "|"
log = logging.getLogger("capture")
log.propagate = False
log.addHandler(h)
log.warning("a")
log.warning("b")
print(out.getvalue())

Wynik

a|b|

Zamknięcie handlera nie zamyka przekazanego strumienia.

Źródła