CKTIS / Python
contextlib.redirect_stderr
Associa temporariamente sys.stderr a um destino de escrita e fornece-o por as.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
with contextlib.redirect_stderr(new_target) as stream:Associa temporariamente sys.stderr a um destino de escrita e fornece-o por as.
As threads do mesmo interpretador partilham sys.stderr. A reentrância não garante segurança entre threads. Aqui print dirigido a sys.stderr guarda notice na memória sem alterar sys.stdout. A saída repõe o fluxo anterior mesmo após um erro.
A alteração é global e permite aninhamento, sem redirecionar o canal de erro do sistema de um subprocesso.
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
Exemplos
import contextlib
import io, sys
buffer = io.StringIO()
with contextlib.redirect_stderr(buffer):
print("notice", file=sys.stderr)
print(buffer.getvalue().strip())
Resultado
notice
A alteração é global e permite aninhamento, sem redirecionar o canal de erro do sistema de um subprocesso.