WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

contextlib.redirect_stderr

Bindet sys.stderr vorübergehend an ein beschreibbares Ziel und liefert es über as.

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

Syntax

with contextlib.redirect_stderr(new_target) as stream:

Bindet sys.stderr vorübergehend an ein beschreibbares Ziel und liefert es über as.

Threads desselben Interpreters teilen sys.stderr. Wiedereintrittsfähigkeit bedeutet hier keine Threadsicherheit. Hier schreibt print explizit nach sys.stderr und notice landet im Puffer, während sys.stdout gleich bleibt. Beim Austritt wird auch nach Fehlern der alte Strom wiederhergestellt.

Die Änderung ist global und schachtelbar, der Fehlerkanal eines Unterprozesses bleibt unberührt.

import io, sys
from contextlib import redirect_stderr
before = sys.stderr
s = io.StringIO()
try:
    with redirect_stderr(s) as stream:
        assert stream is s
        print("warning", file=sys.stderr)
        raise ValueError
except ValueError:
    assert sys.stderr is before and s.getvalue() == "warning\n"
other = io.StringIO()
with redirect_stderr(s):
    with redirect_stderr(other):
        assert sys.stderr is other
    assert sys.stderr is s

Beispiele

import contextlib
import io, sys

buffer = io.StringIO()
with contextlib.redirect_stderr(buffer):
    print("notice", file=sys.stderr)
print(buffer.getvalue().strip())

Ergebnis

notice

Die Änderung ist global und schachtelbar, der Fehlerkanal eines Unterprozesses bleibt unberührt.

Quellen