This gem provides a simple way to create a project for solving Advent of Code puzzles.
It also provides some handy tools to automate your interactions with the Advent of Code website.
If you want more help with your puzzles (use with care ... it'll take the fun out of doing it yourself) then take a look at aoc_rb_helpers.
First of all, install the gem:
$ gem install aoc_rb
Next, generate your Advent of Code project:
$ aoc new my-project-name
This will generate a new project with the given name. After this you should be ready to go!
$ cd my-project-name
$ aoc
Before running any commands, you must set up your AOC_COOKIE environment variable:
$ cp .env-template .env
You'll need to log in to the Advent of Code website and then grab a copy of your session key from your cookies.
In Chrome you can do this via chrome settings by entering chrome://settings/cookies/detail?site=adventofcode.com in your address bar. Just click on session and copy your key from the Content section.
Now edit the new .env file, so that it looks like the following, replacing ABCDE12345 with the session key you just copied:
AOC_COOKIE=ABCDE12345
You're now able to run all the aoc commands provided by this gem.
You'll see you have a few options when running the aoc command within your project.
prep will set everything up for a new daily puzzle. It defaults to the puzzle for today, but you can work with older puzzles by passing the year and day:
$ aoc prep 2017 12
This will generate a challenges/2017/12 folder with an input.txt file (your puzzle input), a part_1.md file with the instructions for part 1, and a solution.rb file for you to use when implementing your solution.
In spec/2017/12 there will be a solution_spec.rb which you can use to write tests for your solution. It's a good idea to use the examples provided in the part_1.md to test your solution!
When you've got a working solution you can see what it generates by running:
$ aoc exec
Which runs todays solution. For previous days, just like with prep, you can provide a date:
$ aoc exec 2017 12
If you're happy with the output, you can respond to the prompt and aoc will submit your answer for you. If you're successful with part 1, it will automatically download the instructions for part 2 for you.
Rinse & repeat!
Bug reports and pull requests are welcome on GitHub at https://github.com/pacso/aoc_rb. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
The gem is available as open source under the terms of the MIT License.
Everyone interacting in the AocRb project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.
