This is a template project for solving Advent Of Code (2023) in Haskell: fork it and you can start solving!

You are expected to have ghcup installed on your machine.

Run ./ghcup-set.sh to set the intended version of GHC, cabal and HLS via GHCup.

If any of the versions needed are not yet installed on your machine, you can use ghcup tui to install them.

It might work with other combination of versions also, but this combo works for sure.

src/ contains all the Haskell code. src/Day01.hs, src/Day02.hs, ... each contain the solution for that specific day, and they are all imported into the src/Main.hs, which is the executable that we use to easily run the solution for the specific day.

data/ dir is where input text files go for each day. Your code in src/DayXX.hs can then read those files as needed.

cabal run will build all your code and then run the executable which has src/Main.hs as its entry point. It will run the solution for whichever day is set as default day at the moment.

cabal run aoc2023 -- 2 will run solution for a specific day, in this example day number 2.

cabal repl will take you to ghci where all the modules are already loaded for you and you can easily run any function, this is great for debugging and testing, or even normal running. You can just type day01 and run it that way. Type :r to reload upon changes in the code.

When solving a new Day, lets say Day 17, there are a couple of things you need to set up:

1. Create a new file: src/Day17.hs. Inside it, make sure to update its module name to Day17.
2. Add this module to aoc2023.cabal file, under other-modules, as Day17.
3. Add corresponding input text file to data/ if needed, e.g. data/day17-input.txt.
4. In src/Main.hs, import Day17 and call it as you wish.

You might also want to set default day to run in src/Main.hs to be this new day, so you can just quickly run it with cabal run when needed.