Advent of Code 2023

This project contains solutions to the Advent of Code 2023 challenge in Kotlin. Advent of Code is an Advent calendar of small programming puzzles by Eric Wastl.

Solutions

• Day 1: ⢝⢝ Trebuchet?! -- Day1.kt
• Day 2: 🎲 Cube Conundrum -- Day2.kt
• Day 3: ⚙️ Gear Ratios -- Day3.kt
• Day 4: 🎴️ Scratchcards -- Day4.kt
• Day 5: 🌱 If You Give A Seed A Fertilizer -- Day5.kt
• Day 6: 🏎️ Wait For It -- Day6.kt
• Day 8: 🗺️️ Haunted Wasteland -- Day8.kt
• Day 9: 🛠️ Mirage Maintenance -- Day9.kt
• Day 11: ✨️ Cosmic Expansion -- Day11.kt
• Day 13: 🪞 Point of Incidence -- Day13.kt

Features

• Gradle setup so you can run a specific day or all days on the command line (see Running)
• Timings for each part of each day
• Input for each day automatically exposed in String and List form
• Junit 5 and AssertJ test libraries included (see Testing)
• Starter .gitignore

Running

Project is already setup with gradle. To run the app:

• Navigate to top-level directory on the command line
• Run ./gradlew run to run all days
• Run ./gradlew run --args $DAY where $DAY is an integer to run a specific day
• Run ./gradlew run --args "$DAY1 $DAY2 $ANOTHERDAY" to run a subset of days

Testing

Project includes JUnit and AssertJ and a stub unit test to get you going. To run all tests:

• Navigate to top-level directory on the command line
• Run ./gradlew test
• Add --info, --debug or --stacktrace flags for more output

By default, instantiations of Day classes in tests will use the input files in src/test/resources, not those in src/main/resources. This hopefully gives you flexibility - you could either just copy the real input into src/test/resources if you want to test the actual answers, or you could add a file of test data based on the examples given on the Advent of Code description for the day. The stub Day1Test class shows a test of the functionality of Day1 where the test input differs from the actual input.

Architecture

• Inputs go into src/main/resources and follow the naming convention input_day_X.txt
• Solutions go into src/main/kotlin/days and implement the Puzzle interface
• Solutions follow the naming convention DayX
• It is assumed all solutions will have two parts
• It is assumed that the puzzle input is provided through the primary constructor
• You can use the InputReader methods for reading input
• To get started simply replace src/main/resources/input_day_1.txt with the real input and the solutions in Day1 with your own