From abb78ac1b23de05da2da8e7bd48df3c422fac7cf Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:28:35 -0300
Subject: [PATCH 01/37] feature: rename `initial-state` file

Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 src/statics/initial-state.csv | 34 ++++++++++++++++++++++++++++++++++
 src/statics/initial-state.txt |  1 -
 2 files changed, 34 insertions(+), 1 deletion(-)
 create mode 100644 src/statics/initial-state.csv
 delete mode 100644 src/statics/initial-state.txt

diff --git a/src/statics/initial-state.csv b/src/statics/initial-state.csv
new file mode 100644
index 0000000..81d1e8d
--- /dev/null
+++ b/src/statics/initial-state.csv
@@ -0,0 +1,34 @@
+Row;Column
+1;6
+1;7
+2;7
+3;5
+4;1
+4;2
+4;4
+4;6
+4;7
+4;8
+4;9
+5;1
+5;2
+5;4
+5;6
+5;10
+5;12
+6;4
+6;5
+6;8
+6;9
+6;11
+6;12
+7;4
+7;9
+8;5
+8;6
+8;7
+8;9
+9;8
+10;7
+11;7
+11;8
\ No newline at end of file
diff --git a/src/statics/initial-state.txt b/src/statics/initial-state.txt
deleted file mode 100644
index 8b13789..0000000
--- a/src/statics/initial-state.txt
+++ /dev/null
@@ -1 +0,0 @@
-

From ba06238ed63523c0f3968aa12f3b50b9cb47b942 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:29:17 -0300
Subject: [PATCH 02/37] feature: add new main argument

Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 src/src.cbp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/src.cbp b/src/src.cbp
index c9a891c..86c4aa8 100644
--- a/src/src.cbp
+++ b/src/src.cbp
@@ -11,7 +11,7 @@
 				<Option object_output="obj/Debug/" />
 				<Option type="1" />
 				<Option compiler="gcc" />
-				<Option parameters='--dashboard-rows=28 --dashboard-cols=55 --pattern=&quot;glider cannon&quot; --maximum-generation=-1 --delay=50 --platform=sdl' />
+				<Option parameters='--dashboard-rows=28 --dashboard-cols=55 --pattern=&quot;glider cannon&quot; --maximum-generation=-1 --delay=50 --platform=sdl --initial-state-file=&quot;initial-state.csv&quot;' />
 				<Compiler>
 					<Add option="-g" />
 				</Compiler>
@@ -21,7 +21,7 @@
 				<Option object_output="obj/Release/" />
 				<Option type="1" />
 				<Option compiler="gcc" />
-				<Option parameters='--dashboard-rows=28 --dashboard-cols=55 --pattern=&quot;glider cannon&quot; --maximum-generation=-1 --delay=50 --platform=sdl' />
+				<Option parameters='--dashboard-rows=28 --dashboard-cols=55 --pattern=&quot;glider cannon&quot; --maximum-generation=-1 --delay=50 --platform=sdl --initial-state-file=&quot;initial-state.csv&quot;' />
 				<Compiler>
 					<Add option="-O2" />
 				</Compiler>

From 02a8063aa8ca380e348b3a3043d6ae9511291dfa Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:30:44 -0300
Subject: [PATCH 03/37] feature: create `validateInitialStateFile` function
 validator

Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 src/validators.c | 15 ++++++++++++++-
 src/validators.h |  3 +++
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/src/validators.c b/src/validators.c
index 0d278a5..53020a1 100644
--- a/src/validators.c
+++ b/src/validators.c
@@ -1,6 +1,9 @@
 
 #include "./validators.h"
 
+#include <stdio.h>
+#include <strings.h>
+
 #include "./macros.h"
 #include "./sdl/methods.h"
 
@@ -24,4 +27,14 @@ int validateCols(int cols) {
     maxCols = (screenWidth / CELL_SIZE) - 2;
 
     return cols > 0 && cols <= maxCols;
-}
\ No newline at end of file
+}
+
+int validateInitialStateFile(char* filePath) {
+    char* extensions[] = {"csv", "txt"};
+    char* extension = strrchr(filePath, '.');
+
+    printf("> filePath: \"%s\"\n\n", filePath);
+    printf("> extension: \"%s\"\n\n", extension);
+
+    return extension == NULL ? 0 : isStrIn(extension + 1, extensions, 2);
+}
diff --git a/src/validators.h b/src/validators.h
index 0674f9a..d5a5118 100644
--- a/src/validators.h
+++ b/src/validators.h
@@ -7,4 +7,7 @@ int validateRows(int rows);
 // TODO: Documentation
 int validateCols(int cols);
 
+// TODO: Documentation
+int validateInitialStateFile(char* pattern);
+
 #endif  // SRC_VALIDATORS_H_INCLUDED

From c8751b251fe90a78752a5231185b4bb26521301c Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:32:52 -0300
Subject: [PATCH 04/37] feature: remove unnecessary include

Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 libs/game/structs.h | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/libs/game/structs.h b/libs/game/structs.h
index 06191cd..ecba237 100644
--- a/libs/game/structs.h
+++ b/libs/game/structs.h
@@ -2,8 +2,6 @@
 #ifndef LIBS_GAME_STRUCTS_H_INCLUDED
 #define LIBS_GAME_STRUCTS_H_INCLUDED
 
-#include "../main.h"
-
 /**
  * @struct TGame
  * @brief Represents a Conway's Game of Life structure.
@@ -25,4 +23,4 @@ typedef struct {
     int delayBetweenGenerations; /** Delay time in milliseconds for processed the next generation.*/
 } TGame;
 
-#endif  // LIBS_GAME_STRUCTS_H_INCLUDED
\ No newline at end of file
+#endif  // LIBS_GAME_STRUCTS_H_INCLUDED

From 65839d59ac594ab8feb06cdb00ae30b1b1cd2357 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:34:03 -0300
Subject: [PATCH 05/37] fix: add missing includes

Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 libs/game/methods.c          | 3 ++-
 libs/patterns/constructors.c | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/libs/game/methods.c b/libs/game/methods.c
index 64ca270..c000a7c 100644
--- a/libs/game/methods.c
+++ b/libs/game/methods.c
@@ -5,6 +5,7 @@
 #include <stdio.h>
 
 #include "../patterns/main.h"
+#include "../utilities.h"
 #include "./macros.h"
 #include "./structs.h"
 
@@ -227,4 +228,4 @@ void startGameByConsole(TGame* pGame, int maxGeneration, int delayBetweenGenerat
         printGameByConsole(pGame);
         if (generation != maxGeneration) sleep(delayBetweenGenerations);
     }
-}
\ No newline at end of file
+}
diff --git a/libs/patterns/constructors.c b/libs/patterns/constructors.c
index 87cd95c..558d840 100644
--- a/libs/patterns/constructors.c
+++ b/libs/patterns/constructors.c
@@ -2,6 +2,7 @@
 #include "./constructors.h"
 
 #include "../game/main.h"
+#include "../utilities.h"
 #include "./methods.h"
 #include "./structs.h"
 

From ad1a074f2488ab70c6af675ca66e77abe3c2c700 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:35:21 -0300
Subject: [PATCH 06/37] feature: create `drawDashboardFromFile` function

Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 libs/utilities.c | 55 +++++++++++++++++++++++++++++++++++++++++++++---
 libs/utilities.h |  6 +++++-
 2 files changed, 57 insertions(+), 4 deletions(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index 79a560f..a4d9a14 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -19,6 +19,57 @@ void destroy2DArray(char** arr, int rows, int cols) {
     free(arr);
 }
 
+int drawDashboardFromFile(char* filePath, TGame* pGame) {
+    FILE* pf;
+
+    char* line;
+    int lineLength = 100;
+
+    char* row;
+    char* col;
+    char* sep;
+
+    int rowInt;
+    int colInt;
+
+    int rows = pGame->rows;
+    int cols = pGame->cols;
+
+    pf = fopen(filePath, "rt");
+    if (pf == NULL) return 0;
+
+    line = malloc(sizeof(char) * (lineLength + 1));
+    if (line == NULL) {
+        fclose(pf);
+        return 0;
+    };
+    *(line + lineLength) = '\0';
+
+    fgets(line, lineLength, pf);
+
+    while (fgets(line, lineLength, pf)) {
+        row = line;
+        sep = strrchr(line, ';');
+        if (sep == NULL) continue;
+
+        *sep = '\0';
+        col = sep + 1;
+
+        sscanf(row, "%d", &rowInt);
+        sscanf(col, "%d", &colInt);
+
+        if (rowInt > rows) rows = rowInt;
+        if (colInt > cols) cols = colInt;
+    }
+
+    printf("\n\n> rows: %d\n", rows);
+    printf("> cols: %d\n\n", cols);
+
+    // TODO: draw in dashboard.
+
+    return 1;
+}
+
 char* getUserInputStr(char* message, char* onInvalidMessage, int strLength,
                       int (*validator)(char* userInput)) {
     char* userInput = malloc(strLength * sizeof(char));
@@ -79,8 +130,7 @@ char** new2DArray(int rows, int cols) {
 
 void sleep(int miliseconds) {
     clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds))
-        ;
+    while (clock() < (startTime + miliseconds));
 }
 
 int strcmpi(const char* str01, const char* str02) {
@@ -138,7 +188,6 @@ void trimRightStr(char* str) {
 
     for (i = strLength - 1; i > 0; i--) {
         if (!isspace(*(str + i))) break;
-        counter++;
     }
 
     *(str + strLength - counter) = '\0';
diff --git a/libs/utilities.h b/libs/utilities.h
index 1c590f8..88c9e11 100644
--- a/libs/utilities.h
+++ b/libs/utilities.h
@@ -4,6 +4,7 @@
 
 #include <stdlib.h>
 
+#include "./game/main.h"
 #include "./macros.h"
 #include "./patterns/main.h"
 
@@ -23,6 +24,9 @@
  */
 void destroy2DArray(char** arr, int rows, int cols);
 
+// TODO: Documentation
+int drawDashboardFromFile(char* filePath, TGame* pGame);
+
 /**
  * @brief Gets user input as a string.
  *
@@ -134,4 +138,4 @@ void trimLeftStr(char* str);
  */
 void trimRightStr(char* str);
 
-#endif  // LIBS_UTILITIES_H_INCLUDED
\ No newline at end of file
+#endif  // LIBS_UTILITIES_H_INCLUDED

From 2da6b96f10680b670025bf62707bfa96dfe903f0 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:37:01 -0300
Subject: [PATCH 07/37] feature: add new main argument

 Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 src/structs.h   | 1 +
 src/utilities.c | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/src/structs.h b/src/structs.h
index db537bc..5cdc984 100644
--- a/src/structs.h
+++ b/src/structs.h
@@ -10,6 +10,7 @@ typedef struct {
     int maximumGeneration;
     int delay;
     char* platform;
+    char* initialStateFile;
 } TMainArguments;
 
 #endif  // SRC_STRUCTS_H_INCLUDED
\ No newline at end of file
diff --git a/src/utilities.c b/src/utilities.c
index ed63e14..54923da 100644
--- a/src/utilities.c
+++ b/src/utilities.c
@@ -21,6 +21,8 @@ void getMainArguments(TMainArguments* pMainArguments, int argc, char* argv[]) {
     for (i = 1; i < argc; i++) {
         argumentName = *(argv + i);
         sep = strrchr(argumentName, '=');
+        if (sep == NULL) continue;
+
         argumentValue = sep + 1;
         *sep = '\0';
 
@@ -49,6 +51,10 @@ void getMainArguments(TMainArguments* pMainArguments, int argc, char* argv[]) {
 
         } else if (strcmp(argumentName, "--platform") == 0) {
             if (validatePlatform(argumentValue)) pMainArguments->platform = argumentValue;
+
+        } else if (strcmp(argumentName, "--initial-state-file") == 0) {
+            if (validateInitialStateFile(argumentValue))
+                pMainArguments->initialStateFile = argumentValue;
         };
     }
 }
@@ -68,4 +74,5 @@ void setDefaultMainArguments(TMainArguments* pMainArguments) {
     pMainArguments->maximumGeneration = 0;
     pMainArguments->delay = 0;
     pMainArguments->platform = "";
+    pMainArguments->initialStateFile = "";
 }

From ebfdd667fa97e2beab53955a8b2100dc2e9b5c09 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:38:14 -0300
Subject: [PATCH 08/37] feature: improve performance and implement
 `initialStateFile` main argument

---
 src/main.c | 32 +++++++++++++++++++-------------
 1 file changed, 19 insertions(+), 13 deletions(-)

diff --git a/src/main.c b/src/main.c
index d4a0f13..0b056b8 100644
--- a/src/main.c
+++ b/src/main.c
@@ -47,23 +47,29 @@ int main(int argc, char* argv[]) {
 
     /* ----------------------------- Request Pattern ---------------------------- */
 
-    if (strcmp(mainArguments.pattern, "") == 0) {
-        requestedPattern = getUserInputStr(
-            "> Which pattern do you want? ('Glider','Toad', 'Press', or 'Glider cannon'): ",
-            "> Invalid pattern! Try again...", 50, &validatePattern);
+    if (*mainArguments.initialStateFile == '\0') {
+        if (*mainArguments.pattern == '\0') {
+            requestedPattern = getUserInputStr(
+                "> Which pattern do you want? ('Glider','Toad', 'Press', or 'Glider cannon'): ",
+                "> Invalid pattern! Try again...", 50, &validatePattern);
 
-        printf("> Pattern received: '%s'.\n\n", requestedPattern);
+            printf("> Pattern received: '%s'.\n\n", requestedPattern);
 
-        drawPattern(&game, requestedPattern);
+            drawPattern(&game, requestedPattern);
 
-        free(requestedPattern);
-    } else {
-        requestedPattern = mainArguments.pattern;
+            free(requestedPattern);
+        } else {
+            requestedPattern = mainArguments.pattern;
 
-        printf("> Pattern received: '%s'.\n\n", requestedPattern);
+            printf("> Pattern received: '%s'.\n\n", requestedPattern);
 
-        drawPattern(&game, requestedPattern);
-    };
+            drawPattern(&game, requestedPattern);
+        };
+    } else {
+        /* --------------------------- Draw Initial State --------------------------- */
+
+        drawDashboardFromFile(mainArguments.initialStateFile, &game);
+    }
 
     /* ----------------------- Request Maximum Generation ----------------------- */
 
@@ -121,7 +127,7 @@ int main(int argc, char* argv[]) {
 
     /* ---------------------------- Request Platform ---------------------------- */
 
-    if (strcmp(mainArguments.platform, "") == 0) {
+    if (*mainArguments.platform == '\0') {
         platformSelected = getUserInputStr(
             "> In which platform do you want to start the Conway's Game of Life game? (console, or "
             "Simple DirectMedia Layer (SDL)): ",

From 71dae16950f9fa1dc0989fd8b8065ef0751760a2 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:38:37 -0300
Subject: [PATCH 09/37] fix: remove unnecessary code

Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 src/validators.c | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/validators.c b/src/validators.c
index 53020a1..955b398 100644
--- a/src/validators.c
+++ b/src/validators.c
@@ -1,7 +1,6 @@
 
 #include "./validators.h"
 
-#include <stdio.h>
 #include <strings.h>
 
 #include "./macros.h"
@@ -32,9 +31,5 @@ int validateCols(int cols) {
 int validateInitialStateFile(char* filePath) {
     char* extensions[] = {"csv", "txt"};
     char* extension = strrchr(filePath, '.');
-
-    printf("> filePath: \"%s\"\n\n", filePath);
-    printf("> extension: \"%s\"\n\n", extension);
-
     return extension == NULL ? 0 : isStrIn(extension + 1, extensions, 2);
 }

From d31e8ac08a895312533fd0a7e8e3e983f1184301 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:39:57 -0300
Subject: [PATCH 10/37] todos: add new todo

---
 todos.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/todos.md b/todos.md
index 843cee3..5fe4de3 100644
--- a/todos.md
+++ b/todos.md
@@ -6,5 +6,6 @@
 -   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
 -   Implementar argumentos en la función `main()` para poder comenzar el juego de Conway's sin la necesidad de solicitarle al usuario el ingreso de datos.
 -   Liberar la memoria dinámica aunque el programa finalize.
+-   Lograr que la función `drawDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
 -   Realizar la parte III del trabajo práctico (lectura de archivos).
 -   Validar que el tamaño del `dashboard` no exceda el tamaño máximo representable en la pantalla del usuario para evitar que la interfaz de SDL abarque más del 100% de dicha pantalla.

From 9979bec2a6b1772a6c50006c30787d81932dc154 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 13 Oct 2024 22:40:29 +0000
Subject: [PATCH 11/37] ci: format code

---
 libs/utilities.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index a4d9a14..86e5030 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -130,7 +130,8 @@ char** new2DArray(int rows, int cols) {
 
 void sleep(int miliseconds) {
     clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds));
+    while (clock() < (startTime + miliseconds))
+        ;
 }
 
 int strcmpi(const char* str01, const char* str02) {

From 3502e6e7c611c7dee51dd0bba37edad8d51b6f06 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 19:42:54 -0300
Subject: [PATCH 12/37] todos: add new todo

---
 todos.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/todos.md b/todos.md
index 5fe4de3..31d18e9 100644
--- a/todos.md
+++ b/todos.md
@@ -3,6 +3,7 @@
 -   Actualizar las secciones `Application Structure` de los archivos `README.md`, ya que no cuentan con el detalle de los nuevos archivos incorporados.
 -   Actualizar las secciones `Features` de los archivos `README.md`.
 -   Corroborar que el tamaño de los vectores (unidimensionales y bidimensionales) no puedan ser creado, si le asignan filas o columnas con valor negativo.
+-   Crear sección con las macros que la aplicación puede implementar.
 -   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
 -   Implementar argumentos en la función `main()` para poder comenzar el juego de Conway's sin la necesidad de solicitarle al usuario el ingreso de datos.
 -   Liberar la memoria dinámica aunque el programa finalize.

From 320bde27dba4edacf78f457c09d276d564fe0c2a Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 20:05:37 -0300
Subject: [PATCH 13/37] fix: remove unnecessary macros

Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 libs/game/macros.h | 25 -------------------------
 1 file changed, 25 deletions(-)

diff --git a/libs/game/macros.h b/libs/game/macros.h
index 5b6c798..687bc02 100644
--- a/libs/game/macros.h
+++ b/libs/game/macros.h
@@ -1,31 +1,6 @@
 
 #ifndef LIBS_GAME_MACROS_H_INCLUDED
 #define LIBS_GAME_MACROS_H_INCLUDED
-
-/**
- * @def DASHBOARD_ROWS
- * @brief Defines the number of rows in a grid.
- *
- * This macro is used to define the number of rows in a grid.
- * It is typically used in conjunction with the `DASHBOARD_COLS` macro to define
- * the size of a grid.
- *
- * @warning The value of `DASHBOARD_ROWS` must be a positive integer.
- */
-#define DASHBOARD_ROWS 56
-
-/**
- * @def DASHBOARD_COLS
- * @brief Defines the number of columns in a grid.
- *
- * This macro is used to define the number of columns in a grid.
- * It is typically used in conjunction with the `DASHBOARD_ROWS` macro to define
- * the size of a grid.
- *
- * @warning The value of `DASHBOARD_COLS` must be a positive integer.
- */
-#define DASHBOARD_COLS 110
-
 /**
  * @def ALIVE_CELL
  * @brief Represents a live cell.

From 09b7ed694cb87d3464331d2064390b1b290b367d Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 20:05:54 -0300
Subject: [PATCH 14/37] fix: restore variable

---
 libs/utilities.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index 86e5030..53d221c 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -130,8 +130,7 @@ char** new2DArray(int rows, int cols) {
 
 void sleep(int miliseconds) {
     clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds))
-        ;
+    while (clock() < (startTime + miliseconds));
 }
 
 int strcmpi(const char* str01, const char* str02) {
@@ -189,6 +188,7 @@ void trimRightStr(char* str) {
 
     for (i = strLength - 1; i > 0; i--) {
         if (!isspace(*(str + i))) break;
+        counter++;
     }
 
     *(str + strLength - counter) = '\0';

From 83cf17626d59b3e37ba1614247622c43ffac7f28 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 13 Oct 2024 23:07:46 +0000
Subject: [PATCH 15/37] ci: format code

---
 libs/utilities.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index 53d221c..e5db4e9 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -130,7 +130,8 @@ char** new2DArray(int rows, int cols) {
 
 void sleep(int miliseconds) {
     clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds));
+    while (clock() < (startTime + miliseconds))
+        ;
 }
 
 int strcmpi(const char* str01, const char* str02) {

From 4393512b6c54f126c59b7eb11ce67fb356ecf0e8 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 20:44:39 -0300
Subject: [PATCH 16/37] todo: remove todo

---
 todos.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/todos.md b/todos.md
index 31d18e9..5fe4de3 100644
--- a/todos.md
+++ b/todos.md
@@ -3,7 +3,6 @@
 -   Actualizar las secciones `Application Structure` de los archivos `README.md`, ya que no cuentan con el detalle de los nuevos archivos incorporados.
 -   Actualizar las secciones `Features` de los archivos `README.md`.
 -   Corroborar que el tamaño de los vectores (unidimensionales y bidimensionales) no puedan ser creado, si le asignan filas o columnas con valor negativo.
--   Crear sección con las macros que la aplicación puede implementar.
 -   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
 -   Implementar argumentos en la función `main()` para poder comenzar el juego de Conway's sin la necesidad de solicitarle al usuario el ingreso de datos.
 -   Liberar la memoria dinámica aunque el programa finalize.

From e5984597288d0d83e057a7b1696ea2aca3458665 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 21:29:52 -0300
Subject: [PATCH 17/37] feature: implement `MAX` macro

Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 libs/utilities.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index e5db4e9..1c390d5 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -7,6 +7,7 @@
 #include <string.h>
 #include <time.h>
 
+#include "./macros.h"
 #include "./patterns/main.h"
 
 void destroy2DArray(char** arr, int rows, int cols) {
@@ -58,8 +59,8 @@ int drawDashboardFromFile(char* filePath, TGame* pGame) {
         sscanf(row, "%d", &rowInt);
         sscanf(col, "%d", &colInt);
 
-        if (rowInt > rows) rows = rowInt;
-        if (colInt > cols) cols = colInt;
+        rows = MAX(rowInt, rows);
+        cols = MAX(colInt, cols);
     }
 
     printf("\n\n> rows: %d\n", rows);
@@ -130,8 +131,7 @@ char** new2DArray(int rows, int cols) {
 
 void sleep(int miliseconds) {
     clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds))
-        ;
+    while (clock() < (startTime + miliseconds));
 }
 
 int strcmpi(const char* str01, const char* str02) {

From 6605d83f820b6c11ee97d9c271609a7b80e9e2cb Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 21:44:15 -0300
Subject: [PATCH 18/37] doc: complete remaining documentation

---
 libs/macros.h     | 14 ++++++++++++--
 libs/utilities.h  | 13 ++++++++++++-
 src/macros.h      |  6 +++++-
 src/sdl/methods.h |  9 ++++++++-
 src/structs.h     | 21 +++++++++++++--------
 src/utilities.h   | 23 +++++++++++++++++++++--
 src/validators.h  | 35 +++++++++++++++++++++++++++++++----
 7 files changed, 102 insertions(+), 19 deletions(-)

diff --git a/libs/macros.h b/libs/macros.h
index 93645ff..b73ad24 100644
--- a/libs/macros.h
+++ b/libs/macros.h
@@ -2,10 +2,20 @@
 #ifndef LIBS_MACROS_H_INCLUDED
 #define LIBS_MACROS_H_INCLUDED
 
-// TODO: Documentation
+/**
+ * @def MAX
+ * @brief Returns the maximum value between two values.
+ *
+ * @warning The value of `a` and `b` parameters must be an integer or float.
+ */
 #define MAX(a, b) a > b ? a : b;
 
-// TODO: Documentation
+/**
+ * @def MIN
+ * @brief Returns the minimum value between two values.
+ *
+ * @warning The value of `a` and `b` parameters must be an integer or float.
+ */
 #define MIN(a, b) a > b ? b : a;
 
 /**
diff --git a/libs/utilities.h b/libs/utilities.h
index 88c9e11..d0c57c4 100644
--- a/libs/utilities.h
+++ b/libs/utilities.h
@@ -24,7 +24,18 @@
  */
 void destroy2DArray(char** arr, int rows, int cols);
 
-// TODO: Documentation
+/**
+ * @brief Sets a Conway's Game of Life dashboard based on a file.
+ *
+ * This function reads a file content and updates a Conway's Game of Life structure with the parsed
+ * content to set the dashboard. Also, it modifies the `rows`, `cols`, `center`, `cellsAlive`, and
+ * `cellsDead` field of the Conway's Game of Life structure.
+ *
+ * @param filePath File path with the content to be parsed.
+ * @param pGame Pointer to the Conway's Game of Life structure.
+ *
+ * @return Returns `1` on success, otherwise returns `0`.
+ */
 int drawDashboardFromFile(char* filePath, TGame* pGame);
 
 /**
diff --git a/src/macros.h b/src/macros.h
index 092e773..5315f40 100644
--- a/src/macros.h
+++ b/src/macros.h
@@ -1,7 +1,11 @@
 #ifndef SRC_MACROS_H_INCLUDED
 #define SRC_MACROS_H_INCLUDED
 
-// TODO: Documentation
+/**
+ * @def CELL_SIZE
+ *
+ * @warning The value of `CELL_SIZE` must be a positive integer.
+ */
 #define CELL_SIZE 10
 
 #endif  // SRC_MACROS_H_INCLUDED
diff --git a/src/sdl/methods.h b/src/sdl/methods.h
index 6799f86..89e828e 100644
--- a/src/sdl/methods.h
+++ b/src/sdl/methods.h
@@ -3,7 +3,14 @@
 
 #include "../../libs/main.h"
 
-// TODO: Documentation
+/**
+ * @brief Gets the current screen resolution.
+ *
+ * @param width Pointer to store the screen width.
+ * @param height Pointer to store the screen height.
+ *
+ * @return Returns `1` if the screen resolution was successfully obtained, or `0` if it was not.
+ */
 int getScreenResolution(int* width, int* height);
 
 /**
diff --git a/src/structs.h b/src/structs.h
index 5cdc984..9bb341b 100644
--- a/src/structs.h
+++ b/src/structs.h
@@ -2,15 +2,20 @@
 #ifndef SRC_STRUCTS_H_INCLUDED
 #define SRC_STRUCTS_H_INCLUDED
 
-// TODO: Documentation
+/**
+ * @struct TMainArguments
+ * @brief Represents the main arguments of the application.
+ *
+ * This structure holds the main configuration parameters for the application.
+ */
 typedef struct {
-    int dashboardRows;
-    int dashboardCols;
-    char* pattern;
-    int maximumGeneration;
-    int delay;
-    char* platform;
-    char* initialStateFile;
+    int dashboardRows;      /** Number of rows in the dashboard. */
+    int dashboardCols;      /** Number of columns in the dashboard. */
+    char* pattern;          /** Pattern to be drawn on the dashboard. */
+    int maximumGeneration;  /** Maximum number of generations to simulate. */
+    int delay;              /** Delay between generations in milliseconds. */
+    char* platform;         /** Platform on which the application will be run. */
+    char* initialStateFile; /** File containing the initial state of the dashboard. */
 } TMainArguments;
 
 #endif  // SRC_STRUCTS_H_INCLUDED
\ No newline at end of file
diff --git a/src/utilities.h b/src/utilities.h
index 2817b74..131b49f 100644
--- a/src/utilities.h
+++ b/src/utilities.h
@@ -4,10 +4,29 @@
 
 #include "./structs.h"
 
-// TODO: Documentation
+/**
+ * @brief Retrieves and processes the main arguments of the application.
+ *
+ * This function takes the command-line arguments passed to the application,
+ * processes them, and stores the relevant information in a structure. It
+ * ensures that the arguments are correctly parsed and validated.
+ *
+ * @param pMainArguments Pointer to a `TMainArguments` structure where the
+ *                       processed arguments will be stored.
+ * @param argc           Number of command-line arguments.
+ * @param argv           Array with the command-line arguments.
+ */
 void getMainArguments(TMainArguments* pMainArguments, int argc, char* argv[]);
 
-// TODO: Documentation
+/**
+ * @brief Sets the default values for the main arguments of the application.
+ *
+ * This function initializes the provided structure with default values.
+ * It ensures that all necessary fields are set to their initial states.
+ *
+ * @param pMainArguments Pointer to a `TMainArguments` structure that will be initialized
+ *                       with default values.
+ */
 void setDefaultMainArguments(TMainArguments* pMainArguments);
 
 #endif  // SRC_UTILITIES_H_INCLUDED
\ No newline at end of file
diff --git a/src/validators.h b/src/validators.h
index d5a5118..bc07684 100644
--- a/src/validators.h
+++ b/src/validators.h
@@ -1,13 +1,40 @@
 #ifndef SRC_VALIDATORS_H_INCLUDED
 #define SRC_VALIDATORS_H_INCLUDED
 
-// TODO: Documentation
+/**
+ * @brief Validates a number of rows.
+ *
+ * This function checks if a provided number of rows is within an acceptable range.
+ * It ensures that the number of rows meets the required criteria for further processing.
+ *
+ * @param rows The number of rows to be validated.
+ *
+ * @return Returns `1` if the number of rows is valid, otherwise returns `0`.
+ */
 int validateRows(int rows);
 
-// TODO: Documentation
+/**
+ * @brief Validates a number of cols.
+ *
+ * This function checks if a provided number of cols is within an acceptable range.
+ * It ensures that the number of cols meets the required criteria for further processing.
+ *
+ * @param cols The number of cols to be validated.
+ *
+ * @return Returns `1` if the number of cols is valid, otherwise returns `0`.
+ */
 int validateCols(int cols);
 
-// TODO: Documentation
-int validateInitialStateFile(char* pattern);
+/**
+ * @brief Validates a initial state file path.
+ *
+ * This function checks if a file path is valid to be an initial state file.
+ * It ensures that the file extension matches `csv`, or `txt`.
+ *
+ * @param filePath The file path to be validated.
+ *
+ * @return Returns `1` if the file path is valid, otherwise returns `0`.
+ */
+int validateInitialStateFile(char* filePath);
 
 #endif  // SRC_VALIDATORS_H_INCLUDED

From 147ceee9dff933d3cf6e6909ca8bc8694a1a6ac3 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 13 Oct 2024 21:45:59 -0300
Subject: [PATCH 19/37] fix: rename `drawDashboardFromFile` function

---
 libs/utilities.c | 2 +-
 libs/utilities.h | 2 +-
 src/main.c       | 2 +-
 todos.md         | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index 1c390d5..4fece48 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -20,7 +20,7 @@ void destroy2DArray(char** arr, int rows, int cols) {
     free(arr);
 }
 
-int drawDashboardFromFile(char* filePath, TGame* pGame) {
+int setDashboardFromFile(char* filePath, TGame* pGame) {
     FILE* pf;
 
     char* line;
diff --git a/libs/utilities.h b/libs/utilities.h
index d0c57c4..409b255 100644
--- a/libs/utilities.h
+++ b/libs/utilities.h
@@ -36,7 +36,7 @@ void destroy2DArray(char** arr, int rows, int cols);
  *
  * @return Returns `1` on success, otherwise returns `0`.
  */
-int drawDashboardFromFile(char* filePath, TGame* pGame);
+int setDashboardFromFile(char* filePath, TGame* pGame);
 
 /**
  * @brief Gets user input as a string.
diff --git a/src/main.c b/src/main.c
index 0b056b8..c36158b 100644
--- a/src/main.c
+++ b/src/main.c
@@ -68,7 +68,7 @@ int main(int argc, char* argv[]) {
     } else {
         /* --------------------------- Draw Initial State --------------------------- */
 
-        drawDashboardFromFile(mainArguments.initialStateFile, &game);
+        setDashboardFromFile(mainArguments.initialStateFile, &game);
     }
 
     /* ----------------------- Request Maximum Generation ----------------------- */
diff --git a/todos.md b/todos.md
index 5fe4de3..a09d1a3 100644
--- a/todos.md
+++ b/todos.md
@@ -6,6 +6,6 @@
 -   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
 -   Implementar argumentos en la función `main()` para poder comenzar el juego de Conway's sin la necesidad de solicitarle al usuario el ingreso de datos.
 -   Liberar la memoria dinámica aunque el programa finalize.
--   Lograr que la función `drawDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
+-   Lograr que la función `setDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
 -   Realizar la parte III del trabajo práctico (lectura de archivos).
 -   Validar que el tamaño del `dashboard` no exceda el tamaño máximo representable en la pantalla del usuario para evitar que la interfaz de SDL abarque más del 100% de dicha pantalla.

From 1db0071b9b5a0f8c440aec1346c6d8d32eb42419 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Mon, 14 Oct 2024 00:47:50 +0000
Subject: [PATCH 20/37] ci: format code

---
 libs/utilities.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index 4fece48..b94e398 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -131,7 +131,8 @@ char** new2DArray(int rows, int cols) {
 
 void sleep(int miliseconds) {
     clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds));
+    while (clock() < (startTime + miliseconds))
+        ;
 }
 
 int strcmpi(const char* str01, const char* str02) {

From 6a641b3f29fbc4a558fc5820dc0d370b5324a8a7 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Tue, 15 Oct 2024 23:11:30 -0300
Subject: [PATCH 21/37] todos: add new todo

---
 todos.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/todos.md b/todos.md
index a09d1a3..a8c4d23 100644
--- a/todos.md
+++ b/todos.md
@@ -8,4 +8,5 @@
 -   Liberar la memoria dinámica aunque el programa finalize.
 -   Lograr que la función `setDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
 -   Realizar la parte III del trabajo práctico (lectura de archivos).
+-   Remplazar los tipos de datos de las variables y parámetros por aquellos que son más óptimos (según sea en caso).
 -   Validar que el tamaño del `dashboard` no exceda el tamaño máximo representable en la pantalla del usuario para evitar que la interfaz de SDL abarque más del 100% de dicha pantalla.

From b029bff1ad118f43e92b24610f228326bd1743db Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 14:13:26 -0300
Subject: [PATCH 22/37] todos: complete todos

---
 todos.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/todos.md b/todos.md
index a8c4d23..7a6981b 100644
--- a/todos.md
+++ b/todos.md
@@ -2,11 +2,7 @@
 
 -   Actualizar las secciones `Application Structure` de los archivos `README.md`, ya que no cuentan con el detalle de los nuevos archivos incorporados.
 -   Actualizar las secciones `Features` de los archivos `README.md`.
--   Corroborar que el tamaño de los vectores (unidimensionales y bidimensionales) no puedan ser creado, si le asignan filas o columnas con valor negativo.
 -   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
--   Implementar argumentos en la función `main()` para poder comenzar el juego de Conway's sin la necesidad de solicitarle al usuario el ingreso de datos.
--   Liberar la memoria dinámica aunque el programa finalize.
 -   Lograr que la función `setDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
 -   Realizar la parte III del trabajo práctico (lectura de archivos).
 -   Remplazar los tipos de datos de las variables y parámetros por aquellos que son más óptimos (según sea en caso).
--   Validar que el tamaño del `dashboard` no exceda el tamaño máximo representable en la pantalla del usuario para evitar que la interfaz de SDL abarque más del 100% de dicha pantalla.

From 37cda3632a5ad62a0955c5cd25fc837b3ee848bc Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 14:47:58 -0300
Subject: [PATCH 23/37] feature: update variables and parameters data types

---
 libs/game/methods.c     | 60 ++++++++++++++++++++---------------------
 libs/game/methods.h     |  8 +++---
 libs/patterns/methods.c | 14 +++++-----
 libs/patterns/methods.h |  2 +-
 libs/utilities.c        | 51 +++++++++++++++++------------------
 libs/utilities.h        | 14 +++++-----
 libs/validators.c       | 22 +++++++--------
 libs/validators.h       |  8 +++---
 src/main.c              |  2 +-
 src/sdl/methods.c       | 21 ++++++++-------
 src/sdl/methods.h       |  3 ++-
 src/utilities.c         |  4 +--
 src/utilities.h         |  4 +--
 src/validators.c        | 10 +++----
 src/validators.h        |  6 ++---
 todos.md                |  1 -
 16 files changed, 114 insertions(+), 116 deletions(-)

diff --git a/libs/game/methods.c b/libs/game/methods.c
index c000a7c..92281f9 100644
--- a/libs/game/methods.c
+++ b/libs/game/methods.c
@@ -9,17 +9,17 @@
 #include "./macros.h"
 #include "./structs.h"
 
-int countAliveNeighbors(TGame* pGame, int cellRow, int cellCol, int radius) {
-    int i;
-    int j;
+int countAliveNeighbors(TGame* pGame, const int cellRow, const int cellCol, const int radius) {
+    size_t i;
+    size_t j;
 
-    int startRow = cellRow - radius;
-    int startCol = cellCol - radius;
+    const int startRow = cellRow - radius;
+    const int startCol = cellCol - radius;
 
-    int endRow = cellRow + radius + 1;
-    int endCol = cellCol + radius + 1;
+    const int endRow = cellRow + radius + 1;
+    const int endCol = cellCol + radius + 1;
 
-    int aliveNeighbors = 0;
+    size_t aliveNeighbors = 0;
 
     for (i = startRow; i < endRow; i++) {
         if (i > pGame->rows - 1) break;
@@ -39,7 +39,7 @@ int countAliveNeighbors(TGame* pGame, int cellRow, int cellCol, int radius) {
     return aliveNeighbors;
 }
 
-void drawPattern(TGame* pGame, char* pattern) {
+void drawPattern(TGame* pGame, const char* pattern) {
     TPattern SPattern;
 
     fillDashboard(pGame, DEAD_CELL);
@@ -68,14 +68,14 @@ void drawPattern(TGame* pGame, char* pattern) {
 }
 
 void drawPatternInDashboard(TGame* pGame, TPattern* pPattern) {
-    int i;
-    int j;
+    size_t i;
+    size_t j;
 
-    int pI = 0;
-    int pJ = 0;
+    size_t pI = 0;
+    size_t pJ = 0;
 
-    int startRow = pGame->center[0] - pPattern->center[0];
-    int startCol = pGame->center[1] - pPattern->center[1];
+    const int startRow = pGame->center[0] - pPattern->center[0];
+    const int startCol = pGame->center[1] - pPattern->center[1];
 
     for (i = startRow; pI < pPattern->rows; i++) {
         if (i < 0) continue;
@@ -94,9 +94,9 @@ void drawPatternInDashboard(TGame* pGame, TPattern* pPattern) {
     }
 }
 
-void fillDashboard(TGame* pGame, char with) {
-    int i;
-    int j;
+void fillDashboard(TGame* pGame, const char with) {
+    size_t i;
+    size_t j;
 
     for (i = 0; i < pGame->rows; i++) {
         for (j = 0; j < pGame->cols; j++) {
@@ -106,10 +106,10 @@ void fillDashboard(TGame* pGame, char with) {
 }
 
 void generateNextGeneration(TGame* pGame) {
-    int i;
-    int j;
+    size_t i;
+    size_t j;
 
-    int aliveNeighbors;
+    size_t aliveNeighbors;
 
     for (i = 0; i < pGame->rows; i++) {
         for (j = 0; j < pGame->cols; j++) {
@@ -146,8 +146,8 @@ void generateNextGeneration(TGame* pGame) {
 }
 
 void printDashboardByConsole(TGame* pGame) {
-    int i;
-    int j;
+    size_t i;
+    size_t j;
 
     for (i = 0; i < pGame->rows; i++) {
         printf("\n");
@@ -159,8 +159,8 @@ void printDashboardByConsole(TGame* pGame) {
 }
 
 void printGameByConsole(TGame* pGame) {
-    int i;
-    int j;
+    size_t i;
+    size_t j;
 
     // Print header
     for (i = 0; i < pGame->cols + 2; i++) printf("-");
@@ -196,16 +196,16 @@ void printGameByConsole(TGame* pGame) {
 }
 
 void setDashboardCenter(TGame* pGame) {
-    int row = pGame->rows / 2;
-    int col = pGame->cols / 2;
+    const int row = pGame->rows / 2;
+    const int col = pGame->cols / 2;
 
     pGame->center[0] = row;
     pGame->center[1] = col;
 }
 
-void startGameByConsole(TGame* pGame, int maxGeneration, int delayBetweenGenerations) {
-    int generation = 0;
-    int isToInfinity = maxGeneration == INT_MAX;
+void startGameByConsole(TGame* pGame, const int maxGeneration, const int delayBetweenGenerations) {
+    size_t generation = 0;
+    unsigned char isToInfinity = maxGeneration == INT_MAX;
 
     pGame->generation = 0;
     pGame->maximumGeneration = maxGeneration;
diff --git a/libs/game/methods.h b/libs/game/methods.h
index 954b02f..8734d56 100644
--- a/libs/game/methods.h
+++ b/libs/game/methods.h
@@ -21,7 +21,7 @@
  *
  * @warning This function assumes that `pGame` has been properly initialized.
  */
-int countAliveNeighbors(TGame* pGame, int row, int col, int radius);
+int countAliveNeighbors(TGame* pGame, const int row, const int col, const int radius);
 
 /**
  * @brief Draws a specified pattern on a Conway's Game of Life board.
@@ -31,7 +31,7 @@ int countAliveNeighbors(TGame* pGame, int row, int col, int radius);
  *
  * @warning The pattern must be `glider`, `toad`, `press`, or `glider cannon`.
  */
-void drawPattern(TGame* pGame, char* pattern);
+void drawPattern(TGame* pGame, const char* pattern);
 
 /**
  * @brief Draws a specified pattern on a Conway's Game of Life board.
@@ -54,7 +54,7 @@ void drawPatternInDashboard(TGame* pGame, TPattern* pPattern);
  * @warning This function assumes that `pGame` has been
  * properly initialized.
  */
-void fillDashboard(TGame* pGame, char with);
+void fillDashboard(TGame* pGame, const char with);
 
 /**
  * @brief Generates the next generation of a Conway's Game of Life.
@@ -108,6 +108,6 @@ void setDashboardCenter(TGame* pGame);
  *
  * @warning This function assumes that `pGame` has been properly initialized.
  */
-void startGameByConsole(TGame* pGame, int maxGeneration, int delayBetweenGenerations);
+void startGameByConsole(TGame* pGame, const int maxGeneration, const int delayBetweenGenerations);
 
 #endif  // LIBS_GAME_MAIN_H_INCLUDED
\ No newline at end of file
diff --git a/libs/patterns/methods.c b/libs/patterns/methods.c
index c8c542f..a3f05ee 100644
--- a/libs/patterns/methods.c
+++ b/libs/patterns/methods.c
@@ -5,9 +5,9 @@
 
 #include "./structs.h"
 
-void fillPattern(TPattern* pPattern, char with) {
-    int i;
-    int j;
+void fillPattern(TPattern* pPattern, const char with) {
+    size_t i;
+    size_t j;
 
     for (i = 0; i < pPattern->rows; i++) {
         for (j = 0; j < pPattern->cols; j++) {
@@ -17,8 +17,8 @@ void fillPattern(TPattern* pPattern, char with) {
 }
 
 void printPatternByConsole(TPattern* pPattern) {
-    int i;
-    int j;
+    size_t i;
+    size_t j;
 
     for (i = 0; i < pPattern->rows; i++) {
         for (j = 0; j < pPattern->cols; j++) {
@@ -30,8 +30,8 @@ void printPatternByConsole(TPattern* pPattern) {
 }
 
 void setPatternCenter(TPattern* pPattern) {
-    int row = pPattern->rows / 2;
-    int col = pPattern->cols / 2;
+    const int row = pPattern->rows / 2;
+    const int col = pPattern->cols / 2;
 
     pPattern->center[0] = row;
     pPattern->center[1] = col;
diff --git a/libs/patterns/methods.h b/libs/patterns/methods.h
index 62bc634..821833c 100644
--- a/libs/patterns/methods.h
+++ b/libs/patterns/methods.h
@@ -12,7 +12,7 @@
  *
  * @warning This function assumes that `pPattern` has been properly initialized.
  */
-void fillPattern(TPattern* pPattern, char with);
+void fillPattern(TPattern* pPattern, const char with);
 
 /**
  * @brief Prints the `arr` field of a pattern structure by console.
diff --git a/libs/utilities.c b/libs/utilities.c
index b94e398..cf078c8 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -10,8 +10,8 @@
 #include "./macros.h"
 #include "./patterns/main.h"
 
-void destroy2DArray(char** arr, int rows, int cols) {
-    int i;
+void destroy2DArray(char** arr, const int rows, const int cols) {
+    size_t i;
 
     for (i = 0; i < rows; i++) {
         free(*(arr + i));
@@ -20,11 +20,11 @@ void destroy2DArray(char** arr, int rows, int cols) {
     free(arr);
 }
 
-int setDashboardFromFile(char* filePath, TGame* pGame) {
+int setDashboardFromFile(const char* filePath, TGame* pGame) {
     FILE* pf;
 
     char* line;
-    int lineLength = 100;
+    const size_t lineLength = 100;
 
     char* row;
     char* col;
@@ -71,8 +71,8 @@ int setDashboardFromFile(char* filePath, TGame* pGame) {
     return 1;
 }
 
-char* getUserInputStr(char* message, char* onInvalidMessage, int strLength,
-                      int (*validator)(char* userInput)) {
+char* getUserInputStr(const char* message, const char* onInvalidMessage, const int strLength,
+                      unsigned char (*validator)(const char* userInput)) {
     char* userInput = malloc(strLength * sizeof(char));
     if (userInput == NULL) {
         printf("Memory allocation failed!\n");
@@ -95,8 +95,8 @@ char* getUserInputStr(char* message, char* onInvalidMessage, int strLength,
     return userInput;
 }
 
-int isStrIn(char* str, char* arr[], int size) {
-    int i;
+int isStrIn(const char* str, const char* arr[], const int size) {
+    size_t i;
 
     for (i = 0; i < size; i++) {
         if (strcmpi(str, *(arr + i)) == 0) return 1;
@@ -105,13 +105,11 @@ int isStrIn(char* str, char* arr[], int size) {
     return 0;
 }
 
-char** new2DArray(int rows, int cols) {
-    char** bidimensionalArr;
+char** new2DArray(const int rows, const int cols) {
+    size_t i;
+    size_t j;
 
-    int i;
-    int j;
-
-    bidimensionalArr = malloc(rows * sizeof(char*));
+    char** bidimensionalArr = malloc(rows * sizeof(char*));
     if (bidimensionalArr == NULL) {
         printf("Memory allocation failed!\n");
         exit(EXIT_FAILURE);
@@ -130,16 +128,15 @@ char** new2DArray(int rows, int cols) {
 }
 
 void sleep(int miliseconds) {
-    clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds))
-        ;
+    const clock_t startTime = clock();
+    while (clock() < (startTime + miliseconds));
 }
 
 int strcmpi(const char* str01, const char* str02) {
-    int i;
+    size_t i;
 
-    int lengthStr01 = strlen(str01);
-    int lengthStr02 = strlen(str02);
+    const size_t lengthStr01 = strlen(str01);
+    const size_t lengthStr02 = strlen(str02);
 
     char charStr01;
     char charStr02;
@@ -164,11 +161,11 @@ void trimStr(char* str) {
 }
 
 void trimLeftStr(char* str) {
-    int i;
-    int j;
-    int strLength = strlen(str);
+    size_t i;
+    size_t j;
+    size_t strLength = strlen(str);
 
-    int counter = 0;
+    size_t counter = 0;
 
     for (i = 0; i < strLength; i++) {
         if (!isspace(*(str + i))) break;
@@ -183,10 +180,10 @@ void trimLeftStr(char* str) {
 }
 
 void trimRightStr(char* str) {
-    int i;
-    int strLength = strlen(str);
+    size_t i;
+    size_t strLength = strlen(str);
 
-    int counter = 0;
+    size_t counter = 0;
 
     for (i = strLength - 1; i > 0; i--) {
         if (!isspace(*(str + i))) break;
diff --git a/libs/utilities.h b/libs/utilities.h
index 409b255..3c80895 100644
--- a/libs/utilities.h
+++ b/libs/utilities.h
@@ -22,7 +22,7 @@
  * @warning Ensure that the array has been dynamically allocated and that the number of rows and
  * columns are correctly specified to avoid undefined behavior.
  */
-void destroy2DArray(char** arr, int rows, int cols);
+void destroy2DArray(char** arr, const int rows, const int cols);
 
 /**
  * @brief Sets a Conway's Game of Life dashboard based on a file.
@@ -36,7 +36,7 @@ void destroy2DArray(char** arr, int rows, int cols);
  *
  * @return Returns `1` on success, otherwise returns `0`.
  */
-int setDashboardFromFile(char* filePath, TGame* pGame);
+int setDashboardFromFile(const char* filePath, TGame* pGame);
 
 /**
  * @brief Gets user input as a string.
@@ -57,8 +57,8 @@ int setDashboardFromFile(char* filePath, TGame* pGame);
  * @warning Ensure to free the returned pointer after use with the appropriate deallocation
  * functions to avoid memory leaks.
  */
-char* getUserInputStr(char* message, char* onInvalidMessage, int strLength,
-                      int (*validator)(char* userInput));
+char* getUserInputStr(const char* message, const char* onInvalidMessage, const int strLength,
+                      unsigned char (*validator)(const char* userInput));
 
 /**
  * @brief Checks if a string is present in an array of strings.
@@ -71,7 +71,7 @@ char* getUserInputStr(char* message, char* onInvalidMessage, int strLength,
  *
  * @return 1 if the string is found in the array, 0 otherwise.
  */
-int isStrIn(char* str, char* arr[], int arrLength);
+int isStrIn(const char* str, const char* arr[], const int arrLength);
 
 /**
  * @brief Initializes a 2D array of characters.
@@ -87,14 +87,14 @@ int isStrIn(char* str, char* arr[], int arrLength);
  * @warning Ensure to free the allocated memory using appropriate deallocation functions to avoid
  * memory leaks.
  */
-char** new2DArray(int rows, int cols);
+char** new2DArray(const int rows, const int cols);
 
 /**
  * @brief Pauses the execution of the program.
  *
  * @warning The actual delay may be longer than specified due to system timer.
  */
-void sleep(int milliseconds);
+void sleep(const int milliseconds);
 
 /**
  * @brief Compares two strings case-insensitively.
diff --git a/libs/validators.c b/libs/validators.c
index 07e0e97..7e649f4 100644
--- a/libs/validators.c
+++ b/libs/validators.c
@@ -9,10 +9,10 @@
 #include "./macros.h"
 #include "./utilities.h"
 
-int validateDelay(char* delay) {
-    int i;
+unsigned char validateDelay(const char* delay) {
+    size_t i;
     int delayInt;
-    int delayLength = strlen(delay);
+    size_t delayLength = strlen(delay);
 
     for (i = 0; i < delayLength; i++) {
         if (!isdigit(*(delay + i))) return 0;
@@ -22,10 +22,10 @@ int validateDelay(char* delay) {
     return delayInt >= MINIMUM_DELAY && delayInt <= MAXIMUM_DELAY;
 }
 
-int validateGeneration(char* generation) {
-    int i;
+unsigned char validateGeneration(const char* generation) {
+    size_t i;
     int generationInt;
-    int generationLength = strlen(generation);
+    size_t generationLength = strlen(generation);
 
     for (i = 0; i < generationLength; i++) {
         if (*(generation + i) != '-' && !isdigit(*(generation + i))) return 0;
@@ -35,13 +35,13 @@ int validateGeneration(char* generation) {
     return generationInt >= INT_MIN && generationInt <= INT_MAX;
 }
 
-int validatePattern(char* pattern) {
-    char* options[] = {"glider", "toad", "press", "glider cannon"};
+unsigned char validatePattern(const char* pattern) {
+    const char* options[] = {"glider", "toad", "press", "glider cannon"};
     return isStrIn(pattern, options, 4);
 }
 
-int validatePlatform(char* userInput) {
-    char* options[] = {"console", "simple directmedia layer (sdl)", "simple directmedia layer",
-                       "sdl"};
+unsigned char validatePlatform(const char* userInput) {
+    const char* options[] = {"console", "simple directmedia layer (sdl)",
+                             "simple directmedia layer", "sdl"};
     return isStrIn(userInput, options, 4);
 }
\ No newline at end of file
diff --git a/libs/validators.h b/libs/validators.h
index cf37427..5e318aa 100644
--- a/libs/validators.h
+++ b/libs/validators.h
@@ -12,7 +12,7 @@
  *
  * @return 1 if the delay is valid, 0 otherwise.
  */
-int validateDelay(char* delay);
+unsigned char validateDelay(const char* delay);
 
 /**
  * @brief Validates a generation.
@@ -24,7 +24,7 @@ int validateDelay(char* delay);
  *
  * @return 1 if the generation is valid, 0 otherwise.
  */
-int validateGeneration(char* generation);
+unsigned char validateGeneration(const char* generation);
 
 /**
  * @brief Validates a pattern.
@@ -36,7 +36,7 @@ int validateGeneration(char* generation);
  *
  * @return 1 if the pattern is valid, 0 otherwise.
  */
-int validatePattern(char* pattern);
+unsigned char validatePattern(const char* pattern);
 
 /**
  * @brief Validates a platform.
@@ -48,6 +48,6 @@ int validatePattern(char* pattern);
  *
  * @return 1 if the platform is valid, 0 otherwise.
  */
-int validatePlatform(char* platform);
+unsigned char validatePlatform(const char* platform);
 
 #endif  // LIBS_VALIDATORS_H_INCLUDED
diff --git a/src/main.c b/src/main.c
index c36158b..b180a07 100644
--- a/src/main.c
+++ b/src/main.c
@@ -9,7 +9,7 @@
 #include "./structs.h"
 #include "./utilities.h"
 
-int main(int argc, char* argv[]) {
+int main(const int argc, char* argv[]) {
     TMainArguments mainArguments;
 
     TGame game;
diff --git a/src/sdl/methods.c b/src/sdl/methods.c
index 1b0fd23..ce49acb 100644
--- a/src/sdl/methods.c
+++ b/src/sdl/methods.c
@@ -31,14 +31,15 @@ int getScreenResolution(int* width, int* height) {
     return 1;
 }
 
-int startGameBySDL(TGame* pGame, int maxGeneration, int delayBetweenGenerations) {
-    int i;
-    int j;
+unsigned char startGameBySDL(TGame* pGame, const int maxGeneration,
+                             const int delayBetweenGenerations) {
+    size_t i;
+    size_t j;
 
-    int cellSize = CELL_SIZE;
-    int generation = 0;
-    int isToInfinity = maxGeneration == INT_MAX;
-    int userRequestClose = 0;
+    const size_t cellSize = CELL_SIZE;
+    size_t generation = 0;
+    const unsigned char isToInfinity = maxGeneration == INT_MAX;
+    unsigned char userRequestClose = 0;
 
     SDL_Window* window = NULL;
     SDL_Renderer* renderer = NULL;
@@ -47,9 +48,9 @@ int startGameBySDL(TGame* pGame, int maxGeneration, int delayBetweenGenerations)
 
     // Window configuration
     char windowCaption[256];
-    int windowWidth = cellSize * (pGame->cols + 2);
-    int windowHeight = cellSize * (pGame->rows + 2);
-    Uint32 windowFlags = SDL_WINDOW_SHOWN | SDL_WINDOW_RESIZABLE;
+    const int windowWidth = cellSize * (pGame->cols + 2);
+    const int windowHeight = cellSize * (pGame->rows + 2);
+    const Uint32 windowFlags = SDL_WINDOW_SHOWN | SDL_WINDOW_RESIZABLE;
 
     // SDL initialization
     if (SDL_Init(SDL_INIT_VIDEO) != 0) {
diff --git a/src/sdl/methods.h b/src/sdl/methods.h
index 89e828e..a258de5 100644
--- a/src/sdl/methods.h
+++ b/src/sdl/methods.h
@@ -22,6 +22,7 @@ int getScreenResolution(int* width, int* height);
  *
  * @warning This function assumes that `pGame` has been properly initialized.
  */
-int startGameBySDL(TGame* pGame, int maxGeneration, int delayBetweenGenerations);
+unsigned char startGameBySDL(TGame* pGame, const int maxGeneration,
+                             const int delayBetweenGenerations);
 
 #endif  // SDL_METHODS_H_INCLUDED
diff --git a/src/utilities.c b/src/utilities.c
index 54923da..2b2d5e8 100644
--- a/src/utilities.c
+++ b/src/utilities.c
@@ -9,8 +9,8 @@
 #include "./sdl/main.h"
 #include "./validators.h"
 
-void getMainArguments(TMainArguments* pMainArguments, int argc, char* argv[]) {
-    int i;
+void getMainArguments(TMainArguments* pMainArguments, const int argc, char* argv[]) {
+    size_t i;
 
     char* argumentName;
     char* argumentValue;
diff --git a/src/utilities.h b/src/utilities.h
index 131b49f..c30317b 100644
--- a/src/utilities.h
+++ b/src/utilities.h
@@ -16,7 +16,7 @@
  * @param argc           Number of command-line arguments.
  * @param argv           Array with the command-line arguments.
  */
-void getMainArguments(TMainArguments* pMainArguments, int argc, char* argv[]);
+void getMainArguments(TMainArguments* pMainArguments, const int argc, char* argv[]);
 
 /**
  * @brief Sets the default values for the main arguments of the application.
@@ -29,4 +29,4 @@ void getMainArguments(TMainArguments* pMainArguments, int argc, char* argv[]);
  */
 void setDefaultMainArguments(TMainArguments* pMainArguments);
 
-#endif  // SRC_UTILITIES_H_INCLUDED
\ No newline at end of file
+#endif  // SRC_UTILITIES_H_INCLUDED
diff --git a/src/validators.c b/src/validators.c
index 955b398..f0d5dae 100644
--- a/src/validators.c
+++ b/src/validators.c
@@ -6,7 +6,7 @@
 #include "./macros.h"
 #include "./sdl/methods.h"
 
-int validateRows(int rows) {
+unsigned char validateRows(const int rows) {
     int maxRows;
     int screenHeight;
     int _;
@@ -17,7 +17,7 @@ int validateRows(int rows) {
     return rows > 0 && rows <= maxRows;
 }
 
-int validateCols(int cols) {
+unsigned char validateCols(const int cols) {
     int maxCols;
     int screenWidth;
     int _;
@@ -28,8 +28,8 @@ int validateCols(int cols) {
     return cols > 0 && cols <= maxCols;
 }
 
-int validateInitialStateFile(char* filePath) {
-    char* extensions[] = {"csv", "txt"};
-    char* extension = strrchr(filePath, '.');
+unsigned char validateInitialStateFile(const char* filePath) {
+    const char* extensions[] = {"csv", "txt"};
+    const char* extension = strrchr(filePath, '.');
     return extension == NULL ? 0 : isStrIn(extension + 1, extensions, 2);
 }
diff --git a/src/validators.h b/src/validators.h
index bc07684..78d88d3 100644
--- a/src/validators.h
+++ b/src/validators.h
@@ -11,7 +11,7 @@
  *
  * @return Returns `1` if the number of rows is valid, otherwise returns `0`.
  */
-int validateRows(int rows);
+unsigned char validateRows(const int rows);
 
 /**
  * @brief Validates a number of cols.
@@ -23,7 +23,7 @@ int validateRows(int rows);
  *
  * @return Returns `1` if the number of cols is valid, otherwise returns `0`.
  */
-int validateCols(int cols);
+unsigned char validateCols(const int cols);
 
 /**
  * @brief Validates a initial state file path.
@@ -35,6 +35,6 @@ int validateCols(int cols);
  *
  * @return Returns `1` if the file path is valid, otherwise returns `0`.
  */
-int validateInitialStateFile(char* filePath);
+unsigned char validateInitialStateFile(const char* filePath);
 
 #endif  // SRC_VALIDATORS_H_INCLUDED
diff --git a/todos.md b/todos.md
index 7a6981b..b407191 100644
--- a/todos.md
+++ b/todos.md
@@ -5,4 +5,3 @@
 -   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
 -   Lograr que la función `setDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
 -   Realizar la parte III del trabajo práctico (lectura de archivos).
--   Remplazar los tipos de datos de las variables y parámetros por aquellos que son más óptimos (según sea en caso).

From c9e3c9bbc17c4f4355715c01890a0e828cd6b8d2 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Fri, 18 Oct 2024 17:48:44 +0000
Subject: [PATCH 24/37] ci: format code

---
 libs/utilities.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index cf078c8..d4ef0c4 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -129,7 +129,8 @@ char** new2DArray(const int rows, const int cols) {
 
 void sleep(int miliseconds) {
     const clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds));
+    while (clock() < (startTime + miliseconds))
+        ;
 }
 
 int strcmpi(const char* str01, const char* str02) {

From 017eeb7cf8c9aecf07add3d7117a3d242f50f076 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 14:55:05 -0300
Subject: [PATCH 25/37] doc: update documentation guidelines

---
 .github/translations/en/documentation.md | 20 ++++++--------------
 .github/translations/es/documentation.md | 20 ++++++--------------
 2 files changed, 12 insertions(+), 28 deletions(-)

diff --git a/.github/translations/en/documentation.md b/.github/translations/en/documentation.md
index a58369a..5d3f6c8 100644
--- a/.github/translations/en/documentation.md
+++ b/.github/translations/en/documentation.md
@@ -21,10 +21,7 @@ The documentation must follow these rules:
  * <DETAILED DESCRIPTION OF THE STRUCTURE (PURPOSE, AND LISTS OF FIELDS)>.
  */
 typedef struct {
-    /**
-     * @brief <BRIEF DESCRIPTION OF THE MEMBER>.
-     */
-    DataType01 member01;
+    DataType01 member01; /** <BRIEF DESCRIPTION OF THE MEMBER>. */
 
     // ...
 } MyStruct;
@@ -42,15 +39,8 @@ _For example..._
  * representing the x and y coordinates.
  */
 typedef struct {
-    /**
-     * @brief The x-coordinate of the point.
-     */
-    int x;
-
-    /**
-     * @brief The y-coordinate of the point.
-     */
-    int y;
+    int x; /**  The x-coordinate of the point. */
+    int y; /** The y-coordinate of the point. */
 } Point2D;
 ```
 
@@ -116,7 +106,9 @@ int factorial(int n) {
  * @def <MACRO NAME>
  * @brief <BRIEF DESCRIPTION OF WHAT THE MACRO DOES>.
  *
- * @warning <WARNINGS ABOUT THE USE OF THE MACRO (OPTIONAL)>.
+ * <DETAILED DESCRIPTION OF THE MACRO (OPTIONAL)>.
+ *
+ * @warning <WARNINGS ABOUT THE USE OF THE MACRO>.
  */
 #define MY_MACRO value
 ```
diff --git a/.github/translations/es/documentation.md b/.github/translations/es/documentation.md
index cb6d2b8..d29146e 100644
--- a/.github/translations/es/documentation.md
+++ b/.github/translations/es/documentation.md
@@ -21,10 +21,7 @@ Las documentaciones que se realicen deben seguir las siguientes reglas:
  * <DESCRIPCIÓN DETALLADA DE LA ESTRUCTURA (PROPÓSITO Y LISTADO DE CAMPOS)>.
  */
 typedef struct {
-    /**
-     * @brief <BREVE DESCRIPCIÓN DEL MIEMBRO>.
-     */
-    DataType01 member01;
+    DataType01 member01; /** <BREVE DESCRIPCIÓN DEL MIEMBRO>. */
 
     // ...
 } MyStruct;
@@ -42,15 +39,8 @@ _Por ejemplo..._
  * representing the x and y coordinates.
  */
 typedef struct {
-    /**
-     * @brief The x-coordinate of the point.
-     */
-    int x;
-
-    /**
-     * @brief The y-coordinate of the point.
-     */
-    int y;
+    int x; /** The x-coordinate of the point. */
+    int y; /** The y-coordinate of the point. */
 } Point2D;
 ```
 
@@ -116,7 +106,9 @@ int factorial(int n) {
  * @def <NOMBRE DE LA MACRO>
  * @brief <BREVE DESCRIPCIÓN DE LO QUE HACE LA MACRO>.
  *
- * @warning <ADVERTENCIAS SOBRE EL USO DE LA MACRO (OPCIONAL)>.
+ * <DESCRIPCIÓN DETALLADA DE LA MACRO (OPCIONAL)>.
+ *
+ * @warning <ADVERTENCIAS SOBRE EL USO DE LA MACRO>.
  */
 #define MY_MACRO value
 ```

From b75b0600f84e349572972d84aa9f643844e941a4 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 15:29:24 -0300
Subject: [PATCH 26/37] doc: update `Application Structure` section

---
 .github/translations/es/README.md | 85 +++++++++++++++++++++++--------
 README.md                         | 85 +++++++++++++++++++++++--------
 2 files changed, 130 insertions(+), 40 deletions(-)

diff --git a/.github/translations/es/README.md b/.github/translations/es/README.md
index 692cfc7..4cf4a9b 100644
--- a/.github/translations/es/README.md
+++ b/.github/translations/es/README.md
@@ -70,6 +70,7 @@ C-Practical-Work-2024/
 │
 ├── .github/
 │   ├── statics/
+│   │   ├── demo.mp4
 │   │   ├── illustration-01.png
 │   │   ├── illustration-02.png
 │   │   └── preview.png
@@ -85,14 +86,8 @@ C-Practical-Work-2024/
 │   │       └── requirements.md
 │   │
 │   └── workflows/
+│       ├── format-code-on-pr.yml
 │       └── format-code.yml
-│
-├── src/
-│   ├── main.c
-│   ├── src.cbp
-│   │
-│   └── statics/
-│       └── initial-state.txt
 |
 ├── libs/
 │   ├── libs.cbp
@@ -103,6 +98,13 @@ C-Practical-Work-2024/
 │   ├── validators.c
 │   ├── validators.h
 |   |
+│   ├── game/
+|   |   ├── macros.h
+|   |   ├── main.h
+|   |   ├── methods.c
+|   |   ├── methods.h
+|   |   └── structs.h
+|   |
 │   └── patterns/
 │       ├── constructors.c
 │       ├── constructors.h
@@ -111,6 +113,27 @@ C-Practical-Work-2024/
 │       ├── methods.c
 │       ├── methods.h
 │       └── structs.h
+│
+├── src/
+│   ├── macros.h
+│   ├── main.c
+│   ├── src.cbp
+│   ├── structs.h
+│   ├── utilities.c
+│   ├── utilities.h
+│   ├── validators.c
+│   ├── validators.h
+│   │
+│   ├── sdl/
+│   │   ├── main.h
+│   │   ├── methods.c
+│   │   ├── methods.h
+│   │   │
+│   │   └── SDL2/
+│   │       └── ( ... )
+│   │
+│   └── statics/
+│       └── initial-state.csv
 |
 ├── .clang-format
 ├── .gitignore
@@ -124,35 +147,57 @@ C-Practical-Work-2024/
     -   **[translations](./.github/translations)** - Traducciones de los archivos con extensión `.md` (Markdown).
     -   **[workflows](./.github/workflows)** - Flujos de trabajo de las GitHub Actions.
 
--   **[src](./src)** - Proyecto principal de la aplicación.
-
-    -   **[main.c](./src/main.c)** - Archivo de ejecución principal.
-    -   **[src.cbp](./src/src.cbp)** - Archivo de configuración del proyecto.
-
-    -   **[statics](./src/statics)** - Archivos (imágenes, videos, diagramas, etc.).
-
-        -   **[initial-state.txt](./src/statics/initial-state.txt)** - Archivo con el estado inicial de la aplicación.
-
 -   **[libs](./libs)** - Proyecto con las librerías necesarias para la ejecución del proyecto principal de aplicación.
 
     -   **[libs.cbp](./libs/libs.cbp)** - Archivo de configuración del proyecto.
     -   **[macros.h](./libs/macros.h)** - Archivo con las macros esenciales del proyecto.
     -   **[main.h](./libs/main.h)** - Archivo que indexa todos los archivos `.h` del proyecto.
     -   **[utilities.c](./libs/utilities.c)** - Archivo con el desarrollo de los prototipos de función presentes en `utilities.h`.
-    -   **[utilities.h](./libs/utilities.h)** - Archivo con las estructuras y los prototipos de función de uso común.
+    -   **[utilities.h](./libs/utilities.h)** - Archivo con los prototipos de función de uso común.
     -   **[validators.c](./libs/validators.c)** - Archivo con el desarrollo de los prototipos de función presentes en `validators.h`.
     -   **[validators.h](./libs/validators.h)** - Archivo con prototipos de funciones relacionadas con procesos de validación.
 
+    -   **[game](./libs/game)** - Funciones y estructuras para crear e interactuar con el Juego de la Vida de Conway.
+
+        -   **[macros.h](./libs/game/macros.h)** - Archivo con macros.
+        -   **[main.h](./libs/game/main.h)** - Archivo que indexa todos los archivos `.h` dentro de la carpeta `games`.
+        -   **[methods.c](./libs/game/methods.c)** - Archivo con el desarrollo de los prototipos de función presentes en `methods.h`.
+        -   **[methods.h](./libs/game/methods.h)** - Archivo con los prototipos de función relacionados a los métodos del Juego de la Vida de Conway.
+        -   **[structs.h](./libs/game/methods.h)** - Archivo con estructuras.
+
     -   **[patterns](./libs/patterns)** - Funciones y estructuras para crear patrones con células.
 
         -   **[constructors.c](./libs/patterns/constructors.c)** - Archivo con el desarrollo de los prototipos de función presentes en `constructors.h`.
-        -   **[constructors.h](./libs/patterns/constructors.h)** - Archivo con las estructuras y los prototipos de función relacionados a la creación de patrones.
-        -   **[macros.h](./libs/macros.h)** - Archivo con macros.
-        -   **[main.h](./libs/main.h)** - Archivo que indexa todos los archivos `.h` dentro de la carpeta `patterns`.
+        -   **[constructors.h](./libs/patterns/constructors.h)** - Archivo con los prototipos de función relacionados a la creación de patrones.
+        -   **[macros.h](./libs/patterns/macros.h)** - Archivo con macros.
+        -   **[main.h](./libs/patterns/main.h)** - Archivo que indexa todos los archivos `.h` dentro de la carpeta `patterns`.
         -   **[methods.c](./libs/patterns/methods.c)** - Archivo con el desarrollo de los prototipos de función presentes en `methods.h`.
         -   **[methods.h](./libs/patterns/methods.h)** - Archivo con los prototipos de función relacionados a los métodos de los patrones.
         -   **[structs.h](./libs/patterns/methods.h)** - Archivo con estructuras.
 
+-   **[src](./src)** - Proyecto principal de la aplicación.
+
+    -   **[macros.h](./src/macros.h)** - Archivo con las principales macros del proyecto.
+    -   **[main.c](./src/main.c)** - Archivo de ejecución principal.
+    -   **[src.cbp](./src/src.cbp)** - Archivo de configuración del proyecto.
+    -   **[structs.h](./src/structs.h)** - Archivo con las principales estructuras para configurar el proyecto.
+    -   **[utilities.c](./src/utilities.c)** - Archivo con el desarrollo de los prototipos de función presentes en `utilities.h`.
+    -   **[utilities.h](./src/utilities.h)** - Archivo con los prototipos de función para configurar el proyecto.
+    -   **[validators.c](./src/validators.c)** - Archivo con el desarrollo de los prototipos de función presentes en `utilities.h`.
+    -   **[validators.h](./src/validators.h)** - Archivo con los prototipos de función para validar los argumentos del proyecto.
+
+    -   **[sdl](./src/sdl)** - Funciones para interactuar con la librería SDL2.
+
+        -   **[SDL2](./src/sdl/SDL2)** - Librería SDL2.
+
+        -   **[main.h](./src/sdl/main.h)** - Archivo que indexa todos los archivos `.h` dentro de la carpeta `sdl`.
+        -   **[methods.c](./src/sdl/methods.c)** - Archivo con el desarrollo de los prototipos de función presentes en `methods.h`.
+        -   **[methods.h](./src/sdl/methods.h)** - Archivo con los prototipos de función que permiten interactuar con la librería SDL2.
+
+    -   **[statics](./src/statics)** - Archivos (imágenes, videos, diagramas, etc.).
+
+        -   **[initial-state.csv](./src/statics/initial-state.txt)** - Archivo con el estado inicial de la aplicación.
+
 -   **[.clang-format](./.clang-format)** - Archivo de configuración de la herramienta de formateo de código `clang-format`.
 -   **[.gitignore](./.gitignore)** - Archivo de configuración de Git para evitar el rastreo de archivos no deseados.
 -   **[LICENSE](./LICENSE)** - Licencia del proyecto.
diff --git a/README.md b/README.md
index 5d77718..69d163b 100644
--- a/README.md
+++ b/README.md
@@ -70,6 +70,7 @@ C-Practical-Work-2024/
 │
 ├── .github/
 │   ├── statics/
+│   │   ├── demo.mp4
 │   │   ├── illustration-01.png
 │   │   ├── illustration-02.png
 │   │   └── preview.png
@@ -85,14 +86,8 @@ C-Practical-Work-2024/
 │   │       └── requirements.md
 │   │
 │   └── workflows/
+│       ├── format-code-on-pr.yml
 │       └── format-code.yml
-│
-├── src/
-│   ├── main.c
-│   ├── src.cbp
-│   │
-│   └── statics/
-│       └── initial-state.txt
 |
 ├── libs/
 │   ├── libs.cbp
@@ -103,6 +98,13 @@ C-Practical-Work-2024/
 │   ├── validators.c
 │   ├── validators.h
 |   |
+│   ├── game/
+|   |   ├── macros.h
+|   |   ├── main.h
+|   |   ├── methods.c
+|   |   ├── methods.h
+|   |   └── structs.h
+|   |
 │   └── patterns/
 │       ├── constructors.c
 │       ├── constructors.h
@@ -111,6 +113,27 @@ C-Practical-Work-2024/
 │       ├── methods.c
 │       ├── methods.h
 │       └── structs.h
+│
+├── src/
+│   ├── macros.h
+│   ├── main.c
+│   ├── src.cbp
+│   ├── structs.h
+│   ├── utilities.c
+│   ├── utilities.h
+│   ├── validators.c
+│   ├── validators.h
+│   │
+│   ├── sdl/
+│   │   ├── main.h
+│   │   ├── methods.c
+│   │   ├── methods.h
+│   │   │
+│   │   └── SDL2/
+│   │       └── ( ... )
+│   │
+│   └── statics/
+│       └── initial-state.csv
 |
 ├── .clang-format
 ├── .gitignore
@@ -124,35 +147,57 @@ C-Practical-Work-2024/
     -   **[translations](./.github/translations)** - Translations of `.md` (Markdown) files.
     -   **[workflows](./.github/workflows)** - GitHub Actions workflows.
 
--   **[src](./src)** - Main project of the application.
-
-    -   **[main.c](./src/main.c)** - Main execution file.
-    -   **[src.cbp](./src/src.cbp)** - Project configuration file.
-
-    -   **[statics](./src/statics)** - Files (images, videos, diagrams, etc.).
-
-        -   **[initial-state.txt](./src/statics/initial-state.txt)** - File with the initial state of the application.
-
 -   **[libs](./libs)** - Project containing the libraries necessary for the execution of the main application project.
 
     -   **[libs.cbp](./libs/libs.cbp)** - Project configuration file.
     -   **[macros.h](./libs/macros.h)** - File with essential project macros.
     -   **[main.h](./libs/main.h)** - File indexing all `.h` files of the project.
     -   **[utilities.c](./libs/utilities.c)** - File with the implementation of the function prototypes found in `utilities.h`.
-    -   **[utilities.h](./libs/utilities.h)** - File with common structures and function prototypes.
+    -   **[utilities.h](./libs/utilities.h)** - File with common function prototypes.
     -   **[validators.c](./libs/validators.c)** - File with the implementation of the function prototypes found in `validators.h`.
     -   **[validators.h](./libs/validators.h)** - File with functions prototypes related to validation process.
 
+    -   **[game](./libs/game)** - Functions and structures to create and interact with Conway's Game of Life.
+
+        -   **[macros.h](./libs/game/macros.h)** - File containing macros.
+        -   **[main.h](./libs/game/main.h)** - File that indexes all `.h` files within the `games` folder.
+        -   **[methods.c](./libs/game/methods.c)** - File containing the implementation of the function prototypes found in `methods.h`.
+        -   **[methods.h](./libs/game/methods.h)** - File containing the function prototypes related to Conway's Game of Life methods.
+        -   **[structs.h](./libs/game/structs.h)** - File containing structures.
+
     -   **[patterns](./libs/patterns)** - Functions and structures for create patterns with cells.
 
         -   **[constructors.c](./libs/patterns/constructors.c)** - File with the implementation of the function prototypes found in `constructors.h`.
-        -   **[constructors.h](./libs/patterns/constructors.h)** - File with structures and function prototypes related to patterns creation.
-        -   **[macros.h](./libs/macros.h)** - File with macros.
-        -   **[main.h](./libs/main.h)** - File indexing all `.h` files inside `patterns` folder.
+        -   **[constructors.h](./libs/patterns/constructors.h)** - File with function prototypes related to patterns creation.
+        -   **[macros.h](./libs/patterns/macros.h)** - File with macros.
+        -   **[main.h](./libs/patterns/main.h)** - File indexing all `.h` files inside `patterns` folder.
         -   **[methods.c](./libs/patterns/methods.c)** - File with the implementation of the function prototypes found in `methods.h`.
         -   **[methods.h](./libs/patterns/methods.h)** - File with function prototypes related to pattern methods.
         -   **[structs.h](./libs/patterns/methods.h)** - File with structs.
 
+-   **[src](./src)** - Main project of the application.
+
+    -   **[macros.h](./src/macros.h)** - File with the project's main macros.
+    -   **[main.c](./src/main.c)** - Main execution file.
+    -   **[src.cbp](./src/src.cbp)** - Project configuration file.
+    -   **[structs.h](./src/structs.h)** - File with the main structures for configuring the project.
+    -   **[utilities.c](./src/utilities.c)** - File with the implementation of the function prototypes found in `utilities.h`.
+    -   **[utilities.h](./src/utilities.h)** - File with the function prototypes for configuring the project.
+    -   **[validators.c](./src/validators.c)** - File with the implementation of the function prototypes found in `utilities.h`.
+    -   **[validators.h](./src/validators.h)** - File with the function prototypes for validating the project's arguments.
+
+    -   **[sdl](./src/sdl)** - Functions for interacting with the SDL2 library.
+
+        -   **[SDL2](./src/sdl/SDL2)** - SDL2 library.
+
+        -   **[main.h](./src/sdl/main.h)** - File indexing all `.h` files inside `sdl` folder.
+        -   **[methods.c](./src/sdl/methods.c)** - File with the implementation of the function prototypes found in `methods.h`.
+        -   **[methods.h](./src/sdl/methods.h)** - File with the function prototypes to interact with the SDL2 library.
+
+    -   **[statics](./src/statics)** - Files (images, videos, diagrams, etc.).
+
+        -   **[initial-state.txt](./src/statics/initial-state.txt)** - File with the initial state of the application.
+
 -   **[.clang-format](./.clang-format)** - Configuration file for the `clang-format` code formatting tool.
 -   **[.gitignore](./.gitignore)** - Git configuration file to avoid tracking unwanted files.
 -   **[LICENSE](./LICENSE)** - Project license.

From f296cd1545faef9797054e43a29596b297ca8107 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 15:29:50 -0300
Subject: [PATCH 27/37] todos: complete todo

---
 todos.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/todos.md b/todos.md
index b407191..ec5c0e4 100644
--- a/todos.md
+++ b/todos.md
@@ -1,6 +1,5 @@
 # Falta
 
--   Actualizar las secciones `Application Structure` de los archivos `README.md`, ya que no cuentan con el detalle de los nuevos archivos incorporados.
 -   Actualizar las secciones `Features` de los archivos `README.md`.
 -   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
 -   Lograr que la función `setDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.

From f6c488fc70c77e387074a8b4d62e0e7dd88eed0c Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 15:41:47 -0300
Subject: [PATCH 28/37] doc: update `Features` section

---
 .github/translations/es/README.md | 7 +++++++
 README.md                         | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/.github/translations/es/README.md b/.github/translations/es/README.md
index 4cf4a9b..be31b29 100644
--- a/.github/translations/es/README.md
+++ b/.github/translations/es/README.md
@@ -40,9 +40,16 @@ Este repositorio contiene el trabajo práctico de la materia Tópicos de Program
 
 ## Características
 
+-   Confirmaciones siguiendo la guía de los [Commits Convencionales](https://www.conventionalcommits.org/es/v1.0.0/)
+-   Control de entradas utilizando validaciones
 -   Convenciones y estándares de código
+-   Despliegue de entregables
+-   Diseño responsivo
 -   Documentación del código utilizando la sintaxis de [Doxygen](https://www.doxygen.nl/)
+-   Implementación de argumentos del programa
+-   Implementación de la libraría [Simple DirectMedia Layer (SDL)](https://www.libsdl.org/)
 -   Integración continua con [GitHub Actions](https://docs.github.com/es/actions)
+-   Lectura e interpretación de archivos
 -   Memoria dinámica
 -   Planificación de la arquitectura
 -   Planificación del flujo de trabajo del equipo (ramas, etiquetas y versionado)
diff --git a/README.md b/README.md
index 69d163b..185be91 100644
--- a/README.md
+++ b/README.md
@@ -43,8 +43,15 @@ This repository contains the practical work for the Programming Topics course at
 -   Architecture planning
 -   Code conventions and standards
 -   Code documentation using [Doxygen](https://www.doxygen.nl/) syntax
+-   Commits following the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/)
 -   Continuous integration with [GitHub Actions](https://docs.github.com/en/actions)
+-   Deployment of releases
 -   Dynamic memory
+-   File reading and interpretation
+-   Implementation of program arguments
+-   Implementation of the [Simple DirectMedia Layer (SDL)](https://www.libsdl.org/) library
+-   Input control using validations
+-   Responsive design
 -   Team Workflow planning (branches, tags, and releases)
 
 ## Installation

From 5da368f901c0452d5c43d5eeadecfa2b5b7d5492 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 15:42:01 -0300
Subject: [PATCH 29/37] todos: complete todo

---
 todos.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/todos.md b/todos.md
index ec5c0e4..e462484 100644
--- a/todos.md
+++ b/todos.md
@@ -1,6 +1,5 @@
 # Falta
 
--   Actualizar las secciones `Features` de los archivos `README.md`.
 -   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
 -   Lograr que la función `setDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
 -   Realizar la parte III del trabajo práctico (lectura de archivos).

From 1fe86cd347d297f1221a248103751328c7a39b0b Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 16:19:34 -0300
Subject: [PATCH 30/37] doc: create `Program arguments` section

---
 .github/translations/en/documentation.md |  2 +-
 .github/translations/en/requirements.md  |  4 ++--
 .github/translations/es/README.md        | 19 ++++++++++++++++-
 README.md                                | 27 +++++++++++++++++++-----
 4 files changed, 43 insertions(+), 9 deletions(-)

diff --git a/.github/translations/en/documentation.md b/.github/translations/en/documentation.md
index 5d3f6c8..5d15f24 100644
--- a/.github/translations/en/documentation.md
+++ b/.github/translations/en/documentation.md
@@ -1,4 +1,4 @@
-# Code Documentation
+# Code documentation
 
 This document provides a series of templates and examples to document the [structures](#structures), [functions](#functions), and [macros](#macros) of the application.
 
diff --git a/.github/translations/en/requirements.md b/.github/translations/en/requirements.md
index 342763a..bef23ac 100644
--- a/.github/translations/en/requirements.md
+++ b/.github/translations/en/requirements.md
@@ -3,13 +3,13 @@
 > [!CAUTION]
 > 2 grades are required in the subject, the practical work (PW) must be submitted and defended individually in parts 1 and 2 before the midterm exam. The defense will be individual, and you must demonstrate mastery of the tools in general and the practical work in particular. For the PW to be archived, it must be submitted by the deadline indicated by the teachers in the following format: `ID_LASTNAME_FIRSTNAME_PW.zip`, e.g., `41127133_PEREZ_MARIA_PIA_PW.zip`. Note that it is a `.zip`, not `.rar` or `.7z`, respect the submission format. The PW as a suffix indicates it is practical work. Attach the statement and remove the `bin` and `obj` folders, as you are sharing programs, and for obvious reasons, the servers will delete compressed files containing binaries or executables.
 
-## Necessary Knowledge
+## Necessary knowledge
 
 -   **Part 1**: Structured programming and arrays.
 -   **Part 2**: Dynamic memory.
 -   **Part 3**: Files.
 
-## General Guidelines and Statement
+## General guidelines and statement
 
 Develop the following work in groups of 3 to 5 people. Submission and defense are mandatory. Parts 1 and 2 will be required to take the midterm exam. Keep in mind that the solution must be executable in the laboratories of the [UNLaM](https://www.unlam.edu.ar/), so it must be compatible with the **MinGW 64-bit** compiler. For richer and lag-free visualization, it is recommended to use the [SDL (Simple DirectMedia Layer)](https://www.libsdl.org/) library, the teachers will provide a project with the library included. You will only need to know the functions that allow drawing the elements of the work (_Illustration 1_).
 
diff --git a/.github/translations/es/README.md b/.github/translations/es/README.md
index be31b29..7b63b95 100644
--- a/.github/translations/es/README.md
+++ b/.github/translations/es/README.md
@@ -64,7 +64,24 @@ Este repositorio contiene el trabajo práctico de la materia Tópicos de Program
 
 4. Selecciona el proyecto [src.cbp](./src/src.cbp) (proyecto principal) y ejecútalo en modo Release para disfrutar del Juego de la Vida de Conway.
 
-## Problemas conocidos
+### Argumentos del programa
+
+| Argumento              | Descripción                                            | Valor/es aceptado/s                                                    | Valor por defecto                                     | Ejemplo                                              |
+| :--------------------- | :----------------------------------------------------- | :--------------------------------------------------------------------- | :---------------------------------------------------- | ---------------------------------------------------- |
+| `--dashboard-rows`     | Cantidad de filas que tendrá el tablero.               | `int` (0, valor por defecto]                                           | `(<RESOLUCIÓN DEL ALTO DE LA PANTALLA> / 10) * 0.93`  | `--dashboard-rows=28`                                |
+| `--dashboard-cols`     | Cantidad de columnas que tendrá el tablero.            | `int` (0, valor por defecto]                                           | `(<RESOLUCIÓN DEL ANCHO DE LA PANTALLA> / 10) * 0.99` | `--dashboard-cols=55`                                |
+| `--pattern`            | Patrón a dibujar en el centro del tablero.             | `"glider"`, `"toad"`, `"press"` ó `"glider cannon"`                    | `""`                                                  | `--pattern="glider cannon"`                          |
+| `--maximum-generation` | Generaciones máximas.                                  | `int` (un valor menor a `0` se interpreta como generaciones infinitas) | `0`                                                   | `--maximum-generation=-1`                            |
+| `--delay`              | Tiempo de espera para generar la siguiente generación. | `int` [0, 1000]                                                        | `0`                                                   | `--delay=50`                                         |
+| `--platform`           | Plataforma en donde se dibujara el tablero.            | `"console"` ó `"sdl"`                                                  | `""`                                                  | `--platform="sdl"`                                   |
+| `--initial-state-file` | Ruta a un archivo con el estado inicial del tablero.   | Cualquier ruta a un archivo con extensión `.txt` ó `.csv`              | `""`                                                  | `--initial-state-file="./statics/initial-state.csv"` |
+
+> [¿Cómo defino los argumentos del programa?](https://www.youtube.com/watch?v=9Mi_TTOml94) (opcional).
+
+> [!IMPORTANT]
+> Todos los argumentos (exceptuando `--dashboard-rows`, `--dashboard-cols` y `--initial-state-file`) serán solicitados por consola si no son definidos o acepados. Además, el parámetro `--pattern` sera ignorado si se declara un parámetro `--initial-state-file` válido.
+
+### Problemas conocidos
 
 | Problema                                                              | Solución                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | :-------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
diff --git a/README.md b/README.md
index 185be91..04554c8 100644
--- a/README.md
+++ b/README.md
@@ -64,13 +64,30 @@ This repository contains the practical work for the Programming Topics course at
 
 4. Select the [src.cbp](./src/src.cbp) project (main project) and run it in Release mode to enjoy Conway's Game of Life.
 
-## Known Issues
+### Program arguments
+
+| Argument               | Description                                             | Accepted value(s)                                        | Default value                              | Example                                              |
+| :--------------------- | :------------------------------------------------------ | :------------------------------------------------------- | :----------------------------------------- | ---------------------------------------------------- |
+| `--dashboard-rows`     | Number of rows for the dashboard.                       | `int` (0, default value]                                 | `(<SCREEN HEIGHT RESOLUTION> / 10) * 0.93` | `--dashboard-rows=28`                                |
+| `--dashboard-cols`     | Number of columns for the dashboard.                    | `int` (0, default value]                                 | `(<SCREEN WIDTH RESOLUTION> / 10) * 0.99`  | `--dashboard-cols=55`                                |
+| `--pattern`            | Pattern to draw in the center of the dashboard.         | `"glider"`, `"toad"`, `"press"` or `"glider cannon"`     | `""`                                       | `--pattern="glider cannon"`                          |
+| `--maximum-generation` | Maximum number of generations.                          | `int` (a value less than `0` means infinite generations) | `0`                                        | `--maximum-generation=-1`                            |
+| `--delay`              | Delay to generate the next generation.                  | `int` [0, 1000]                                          | `0`                                        | `--delay=50`                                         |
+| `--platform`           | Platform where the dashboard will be rendered.          | `"console"` or `"sdl"`                                   | `""`                                       | `--platform="sdl"`                                   |
+| `--initial-state-file` | Path to a file with the initial state of the dashboard. | Any path to a file with a `.txt` or `.csv` extension     | `""`                                       | `--initial-state-file="./statics/initial-state.csv"` |
+
+> [How do I define the program arguments?](https://www.youtube.com/watch?v=9Mi_TTOml94) (optional).
+
+> [!IMPORTANT]
+> All arguments (except for `--dashboard-rows`, `--dashboard-cols`, and `--initial-state-file`) will be requested via the console if not defined or accepted. Additionally, the `--pattern` parameter will be ignored if a valid `--initial-state-file` is provided.
+
+### Known issues
 
 | Issue                                                       | Solution                                                                                                                                                                                                                                                                                                                                                                                                         |
 | :---------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **[src.cbp](./src/src.cbp) (main project) doesn't compile** | _Select the [libs.cbp](./libs/libs.cbp) project (library project) and compile it in Release mode and Debug mode. Then, select the [src.cbp](./src/src.cbp) project (main project), right-click on it, choose `Build Options`, and go to the `Linker settings` tab. There, add the `libs.a` files located in the `libs/bin/Debug` and `libs/bin/Release` folders. Finally, try compiling the main project again._ |
 
-## Application Structure
+## Application structure
 
 ```plaintext
 C-Practical-Work-2024/
@@ -210,7 +227,7 @@ C-Practical-Work-2024/
 -   **[LICENSE](./LICENSE)** - Project license.
 -   **[README.md](./README.md)** - Markdown file with the general documentation for the application and repository.
 
-## Team Workflow
+## Team workflow
 
 ```mermaid
 %%{init: { 'logLevel': 'debug', 'theme': 'dark', 'gitGraph': {'showBranches': true, 'showCommitLabel': true, 'mainBranchName': 'Master', 'parallelCommits': true}} }%%
@@ -259,7 +276,7 @@ C-Practical-Work-2024/
 
 > The other branches are fictional and represent individual contributions from each member to the `develop` branch.
 
-## Development Team
+## Development team
 
 -   [Giannotti Tiago](https://github.com/TiagoGiannotti)
 -   [Hoz Lucas](https://github.com/hozlucas28)
@@ -267,7 +284,7 @@ C-Practical-Work-2024/
 -   [Linares Guido](https://www.linkedin.com/in/guido-linares-25859b209/)
 -   [Quiroga Ferney Santiago](https://github.com/Ferny1011)
 
-## Additional Material
+## Additional material
 
 -   [Code Documentation](./.github/translations/en/documentation.md)
 -   [Practical Work Requirements](./.github/translations/en/requirements.md)

From 4a5f48e456b65290bf8f1f883cb6672bd65aa4d5 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 16:19:51 -0300
Subject: [PATCH 31/37] todos: complete todo

---
 todos.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/todos.md b/todos.md
index e462484..94b759e 100644
--- a/todos.md
+++ b/todos.md
@@ -1,5 +1,4 @@
 # Falta
 
--   Crear sección de comandos (argumentos a Main) que la aplicación puede recibir por consola.
 -   Lograr que la función `setDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
 -   Realizar la parte III del trabajo práctico (lectura de archivos).

From b6f11638fa44f918bff018ff91c6371933fc8659 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Fri, 18 Oct 2024 16:23:31 -0300
Subject: [PATCH 32/37] fix: remove auto set program arguments

---
 src/src.cbp | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/src.cbp b/src/src.cbp
index 86c4aa8..cf358f5 100644
--- a/src/src.cbp
+++ b/src/src.cbp
@@ -11,7 +11,6 @@
 				<Option object_output="obj/Debug/" />
 				<Option type="1" />
 				<Option compiler="gcc" />
-				<Option parameters='--dashboard-rows=28 --dashboard-cols=55 --pattern=&quot;glider cannon&quot; --maximum-generation=-1 --delay=50 --platform=sdl --initial-state-file=&quot;initial-state.csv&quot;' />
 				<Compiler>
 					<Add option="-g" />
 				</Compiler>
@@ -21,7 +20,6 @@
 				<Option object_output="obj/Release/" />
 				<Option type="1" />
 				<Option compiler="gcc" />
-				<Option parameters='--dashboard-rows=28 --dashboard-cols=55 --pattern=&quot;glider cannon&quot; --maximum-generation=-1 --delay=50 --platform=sdl --initial-state-file=&quot;initial-state.csv&quot;' />
 				<Compiler>
 					<Add option="-O2" />
 				</Compiler>

From 76dee53bb43f10ebc783d13592936377659186f7 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 20 Oct 2024 18:39:24 -0300
Subject: [PATCH 33/37] fix: data types

---
 libs/game/methods.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/game/methods.c b/libs/game/methods.c
index 92281f9..5c93738 100644
--- a/libs/game/methods.c
+++ b/libs/game/methods.c
@@ -10,8 +10,8 @@
 #include "./structs.h"
 
 int countAliveNeighbors(TGame* pGame, const int cellRow, const int cellCol, const int radius) {
-    size_t i;
-    size_t j;
+    int i;
+    int j;
 
     const int startRow = cellRow - radius;
     const int startCol = cellCol - radius;

From 3f540fe1d0a2564de1d88fd0b31cd702ae4d4263 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 20 Oct 2024 19:21:01 -0300
Subject: [PATCH 34/37] feature: implement `setDashboardFromFile` function

Co-authored-by: EstefaniaHuergo <estefaniahhuergo@gmail.com>
Co-authored-by: Ferney Santiago Quiroga <Ferny1011@users.noreply.github.com>
Co-authored-by: Guidolinares <gulinares@alumno.unlam.com>
Co-authored-by: Tiago Giannotti <tiago.giannotti.02@gmail.com>
---
 libs/utilities.c | 65 ++++++++++++++++++++++++++++++++++++++++--------
 libs/utilities.h |  4 ++-
 src/main.c       | 32 +++++++++++++++---------
 3 files changed, 78 insertions(+), 23 deletions(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index d4ef0c4..dbcb1e1 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -20,8 +20,9 @@ void destroy2DArray(char** arr, const int rows, const int cols) {
     free(arr);
 }
 
-int setDashboardFromFile(const char* filePath, TGame* pGame) {
+int setDashboardFromFile(const char* filePath, TGame* pGame, const int minRows, const int minCols) {
     FILE* pf;
+    TPattern pattern;
 
     char* line;
     const size_t lineLength = 100;
@@ -33,8 +34,11 @@ int setDashboardFromFile(const char* filePath, TGame* pGame) {
     int rowInt;
     int colInt;
 
-    int rows = pGame->rows;
-    int cols = pGame->cols;
+    int rows = minRows;
+    int cols = minCols;
+
+    int patternRows = 0;
+    int patternCols = 0;
 
     pf = fopen(filePath, "rt");
     if (pf == NULL) return 0;
@@ -59,14 +63,56 @@ int setDashboardFromFile(const char* filePath, TGame* pGame) {
         sscanf(row, "%d", &rowInt);
         sscanf(col, "%d", &colInt);
 
-        rows = MAX(rowInt, rows);
-        cols = MAX(colInt, cols);
+        patternRows = MAX(rowInt, patternRows);
+        patternCols = MAX(colInt, patternCols);
+    }
+
+    rows = MAX(patternRows, rows);
+    cols = MAX(patternCols, cols);
+
+    pGame->dashboard = new2DArray(rows, cols);
+    pGame->rows = rows;
+    pGame->cols = cols;
+    pGame->cellsAlive = 0;
+    pGame->generation = 0;
+
+    setDashboardCenter(pGame);
+
+    fillDashboard(pGame, DEAD_CELL);
+
+    pattern.arr = new2DArray(patternRows, patternCols);
+    pattern.rows = patternRows;
+    pattern.cols = patternCols;
+
+    setPatternCenter(&pattern);
+
+    fillPattern(&pattern, DEAD_CELL);
+
+    rewind(pf);
+    fgets(line, lineLength, pf);
+
+    while (fgets(line, lineLength, pf)) {
+        row = line;
+        sep = strrchr(line, ';');
+        if (sep == NULL) continue;
+
+        *sep = '\0';
+        col = sep + 1;
+
+        sscanf(row, "%d", &rowInt);
+        sscanf(col, "%d", &colInt);
+
+        pattern.arr[rowInt - 1][colInt - 1] = ALIVE_CELL;
+        pGame->cellsAlive++;
     }
 
-    printf("\n\n> rows: %d\n", rows);
-    printf("> cols: %d\n\n", cols);
+    pGame->cellsDead = (cols * rows) - pGame->cellsAlive;
+
+    drawPatternInDashboard(pGame, &pattern);
+    destroy2DArray(pattern.arr, pattern.rows, pattern.cols);
 
-    // TODO: draw in dashboard.
+    fclose(pf);
+    free(line);
 
     return 1;
 }
@@ -129,8 +175,7 @@ char** new2DArray(const int rows, const int cols) {
 
 void sleep(int miliseconds) {
     const clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds))
-        ;
+    while (clock() < (startTime + miliseconds));
 }
 
 int strcmpi(const char* str01, const char* str02) {
diff --git a/libs/utilities.h b/libs/utilities.h
index 3c80895..ae8ed73 100644
--- a/libs/utilities.h
+++ b/libs/utilities.h
@@ -33,10 +33,12 @@ void destroy2DArray(char** arr, const int rows, const int cols);
  *
  * @param filePath File path with the content to be parsed.
  * @param pGame Pointer to the Conway's Game of Life structure.
+ * @param minRows Minimum number of rows for the dashboard.
+ * @param minCols Minimum number of columns for the dashboard.
  *
  * @return Returns `1` on success, otherwise returns `0`.
  */
-int setDashboardFromFile(const char* filePath, TGame* pGame);
+int setDashboardFromFile(const char* filePath, TGame* pGame, const int minRows, const int minCols);
 
 /**
  * @brief Gets user input as a string.
diff --git a/src/main.c b/src/main.c
index b180a07..3ba42a9 100644
--- a/src/main.c
+++ b/src/main.c
@@ -32,22 +32,23 @@ int main(const int argc, char* argv[]) {
 
     rows = mainArguments.dashboardRows;
     cols = mainArguments.dashboardCols;
-    dashboard = new2DArray(rows, cols);
 
-    game.dashboard = dashboard;
-    game.rows = rows;
-    game.cols = cols;
-    game.cellsAlive = 0;
-    game.cellsDead = cols * rows;
-    game.generation = 0;
+    /* ----------------------------- Request Pattern ---------------------------- */
 
-    setDashboardCenter(&game);
+    if (*mainArguments.initialStateFile == '\0') {
+        dashboard = new2DArray(rows, cols);
 
-    fillDashboard(&game, DEAD_CELL);
+        game.dashboard = dashboard;
+        game.rows = rows;
+        game.cols = cols;
+        game.cellsAlive = 0;
+        game.cellsDead = cols * rows;
+        game.generation = 0;
 
-    /* ----------------------------- Request Pattern ---------------------------- */
+        setDashboardCenter(&game);
+
+        fillDashboard(&game, DEAD_CELL);
 
-    if (*mainArguments.initialStateFile == '\0') {
         if (*mainArguments.pattern == '\0') {
             requestedPattern = getUserInputStr(
                 "> Which pattern do you want? ('Glider','Toad', 'Press', or 'Glider cannon'): ",
@@ -68,7 +69,14 @@ int main(const int argc, char* argv[]) {
     } else {
         /* --------------------------- Draw Initial State --------------------------- */
 
-        setDashboardFromFile(mainArguments.initialStateFile, &game);
+        if (!setDashboardFromFile(mainArguments.initialStateFile, &game, rows, cols)) {
+            printf(
+                "> An error occurred on set the initial state of the dashboard! Please check the "
+                "file path with the initial state (received %s) and it's content.\n",
+                mainArguments.initialStateFile);
+
+            exit(EXIT_FAILURE);
+        }
     }
 
     /* ----------------------- Request Maximum Generation ----------------------- */

From d7e08e19fba7031e6da77cd5f15f6958b0c90d7a Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 20 Oct 2024 22:21:27 +0000
Subject: [PATCH 35/37] ci: format code

---
 libs/utilities.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libs/utilities.c b/libs/utilities.c
index dbcb1e1..8919bda 100644
--- a/libs/utilities.c
+++ b/libs/utilities.c
@@ -175,7 +175,8 @@ char** new2DArray(const int rows, const int cols) {
 
 void sleep(int miliseconds) {
     const clock_t startTime = clock();
-    while (clock() < (startTime + miliseconds));
+    while (clock() < (startTime + miliseconds))
+        ;
 }
 
 int strcmpi(const char* str01, const char* str02) {

From 6c7fe0672bdf1e6e2d273879a0a13ea7812433a3 Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 20 Oct 2024 19:21:40 -0300
Subject: [PATCH 36/37] todos: complete all todos

---
 todos.md | 4 ----
 1 file changed, 4 deletions(-)
 delete mode 100644 todos.md

diff --git a/todos.md b/todos.md
deleted file mode 100644
index 94b759e..0000000
--- a/todos.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Falta
-
--   Lograr que la función `setDashboardFromFile` dibuje el estado inicial del juego en base al contenido del archivo.
--   Realizar la parte III del trabajo práctico (lectura de archivos).

From a9b055a2ac89295ae17afe18b551bc604e602b8a Mon Sep 17 00:00:00 2001
From: hozlucas28 <hozlucas28@gmail.com>
Date: Sun, 20 Oct 2024 19:31:16 -0300
Subject: [PATCH 37/37] doc: add new alert

---
 .github/translations/es/README.md | 3 +++
 README.md                         | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/.github/translations/es/README.md b/.github/translations/es/README.md
index 7b63b95..df3d398 100644
--- a/.github/translations/es/README.md
+++ b/.github/translations/es/README.md
@@ -81,6 +81,9 @@ Este repositorio contiene el trabajo práctico de la materia Tópicos de Program
 > [!IMPORTANT]
 > Todos los argumentos (exceptuando `--dashboard-rows`, `--dashboard-cols` y `--initial-state-file`) serán solicitados por consola si no son definidos o acepados. Además, el parámetro `--pattern` sera ignorado si se declara un parámetro `--initial-state-file` válido.
 
+> [!WARNING]
+> El contenido del archivo apuntado por el parámetro `--initial-state-file` debe seguir un formato especifico como puede observar en el archivo [initial-state.csv](../../../src/statics/initial-state.csv).
+
 ### Problemas conocidos
 
 | Problema                                                              | Solución                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
diff --git a/README.md b/README.md
index 04554c8..67217c1 100644
--- a/README.md
+++ b/README.md
@@ -81,6 +81,9 @@ This repository contains the practical work for the Programming Topics course at
 > [!IMPORTANT]
 > All arguments (except for `--dashboard-rows`, `--dashboard-cols`, and `--initial-state-file`) will be requested via the console if not defined or accepted. Additionally, the `--pattern` parameter will be ignored if a valid `--initial-state-file` is provided.
 
+> [!WARNING]
+> The content of the file targeted by the `--initial-state-file` parameter must follow a specific format, as seen in the file [initial-state.csv](./src/statics/initial-state.csv).
+
 ### Known issues
 
 | Issue                                                       | Solution                                                                                                                                                                                                                                                                                                                                                                                                         |