Initial

advent/days/day__/solution.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from typing import Iterator
+
+day_num = 0
+
+
+def part1(lines: Iterator[str]) -> None:
+    return None
+
+
+def part2(lines: Iterator[str]) -> None:
+    return None

advent/days/day__/test_solution.py

@@ -0,0 +1,17 @@
+from advent.common import utils
+
+from .solution import day_num, part1, part2
+
+
+def test_part1():
+    data = utils.read_data(day_num, '')
+    expected = None
+    result = part1(data)
+    assert result == expected
+
+
+def test_part2():
+    data = utils.read_data(day_num, '')
+    expected = None
+    result = part2(data)
+    assert result == expected

advent/days/template.py

@@ -0,0 +1,23 @@
+import typing
+
+ResultType = int | str | list[str]
+
+
+class Day(typing.Protocol):
+    day_num: int
+
+    @staticmethod
+    def part1(lines: typing.Iterator[str]) -> ResultType | None:
+        ...
+
+    @staticmethod
+    def part2(lines: typing.Iterator[str]) -> ResultType | None:
+        ...
+
+
+def is_day(object: typing.Any) -> typing.TypeGuard[Day]:
+    try:
+        return (isinstance(object.day_num, int)
+                and callable(object.part1) and callable(object.part2))
+    except AttributeError:
+        return False