Leer y escribir archivos en Python: open(), modos y la instrucción with
Los modos de open(), cómo leer línea a línea, escribir con write() y por qué usar with para cerrar el archivo.
Leer y escribir archivos es una de las primeras cosas útiles que se hacen en Python: guardar resultados, leer una lista de datos o procesar un texto. Todo parte de la función open(). Esta guía sigue el tutorial oficial de Python.
Abrir un archivo
open() devuelve un objeto archivo y se usa normalmente con dos argumentos: open(nombre_de_archivo, modo). El primero es una cadena con el nombre del archivo; el segundo, otra cadena con unos pocos caracteres que describen cómo se va a usar:
| Modo | Qué hace |
|---|---|
'r' |
Solo lectura. Es el valor por defecto si omites el modo |
'w' |
Solo escritura. Un archivo existente con el mismo nombre se borra |
'a' |
Abre para agregar: lo que escribes se añade al final |
'r+' |
Lectura y escritura |
Por defecto los archivos se abren en modo texto: lees y escribes cadenas, codificadas con una codificación concreta. Si no indicas encoding, el valor por defecto es UTF-8. Añadiendo una b al modo, el archivo se abre en modo binario, en el que los datos se leen y escriben como objetos bytes (y no puedes indicar una codificación).
En modo texto, Python convierte los finales de línea propios de cada plataforma (\n en Unix, \r\n en Windows) a un simple \n al leer, y al revés al escribir. Está bien para texto, pero corrompería datos binarios como los de un JPEG o un EXE: para esos archivos, usa el modo binario.
La instrucción with
El tutorial recomienda abrir los archivos con with, porque el archivo se cierra correctamente al terminar el bloque, incluso si se produce una excepción, y es más corto que un try-finally:
with open('workfile') as f:
read_data = f.read()
# Fuera del bloque, f.closed es True
Si no usas with, debes llamar a f.close() para cerrar el archivo y liberar los recursos. Python avisa de que llamar a f.write() sin with ni f.close() puede hacer que lo escrito no llegue por completo al disco, aunque el programa termine bien. Y una vez cerrado, intentar usar el archivo falla con ValueError: I/O operation on closed file.
Leer
f.read()lee todo el contenido y lo devuelve como una cadena. Con un número,f.read(size), lee como máximo esa cantidad de caracteres (o de bytes en binario). El tutorial avisa: si omites el tamaño, el archivo entero se carga en memoria, y es cosa tuya que no sea más grande que ella. Al llegar al final devuelve una cadena vacía.f.readline()lee una sola línea, con su\nal final. Si devuelve una cadena vacía, se ha llegado al final del archivo; una línea en blanco es'\n'.- Recorrer el archivo con un bucle
fores la forma que el tutorial destaca como eficiente en memoria, rápida y más sencilla:
for line in f:
print(line, end='')
- Para leer todas las líneas en una lista puedes usar
list(f)of.readlines().
Escribir
f.write(cadena) escribe la cadena en el archivo y devuelve cuántos caracteres escribió. Otros tipos de objeto hay que convertirlos antes: a cadena en modo texto o a bytes en modo binario, por ejemplo con str(valor).
Si algo falla
Abrir un archivo que no existe, o sin permisos, produce un error. Aprende a leerlo y a gestionarlo en errores y excepciones en Python. Si empiezas desde cero, antes tienes la guía para instalar Python y escribir tu primer programa, y para organizar lo que lees, las listas y diccionarios y las funciones. Si lo que lees es JSON, puedes revisarlo antes con el formateador de JSON.
Fuentes consultadas
- Entrada y salida: leer y escribir archivos (El tutorial de Python) (Python Software Foundation)
Guía de PortalTec: https://www.portaltec.eu/articulos/leer-escribir-archivos-python/
