Cursus — Python Module 04 pendiente

«Data Archivist»: ficheros y flujos de datos. Cuatro ejercicios, del rank 02, en unos archivos digitales del año 2087, que recorren open, lectura y escritura, la entrada, salida y error estándar y, al final, la sentencia with. Aún no está hecho: esta ficha explica el enunciado; el código llegará cuando lo esté.

Del descriptor al objeto fichero — En C abrir un fichero era pedirle al sistema un número: open devuelve un descriptor, un int, y con él read y write mueven bytes hasta que close lo libera. Lo hiciste en C 10 (ft_cat, ft_tail) y en get_next_line. Python envuelve ese descriptor en un objeto que decodifica el texto, lleva su propio búfer y sabe leerse entero, por líneas o a trozos. Debajo sigue estando lo mismo: las llamadas al sistema de Unix y sus tres canales heredados de los años setenta — entrada estándar (0), salida estándar (1) y error estándar (2) —, «más antiguos que Internet», como dice el enunciado. Y sigue estando el viejo problema de cerrar lo que abres, que Python resolvió en 2006 (Python 2.5) con la sentencia with y los gestores de contexto: el último ejercicio.

Qué pide

Rank: 02Python: 3.10 o superiorObligatorio: flake8, mypyEjercicios: 4 (ex0–ex3)

Los ejemplos usan un fichero de prueba, ancient_fragment.txt, con tres líneas del tipo [FRAGMENT 001] …; hay que crearlo a mano para probar.

ex0ft_ancient_text

Entrega: ex0/ft_ancient_text.pyAutorizado: import sys, sys.argv, len(), open(), import typing, typing.IO, io.read(), io.close(), print()

Recibe el nombre de un fichero por la línea de comandos, lo lee y muestra su contenido como haría cat, entre una cabecera y un pie como los del ejemplo (que acaba con «File '…' closed.»). Sin argumento, muestra el uso. Hay que gestionar los fallos: fichero inexistente ([Errno 2] No such file or directory), sin permisos ([Errno 13] Permission denied), etc.

Qué te obliga a aprender — El ciclo abrir, leer y cerrar en Python, y que los errores del sistema llegan como excepciones (la familia OSError del Module 02) con el mismo errno que en C. El enunciado pregunta qué tipo de dato devuelve open(): no es un número como en C sino un objeto fichero, y para anotarlo en las firmas está autorizado typing.IO.

ex1ft_archive_creation

Entrega: ex1/ft_archive_creation.pyAutorizado: import sys, sys.argv, len(), open(), import typing, typing.IO, io.read(), io.write(), io.close(), print(), input()

Se parte del ex0 y, al final, se añade: poner un carácter # al final de cada línea, mostrar el contenido transformado y preguntar al usuario el nombre del fichero donde guardarlo, o dejarlo vacío para no guardar nada. Si da un nombre, se guarda (creando el fichero o sustituyéndolo si ya existe) y se muestra un mensaje final.

Qué te obliga a aprender — Escribir: los modos de open («r» para leer, «w» para escribir desde cero, «a» para añadir al final…), que son los O_RDONLY, O_WRONLY | O_CREAT | O_TRUNC y compañía de C con otro nombre. Y transformar texto línea a línea sin perder los saltos de línea: el # va antes del \n, no después.

ex2ft_stream_management

Entrega: ex2/ft_stream_management.pyAutorizado: import sys, sys.argv, sys.stdin, sys.stdout, sys.stderr, len(), open(), import typing, typing.IO, io.read(), io.readline(), io.write(), io.flush(), io.close(), print()

Se parte del ex1 con dos cambios: los mensajes de error que salen de las excepciones se escriben en la salida de error, no en la estándar, con un prefijo claro ([STDERR] en el ejemplo); y la respuesta del usuario se lee sin usar input().

Qué te obliga a aprender — Que sys.stdin, sys.stdout y sys.stderr son objetos fichero como los que abres tú, ya abiertos al arrancar: el write(2, …) de C es aquí escribir en sys.stderr. Separar los canales importa porque permite redirigirlos por separado (2> errores.log) y que un error nunca se cuele en los datos que se pasan por una tubería. Hacer a mano el trabajo de input() enseña lo que hacía por ti: mostrar la pregunta, asegurarse de que se ve aunque no acabe en salto de línea (el búfer de salida y flush) y quitar el \n final de lo leído.

ex3ft_vault_security

Entrega: ex3/ft_vault_security.pyAutorizado: open(), read(), write(), print()

Una función secure_archive() que da acceso seguro a cualquier fichero, para leer o para escribir, usando with. Recibe un nombre de fichero obligatorio, un parámetro opcional (un int o un str, a elegir) que indica la acción, y otra cadena opcional con el contenido a escribir. Devuelve una tupla (True|False, str): si la operación ha ido bien y el contenido asociado (lo leído o un mensaje de error). El ejemplo prueba un fichero inexistente, uno sin permisos, uno normal y la escritura de lo leído en un fichero nuevo. En la evaluación se revisará que la estructura del código cumpla estos requisitos.

La sintaxis general de with:

with open("notas.txt") as f:
    texto = f.read()
# aquí f ya está cerrado, haya habido error o no
Qué te obliga a aprender — Los gestores de contexto: un objeto que sabe prepararse al entrar en el bloque y limpiar al salir, salga como salga. Es el try/finally del Module 02 empaquetado y reutilizable, y la razón por la que el enunciado prohíbe with antes: para que en ex0–ex2 cierres a mano y entiendas lo que with te ahorra. También los parámetros opcionales con valor por defecto y devolver un resultado en forma de tupla en lugar de lanzar la excepción.
Puntos delicados

Fuente

Enunciado oficial en inglés, Data Archivist — Digital Preservation in the Cyber Archives, versión 3.0: packs/cursus/M2/206_Python_Module_04/en.subject.pdf, con el texto extraído en subject.txt en la misma carpeta.