Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

logging.StreamHandler

StreamHandler écrit le texte et le terminateur dans le flux fourni, par défaut sys.stderr, puis appelle flush.

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

Syntaxe

logging.StreamHandler(stream=None)

StreamHandler écrit le texte et le terminateur dans le flux fourni, par défaut sys.stderr, puis appelle flush.

Le terminateur initial est un saut de ligne. Avec |, deux records donnent a|b|. Lors d’un changement setStream vide le tampon et renvoie l’ancien flux, ou None pour le même flux.

Fermer le gestionnaire laisse le flux fourni ouvert.

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

Exemples

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

Résultat

a|b|

Fermer le gestionnaire laisse le flux fourni ouvert.

Sources