INF246-Tarea1: A C repository from HectorxH

Integrantes
｡*:☆☞°ヮ°)☞ ☜(°ヮ°☜)｡:゜☆｡
+---------------------+-------------+
| Nombre | ROL |
+---------------------+-------------+
| Héctor Larrañaga | 201873623-6 |
+---------------------+-------------+
| Anastasiia Fedorova | 201873505-1 |
+---------------------+-------------+

+---------------------------------------------------------+
SOBRE MAKEFILE
(los comandos se anotan en comillas para diferenciarlas del texto simple)
☆ Ingresar "make" en la consola para ejecutar el makefile.
☆ Ingresar "./main.out" para ejecutar el código.
☆ Ingresar "make clean" en la consola para borrar los archivos .o y .out
☆ Para evitar los conflictos con <dirent.h> se utiliza gnu11 para la compilación.
+---------------------------------------------------------+
SOBRE LOS ARCHIVOS DE JUEGOS Y LAS CARPETAS
☆ Se asume que los archivos de juegos tendrán nombres en formato "nombrejuego.txt"
☆ Para el correcto funcionamiento, los .txt deben estar ubicados en carpeta "games",
en el mismo directorio donde se ubica el ejecutable.
☆ En caso contrario, el programa desplegará el error de "./games no encontrada".
☆ Para ordenar los juegos se creará la carpeta base "Steam"
☆ Se entrega los .txt generados a partir de un .csv de manera aleatoria.
Las categorías de cada juego no necesariamente reflejan la realidad
(ej. Payday2 puede ser un Visual Novel porque así fue generado etc.)
+---------------------------------------------------------+
SOBRE EL GENERADOR
☆ Se entrega un generador escrito en Python junto con .csv base
☆ Para generar más casos de prueba basta correr "python3 generator.py"
☆ El generador no asegura que hayan 2 juegos por categoría ni que hayan 5 juegos con más de una categoría.
El caso ya generado sí cumple este criterio. En caso de querer generar más casos casos tener en cuenta que la regla
no necesariamente se va a cumplir.
+---------------------------------------------------------+
SOBRE LAS LLAMADAS AL SISTEMA
☆ El programa utiliza "mkdir()" para crear directorios.
> https://man7.org/linux/man-pages/man2/mkdir.2.html
☆ El programa utiliza "rmdir()" para borrar directorios vacios
(para limpiar ./Steam si ya existe antes de crear uno nuevo y borrar ./games vacio)
> https://man7.org/linux/man-pages/man2/rmdir.2.html
☆ El programa utiliza "rename()" para mover los archivos entre directorios.(para categorizar)
> https://man7.org/linux/man-pages/man2/rename.2.html

☆ El programa utiliza "remove()" para borrar los archivos .txt.
(para limpiar ./Steam si ya existe antes de crear uno nuevo)
> https://linux.die.net/man/3/remove
☆ El programa hace uso de libreria <dirent.h> para leer y reconocer directorios
☆ El programa utiliza "readdir()" para leer los directorios.
> https://man7.org/linux/man-pages/man2/readdir.2.html

☆ Para leer los archivos se utilizan las funciones fopen(), fgets() y fclose() que hacen las
llamadas al sistema correspondientes.
(son funciones wrapper para syscalls como, por ejemplo, open(), read(), close()).
+---------------------------------------------------------+
SOBRE LA APLICACIÓN DE LA CONSOLA
☆ La aplicación de consola tiene 3 "fases". Se utiliza el input de usuario para mostrar los
contenidos correspondientes.
☆ Fase 1: Lista de categorías. Se despliega la lista de categorías disponibles. El
usuario debe escoger una de ellas, ingresado un entero de 1 a 5. En caso de ingresar
un 0, se cierra la aplicación. En caso de ingresar un número inválido, se avisará de ello
por la consola. En caso de ingresar un número entre 1 a 5 el usuario accede la lista de juegos
según la categoría que eligió.
☆ Fase 2: Lista de juegos. Se despliega la lista de juegos ordenada según el número de categorías.
El usuario puede acceder a la información de juego al ingresar su número. Se puede volver a la lista
de las categorías al ingresar 0.
☆ Fase 3: Información sobre el juego eligido. El usuario que ingresa un número válido de juego según
la información mostrada por pantalla en la Fase 2 puede ver los datos de juego. Para ingresar a la lista
de juefos el usuario debe ingresar 0.
+---------------------------------------------------------+

HectorxH/INF246-Tarea1