feat(puzzles): Add spec and tests for 2022/day01 puzzle

Author: obalunenko

internal/puzzles/solutions/2022/day01/solution.go

@@ -0,0 +1,30 @@
+// Package day01 contains solution for https://adventofcode.com/2022/day/1 puzzle.
+package day01
+
+import (
+	"io"
+
+	"github.com/obalunenko/advent-of-code/internal/puzzles"
+)
+
+func init() {
+	puzzles.Register(solution{})
+}
+
+type solution struct{}
+
+func (s solution) Year() string {
+	return puzzles.Year2022.String()
+}
+
+func (s solution) Day() string {
+	return puzzles.Day01.String()
+}
+
+func (s solution) Part1(input io.Reader) (string, error) {
+	return "", puzzles.ErrNotImplemented
+}
+
+func (s solution) Part2(input io.Reader) (string, error) {
+	return "", puzzles.ErrNotImplemented
+}

internal/puzzles/solutions/2022/day01/solution_test.go

@@ -0,0 +1,102 @@
+package day01
+
+import (
+	"errors"
+	"io"
+	"strings"
+	"testing"
+	"testing/iotest"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func Test_solution_Year(t *testing.T) {
+	var s solution
+
+	want := "2022"
+	got := s.Year()
+
+	assert.Equal(t, want, got)
+}
+
+func Test_solution_Day(t *testing.T) {
+	var s solution
+
+	want := "1"
+	got := s.Day()
+
+	assert.Equal(t, want, got)
+}
+
+func Test_solution_Part1(t *testing.T) {
+	var s solution
+
+	type args struct {
+		input io.Reader
+	}
+
+	tests := []struct {
+		name    string
+		args    args
+		want    string
+		wantErr assert.ErrorAssertionFunc
+	}{
+		{
+			name: "test example from description",
+			args: args{
+				input: strings.NewReader("1000\n2000\n3000\n\n4000\n\n5000\n6000\n\n7000\n8000\n9000\n\n10000"),
+			},
+			want:    "24000",
+			wantErr: assert.NoError,
+		},
+		{
+			name: "",
+			args: args{
+				input: iotest.ErrReader(errors.New("custom error")),
+			},
+			want:    "",
+			wantErr: assert.Error,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			got, err := s.Part1(tt.args.input)
+			if !tt.wantErr(t, err) {
+				return
+			}
+
+			assert.Equal(t, tt.want, got)
+		})
+	}
+}
+
+func Test_solution_Part2(t *testing.T) {
+	t.Skip("Not implemented")
+
+	var s solution
+
+	type args struct {
+		input io.Reader
+	}
+
+	tests := []struct {
+		name    string
+		args    args
+		want    string
+		wantErr assert.ErrorAssertionFunc
+	}{
+		{},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			got, err := s.Part2(tt.args.input)
+			if !tt.wantErr(t, err) {
+
+			}
+
+			assert.Equal(t, tt.want, got)
+		})
+	}
+}

internal/puzzles/solutions/2022/day01/spec.md

@@ -0,0 +1,55 @@
+# --- Day 1: Calorie Counting ---
+
+## Part 1
+
+Santa's reindeer typically eat regular reindeer food, but they need a lot of magical energy to deliver presents on 
+Christmas. For that, their favorite snack is a special type of star fruit that only grows deep in the jungle. 
+The Elves have brought you on their annual expedition to the grove where the fruit grows.
+
+To supply enough magical energy, the expedition needs to retrieve a minimum of fifty stars by December 25th. 
+Although the Elves assure you that the grove has plenty of fruit, you decide to grab any fruit you see along the way, 
+just in case.
+
+Collect stars by solving puzzles. Two puzzles will be made available on each day in the Advent calendar; 
+the second puzzle is unlocked when you complete the first. Each puzzle grants one star. Good luck!
+
+The jungle must be too overgrown and difficult to navigate in vehicles or access from the air; the Elves' 
+expedition traditionally goes on foot. As your boats approach land, the Elves begin taking inventory of their supplies. 
+One important consideration is food - in particular, the number of Calories each Elf is carrying (your puzzle input).
+
+The Elves take turns writing down the number of Calories contained by the various meals, snacks, rations, etc. 
+that they've brought with them, one item per line. Each Elf separates their own inventory from the previous 
+Elf's inventory (if any) by a blank line.
+
+For example, suppose the Elves finish writing their items' Calories and end up with the following list:
+
+```text
+1000
+2000
+3000
+
+4000
+
+5000
+6000
+
+7000
+8000
+9000
+
+10000
+```
+
+This list represents the Calories of the food carried by five Elves:
+
+- The first Elf is carrying food with `1000`, `2000`, and `3000` Calories, a total of `6000` Calories.
+- The second Elf is carrying one food item with `4000` Calories.
+- The third Elf is carrying food with `5000` and `6000` Calories, a total of `11000` Calories.
+- The fourth Elf is carrying food with `7000`, `8000`, and `9000` Calories, a total of `24000` Calories.
+- The fifth Elf is carrying one food item with `10000` Calories.
+
+In case the Elves get hungry and need extra snacks, they need to know which Elf to ask: 
+they'd like to know how many Calories are being carried by the Elf carrying the most Calories. 
+In the example above, this is `24000` `(carried by the fourth Elf)`.
+
+Find the Elf carrying the most Calories. How many total Calories is that Elf carrying?