HOWTO · Python
Redirecionar a saída de impressão para um arquivo em Python
Este tutorial demonstra como redirecionar a saída de impressão para um arquivo em Python
Nesta página
Para salvar texto em um arquivo no Python, abra-o com open() e escreva usando o objeto de arquivo retornado. Use o modo "w" para criar ou substituir um arquivo, ou "a" para acrescentar conteúdo ao final. Uma instrução with fecha o arquivo quando o bloco termina.
Este exemplo grava uma mensagem em report.txt e, em seguida, exibe o texto salvo:
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "report.txt"
with path.open("w", encoding="utf-8") as file:
file.write("Monthly report\nRevenue: 1200\n")
print(f"Saved to {path.name}:")
print(path.read_text(encoding="utf-8"), end="")
Saved to report.txt:
Monthly report
Revenue: 1200
Os exemplos a seguir mostram quando usar write(), print(), o redirecionamento da saída padrão, writelines() ou a interface de caminhos de pathlib. A maioria usa uma instrução with para fechar o arquivo automaticamente; o exemplo com sys.stdout restaura o fluxo anterior e fecha o arquivo explicitamente.
Escrever texto com open() e write()
open() define como um arquivo será aberto; write() é um método do objeto de arquivo que ela retorna. O modo "w" cria um arquivo ou substitui o conteúdo existente. O modo "a" cria o arquivo, se necessário, e acrescenta texto ao final. Esses são modos de abertura do arquivo, não operações de write().
write() recebe uma string e não adiciona uma quebra de linha. Inclua \n onde quiser iniciar uma nova linha. O valor de retorno é o número de caracteres escritos.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "notes.txt"
with path.open("w", encoding="utf-8") as file:
file.write("First line\n")
file.write("Second line\n")
print(path.read_text(encoding="utf-8"), end="")
First line
Second line
Para acrescentar conteúdo, altere o modo para "a". Por exemplo, with open("notes.txt", "a", encoding="utf-8") as file: file.write("Next entry\n") adiciona uma linha após o conteúdo existente. O caminho é resolvido em relação ao diretório de trabalho atual do programa, a menos que você informe outro caminho.
Gravar em um arquivo com print()
Use print(..., file=file_object) quando quiser o comportamento de formatação habitual de print(), mas precisar gravar a saída em um arquivo. A função converte objetos em texto, separa vários valores com um espaço por padrão e adiciona uma quebra de linha por padrão. sep e end permitem alterar essas opções.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "summary.txt"
with path.open("w", encoding="utf-8") as file:
print("Count:", 3, file=file)
print("Ready:", True, file=file)
print(path.read_text(encoding="utf-8"), end="")
Count: 3
Ready: True
O bloco with fecha o arquivo quando a impressão termina. Não é necessário chamar close() dentro desse bloco; quando ele termina, o Python fecha o arquivo automaticamente.
Redirecionar a saída padrão com sys.stdout
sys.stdout é o fluxo usado por print() quando o argumento file não é fornecido. Atribuir um arquivo a sys.stdout redireciona a saída padrão do processo. Por isso, salve e restaure o fluxo anterior e feche o arquivo. Para redirecionamentos pontuais e delimitados, prefira contextlib.redirect_stdout() na próxima seção. Consulte a referência de sys.stdout. O destino em português não está disponível; a referência está em inglês.
import sys
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "log.txt"
previous_stdout = sys.stdout
file = path.open("w", encoding="utf-8")
try:
sys.stdout = file
print("Job complete")
finally:
sys.stdout = previous_stdout
file.close()
print(path.read_text(encoding="utf-8"), end="")
Job complete
Restaurar o fluxo original em finally garante que as saídas seguintes voltem ao destino anterior, inclusive quando o código no bloco redirecionado falha. O with externo gerencia o diretório temporário; o próprio arquivo é fechado explicitamente após a restauração de sys.stdout.
Redirecionar a saída temporariamente com contextlib.redirect_stdout()
contextlib.redirect_stdout() direciona temporariamente sys.stdout para um objeto semelhante a um arquivo dentro de um bloco with. Quando o bloco termina, o fluxo de saída padrão anterior é restaurado. O arquivo continua sendo gerenciado por sua própria instrução with.
import contextlib
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "output.txt"
with path.open("w", encoding="utf-8") as file:
with contextlib.redirect_stdout(file):
print("Build finished")
print(path.read_text(encoding="utf-8"), end="")
Build finished
Essa abordagem captura chamadas a print() e outras gravações na saída padrão feitas dentro do contexto. Ela não redireciona a saída de erro padrão (sys.stderr).
Escrever uma sequência com writelines()
writelines() grava no arquivo, em ordem, cada string de um iterável. O método não insere quebras de linha; portanto, inclua \n nas strings quando quiser que o arquivo tenha linhas separadas.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "items.txt"
lines = ["apples\n", "pears\n", "plums\n"]
with path.open("w", encoding="utf-8") as file:
file.writelines(lines)
print(path.read_text(encoding="utf-8"), end="")
apples
pears
plums
Em um arquivo de texto, os elementos precisam ser strings. Se não quiser quebras de linha, deixe \n de fora de cada string.
Abrir e gravar arquivos com pathlib
pathlib fornece objetos para criar e manipular caminhos do sistema de arquivos. Ele não substitui os objetos de arquivo: use Path.open() para obter um objeto e, em seguida, chame o método write() dele. Isso é útil quando o caminho é montado a partir de pastas ou de outros componentes.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
path = Path(folder) / "archive" / "entry.txt"
path.parent.mkdir()
with path.open("w", encoding="utf-8") as file:
file.write("Stored with pathlib.\n")
print(path.read_text(encoding="utf-8"), end="")
Stored with pathlib.
Use Path.write_text() para gravar texto em uma única etapa, de forma concisa, quando não precisar gerenciar diretamente um objeto de arquivo. Para gravações repetidas ou métodos como writelines(), Path.open() fornece o objeto de arquivo necessário.
Para fazer a tarefa inversa, consulte como ler um arquivo para uma string em Python.