From 9a3e662823a75d5c532dc1f4a4abf49a64207dc9 Mon Sep 17 00:00:00 2001
From: Trishaan <tshetty1@my.bcit.ca>
Date: Fri, 3 Oct 2025 14:31:00 -0700
Subject: [PATCH 1/5] created date, name and person class with printable
 interface

---
 src/code/ca/bcit/comp2522/lab04/Date.java     | 391 ++++++++++++++++++
 src/code/ca/bcit/comp2522/lab04/Name.java     |  66 +++
 src/code/ca/bcit/comp2522/lab04/Person.java   |  37 ++
 .../ca/bcit/comp2522/lab04/Printable.java     |   5 +
 4 files changed, 499 insertions(+)
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Date.java
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Name.java
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Person.java
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Printable.java

diff --git a/src/code/ca/bcit/comp2522/lab04/Date.java b/src/code/ca/bcit/comp2522/lab04/Date.java
new file mode 100644
index 0000000..317601e
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Date.java
@@ -0,0 +1,391 @@
+package ca.bcit.comp2522.lab04;
+
+//TODO proof read. Added the implementation and over rid the printable method.
+
+/**
+ * Date contains useful methods about a given date.
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public final class Date implements Printable {
+    // Domain of dates
+    private static final int MIN_YEAR = 1800;
+    private static final int MAX_YEAR = 2025;
+    private static final int MIN_DAY = 1;
+
+    // Constants for calculating leap year, and days in given month
+    private static final int YEARS_BTWN_LEAP_YEARS = 4;
+    private static final int YEARS_PER_CENTURY = 100;
+    private static final int YEARS_BTWN_LEAP_CENTURIES = 400;
+    private static final int LEAP_YEAR_MOD_RESULT = 0;
+    private static final int LEAP_YEAR_DAYS = 29;
+    private static final int NON_LEAP_YEAR_DAYS = 28;
+    private static final int MONTH_MOST_DAYS = 31;
+    private static final int MONTH_REGULAR_DAYS = 30;
+    private static final int EVEN = 2;
+    private static final int IS_DIVISIBLE = 1;
+
+    // Constants to get next or last value
+    private static final int GET_NEXT = 1;
+    private static final int GET_PREVIOUS = 1;
+
+    // Constants to add to sum for calculating day of week
+    private static final int CENTURY_CODE_YEAR_EIGHTEEN_HUNDREDS = 2;
+    private static final int CENTURY_CODE_YEAR_TWO_THOUSANDS = 6;
+    private static final int CENTURY_CODE_AND_MONTH_CODE = 12;
+
+    // Century definitions
+    private static final int YEAR_EIGHTEEN_HUNDREDS = 1800;
+    private static final int YEAR_NINETEEN_HUNDREDS = 1900;
+    private static final int YEAR_TWO_THOUSANDS = 2000;
+
+    // Months
+    private static final int JANUARY = 1;
+    private static final int FEBRUARY = 2;
+    private static final int MARCH = 3;
+    private static final int APRIL = 4;
+    private static final int MAY = 5;
+    private static final int JUNE = 6;
+    private static final int JULY = 7;
+    private static final int AUGUST = 8;
+    private static final int SEPTEMBER = 9;
+    private static final int OCTOBER = 10;
+    private static final int NOVEMBER = 11;
+    private static final int DECEMBER = 12;
+
+    // Days of week
+    private static final int SATURDAY = 0;
+    private static final int SUNDAY = 1;
+    private static final int MONDAY = 2;
+    private static final int TUESDAY = 3;
+    private static final int WEDNESDAY = 4;
+    private static final int THURSDAY = 5;
+    private static final int FRIDAY = 6;
+
+    // Constants used to calculate day of week
+    private static final int DIVISION_BY_TWELVE = 12;
+    private static final int DIVISION_BY_FOUR = 4;
+    private static final int DAYS_OF_WEEK = 7;
+    private static final String MONTH_CODES = "144025036146";
+
+    private final int year;
+    private final int month;
+    private final int day;
+
+    /*
+        isLeapYear calculates if a given year is a leap year or not.
+
+        a) A year is a leap year if it is divisible by LEAP_YEAR_MOD_FOUR,
+
+        b) If the year is also divisible by LEAP_YEAR_MOD_ONE_HUNDRED then
+           it is not a leap year.
+
+        c) If the year is divisible by LEAP_YEAR_MOD_ONE_HUNDRED and is
+           divisible by LEAP_YEAR_MOD_FOUR_HUNDRED, then it is a leap year.
+     */
+    private static boolean isLeapYear(final int year) {
+
+        final boolean isLeapYear;
+        final boolean leapYearRuleOne;
+        final boolean leapYearRuleTwo;
+
+        leapYearRuleOne = (year % YEARS_BTWN_LEAP_CENTURIES) == LEAP_YEAR_MOD_RESULT;
+        leapYearRuleTwo = (year % YEARS_BTWN_LEAP_YEARS == LEAP_YEAR_MOD_RESULT && year % YEARS_PER_CENTURY != LEAP_YEAR_MOD_RESULT);
+
+        isLeapYear = leapYearRuleOne || leapYearRuleTwo;
+
+        return isLeapYear;
+    }
+
+    /**
+        daysInMonth calculates the max number of days in a given month.
+
+        If the month is February, we must know if it is a leap year or
+        not, as the numbers of days changes.
+
+        Otherwise, for any other month, we determine if the month comes
+        before August, as every odd month from January to July, has
+        MONTH_MOST_DAYS, and every even month has MONTH_REGULAR_DAYS.
+
+        If the month is after August, then from August to December every
+        odd month hsa MONTH_MOST_DAYS, and every even month has
+        MONTH_REGULAR_DAYS.
+     */
+    private static int daysInMonth(
+            final int month,
+            final boolean isLeapYear
+    ) {
+
+        if (month == FEBRUARY) {
+            if (isLeapYear) {
+                return LEAP_YEAR_DAYS;
+            } else {
+                return NON_LEAP_YEAR_DAYS;
+            }
+        }
+
+        final boolean longMonth;
+
+        if (month <= JULY) {
+            longMonth = (month % EVEN) == IS_DIVISIBLE;
+        } else {
+            longMonth = ((month + GET_NEXT) % EVEN) == IS_DIVISIBLE;
+        }
+
+        if (longMonth) {
+            return MONTH_MOST_DAYS;
+        } else {
+            return MONTH_REGULAR_DAYS;
+        }
+    }
+
+    /*
+        validateYear checks input year is in valid range
+     */
+    public static void validateYear(final int year)
+            throws IllegalArgumentException
+    {
+
+        if (year < MIN_YEAR || year > MAX_YEAR) {
+            throw new IllegalArgumentException("invalid year");
+        }
+    }
+
+    /*
+        validateMonth checks input month is in valid range
+     */
+    public static void validateMonth(final int month)
+            throws IllegalArgumentException
+    {
+
+        if (month < JANUARY || month > DECEMBER) {
+            throw new IllegalArgumentException("invalid month");
+        }
+    }
+
+    /*
+        validateDay ensures the day given is less than the max day
+        calculated by daysInMonth and greater than the MIN_DAY
+     */
+    public static void validateDay(
+            final int day,
+            final int month,
+            final int year
+    )
+            throws IllegalArgumentException
+    {
+
+        final boolean leapYear;
+        final int maxDays;
+
+        leapYear = isLeapYear(year);
+        maxDays = daysInMonth(month, leapYear);
+
+        if (day < MIN_DAY || day > maxDays) {
+            throw new IllegalArgumentException("invalid day");
+        }
+    }
+
+    /**
+     * Date constructor
+     * @param year int
+     * @param month int
+     * @param day int
+     */
+    public Date(
+            final int year,
+            final int month,
+            final int day
+    ) {
+
+        validateYear(year);
+        validateMonth(month);
+        validateDay(day, month, year);
+
+        this.year = year;
+        this.month = month;
+        this.day = day;
+    }
+
+    /**
+     * getYear of Date
+     * @return year
+     */
+    public final int getYear() {
+
+        return this.year;
+    }
+
+    /**
+     * getMonth of Date
+     * @return month
+     */
+    public final String getMonth() {
+
+        final String month;
+
+        if (this.month == JANUARY) {
+            month = "January";
+        } else if (this.month == FEBRUARY) {
+            month = "February";
+        } else if (this.month == MARCH) {
+            month = "March";
+        } else if (this.month == APRIL) {
+            month = "April";
+        } else if (this.month == MAY) {
+            month = "May";
+        } else if (this.month == JUNE) {
+            month = "June";
+        } else if (this.month == JULY) {
+            month = "July";
+        } else if (this.month == AUGUST) {
+            month = "August";
+        } else if (this.month == SEPTEMBER) {
+            month = "September";
+        } else if (this.month == OCTOBER) {
+            month = "October";
+        } else if (this.month == NOVEMBER) {
+            month = "November";
+        } else if (this.month == DECEMBER) {
+            month = "December";
+        } else {
+            throw new IllegalArgumentException("invalid month");
+        }
+
+        return month;
+    }
+
+    /**
+     * getDay of Date
+     * @return day
+     */
+    public final int getDay() {
+
+        return this.day;
+    }
+
+    /**
+     * getYyyyMmDd formatted as string
+     * @return date in YyyyMmDd format
+     */
+    public final String getYyyyMmDd() {
+
+        final String date;
+
+        date = this.year + "-" +  this.month + "-" + this.day;
+
+        return date;
+    }
+
+    /**
+     * getDayOfWeek
+     *
+     * To get the day of the week, do the following seven steps for dates in the 1900s:
+     *
+     * e.g. October 31 1977:
+     * step 1: calculate the number of twelves in 77:
+     * 6
+     * step 2: calculate the remainder from step 1: 77 - 12*6 = 77 - 72 =
+     * 5
+     * step 3: calculate the number of fours in step 2: 5/4 = 1.25, so
+     * 1
+     * step 4: add the day of the month to each step above: 31 + 6 + 5 + 1 =
+     * 43
+     * step 5: add the month code (for jfmamjjasond: 144025036146): for october it is 1: 43 + 1 =
+     * 44
+     * step 6: add the previous five numbers: (44) and mod by 7: 44%7 = 2 (44/7 = 6 remainder 2)
+     * step 7: sat sun mon tue wed thu fri is 0 1 2 3 4 5 6; our 2 means Oct 31 1977 was monday
+     * Extra notes:
+     * a) for January/February dates in leap years, add 6 at the start
+     * b) for all dates in the 2000s, add 6 at the start
+     * c) for all dates in the 1800s, add 2 at the star
+     *
+     * @return day of week
+     */
+    public final String getDayOfWeek() {
+
+        final int year;
+        final int century;
+        final String monthCode;
+
+        final int step0;
+        final int step1;
+        final int step2;
+        final int step3;
+        final int step4;
+        final int step5;
+
+        final int dayIndex;
+        final String day;
+
+        monthCode = MONTH_CODES.charAt(this.month - GET_PREVIOUS) + "";
+
+        if (this.year < YEAR_NINETEEN_HUNDREDS) {
+            century = YEAR_EIGHTEEN_HUNDREDS;
+        } else if (this.year < YEAR_TWO_THOUSANDS) {
+            century = YEAR_NINETEEN_HUNDREDS;
+        } else {
+            century = YEAR_TWO_THOUSANDS;
+        }
+
+        year = this.year - century;
+
+        if (
+                isLeapYear(this.year) &&
+                        (this.month == JANUARY || this.month == FEBRUARY) &&
+                        this.year >= YEAR_TWO_THOUSANDS
+        ) {
+
+            step0 = CENTURY_CODE_AND_MONTH_CODE;
+
+        } else if (
+                isLeapYear(this.year) &&
+                        (this.month == JANUARY || this.month == FEBRUARY)
+        ) {
+            step0 = CENTURY_CODE_YEAR_TWO_THOUSANDS;
+        } else if (this.year >= YEAR_TWO_THOUSANDS) {
+            step0 = CENTURY_CODE_YEAR_TWO_THOUSANDS;
+        } else if (this.year < YEAR_NINETEEN_HUNDREDS) {
+            step0 = CENTURY_CODE_YEAR_EIGHTEEN_HUNDREDS;
+        } else {
+            step0 = 0;
+        }
+
+        step1 = year / DIVISION_BY_TWELVE;
+        step2 = year - (DIVISION_BY_TWELVE * step1);
+        step3 = step2 / DIVISION_BY_FOUR;
+        step4 = this.day + step0 + step1  + step2 + step3;
+        step5 = step4 + Integer.parseInt(monthCode);
+
+        dayIndex = step5 % DAYS_OF_WEEK;
+
+        if (dayIndex == SATURDAY) {
+            day = "Saturday";
+        } else if (dayIndex == SUNDAY) {
+            day = "Sunday";
+        } else if (dayIndex == MONDAY) {
+            day = "Monday";
+        } else if (dayIndex == TUESDAY) {
+            day = "Tuesday";
+        } else if (dayIndex == WEDNESDAY) {
+            day = "Wednesday";
+        } else if (dayIndex == THURSDAY) {
+            day = "Thursday";
+        } else if (dayIndex == FRIDAY) {
+            day = "Friday";
+        } else {
+            throw new IllegalArgumentException("invalid day");
+        }
+
+        return day;
+    }
+
+    @Override
+    public void display() {
+        System.out.println(getYyyyMmDd());
+    }
+}
diff --git a/src/code/ca/bcit/comp2522/lab04/Name.java b/src/code/ca/bcit/comp2522/lab04/Name.java
new file mode 100644
index 0000000..85b4ae0
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Name.java
@@ -0,0 +1,66 @@
+package ca.bcit.comp2522.lab04;
+
+public class Name {
+    private final String first;
+    private final String last;
+
+    private static final int MAX_CHARACTERS = 50;
+
+
+    public Name(final String first, final String last)
+    {
+        stringValidator(first, MAX_CHARACTERS);
+        stringValidator(last,  MAX_CHARACTERS);
+        this.first = first;
+        this.last = last;
+    }
+
+    /**
+     * stringValidator checks the string being passed into it for
+     * being null, blank, empty or over the limit of characters.
+     *
+     * @param stringToCheck passes the string to be checked.
+     * @param maxLength passes the integer value of the number of character count
+     *                  the String can be.
+     * */
+    public void stringValidator(final String stringToCheck,
+                                final int maxLength){
+
+        if (stringToCheck == null)
+        {
+            throw new IllegalArgumentException(
+                    "String cannot be null");
+        }
+
+        if (stringToCheck.isBlank() ||
+                stringToCheck.isEmpty())
+        {
+            throw new IllegalArgumentException(
+                    "String cannot be empty or blank");
+        }
+
+        if (stringToCheck.length() > maxLength)
+        {
+            throw new IllegalArgumentException(
+                    "String longer than " + maxLength +
+                            " characters");
+        }
+    }
+
+    public void stringValidator(final String stringToCheck)
+    {
+
+        if (stringToCheck == null)
+        {
+            throw new IllegalArgumentException(
+                    "String cannot be null");
+        }
+
+        if (stringToCheck.isBlank() ||
+                stringToCheck.isEmpty())
+        {
+            throw new IllegalArgumentException(
+                    "String cannot be empty or blank");
+        }
+    }
+}
diff --git a/src/code/ca/bcit/comp2522/lab04/Person.java b/src/code/ca/bcit/comp2522/lab04/Person.java
new file mode 100644
index 0000000..4179ac4
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Person.java
@@ -0,0 +1,37 @@
+package ca.bcit.comp2522.lab04;
+
+public class Person {
+    private final Date dateOfBirth;
+    private final Date dateOfDeath;
+    private final Name name;
+
+    private final boolean CAN_BE_NULL = true;
+    private final boolean CANT_BE_NULL = false;
+
+    public Person(final Date dateOfBirth,
+                  final Date dateOfDeath,
+                  final Name name)
+    {
+        dateValidator(dateOfBirth, CAN_BE_NULL);
+        dateValidator(dateOfDeath, CANT_BE_NULL);
+
+        this.dateOfBirth = dateOfBirth;
+        this.dateOfDeath = dateOfDeath;
+        this.name = name;
+
+    }
+
+
+    public void dateValidator(final Date dateToBeChecked,
+                              final boolean canBeNull)
+    {
+        if (!canBeNull)
+        {
+         if ( dateToBeChecked == null)
+         {
+             throw new IllegalArgumentException("Date cannot be null");
+         }
+        }
+    }
+
+}
diff --git a/src/code/ca/bcit/comp2522/lab04/Printable.java b/src/code/ca/bcit/comp2522/lab04/Printable.java
new file mode 100644
index 0000000..5e46bbd
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Printable.java
@@ -0,0 +1,5 @@
+package ca.bcit.comp2522.lab04;
+
+public interface Printable {
+    void display();
+}

From e5d7e36fdbea78c00cc3f5269f56948631f15844 Mon Sep 17 00:00:00 2001
From: SowinskiBraeden <braeden@sowinski.dev>
Date: Fri, 3 Oct 2025 20:07:10 -0700
Subject: [PATCH 2/5] clean lab04

---
 .idea/workspace.xml                           |  17 ++-
 src/code/ca/bcit/comp2522/lab04/Date.java     | 101 ++++++++++--------
 src/code/ca/bcit/comp2522/lab04/Name.java     |  75 +++++++------
 src/code/ca/bcit/comp2522/lab04/Person.java   |  61 ++++++-----
 .../ca/bcit/comp2522/lab04/Printable.java     |  14 ++-
 5 files changed, 156 insertions(+), 112 deletions(-)

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index 7a20347..5e0b70e 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -5,12 +5,11 @@
   </component>
   <component name="ChangeListManager">
     <list default="true" id="4481728b-524b-48ee-9d70-e414a15f05bd" name="Changes" comment="">
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IDevice.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IDevice.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IPad.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IPad.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IPhone.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IPhone.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IPhone16.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IPhone16.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IPod.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/IPod.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/Main.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab03/Main.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Date.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Date.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Name.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Name.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Person.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Person.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Printable.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Printable.java" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -45,7 +44,7 @@
     "ModuleVcsDetector.initialDetectionPerformed": "true",
     "RunOnceActivity.ShowReadmeOnStart": "true",
     "RunOnceActivity.git.unshallow": "true",
-    "git-widget-placeholder": "main",
+    "git-widget-placeholder": "braeden/lab04",
     "kotlin-language-version-configured": "true",
     "last_opened_file_path": "/home/flami/Projects/comp2522",
     "node.js.detected.package.eslint": "true",
@@ -88,8 +87,8 @@
   <component name="SharedIndexes">
     <attachedChunks>
       <set>
-        <option value="bundled-jdk-9823dce3aa75-bf35d07a577b-intellij.indexing.shared.core-IU-252.26199.169" />
-        <option value="bundled-js-predefined-d6986cc7102b-9c94529fcfe0-JavaScript-IU-252.26199.169" />
+        <option value="bundled-jdk-9823dce3aa75-bf35d07a577b-intellij.indexing.shared.core-IU-252.26830.84" />
+        <option value="bundled-js-predefined-d6986cc7102b-3aa1da707db6-JavaScript-IU-252.26830.84" />
       </set>
     </attachedChunks>
   </component>
diff --git a/src/code/ca/bcit/comp2522/lab04/Date.java b/src/code/ca/bcit/comp2522/lab04/Date.java
index 317601e..8cbfd91 100644
--- a/src/code/ca/bcit/comp2522/lab04/Date.java
+++ b/src/code/ca/bcit/comp2522/lab04/Date.java
@@ -11,66 +11,68 @@ package ca.bcit.comp2522.lab04;
  * @author Calvin Arifianto
  * @version 1.0.0
  */
-public final class Date implements Printable {
+public final class Date implements Printable
+{
+
     // Domain of dates
     private static final int MIN_YEAR = 1800;
     private static final int MAX_YEAR = 2025;
-    private static final int MIN_DAY = 1;
+    private static final int MIN_DAY  = 1;
 
     // Constants for calculating leap year, and days in given month
-    private static final int YEARS_BTWN_LEAP_YEARS = 4;
-    private static final int YEARS_PER_CENTURY = 100;
+    private static final int YEARS_BTWN_LEAP_YEARS     = 4;
+    private static final int YEARS_PER_CENTURY         = 100;
     private static final int YEARS_BTWN_LEAP_CENTURIES = 400;
-    private static final int LEAP_YEAR_MOD_RESULT = 0;
-    private static final int LEAP_YEAR_DAYS = 29;
-    private static final int NON_LEAP_YEAR_DAYS = 28;
-    private static final int MONTH_MOST_DAYS = 31;
-    private static final int MONTH_REGULAR_DAYS = 30;
-    private static final int EVEN = 2;
-    private static final int IS_DIVISIBLE = 1;
+    private static final int LEAP_YEAR_MOD_RESULT      = 0;
+    private static final int LEAP_YEAR_DAYS            = 29;
+    private static final int NON_LEAP_YEAR_DAYS        = 28;
+    private static final int MONTH_MOST_DAYS           = 31;
+    private static final int MONTH_REGULAR_DAYS        = 30;
+    private static final int EVEN                      = 2;
+    private static final int IS_DIVISIBLE              = 1;
 
     // Constants to get next or last value
-    private static final int GET_NEXT = 1;
+    private static final int GET_NEXT     = 1;
     private static final int GET_PREVIOUS = 1;
 
     // Constants to add to sum for calculating day of week
     private static final int CENTURY_CODE_YEAR_EIGHTEEN_HUNDREDS = 2;
-    private static final int CENTURY_CODE_YEAR_TWO_THOUSANDS = 6;
-    private static final int CENTURY_CODE_AND_MONTH_CODE = 12;
+    private static final int CENTURY_CODE_YEAR_TWO_THOUSANDS     = 6;
+    private static final int CENTURY_CODE_AND_MONTH_CODE         = 12;
 
     // Century definitions
     private static final int YEAR_EIGHTEEN_HUNDREDS = 1800;
     private static final int YEAR_NINETEEN_HUNDREDS = 1900;
-    private static final int YEAR_TWO_THOUSANDS = 2000;
+    private static final int YEAR_TWO_THOUSANDS     = 2000;
 
     // Months
-    private static final int JANUARY = 1;
-    private static final int FEBRUARY = 2;
-    private static final int MARCH = 3;
-    private static final int APRIL = 4;
-    private static final int MAY = 5;
-    private static final int JUNE = 6;
-    private static final int JULY = 7;
-    private static final int AUGUST = 8;
+    private static final int JANUARY   = 1;
+    private static final int FEBRUARY  = 2;
+    private static final int MARCH     = 3;
+    private static final int APRIL     = 4;
+    private static final int MAY       = 5;
+    private static final int JUNE      = 6;
+    private static final int JULY      = 7;
+    private static final int AUGUST    = 8;
     private static final int SEPTEMBER = 9;
-    private static final int OCTOBER = 10;
-    private static final int NOVEMBER = 11;
-    private static final int DECEMBER = 12;
+    private static final int OCTOBER   = 10;
+    private static final int NOVEMBER  = 11;
+    private static final int DECEMBER  = 12;
 
     // Days of week
-    private static final int SATURDAY = 0;
-    private static final int SUNDAY = 1;
-    private static final int MONDAY = 2;
-    private static final int TUESDAY = 3;
+    private static final int SATURDAY  = 0;
+    private static final int SUNDAY    = 1;
+    private static final int MONDAY    = 2;
+    private static final int TUESDAY   = 3;
     private static final int WEDNESDAY = 4;
-    private static final int THURSDAY = 5;
-    private static final int FRIDAY = 6;
+    private static final int THURSDAY  = 5;
+    private static final int FRIDAY    = 6;
 
     // Constants used to calculate day of week
     private static final int DIVISION_BY_TWELVE = 12;
-    private static final int DIVISION_BY_FOUR = 4;
-    private static final int DAYS_OF_WEEK = 7;
-    private static final String MONTH_CODES = "144025036146";
+    private static final int DIVISION_BY_FOUR   = 4;
+    private static final int DAYS_OF_WEEK       = 7;
+    private static final String MONTH_CODES     = "144025036146";
 
     private final int year;
     private final int month;
@@ -87,7 +89,8 @@ public final class Date implements Printable {
         c) If the year is divisible by LEAP_YEAR_MOD_ONE_HUNDRED and is
            divisible by LEAP_YEAR_MOD_FOUR_HUNDRED, then it is a leap year.
      */
-    private static boolean isLeapYear(final int year) {
+    private static boolean isLeapYear(final int year)
+    {
 
         final boolean isLeapYear;
         final boolean leapYearRuleOne;
@@ -120,7 +123,8 @@ public final class Date implements Printable {
             final boolean isLeapYear
     ) {
 
-        if (month == FEBRUARY) {
+        if (month == FEBRUARY)
+        {
             if (isLeapYear) {
                 return LEAP_YEAR_DAYS;
             } else {
@@ -216,7 +220,6 @@ public final class Date implements Printable {
      * @return year
      */
     public final int getYear() {
-
         return this.year;
     }
 
@@ -224,7 +227,8 @@ public final class Date implements Printable {
      * getMonth of Date
      * @return month
      */
-    public final String getMonth() {
+    public final String getMonth()
+    {
 
         final String month;
 
@@ -264,7 +268,6 @@ public final class Date implements Printable {
      * @return day
      */
     public final int getDay() {
-
         return this.day;
     }
 
@@ -272,8 +275,8 @@ public final class Date implements Printable {
      * getYyyyMmDd formatted as string
      * @return date in YyyyMmDd format
      */
-    public final String getYyyyMmDd() {
-
+    public final String getYyyyMmDd()
+    {
         final String date;
 
         date = this.year + "-" +  this.month + "-" + this.day;
@@ -306,7 +309,8 @@ public final class Date implements Printable {
      *
      * @return day of week
      */
-    public final String getDayOfWeek() {
+    public final String getDayOfWeek()
+    {
 
         final int year;
         final int century;
@@ -335,16 +339,16 @@ public final class Date implements Printable {
         year = this.year - century;
 
         if (
-                isLeapYear(this.year) &&
-                        (this.month == JANUARY || this.month == FEBRUARY) &&
-                        this.year >= YEAR_TWO_THOUSANDS
+            isLeapYear(this.year) &&
+            (this.month == JANUARY || this.month == FEBRUARY) &&
+            this.year >= YEAR_TWO_THOUSANDS
         ) {
 
             step0 = CENTURY_CODE_AND_MONTH_CODE;
 
         } else if (
                 isLeapYear(this.year) &&
-                        (this.month == JANUARY || this.month == FEBRUARY)
+                (this.month == JANUARY || this.month == FEBRUARY)
         ) {
             step0 = CENTURY_CODE_YEAR_TWO_THOUSANDS;
         } else if (this.year >= YEAR_TWO_THOUSANDS) {
@@ -384,6 +388,9 @@ public final class Date implements Printable {
         return day;
     }
 
+    /**
+     * display Date to console in yyyy-mm-dd format
+     */
     @Override
     public void display() {
         System.out.println(getYyyyMmDd());
diff --git a/src/code/ca/bcit/comp2522/lab04/Name.java b/src/code/ca/bcit/comp2522/lab04/Name.java
index 85b4ae0..80cf20d 100644
--- a/src/code/ca/bcit/comp2522/lab04/Name.java
+++ b/src/code/ca/bcit/comp2522/lab04/Name.java
@@ -1,20 +1,22 @@
 package ca.bcit.comp2522.lab04;
 
-public class Name {
+/**
+ * Name class holds first and last name,
+ * and validates name lengths
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public class Name implements Printable
+{
     private final String first;
     private final String last;
 
     private static final int MAX_CHARACTERS = 50;
 
-
-    public Name(final String first, final String last)
-    {
-        stringValidator(first, MAX_CHARACTERS);
-        stringValidator(last,  MAX_CHARACTERS);
-        this.first = first;
-        this.last = last;
-    }
-
     /**
      * stringValidator checks the string being passed into it for
      * being null, blank, empty or over the limit of characters.
@@ -23,44 +25,55 @@ public class Name {
      * @param maxLength passes the integer value of the number of character count
      *                  the String can be.
      * */
-    public void stringValidator(final String stringToCheck,
-                                final int maxLength){
+    private static void stringValidator(final String stringToCheck, final int maxLength)
+    {
 
         if (stringToCheck == null)
         {
-            throw new IllegalArgumentException(
-                    "String cannot be null");
+            throw new IllegalArgumentException("String cannot be null");
         }
 
-        if (stringToCheck.isBlank() ||
-                stringToCheck.isEmpty())
+        if (stringToCheck.isEmpty() ||
+            stringToCheck.isBlank())
         {
-            throw new IllegalArgumentException(
-                    "String cannot be empty or blank");
+            throw new IllegalArgumentException("String cannot be empty or blank");
         }
 
         if (stringToCheck.length() > maxLength)
         {
             throw new IllegalArgumentException(
                     "String longer than " + maxLength +
-                            " characters");
+                    " characters"
+            );
         }
     }
 
-    public void stringValidator(final String stringToCheck)
+    /**
+     * stringValidator with default MAX_CHARACTERS restriction
+     * @param stringToCheck passes the string to be checked
+     */
+    private static void stringValidator(final String stringToCheck)
     {
+        stringValidator(stringToCheck, MAX_CHARACTERS);
+    }
 
-        if (stringToCheck == null)
-        {
-            throw new IllegalArgumentException(
-                    "String cannot be null");
-        }
+    /**
+     * Name constructor
+     * @param first name to save
+     * @param last name to save
+     */
+    public Name(final String first, final String last)
+    {
+        stringValidator(first);
+        stringValidator(last);
 
-        if (stringToCheck.isBlank() ||
-                stringToCheck.isEmpty())
-        {
-            throw new IllegalArgumentException(
-                    "String cannot be empty or blank");
-        }
+        this.first = first;
+        this.last = last;
+    }
+
+    @Override
+    public void display()
+    {
+        System.out.println("First: " + first + " Last: " + last);
     }
 }
diff --git a/src/code/ca/bcit/comp2522/lab04/Person.java b/src/code/ca/bcit/comp2522/lab04/Person.java
index 4179ac4..2c92b7e 100644
--- a/src/code/ca/bcit/comp2522/lab04/Person.java
+++ b/src/code/ca/bcit/comp2522/lab04/Person.java
@@ -1,37 +1,50 @@
 package ca.bcit.comp2522.lab04;
 
-public class Person {
+/**
+ * Person contains date of birth, death, and a name.
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public class Person
+{
     private final Date dateOfBirth;
     private final Date dateOfDeath;
     private final Name name;
 
-    private final boolean CAN_BE_NULL = true;
-    private final boolean CANT_BE_NULL = false;
+    /**
+     * validateObject ensures a given object is not null
+     * @param object to ensure is not null
+     * @param objectName variable name of object for log
+     */
+    private static void validateObject(
+            final Object object,
+            final String objectName
+    ) {
+        if (object == null) {
+            throw new IllegalArgumentException(objectName + " cannot be null");
+        }
+    }
 
-    public Person(final Date dateOfBirth,
-                  final Date dateOfDeath,
-                  final Name name)
-    {
-        dateValidator(dateOfBirth, CAN_BE_NULL);
-        dateValidator(dateOfDeath, CANT_BE_NULL);
+    /**
+     * Person construct
+     * @param dateOfBirth of person, cannot be null
+     * @param dateOfDeath of person, can be null
+     * @param name of person
+     */
+    public Person(
+        final Date dateOfBirth,
+        final Date dateOfDeath,
+        final Name name
+    ) {
+        validateObject(dateOfBirth, "date of birth");
+        validateObject(name, "name");
 
         this.dateOfBirth = dateOfBirth;
         this.dateOfDeath = dateOfDeath;
         this.name = name;
-
     }
-
-
-    public void dateValidator(final Date dateToBeChecked,
-                              final boolean canBeNull)
-    {
-        if (!canBeNull)
-        {
-         if ( dateToBeChecked == null)
-         {
-             throw new IllegalArgumentException("Date cannot be null");
-         }
-        }
-    }
-
 }
diff --git a/src/code/ca/bcit/comp2522/lab04/Printable.java b/src/code/ca/bcit/comp2522/lab04/Printable.java
index 5e46bbd..ead6470 100644
--- a/src/code/ca/bcit/comp2522/lab04/Printable.java
+++ b/src/code/ca/bcit/comp2522/lab04/Printable.java
@@ -1,5 +1,17 @@
 package ca.bcit.comp2522.lab04;
 
-public interface Printable {
+/**
+ * Printable classes must print all their instance
+ * variables and the instance variables of their parents
+ * to the console in a sentence.
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public interface Printable
+{
     void display();
 }

From 45d26fdf5e1a019b5e9bbdc9fedaade7ff758a55 Mon Sep 17 00:00:00 2001
From: SowinskiBraeden <braeden@sowinski.dev>
Date: Fri, 3 Oct 2025 20:35:36 -0700
Subject: [PATCH 3/5] create remaining lab04 classes and interfaces

---
 .idea/workspace.xml                           |  4 +-
 src/code/ca/bcit/comp2522/lab04/Author.java   | 37 +++++++++++
 .../ca/bcit/comp2522/lab04/Autobiography.java | 28 +++++++++
 .../ca/bcit/comp2522/lab04/Biography.java     | 35 +++++++++++
 src/code/ca/bcit/comp2522/lab04/Book.java     | 43 +++++++++++++
 src/code/ca/bcit/comp2522/lab04/Name.java     | 46 +-------------
 src/code/ca/bcit/comp2522/lab04/Person.java   | 20 ++----
 .../ca/bcit/comp2522/lab04/Reversible.java    |  9 +++
 .../ca/bcit/comp2522/lab04/Validator.java     | 62 +++++++++++++++++++
 9 files changed, 222 insertions(+), 62 deletions(-)
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Author.java
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Autobiography.java
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Biography.java
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Book.java
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Reversible.java
 create mode 100644 src/code/ca/bcit/comp2522/lab04/Validator.java

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index 5e0b70e..f27ca33 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -5,11 +5,8 @@
   </component>
   <component name="ChangeListManager">
     <list default="true" id="4481728b-524b-48ee-9d70-e414a15f05bd" name="Changes" comment="">
-      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Date.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Date.java" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Name.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Name.java" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Person.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Person.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Printable.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Printable.java" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -20,6 +17,7 @@
     <option name="RECENT_TEMPLATES">
       <list>
         <option value="Exception" />
+        <option value="Interface" />
         <option value="Class" />
       </list>
     </option>
diff --git a/src/code/ca/bcit/comp2522/lab04/Author.java b/src/code/ca/bcit/comp2522/lab04/Author.java
new file mode 100644
index 0000000..87d673d
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Author.java
@@ -0,0 +1,37 @@
+package ca.bcit.comp2522.lab04;
+
+/**
+ * Authors are just a Person but also
+ * have a genre in which they write.
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public class Author extends Person {
+    private static final int MAX_GENRE_LENGTH = 30;
+
+    private final String genre;
+
+    /**
+     * Author constructor
+     * @param name of the author
+     * @param dateOfBirth of the author
+     * @param dateOfDeath of author if they did die (can be null)
+     * @param genre that the author writes in
+     */
+    public Author(
+        final Name name,
+        final Date dateOfBirth,
+        final Date dateOfDeath,
+        final String genre
+    ) {
+        super(dateOfBirth, dateOfDeath, name);
+
+        Validator.validateString(genre, MAX_GENRE_LENGTH);
+
+        this.genre = genre;
+    }
+}
diff --git a/src/code/ca/bcit/comp2522/lab04/Autobiography.java b/src/code/ca/bcit/comp2522/lab04/Autobiography.java
new file mode 100644
index 0000000..7f83566
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Autobiography.java
@@ -0,0 +1,28 @@
+package ca.bcit.comp2522.lab04;
+
+/**
+ * Autobiography is just a Biography about the
+ * author and not another Person.
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public class Autobiography extends Biography
+{
+    /**
+     * Autobiography constructor
+     * @param title of autobiography
+     * @param year published
+     * @param author and subject of autobiography
+     */
+    public Autobiography(
+        final String title,
+        final int    year,
+        final Author author
+    ) {
+        super(title, year, author, author);
+    }
+}
diff --git a/src/code/ca/bcit/comp2522/lab04/Biography.java b/src/code/ca/bcit/comp2522/lab04/Biography.java
new file mode 100644
index 0000000..1d8eab2
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Biography.java
@@ -0,0 +1,35 @@
+package ca.bcit.comp2522.lab04;
+
+/**
+ * Biography is a Book about a Person
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public class Biography extends Book
+{
+    private final Person subject;
+
+    /**
+     * Biography constructor
+     * @param title of Biography
+     * @param year published
+     * @param author of Biography
+     * @param subject that the Biography is about
+     */
+    public Biography(
+        final String title,
+        final int    year,
+        final Author author,
+        final Person subject
+    ) {
+        super(title, year, author);
+
+        Validator.validateObject(subject, "subject");
+
+        this.subject = subject;
+    }
+}
diff --git a/src/code/ca/bcit/comp2522/lab04/Book.java b/src/code/ca/bcit/comp2522/lab04/Book.java
new file mode 100644
index 0000000..203e399
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Book.java
@@ -0,0 +1,43 @@
+package ca.bcit.comp2522.lab04;
+
+// TODO: Implement Comparable, Printable, Reversible
+
+/**
+ * Book has an Author, year, and title
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public class Book
+{
+    private static final int MAX_TITLE_LENGTH = 100;
+    private static final int MIN_YEAR         = 1;
+    private static final int MAX_YEAR         = 2025;
+
+    private final String title;
+    private final int    year;
+    private final Author author;
+
+    /**
+     * Book constructor
+     * @param title of the book
+     * @param year the book was published
+     * @param author of the book
+     */
+    public Book(
+        final String title,
+        final int    year,
+        final Author author
+    ) {
+        Validator.validateString(title, MAX_TITLE_LENGTH);
+        Validator.validateObject(author, "author");
+        Validator.validateInteger(year, MIN_YEAR, MAX_YEAR);
+
+        this.title = title;
+        this.year = year;
+        this.author = author;
+    }
+}
diff --git a/src/code/ca/bcit/comp2522/lab04/Name.java b/src/code/ca/bcit/comp2522/lab04/Name.java
index 80cf20d..cef4d71 100644
--- a/src/code/ca/bcit/comp2522/lab04/Name.java
+++ b/src/code/ca/bcit/comp2522/lab04/Name.java
@@ -15,47 +15,7 @@ public class Name implements Printable
     private final String first;
     private final String last;
 
-    private static final int MAX_CHARACTERS = 50;
-
-    /**
-     * stringValidator checks the string being passed into it for
-     * being null, blank, empty or over the limit of characters.
-     *
-     * @param stringToCheck passes the string to be checked.
-     * @param maxLength passes the integer value of the number of character count
-     *                  the String can be.
-     * */
-    private static void stringValidator(final String stringToCheck, final int maxLength)
-    {
-
-        if (stringToCheck == null)
-        {
-            throw new IllegalArgumentException("String cannot be null");
-        }
-
-        if (stringToCheck.isEmpty() ||
-            stringToCheck.isBlank())
-        {
-            throw new IllegalArgumentException("String cannot be empty or blank");
-        }
-
-        if (stringToCheck.length() > maxLength)
-        {
-            throw new IllegalArgumentException(
-                    "String longer than " + maxLength +
-                    " characters"
-            );
-        }
-    }
-
-    /**
-     * stringValidator with default MAX_CHARACTERS restriction
-     * @param stringToCheck passes the string to be checked
-     */
-    private static void stringValidator(final String stringToCheck)
-    {
-        stringValidator(stringToCheck, MAX_CHARACTERS);
-    }
+    private static final int MAX_NAME_CHARACTERS = 50;
 
     /**
      * Name constructor
@@ -64,8 +24,8 @@ public class Name implements Printable
      */
     public Name(final String first, final String last)
     {
-        stringValidator(first);
-        stringValidator(last);
+        Validator.validateString(first, MAX_NAME_CHARACTERS);
+        Validator.validateString(last, MAX_NAME_CHARACTERS);
 
         this.first = first;
         this.last = last;
diff --git a/src/code/ca/bcit/comp2522/lab04/Person.java b/src/code/ca/bcit/comp2522/lab04/Person.java
index 2c92b7e..1595b14 100644
--- a/src/code/ca/bcit/comp2522/lab04/Person.java
+++ b/src/code/ca/bcit/comp2522/lab04/Person.java
@@ -1,5 +1,7 @@
 package ca.bcit.comp2522.lab04;
 
+// TODO: implement Comparable, Printable, Reversible
+
 /**
  * Person contains date of birth, death, and a name.
  *
@@ -15,20 +17,6 @@ public class Person
     private final Date dateOfDeath;
     private final Name name;
 
-    /**
-     * validateObject ensures a given object is not null
-     * @param object to ensure is not null
-     * @param objectName variable name of object for log
-     */
-    private static void validateObject(
-            final Object object,
-            final String objectName
-    ) {
-        if (object == null) {
-            throw new IllegalArgumentException(objectName + " cannot be null");
-        }
-    }
-
     /**
      * Person construct
      * @param dateOfBirth of person, cannot be null
@@ -40,8 +28,8 @@ public class Person
         final Date dateOfDeath,
         final Name name
     ) {
-        validateObject(dateOfBirth, "date of birth");
-        validateObject(name, "name");
+        Validator.validateObject(dateOfBirth, "date of birth");
+        Validator.validateObject(name, "name");
 
         this.dateOfBirth = dateOfBirth;
         this.dateOfDeath = dateOfDeath;
diff --git a/src/code/ca/bcit/comp2522/lab04/Reversible.java b/src/code/ca/bcit/comp2522/lab04/Reversible.java
new file mode 100644
index 0000000..85749f2
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Reversible.java
@@ -0,0 +1,9 @@
+package ca.bcit.comp2522.lab04;
+
+/**
+ * Reversible classes must print their name/title
+ * backwards.
+ */
+public interface Reversible {
+    void backward();
+}
diff --git a/src/code/ca/bcit/comp2522/lab04/Validator.java b/src/code/ca/bcit/comp2522/lab04/Validator.java
new file mode 100644
index 0000000..b4f762c
--- /dev/null
+++ b/src/code/ca/bcit/comp2522/lab04/Validator.java
@@ -0,0 +1,62 @@
+package ca.bcit.comp2522.lab04;
+
+/**
+ * Validator provides useful validation methods
+ * that many classes can use.
+ *
+ * @author Braeden Sowinski
+ * @author Nico Agostini
+ * @author Trishaan Shetty
+ * @author Calvin Arifianto
+ * @version 1.0.0
+ */
+public final class Validator
+{
+
+    /**
+     * validateString ensures a string is not empty, blank,
+     * null or greater than maxLength
+     * @param string to validate
+     * @param maxLength that string can be
+     */
+    public static void validateString(final String string, final int maxLength) {
+        if (string == null || string.isEmpty()) {
+            throw new IllegalArgumentException("string cannot be null or empty");
+        }
+
+        if (string.length() > maxLength) {
+            throw new IllegalArgumentException("string cannot be longer than " + maxLength);
+        }
+    }
+
+    /**
+     * validateObject ensures a given object is not null
+     * @param object to ensure is not null
+     * @param objectName variable name of object for log
+     */
+    public static void validateObject(
+            final Object object,
+            final String objectName
+    ) {
+        if (object == null) {
+            throw new IllegalArgumentException(objectName + " cannot be null");
+        }
+    }
+
+    /**
+     * validateInteger ensures a given number is within
+     * the correct provided range
+     * @param number to validate
+     * @param min of range inclusive
+     * @param max of range inclusive
+     */
+    public static void validateInteger(
+        final int number,
+        final int min,
+        final int max
+    ) {
+        if (number < min || number > max) {
+            throw new IllegalArgumentException(number + " is out of range" + min + " to " + max);
+        }
+    }
+}

From fcb30601541717ac77db3845fd4660c17deec14d Mon Sep 17 00:00:00 2001
From: Braeden Sowinski <braeden@sowinski.dev>
Date: Fri, 3 Oct 2025 20:40:18 -0700
Subject: [PATCH 4/5] Delete .idea/workspace.xml

---
 .idea/workspace.xml | 122 --------------------------------------------
 1 file changed, 122 deletions(-)
 delete mode 100644 .idea/workspace.xml

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
deleted file mode 100644
index f27ca33..0000000
--- a/.idea/workspace.xml
+++ /dev/null
@@ -1,122 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AutoImportSettings">
-    <option name="autoReloadType" value="SELECTIVE" />
-  </component>
-  <component name="ChangeListManager">
-    <list default="true" id="4481728b-524b-48ee-9d70-e414a15f05bd" name="Changes" comment="">
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Name.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Name.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Person.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Person.java" afterDir="false" />
-    </list>
-    <option name="SHOW_DIALOG" value="false" />
-    <option name="HIGHLIGHT_CONFLICTS" value="true" />
-    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
-    <option name="LAST_RESOLUTION" value="IGNORE" />
-  </component>
-  <component name="FileTemplateManagerImpl">
-    <option name="RECENT_TEMPLATES">
-      <list>
-        <option value="Exception" />
-        <option value="Interface" />
-        <option value="Class" />
-      </list>
-    </option>
-  </component>
-  <component name="Git.Settings">
-    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
-  </component>
-  <component name="ProjectColorInfo">{
-  &quot;associatedIndex&quot;: 1
-}</component>
-  <component name="ProjectId" id="32FqHctBhV1BOJd5cgky1d5ERVo" />
-  <component name="ProjectLevelVcsManager">
-    <ConfirmationsSetting value="1" id="Add" />
-  </component>
-  <component name="ProjectViewState">
-    <option name="hideEmptyMiddlePackages" value="true" />
-    <option name="showLibraryContents" value="true" />
-  </component>
-  <component name="PropertiesComponent"><![CDATA[{
-  "keyToString": {
-    "Application.Main.executor": "Run",
-    "ModuleVcsDetector.initialDetectionPerformed": "true",
-    "RunOnceActivity.ShowReadmeOnStart": "true",
-    "RunOnceActivity.git.unshallow": "true",
-    "git-widget-placeholder": "braeden/lab04",
-    "kotlin-language-version-configured": "true",
-    "last_opened_file_path": "/home/flami/Projects/comp2522",
-    "node.js.detected.package.eslint": "true",
-    "node.js.detected.package.tslint": "true",
-    "node.js.selected.package.eslint": "(autodetect)",
-    "node.js.selected.package.tslint": "(autodetect)",
-    "nodejs_package_manager_path": "npm",
-    "project.structure.last.edited": "Project",
-    "project.structure.proportion": "0.15",
-    "project.structure.side.proportion": "0.2",
-    "settings.editor.selected.configurable": "preferences.lookFeel",
-    "vue.rearranger.settings.migration": "true"
-  }
-}]]></component>
-  <component name="RecentsManager">
-    <key name="CopyClassDialog.RECENTS_KEY">
-      <recent name="ca.bcit.comp2522.lab02" />
-    </key>
-  </component>
-  <component name="RunManager">
-    <configuration name="Main" type="Application" factoryName="Application" temporary="true" nameIsGenerated="true">
-      <option name="MAIN_CLASS_NAME" value="ca.bcit.comp2522.lab03.Main" />
-      <module name="comp2522" />
-      <extension name="coverage">
-        <pattern>
-          <option name="PATTERN" value="ca.bcit.comp2522.lab03.*" />
-          <option name="ENABLED" value="true" />
-        </pattern>
-      </extension>
-      <method v="2">
-        <option name="Make" enabled="true" />
-      </method>
-    </configuration>
-    <recent_temporary>
-      <list>
-        <item itemvalue="Application.Main" />
-      </list>
-    </recent_temporary>
-  </component>
-  <component name="SharedIndexes">
-    <attachedChunks>
-      <set>
-        <option value="bundled-jdk-9823dce3aa75-bf35d07a577b-intellij.indexing.shared.core-IU-252.26830.84" />
-        <option value="bundled-js-predefined-d6986cc7102b-3aa1da707db6-JavaScript-IU-252.26830.84" />
-      </set>
-    </attachedChunks>
-  </component>
-  <component name="TaskManager">
-    <task active="true" id="Default" summary="Default task">
-      <changelist id="4481728b-524b-48ee-9d70-e414a15f05bd" name="Changes" comment="" />
-      <created>1757026582895</created>
-      <option name="number" value="Default" />
-      <option name="presentableId" value="Default" />
-      <updated>1757026582895</updated>
-      <workItem from="1757978409399" duration="133000" />
-      <workItem from="1757978555342" duration="50000" />
-      <workItem from="1757978628819" duration="106000" />
-      <workItem from="1757978741081" duration="333000" />
-      <workItem from="1757986074841" duration="318000" />
-      <workItem from="1758045661655" duration="660000" />
-      <workItem from="1758156443615" duration="6374000" />
-      <workItem from="1758221692281" duration="40000" />
-      <workItem from="1758221863793" duration="810000" />
-      <workItem from="1758254368145" duration="997000" />
-      <workItem from="1758294307794" duration="4368000" />
-      <workItem from="1758342126924" duration="1015000" />
-      <workItem from="1758413771974" duration="332000" />
-      <workItem from="1758425336799" duration="21000" />
-      <workItem from="1758473282464" duration="4563000" />
-      <workItem from="1758570032207" duration="3338000" />
-    </task>
-    <servers />
-  </component>
-  <component name="TypeScriptGeneratedFilesManager">
-    <option name="version" value="3" />
-  </component>
-</project>
\ No newline at end of file

From f543545df1924754ee96fee681bb08d8166b25d0 Mon Sep 17 00:00:00 2001
From: SowinskiBraeden <braeden@sowinski.dev>
Date: Fri, 3 Oct 2025 20:41:48 -0700
Subject: [PATCH 5/5] delete .idea/*

---
 .idea/kotlinc.xml                     |   6 --
 .idea/libraries/KotlinJavaRuntime.xml |   8 --
 .idea/material_theme_project_new.xml  |  12 ---
 .idea/misc.xml                        |   6 --
 .idea/modules.xml                     |   8 --
 .idea/vcs.xml                         |   6 --
 .idea/workspace.xml                   | 122 --------------------------
 7 files changed, 168 deletions(-)
 delete mode 100644 .idea/kotlinc.xml
 delete mode 100644 .idea/libraries/KotlinJavaRuntime.xml
 delete mode 100644 .idea/material_theme_project_new.xml
 delete mode 100644 .idea/misc.xml
 delete mode 100644 .idea/modules.xml
 delete mode 100644 .idea/vcs.xml
 delete mode 100644 .idea/workspace.xml

diff --git a/.idea/kotlinc.xml b/.idea/kotlinc.xml
deleted file mode 100644
index 0dd4b35..0000000
--- a/.idea/kotlinc.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Kotlin2JvmCompilerArguments">
-    <option name="jvmTarget" value="1.8" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/libraries/KotlinJavaRuntime.xml b/.idea/libraries/KotlinJavaRuntime.xml
deleted file mode 100644
index b37539c..0000000
--- a/.idea/libraries/KotlinJavaRuntime.xml
+++ /dev/null
@@ -1,8 +0,0 @@
-<component name="libraryTable">
-  <library name="KotlinJavaRuntime" type="repository">
-    <properties maven-id="org.jetbrains.kotlin:kotlin-stdlib-jdk8:2.1.21" />
-    <CLASSES />
-    <JAVADOC />
-    <SOURCES />
-  </library>
-</component>
\ No newline at end of file
diff --git a/.idea/material_theme_project_new.xml b/.idea/material_theme_project_new.xml
deleted file mode 100644
index 1e3ab51..0000000
--- a/.idea/material_theme_project_new.xml
+++ /dev/null
@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="MaterialThemeProjectNewConfig">
-    <option name="metadata">
-      <MTProjectMetadataState>
-        <option name="migrated" value="true" />
-        <option name="pristineConfig" value="false" />
-        <option name="userId" value="335bdae2:1992ba776c5:-7ffe" />
-      </MTProjectMetadataState>
-    </option>
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/misc.xml b/.idea/misc.xml
deleted file mode 100644
index 428d324..0000000
--- a/.idea/misc.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_24" project-jdk-name="24" project-jdk-type="JavaSDK">
-    <output url="file://$PROJECT_DIR$/out" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/modules.xml b/.idea/modules.xml
deleted file mode 100644
index e0c250b..0000000
--- a/.idea/modules.xml
+++ /dev/null
@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/comp2522.iml" filepath="$PROJECT_DIR$/comp2522.iml" />
-    </modules>
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
deleted file mode 100644
index 94a25f7..0000000
--- a/.idea/vcs.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>
\ No newline at end of file
diff --git a/.idea/workspace.xml b/.idea/workspace.xml
deleted file mode 100644
index f27ca33..0000000
--- a/.idea/workspace.xml
+++ /dev/null
@@ -1,122 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AutoImportSettings">
-    <option name="autoReloadType" value="SELECTIVE" />
-  </component>
-  <component name="ChangeListManager">
-    <list default="true" id="4481728b-524b-48ee-9d70-e414a15f05bd" name="Changes" comment="">
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Name.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Name.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Person.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/code/ca/bcit/comp2522/lab04/Person.java" afterDir="false" />
-    </list>
-    <option name="SHOW_DIALOG" value="false" />
-    <option name="HIGHLIGHT_CONFLICTS" value="true" />
-    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
-    <option name="LAST_RESOLUTION" value="IGNORE" />
-  </component>
-  <component name="FileTemplateManagerImpl">
-    <option name="RECENT_TEMPLATES">
-      <list>
-        <option value="Exception" />
-        <option value="Interface" />
-        <option value="Class" />
-      </list>
-    </option>
-  </component>
-  <component name="Git.Settings">
-    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
-  </component>
-  <component name="ProjectColorInfo">{
-  &quot;associatedIndex&quot;: 1
-}</component>
-  <component name="ProjectId" id="32FqHctBhV1BOJd5cgky1d5ERVo" />
-  <component name="ProjectLevelVcsManager">
-    <ConfirmationsSetting value="1" id="Add" />
-  </component>
-  <component name="ProjectViewState">
-    <option name="hideEmptyMiddlePackages" value="true" />
-    <option name="showLibraryContents" value="true" />
-  </component>
-  <component name="PropertiesComponent"><![CDATA[{
-  "keyToString": {
-    "Application.Main.executor": "Run",
-    "ModuleVcsDetector.initialDetectionPerformed": "true",
-    "RunOnceActivity.ShowReadmeOnStart": "true",
-    "RunOnceActivity.git.unshallow": "true",
-    "git-widget-placeholder": "braeden/lab04",
-    "kotlin-language-version-configured": "true",
-    "last_opened_file_path": "/home/flami/Projects/comp2522",
-    "node.js.detected.package.eslint": "true",
-    "node.js.detected.package.tslint": "true",
-    "node.js.selected.package.eslint": "(autodetect)",
-    "node.js.selected.package.tslint": "(autodetect)",
-    "nodejs_package_manager_path": "npm",
-    "project.structure.last.edited": "Project",
-    "project.structure.proportion": "0.15",
-    "project.structure.side.proportion": "0.2",
-    "settings.editor.selected.configurable": "preferences.lookFeel",
-    "vue.rearranger.settings.migration": "true"
-  }
-}]]></component>
-  <component name="RecentsManager">
-    <key name="CopyClassDialog.RECENTS_KEY">
-      <recent name="ca.bcit.comp2522.lab02" />
-    </key>
-  </component>
-  <component name="RunManager">
-    <configuration name="Main" type="Application" factoryName="Application" temporary="true" nameIsGenerated="true">
-      <option name="MAIN_CLASS_NAME" value="ca.bcit.comp2522.lab03.Main" />
-      <module name="comp2522" />
-      <extension name="coverage">
-        <pattern>
-          <option name="PATTERN" value="ca.bcit.comp2522.lab03.*" />
-          <option name="ENABLED" value="true" />
-        </pattern>
-      </extension>
-      <method v="2">
-        <option name="Make" enabled="true" />
-      </method>
-    </configuration>
-    <recent_temporary>
-      <list>
-        <item itemvalue="Application.Main" />
-      </list>
-    </recent_temporary>
-  </component>
-  <component name="SharedIndexes">
-    <attachedChunks>
-      <set>
-        <option value="bundled-jdk-9823dce3aa75-bf35d07a577b-intellij.indexing.shared.core-IU-252.26830.84" />
-        <option value="bundled-js-predefined-d6986cc7102b-3aa1da707db6-JavaScript-IU-252.26830.84" />
-      </set>
-    </attachedChunks>
-  </component>
-  <component name="TaskManager">
-    <task active="true" id="Default" summary="Default task">
-      <changelist id="4481728b-524b-48ee-9d70-e414a15f05bd" name="Changes" comment="" />
-      <created>1757026582895</created>
-      <option name="number" value="Default" />
-      <option name="presentableId" value="Default" />
-      <updated>1757026582895</updated>
-      <workItem from="1757978409399" duration="133000" />
-      <workItem from="1757978555342" duration="50000" />
-      <workItem from="1757978628819" duration="106000" />
-      <workItem from="1757978741081" duration="333000" />
-      <workItem from="1757986074841" duration="318000" />
-      <workItem from="1758045661655" duration="660000" />
-      <workItem from="1758156443615" duration="6374000" />
-      <workItem from="1758221692281" duration="40000" />
-      <workItem from="1758221863793" duration="810000" />
-      <workItem from="1758254368145" duration="997000" />
-      <workItem from="1758294307794" duration="4368000" />
-      <workItem from="1758342126924" duration="1015000" />
-      <workItem from="1758413771974" duration="332000" />
-      <workItem from="1758425336799" duration="21000" />
-      <workItem from="1758473282464" duration="4563000" />
-      <workItem from="1758570032207" duration="3338000" />
-    </task>
-    <servers />
-  </component>
-  <component name="TypeScriptGeneratedFilesManager">
-    <option name="version" value="3" />
-  </component>
-</project>
\ No newline at end of file