Merge branch 'feat/sorting' into main

Implement basic sorting of the Input.csv file.

Author: ByteMeHahaha

.gitignore

@@ -3,3 +3,7 @@ bin/
 
 # Build Artifacts
 *.zip
+
+# Backup data for testing
+data-backups/
+*.bak

README.md

@@ -3,11 +3,30 @@
 A free-format COBOL app that sorts a pre-defined file.
 
 - Author: Ethan Kletschke
-- Version: `0.0.2`
+- Version: `0.0.3`
 - Developed on: Windows 11
 - License: MIT
 
-## Disclaimer 
+## Instructions for Use
 
-This app does nothing at the moment, except declare the files to use in the 
-program and display `"Hello, World!"`.
+1. Decompress the `.zip` folder provided in the latest GitHub release of the app
+2. Move the `Input.csv` file in the `data/` folder into the same folder as the
+  `.exe`.
+3. Run the `.exe` provided in the decompressed folder.
+4. Open `Output.csv` to verify that the sorting is complete.
+
+## Using Your Own Data
+
+Feel free to test the application with your own `.csv` files. Trying different
+data formats helps validate the robustness of the sorting logic and may uncover
+edge cases. When doing so, please adhere to the rules listed below:
+
+### CSV Layout
+
+The columns of the CSV have to be as follows:
+
+1. 4-digit ID, including leading zeros
+2. User name and surname, up to 45 characters
+3. 3-digit age, including leading zeros
+
+Do not include headers!

data/Input.csv

@@ -0,0 +1,20 @@
+8511,Ethan Kletschke,019
+0739,Sabrielle De Lara,017
+1048,Skye Jackson,020
+6004,John Smith,060
+5338,Jackie Bell,012
+5360,Ethan Gardner,012
+8656,Elizabeth Baker,017
+7993,Eliza Smith,105
+2596,Peter Gomez,021
+3603,Alex Grande,092
+1405,Virginia Kelley,059
+5769,Harriett Owens,025
+6272,Aiden Love,048
+6052,Gerald Banks,020
+4529,Cole Park,085
+2696,Minerva Reyes,077
+6309,Maurice Lane,080
+9692,Herman Conner,055
+9422,Patrick Horton,071
+3199,Ida Moody,060

meta/project.yaml

@@ -10,7 +10,7 @@ project-meta:
     - COBOL (GnuCOBOL)
   status: Experimental
   license: MIT
-  version: 0.0.2
+  version: 0.0.3
 
 build:
   dev-environments:

scripts/lint.cmd

@@ -7,6 +7,7 @@ cobc -I ../src ^
   --free ^
   ../src/**.cob ^
   -Wall ^
-  -Wextra
+  -Wextra ^
+  -Wno-terminator
 
 @REM Note: Run from the same folder as the script.

src/main.cob

@@ -6,17 +6,17 @@ ENVIRONMENT DIVISION.
   INPUT-OUTPUT SECTION.
     FILE-CONTROL.
       *> The file to sort
-      SELECT Input-File ASSIGN TO "Input.txt"
+      SELECT Input-File ASSIGN TO "Input.csv"
       ORGANISATION LINE SEQUENTIAL
       ACCESS SEQUENTIAL.
 
-      *> Sort work file (internal to SORT statement)
-      SELECT Sort-File ASSIGN TO "SortWork.txt"
+      *> Sort work file
+      SELECT Sort-File ASSIGN TO "SortWork.csv"
       ORGANISATION LINE SEQUENTIAL
       ACCESS SEQUENTIAL.
 
       *> Sort output file
-      SELECT Out-File ASSIGN TO "Output.txt"
+      SELECT Out-File ASSIGN TO "Output.csv"
       ORGANISATION LINE SEQUENTIAL
       ACCESS SEQUENTIAL.
 
@@ -25,23 +25,35 @@ DATA DIVISION.
     FD Input-File.
       01 Input-Rec.
         05 In-UID PIC 9(4).
-        05 In-Username PIC X(25).
+        05 FILLER PIC X VALUE ",".
+        05 In-Username PIC X(45).
+        05 FILLER PIC X VALUE ",".
         05 In-User-Age PIC 999.
 
     SD Sort-File.
       01 Sort-Rec.
         05 Sf-UID PIC 9(4).
-        05 Sf-Username PIC X(25).
+        05 FILLER PIC X VALUE ",".
+        05 Sf-Username PIC X(45).
+        05 FILLER PIC X VALUE ",".
         05 Sf-User-Age PIC 999.
 
     FD Out-File.
       01 Out-Rec.
         05 Out-UID PIC 9(4).
-        05 Out-Username PIC X(25).
+        05 FILLER PIC X VALUE ",".
+        05 Out-Username PIC X(45).
+        05 FILLER PIC X VALUE ",".
         05 Out-User-Age PIC 999.
 
 PROCEDURE DIVISION.
-  DISPLAY "Hello, World!".
+  SORT Sort-File
+    ON ASCENDING KEY Sf-UID
+    USING Input-File
+    GIVING Out-File.
+
+  DISPLAY "File Sorted".
+
   STOP RUN.
 
 END PROGRAM Sorting-Files.