Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes