HOWTO · Python
Como abrir arquivos em outro diretório no Python
Aprenda a abrir arquivos fora do diretório de trabalho atual do Python usando um caminho absoluto, pathlib ou um caminho relativo, e entenda como os caminhos são resolvidos.
Nesta página
Passe o caminho do arquivo à função open() do Python. Um caminho absoluto identifica o arquivo a partir da raiz do sistema de arquivos; um caminho relativo começa no diretório de trabalho atual (CWD) do processo. O CWD pode ser diferente do diretório em que seu script está. Para arquivos do projeto, pathlib.Path facilita a criação de caminhos compatíveis com diferentes sistemas operacionais.
Entenda os caminhos de arquivos e o diretório de trabalho atual
O CWD é o diretório que o Python usa para resolver caminhos relativos. Em geral, é o diretório de onde você iniciou o programa, e não aquele em que o script está. Confira o CWD quando um caminho não apontar para o local esperado:
import os
print(os.getcwd())
Um caminho absoluto indica um local independentemente do CWD. Já um caminho relativo, como data/notes.txt, é interpretado a partir do CWD. Se open() não encontrar o local resultante, o Python gera FileNotFoundError; antes de alterar o código, confira o caminho e o CWD.
Abra um arquivo com um caminho absoluto
Use o caminho completo quando souber onde o arquivo está. Este exemplo cria um arquivo em um caminho temporário absoluto, lê o conteúdo e o imprime:
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as directory:
file_path = Path(directory) / "notes.txt"
file_path.write_text("Meeting at 10", encoding="utf-8")
with open(file_path, "r", encoding="utf-8") as file:
print(file.read())
O diretório temporário torna o exemplo independente dos arquivos que já existem no seu computador. No seu programa, substitua-o pelo local real do arquivo. O modo "r" lê texto, e encoding="utf-8" deixa a codificação explícita. A instrução with fecha o arquivo ao fim do bloco, mesmo que ocorra um erro dentro dele.
No Windows, você pode escrever um caminho usando barras normais, uma string raw como r"C:\Users\Ada\notes.txt" ou barras invertidas escapadas, como "C:\\Users\\Ada\\notes.txt". Uma barra invertida inicia uma sequência de escape apenas quando vem seguida de uma sequência reconhecida; por exemplo, \n representa uma quebra de linha. Uma string literal raw não pode terminar com uma única barra invertida. Construir o caminho a partir de componentes com pathlib evita boa parte desse cuidado com as strings.
Monte caminhos com pathlib
pathlib.Path é uma classe que representa e combina caminhos do sistema de arquivos. O operador / junta componentes de acordo com as convenções de caminho do sistema operacional atual. Neste exemplo, um arquivo é criado em um diretório irmão e aberto por meio de seu caminho absoluto:
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as parent:
root = Path(parent)
current = root / "app"
other = root / "shared"
current.mkdir()
other.mkdir()
target = other / "notes.txt"
target.write_text("Shared notes", encoding="utf-8")
file_path = target.resolve()
with open(file_path, "r", encoding="utf-8") as file:
print(file.read())
Em um projeto real, comece por um diretório conhecido e acrescente os nomes das pastas, como em Path("/srv/project") / "data" / "notes.txt". Use um diretório inicial absoluto quando o programa precisar funcionar independentemente de onde foi iniciado. Path.resolve() fornece um caminho absoluto para um destino existente e pode facilitar o diagnóstico de problemas com caminhos.
Use um caminho relativo ou altere o diretório de trabalho
Imagine que o projeto tenha scripts/read_notes.py e shared/notes.txt, e que o CWD seja project/scripts. A partir desse CWD, ../shared/notes.txt sobe para project e então entra em shared. Isso é prático quando o diretório de inicialização é previsível, mas o mesmo caminho relativo pode apontar para outro local se o programa começar com um CWD diferente. Para ancorar o caminho do projeto ao script, construa-o a partir de Path(__file__).resolve().parent.
Este exemplo executável cria essa estrutura de projeto, define o CWD do processo como project/scripts e lê o arquivo irmão usando um gerenciador de contexto:
import os
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as directory:
project = Path(directory) / "project"
scripts = project / "scripts"
shared = project / "shared"
scripts.mkdir(parents=True)
shared.mkdir()
(shared / "notes.txt").write_text("Project notes", encoding="utf-8")
original_directory = os.getcwd()
try:
os.chdir(scripts)
with open("../shared/notes.txt", "r", encoding="utf-8") as file:
print(file.read())
finally:
os.chdir(original_directory)
O caminho relativo é resolvido a partir do CWD do processo, definido neste exemplo como project/scripts; ele não é resolvido a partir do diretório do arquivo-fonte.
Se um programa manipula vários arquivos em um mesmo diretório, pode alterar o CWD do processo e então usar caminhos relativos mais curtos. Este exemplo cria o arquivo de entrada antes de mudar de diretório e restaura o CWD original em seguida:
import os
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as directory:
target = Path(directory) / "notes.txt"
target.write_text("Daily notes", encoding="utf-8")
original_directory = os.getcwd()
try:
os.chdir(directory)
with open("notes.txt", "r", encoding="utf-8") as file:
print(file.read())
finally:
os.chdir(original_directory)
os.chdir() altera o estado de todo o processo e, por isso, também muda a forma como outras partes do programa resolvem caminhos relativos. Restaurar o diretório anterior limita esse efeito. Para um único arquivo, passar um caminho absoluto ou um caminho pathlib costuma ser mais simples. Se o acesso ainda falhar, confira se o processo tem permissão para ler o arquivo e verifique também onde ele está.