La entrada y salida de ficheros (comúnmente llamada File I/O) es una herramienta que Python, como la mayoría de los lenguajes, nos brinda de forma estándar. Su utilización es similar a la del lenguaje C, aunque añade mayores caracterísitcas. Puedes encontrar la documentación oficial del tema Reading and Writing Files en este enlace.

El primer paso para introducirnos es saber cómo abrir un determinado archivo. Para esto se utiliza la función open, que toma como primer argumento el nombre de un fichero.

open("archivo.txt")

No está de más aclarar que esto no significa ejecutar el programa por defecto para editar el fichero, sino cargarlo en la memoria para poder realizar operaciones de lectura y escritura.

En caso de no especificarse la ruta completa, se utilizará la actual (donde se encuentre el script).

Como segundo argumento, open espera el modo (como una cadena) en el que se abrirá el fichero. Esto indica si se utilizará para lectura, escritura, ambas, entre otras.

open("archivo.txt", "r")

La r indica el modo lectura. Si se intentara utilizar la función write para escribir algo, se lanzaría la excepción IOError. A continuación los distintos modos.

• r – Lectura únicamente.
• w – Escritura únicamente, reemplazando el contenido actual del archivo o bien creándolo si es inexistente.
• a – Escritura únicamente, manteniendo el contenido actual y añadiendo los datos al final del archivo.
• w+, r+ o a+ – Lectura y escritura.

El signo '+' permite realizar ambas operaciones. La diferencia entre w+ y r+ consiste en que la primera opción borra el contenido anterior antes de escribir nuevos datos, y crea el archivo en caso de ser inexistente. a+ se comporta de manera similar, aunque añade los datos al final del archivo.

Todas las opciones anteriores pueden combinarse con una 'b' (de binary), que consiste en leer o escribir datos binarios. Esta opción es válida únicamente en sistemas Microsoft Windows, que hacen una distinción entre archivos de texto y binarios. En el resto de las plataformas, es simplemente ignorada. Ejemplos: rb, wb, ab+, rb+, wb+.

Por último, open() retorna una instancia de la clase file, desde la cual podremos ejecutar diversas operaciones.

f = open("archivo.txt", "w")

En este ejemplo he abierto el fichero archivo.txt que, en caso de no existir, será automáticamente creado en el directorio actual. A continuación escribiré algunos datos utilizando la función file.write.

f.write("Esto es un texto.")

Reiteradas llamadas a esta función añaden texto al archivo hasta que sea cerrado.

f.write("Esto es una linea.\n")
f.write("Esto es otra linea.\n")
f.write("Esta es la tercer linea.\n")

Nótese el uso del carácter '\n' para indicar el salto de línea.

Por último, cerramos el archivo.

f.close()

---

Con respecto a la lectura, las tres funciones disponibles son read, readline y readlines.

f = open("archivo.txt", "r")
content = f.read()
print(content)
f.close()

Imprime:

Esto es una linea.
Esto es otra linea.
Esta es la tercer linea.

Una segunda llamada a f.read() retornaría una cadena vacía, debido a que ya se ha obtenido todo el contenido.

print(f.readline())
print(f.readline())

Imprime:

Esto es una linea.

Esto es otra linea.

Nótse el carácter de nueva línea al final de la cadena retornada.

---

Para iterar entre todas las líneas de un archivo, ambos ejemplos resultan similares:

for line in f.readlines():
    print(line)

for line in f:
    print(line)

Resultado:

Esto es una linea.

Esto es otra linea.

Esta es la tercer linea.


---

file.seek() permite posicionarse en un determinado lugar del fichero. Ejemplo:

f.seek(30)
print(f.read())

Comienza a leer desde la posición 30, por lo que imprime:

ra linea.
Esta es la tercer linea.

A partir de Python 2.5 puede utilizarse with para asegurar que el archivo sea cerrado al finalizar su utilización, incluso si se produce un error.

with open("archivo.txt", "r") as f:
    content = f.read()

print(f.closed)  # True

Es equivalente a:

try:
    f = open("archivo.txt", "r")
    content = f.read()
finally:
    f.close()

Adicional para Python 2

Usuarios de la rama 2.x consideren utilizar codecs.open() en lugar de la convencional open(). Aquí está el porqué:

f = open("archivo.txt", "w")
f.write(u"Esto es una línea.")  # Nótese la tilde.
f.close()

Produce el siguiente error:

UnicodeEncodeError: 'ascii' codec can't encode character u'\xed' in position 13: ordinal not in range(128)

El problema radica en que open() espera una cadena de tipo ASCII, por lo que al utilizar otras codificaciónes como UTF-8 la función falla.

import codecs

f = codecs.open("archivo.txt", "w", "utf-8")
f.write(u"Esto es una línea.")
f.close()

Este código es ejecutado sin problemas. codecs.open() añade un tercer argumento en el que puede especificarse la codificación.

Además, como alternativa, también puede utilizarse el módulo io con su función io.open, que extiende las funcionalidades de la interfaz tradicional.