WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

logging.StreamHandler

StreamHandler schreibt Text und Abschlusszeichen in den angegebenen Stream, standardmäßig sys.stderr, und ruft flush auf.

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

Syntax

logging.StreamHandler(stream=None)

StreamHandler schreibt Text und Abschlusszeichen in den angegebenen Stream, standardmäßig sys.stderr, und ruft flush auf.

Vorgabe ist ein Zeilenumbruch. Mit | ergeben zwei Einträge a|b|. setStream leert beim Wechsel den Puffer und liefert den alten Stream, beim selben Stream None.

Das Schließen des Handlers schließt den übergebenen Stream nicht.

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

Beispiele

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

Ergebnis

a|b|

Das Schließen des Handlers schließt den übergebenen Stream nicht.

Quellen