feat: aoc 2025 day 2 solution + tests

Author: Mallory Brickerd

_2025/solutions/day02.py

@@ -0,0 +1,85 @@
+"""Boilerplate solution template for Advent of Code daily challenges.
+
+This module provides a template class for solving Advent of Code puzzle problems.
+It includes a base structure with two method stubs (part1 and part2) that can be
+implemented for specific day's challenges.
+
+The template follows the SolutionBase pattern used across the Advent of Code solutions,
+allowing for consistent handling of input parsing and solution execution.
+"""
+
+from functools import partial
+from typing import Callable
+
+from aoc.models.base import SolutionBase
+
+
+class Solution(SolutionBase):
+    """Solution template for Advent of Code daily puzzle.
+
+    This class provides a standardized structure for implementing solutions to
+    daily Advent of Code challenges. It inherits from SolutionBase and includes
+    method stubs for part1 and part2 of the puzzle.
+
+    Subclasses should override these methods with specific implementation logic
+    for parsing input and solving the puzzle requirements.
+    """
+
+    def has_repeated_sequence(self, n: int, num_repeats: int = None) -> bool:
+        s = str(n)
+        length = len(s)
+
+        if num_repeats:
+            if num_repeats <= 1:
+                return False
+
+            if length % num_repeats != 0:
+                return False
+
+            size = length // num_repeats
+            return s == s[:size] * num_repeats
+
+        else:  # Check for any number of repetitions > 1
+            for k in range(2, length + 1):
+                if length % k == 0:
+                    size = length // k
+                    if s == s[:size] * k:
+                        return True
+
+            return False
+
+    def solve_part(self, data: list[str], func: Callable) -> int:
+        """Calculates the sum of numbers in ranges that satisfy the check_func."""
+        invalid = 0
+        for line in data[0].split(","):
+            start, end = map(int, line.split("-"))
+            for product in range(start, end + 1):
+                if func(product):
+                    invalid += product
+
+        return invalid
+
+    def part1(self, data: list[str]) -> int:
+        """Solve the first part of the daily puzzle.
+
+        Args:
+            data: List of input strings to be processed
+
+        Returns
+        -------
+            int: Solution for part 1 of the puzzle
+        """
+        check_for_two_repeats = partial(self.has_repeated_sequence, num_repeats=2)
+        return self.solve_part(data, check_for_two_repeats)
+
+    def part2(self, data: list[str]) -> int:
+        """Solve the second part of the daily puzzle.
+
+        Args:
+            data: List of input strings to be processed
+
+        Returns
+        -------
+            int: Solution for part 2 of the puzzle
+        """
+        return self.solve_part(data, self.has_repeated_sequence)

_2025/tests/data/day02/test_01_input.txt

@@ -0,0 +1 @@
+11-22,95-115,998-1012,1188511880-1188511890,222220-222224,1698522-1698528,446443-446449,38593856-38593862,565653-565659,824824821-824824827,2121212118-2121212124

_2025/tests/data/day02/test_02_input.txt

@@ -0,0 +1 @@
+11-22,95-115,998-1012,1188511880-1188511890,222220-222224,1698522-1698528,446443-446449,38593856-38593862,565653-565659,824824821-824824827,2121212118-2121212124

_2025/tests/test_02.py

@@ -0,0 +1,39 @@
+"""Test suite for Advent of Code daily challenge solution.
+
+This module contains the test cases for the solution to the Advent of Code
+daily puzzle. It uses the TestSolutionUtility to run tests for both parts
+of the challenge.
+
+The template provides a structure for defining tests for a specific day's
+solution, ensuring that the implementation meets the expected outputs for
+given test inputs.
+"""
+from aoc.models.tester import TestSolutionUtility
+
+def test_day02_part1() -> None:
+    """Test the solution for Part 1 of the daily puzzle.
+
+    This test runs the solution for Part 1 of the puzzle against the
+    provided test input and compares the result with the expected output.
+    """
+    TestSolutionUtility.run_test(
+        year=2025,
+        day=2,
+        is_raw=False,
+        part_num=1,
+        expected=1227775554,
+    )
+
+def test_day02_part2() -> None:
+    """Test the solution for Part 2 of the daily puzzle.
+
+    This test runs the solution for Part 2 of the puzzle against the
+    provided test input and compares the result with the expected output.
+    """
+    TestSolutionUtility.run_test(
+        year=2025,
+        day=2,
+        is_raw=False,
+        part_num=2,
+        expected=4174379265,
+    )