advent-of-code-2023/README.md

# Advent of Code 2023

This repository contains my solutions for the [Advent of Code 2023](https://adventofcode.com/2023) challenge.

## Language

I am using C# for this year's challenge. I'd consider myself proficient in C#, but on a day to day basis I don't use it as much and would just like to get more practice with it.

## Structure

Each day's solution is contained in a separate folder. Each folder contains:

- A `PROBLEM.md` file containing the problem description.
- A `INPUT.txt` file containing the input for the problem.
- A dotnet console application containing the solution.
- An xUnit test project containing unit tests for the solution.

### Prerequisites

- [.NET 8.0](https://dotnet.microsoft.com/download/dotnet/8.0)

### Running the Solutions

To run the solutions, navigate to the solution folder and run the following command:

```bash
dotnet run -- <path-to-input-file>
```

Or for part 2 solutions

```bash
dotnet run -- <path-to-input-file> part2
```

You can also build the projects and run the executables directly.

```bash
dotnet build
./bin/Debug/net8.0/<project-name> <path-to-input-file>
```

## Challenges

| Day | Problem                    |                 Solution                 | Status | Notes                                                                                                                                            |
| --- | -------------------------- | :--------------------------------------: | :----: | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| 01  | [Problem](./01/PROBLEM.md) |       [Solution](./01/Trebuchet/)        |   ✅   | The trickiest part here was accounting for overlapping digit words.                                                                              |
| 02  | [Problem](./02/PROBLEM.md) |     [Solution](./02/CubeConundrum/)      |   ✅   | The key to me here was to parse the input into a useful model.                                                                                   |
| 03  | [Problem](./03/PROBLEM.md) |       [Solution](./03/GearRatios/)       |   ✅   | The edge case that got me here was lines ending with a part number.                                                                              |
| 04  | [Problem](./04/PROBLEM.md) |      [Solution](./04/Scratchcards/)      |   ✅   | Part 2 gets out of hand quickly with just 200 cards.                                                                                             |
| 05  | [Problem](./05/PROBLEM.md) |        [Solution](./05/IYGASAF/)         |   ✅   | I brute forced part 2 using parallelism. I know shame.                                                                                           |
| 06  | [Problem](./06/PROBLEM.md) |       [Solution](./06/WaitForIt/)        |   ✅   | Thank goodness part 2 was not like 5's part 2. 😅                                                                                                |
| 07  | [Problem](./07/PROBLEM.md) |       [Solution](./07/CamelCards/)       |   ✅   | What took me longest here was I missed a case when jokers are wild and there are three groups of cards.                                          |
| 08  | [Problem](./08/PROBLEM.md) |    [Solution](./08/HauntedWasteland/)    |   ✅   | Got to implement a least common multiple algorithm for part 2.                                                                                   |
| 09  | [Problem](./09/PROBLEM.md) |   [Solution](./09/MirageMaintenance/)    |   ✅   | Part 1 took me unnecessarily long. The bug was summing a line to check for all zeros is bad idea when negative numbers are involved.             |
| 10  | [Problem](./10/PROBLEM.md) |        [Solution](./10/PipeMaze/)        |   ✅   | So...my solutions are rather slow, but they work. Part 2 appears to have a mathematical solution, but scanning is what I came up with on my own. |
| 11  | [Problem](./11/PROBLEM.md) |    [Solution](./11/CosmicExpansion/)     |   ✅   | Expanding the universe was fine in part 1, but part 2 showed I actually needed to calculate the expansion instead of expanding the input.        |
| 12  | [Problem](./12/PROBLEM.md) |       [Solution](./12/HotSprings/)       |   ✅   | This one stretched my skills. I needed lots of help from the interwebz.                                                                          |
| 13  | [Problem](./13/PROBLEM.md) |    [Solution](./13/PointOfIncidence/)    |   ✅   | This solution is the one I think I'm most proud of so far.                                                                                       |
| 14  | [Problem](./14/PROBLEM.md) | [Solution](./14/ParabolicReflectorDish/) |   ✅   | Cycles and a cache...that's all I'm going to say.                                                                                                |
| 15  | [Problem](./15/PROBLEM.md) |            [Solution](./15/)             |   ⌛   |
| 16  | [Problem](./16/PROBLEM.md) |            [Solution](./16/)             |   ⌛   |
| 17  | [Problem](./17/PROBLEM.md) |            [Solution](./17/)             |   ⌛   |
| 18  | [Problem](./18/PROBLEM.md) |            [Solution](./18/)             |   ⌛   |
| 19  | [Problem](./19/PROBLEM.md) |            [Solution](./19/)             |   ⌛   |
| 20  | [Problem](./20/PROBLEM.md) |            [Solution](./20/)             |   ⌛   |
| 21  | [Problem](./21/PROBLEM.md) |            [Solution](./21/)             |   ⌛   |
| 22  | [Problem](./22/PROBLEM.md) |            [Solution](./22/)             |   ⌛   |
| 23  | [Problem](./23/PROBLEM.md) |            [Solution](./23/)             |   ⌛   |
| 24  | [Problem](./24/PROBLEM.md) |            [Solution](./24/)             |   ⌛   |
| 25  | [Problem](./25/PROBLEM.md) |            [Solution](./25/)             |   ⌛   |