HOWTO · Python
Cómo abrir archivos en otro directorio en Python
Aprende a abrir un archivo fuera del directorio de trabajo actual de Python con una ruta absoluta, pathlib o una ruta relativa, y descubre cómo se resuelven las rutas.
En esta página
Pasa la ruta del archivo a la función open() de Python. Una ruta absoluta identifica un archivo desde la raíz del sistema de archivos; una ruta relativa se interpreta desde el directorio de trabajo actual (CWD) del proceso. El CWD puede ser distinto del directorio que contiene el script. Para acceder a archivos de un proyecto, pathlib.Path facilita la creación de rutas compatibles con distintos sistemas operativos.
Entender las rutas de archivo y el directorio de trabajo actual
El CWD es el directorio que Python toma como base para resolver las rutas relativas. A menudo es el directorio desde el que se inició el programa, no el directorio del script. Si una ruta no apunta al lugar esperado, comprueba cuál es:
import os
print(os.getcwd())
Una ruta absoluta indica una ubicación independientemente del CWD. Una ruta relativa como data/notes.txt se interpreta dentro del CWD. Si open() no encuentra la ubicación resultante, Python genera FileNotFoundError; antes de cambiar el código, comprueba tanto la ruta como el CWD.
Abrir un archivo con una ruta absoluta
Usa la ruta completa cuando sepas dónde está el archivo. Este ejemplo crea un archivo en una ruta temporal absoluta, lo lee e imprime su contenido:
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())
El directorio temporal hace que el ejemplo no dependa de archivos que ya existan en tu equipo. En tu programa, sustitúyelo por la ubicación real del archivo. El modo "r" sirve para leer texto, y encoding="utf-8" deja explícita la codificación. La instrucción with cierra el archivo al terminar el bloque, incluso si se produce un error dentro de él.
En Windows, puedes escribir una ruta con barras inclinadas, como una cadena sin procesar (r"C:\Users\Ada\notes.txt"), o con barras inversas escapadas ("C:\\Users\\Ada\\notes.txt"). Una barra inversa inicia una secuencia de escape solo cuando va seguida de una secuencia reconocida; por ejemplo, \n representa un salto de línea. Un literal de cadena sin procesar no puede terminar con una sola barra inversa. Construir la ruta a partir de componentes con pathlib evita buena parte de este manejo de cadenas.
Construir rutas con pathlib
pathlib.Path es una clase para representar y combinar rutas del sistema de archivos. El operador / une componentes según las convenciones de rutas del sistema operativo actual. Este ejemplo crea un archivo en un directorio hermano y lo abre mediante su ruta absoluta:
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())
En un proyecto real, parte de un directorio conocido y añade los nombres de sus subdirectorios, como en Path("/srv/project") / "data" / "notes.txt". Usa un directorio inicial absoluto si el programa debe funcionar independientemente de dónde se haya iniciado. Path.resolve() obtiene una ruta absoluta para un destino existente y puede facilitar el diagnóstico de rutas.
Usar una ruta relativa o cambiar el directorio de trabajo
Supón que el proyecto contiene scripts/read_notes.py y shared/notes.txt, y que el CWD es project/scripts. Desde ese CWD, ../shared/notes.txt sube a project y luego entra en shared. Es práctico cuando el directorio de inicio es predecible, pero la misma ruta relativa puede apuntar a otro lugar si el programa se inicia con un CWD diferente. Para anclar la ruta del proyecto al script, constrúyela a partir de Path(__file__).resolve().parent.
Este ejemplo ejecutable crea la estructura del proyecto, establece el CWD del proceso en project/scripts y lee el archivo hermano con un gestor 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)
La ruta relativa se resuelve desde el CWD del proceso, que este ejemplo establece en project/scripts; no se resuelve desde el directorio del archivo fuente.
Si un programa procesa varios archivos de un mismo directorio, puede cambiar el CWD del proceso y después usar rutas relativas más cortas. Este ejemplo crea el archivo de entrada antes de cambiar de directorio y restaura el CWD original al terminar:
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() cambia el estado de todo el proceso y, por tanto, también cambia cómo se resuelven las rutas relativas en otras partes del programa. Restaurar el directorio anterior limita ese efecto. Para un solo archivo, suele ser más sencillo pasar una ruta absoluta o una ruta de pathlib. Si el acceso sigue fallando, comprueba que el proceso tenga permiso para leer el archivo y verifica también su ubicación.