fix: 2023 tests

Author: mbrickerd

_2023/tests/data/day10/test_01_input.txt

@@ -1,5 +1,5 @@
 .....
-.F-7.
+.S-7.
 .|.|.
 .L-J.
 .....

_2023/tests/data/day10/test_02_input.txt

@@ -1,10 +1,10 @@
-.F----7F7F7F7F-7....
-.|F--7||||||||FJ....
-.||.FJ||||||||L7....
-FJL7L7LJLJ||LJ.L-7..
-L--J.L7...LJS7F-7L7.
-....F-J..F7FJ|L7L7L7
-....L7.F7||L7|.L7L7|
-.....|FJLJ|FJ|F7|.LJ
-....FJL-7.||.||||...
-....L---J.LJ.LJLJ...
+FF7FSF7F7F7F7F7F---7
+L|LJ||||||||||||F--J
+FL-7LJLJ||||||LJL-77
+F--JF--7||LJLJ7F7FJ-
+L---JF-JLJ.||-FJLJJ7
+|F|F-JF---7F7-L7L|7|
+|FFJF7L7F-JF7|JL---7
+7-L-JL7||F7|L7F-7F7|
+L.L7LFJ|||||FJL7||LJ
+L7JLJL-JLJLJL--JLJ.L

_2023/tests/test_02.py

@@ -1,4 +1,4 @@
-"""Test suite for Day 2: Cube Conundrum.
+"""Test suite for Day 2: Cube Conundrum
 
 This module contains tests for the Day 2 solution, which handles analysis of
 cube games where colored cubes are drawn from a bag. The tests verify:

_2023/tests/test_03.py

@@ -1,10 +1,10 @@
-"""Test suite for Day 3: Gear Ratios.
+"""Test suite for Day 3: Gear Ratios
 
-This module contains tests for the Day 3 solution, which analyzes engine 
+This module contains tests for the Day 3 solution, which analyzes engine
 schematics for valid part numbers and gear ratios. The tests verify:
 
 1. Part 1: Identification and summing of valid part numbers adjacent to symbols
-2. Part 2: Calculation of gear ratios from '*' symbols adjacent to exactly 
+2. Part 2: Calculation of gear ratios from '*' symbols adjacent to exactly
     two numbers
 """
 
@@ -14,7 +14,7 @@
 def test_day03_part1() -> None:
     """Test summing valid part numbers in the schematic.
 
-    Verifies that the solution correctly finds part numbers adjacent 
+    Verifies that the solution correctly finds part numbers adjacent
     to any symbol and sums all valid part numbers.
     """
     TestSolutionUtility.run_test(
@@ -25,10 +25,11 @@ def test_day03_part1() -> None:
         expected=4361,
     )
 
+
 def test_day03_part2() -> None:
     """Test calculation of gear ratios in the schematic.
 
-    Verifies that the solution finds '*' symbols adjacent to exactly two part 
+    Verifies that the solution finds '*' symbols adjacent to exactly two part
     numbers and sums their gear ratios.
     """
     TestSolutionUtility.run_test(

_2023/tests/test_04.py

@@ -1,4 +1,4 @@
-"""Test suite for Day 4: Scratchcards.
+"""Test suite for Day 4: Scratchcards
 
 This module contains tests for the Day 4 solution, which processes scratchcards by matching
 winning and owned numbers to score points and track card copies. The tests verify:
@@ -24,6 +24,7 @@ def test_day04_part1() -> None:
         expected=13,
     )
 
+
 def test_day04_part2() -> None:
     """Test calculating total scratchcards won through copying.
 

_2023/tests/test_05.py

@@ -1,7 +1,21 @@
+"""Test suite for Day 5: If You Give A Seed A Fertilizer
+
+This module contains tests for the Day 5 solution, which maps seeds through multiple conversion
+stages to find the lowest location number. The tests verify:
+
+1. Part 1: Processing individual seed numbers through all mapping stages
+2. Part 2: Processing seed number ranges to find the lowest location
+"""
+
 from aoc.models.tester import TestSolutionUtility
 
 
-def test_day05_part1():
+def test_day05_part1() -> None:
+    """Test finding the lowest location for individual seed numbers.
+
+    Verifies that the solution correctly maps each seed through all conversion stages (soil,
+    fertilizer, water, light, temperature, humidity, location) and finds the minimum location.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=5,
@@ -11,7 +25,12 @@ def test_day05_part1():
     )
 
 
-def test_day05_part2():
+def test_day05_part2() -> None:
+    """Test finding the lowest location for seed number ranges.
+
+    Verifies that the solution correctly interprets seed numbers as range pairs (start, length)
+    and finds the minimum location across all seeds in all ranges.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=5,

_2023/tests/test_06.py

@@ -1,7 +1,21 @@
+"""Test suite for Day 6: Wait For It
+
+This module contains tests for the Day 6 solution, which calculates winning strategies for toy
+boat races based on button hold duration. The tests verify:
+
+1. Part 1: Product of winning ways across multiple separate races
+2. Part 2: Number of winning ways for a single race with concatenated values
+"""
+
 from aoc.models.tester import TestSolutionUtility
 
 
-def test_day06_part1():
+def test_day06_part1() -> None:
+    """Test calculating the product of winning ways for multiple races.
+
+    Verifies that the solution counts winning hold durations for each race and multiplies them
+    together, where boat speed equals hold time and distance equals speed times remaining time.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=6,
@@ -11,7 +25,12 @@ def test_day06_part1():
     )
 
 
-def test_day06_part2():
+def test_day06_part2() -> None:
+    """Test calculating winning ways for a single concatenated race.
+
+    Verifies that the solution joins all time and distance digits into single values and counts
+    the number of button hold durations that beat the record distance.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=6,

_2023/tests/test_07.py

@@ -1,7 +1,21 @@
+"""Test suite for Day 7: Camel Cards
+
+This module contains tests for the Day 7 solution, which ranks and scores poker-like hands to
+calculate total winnings. The tests verify:
+
+1. Part 1: Ranking hands using standard poker hand types and card values
+2. Part 2: Ranking hands with 'J' cards acting as jokers for strongest hand formation
+"""
+
 from aoc.models.tester import TestSolutionUtility
 
 
-def test_day07_part1():
+def test_day07_part1() -> None:
+    """Test calculating total winnings using standard poker rankings.
+
+    Verifies that the solution correctly ranks hands by type and card values, then calculates
+    total winnings as the sum of rank times bid for each hand.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=7,
@@ -11,7 +25,12 @@ def test_day07_part1():
     )
 
 
-def test_day07_part2():
+def test_day07_part2() -> None:
+    """Test calculating total winnings with joker rules enabled.
+
+    Verifies that the solution treats 'J' cards as jokers that strengthen hand types while
+    being weakest for tiebreaking, then calculates total winnings.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=7,

_2023/tests/test_08.py

@@ -1,7 +1,21 @@
+"""Test suite for Day 8: Haunted Wasteland
+
+This module contains tests for the Day 8 solution, which navigates a network of nodes using
+left/right instructions to reach destination nodes. The tests verify:
+
+1. Part 1: Finding the number of steps from 'AAA' to 'ZZZ' following instructions
+2. Part 2: Finding steps for multiple simultaneous paths using LCM of cycle lengths
+"""
+
 from aoc.models.tester import TestSolutionUtility
 
 
-def test_day08_part1():
+def test_day08_part1() -> None:
+    """Test navigating from 'AAA' to 'ZZZ' through the network.
+
+    Verifies that the solution correctly follows left/right instructions through the node network
+    and counts the number of steps required to reach the destination node 'ZZZ'.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=8,
@@ -11,7 +25,12 @@ def test_day08_part1():
     )
 
 
-def test_day08_part2():
+def test_day08_part2() -> None:
+    """Test simultaneous navigation for multiple starting positions.
+
+    Verifies that the solution finds cycle lengths for all paths starting at nodes ending in 'A'
+    and calculates the LCM to determine when all paths reach nodes ending in 'Z' simultaneously.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=8,

_2023/tests/test_09.py

@@ -1,7 +1,21 @@
+"""Test suite for Day 9: Mirage Maintenance
+
+This module contains tests for the Day 9 solution, which extrapolates sequences by computing
+successive differences until reaching all zeros. The tests verify:
+
+1. Part 1: Extrapolating the next value forward for each sequence
+2. Part 2: Extrapolating the previous value backward for each sequence
+"""
+
 from aoc.models.tester import TestSolutionUtility
 
 
-def test_day09_part1():
+def test_day09_part1() -> None:
+    """Test forward extrapolation of sequence values.
+
+    Verifies that the solution computes difference rows until all zeros, then extrapolates the
+    next value by summing the last values of each row.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=9,
@@ -11,7 +25,12 @@ def test_day09_part1():
     )
 
 
-def test_day09_part2():
+def test_day09_part2() -> None:
+    """Test backward extrapolation of sequence values.
+
+    Verifies that the solution extrapolates the previous value by working backwards through
+    difference rows and prepending calculated values to find the first element.
+    """
     TestSolutionUtility.run_test(
         year=2023,
         day=9,