{"id":28804500,"url":"https://github.com/jiraroj-wir/aoc-2015-elixir","last_synced_at":"2025-08-23T02:06:58.277Z","repository":{"id":294036950,"uuid":"984005168","full_name":"jiraroj-wir/AoC-2015-elixir","owner":"jiraroj-wir","description":"Advent of Code 2015 solutions in Elixir — with tests and AI-generated summaries","archived":false,"fork":false,"pushed_at":"2025-06-10T15:41:28.000Z","size":124,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-10T17:25:34.782Z","etag":null,"topics":["advent-of-code","advent-of-code-2015","aoc-2015","elixir"],"latest_commit_sha":null,"homepage":"https://adventofcode.com/2015","language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jiraroj-wir.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-15T08:47:54.000Z","updated_at":"2025-06-10T15:52:13.000Z","dependencies_parsed_at":"2025-06-03T07:48:35.621Z","dependency_job_id":null,"html_url":"https://github.com/jiraroj-wir/AoC-2015-elixir","commit_stats":null,"previous_names":["jiraroj-wir/aoc-2015-elixir"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jiraroj-wir/AoC-2015-elixir","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiraroj-wir%2FAoC-2015-elixir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiraroj-wir%2FAoC-2015-elixir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiraroj-wir%2FAoC-2015-elixir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiraroj-wir%2FAoC-2015-elixir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jiraroj-wir","download_url":"https://codeload.github.com/jiraroj-wir/AoC-2015-elixir/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiraroj-wir%2FAoC-2015-elixir/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260523585,"owners_count":23021968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advent-of-code","advent-of-code-2015","aoc-2015","elixir"],"created_at":"2025-06-18T09:03:56.661Z","updated_at":"2025-08-23T02:06:58.266Z","avatar_url":"https://github.com/jiraroj-wir.png","language":"Elixir","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎄 Advent of Code 2015 — in **Elixir**\n\n\u003e *“Ho-ho-hold my pipe operator.”*  \n\nI decided to tackle the classic [Advent of Code 2015](https://adventofcode.com/2015) with a language that treats tuples like royalty, pattern-matches in its sleep, and runs on the indestructible BEAM: **Elixir**. It’s functional, succinct, expressive, and—most importantly—makes me feel clever every time I write `|\u003e`.\n\n---\n\n## ✨ Why Elixir?\n\n* Functional playground (recursion everywhere, side-effects nowhere).  \n* Powered by Erlang/OTP — battle-tested for distributed systems and networking.  \n* `mix` for painless build \u0026 test tooling, `iex` for REPL happiness.  \n* Pipes (`|\u003e`) that turn data flow into poetry.\n\n---\n\n## 🧰 Environment\n\n```bash\nErlang/OTP 27 [erts-15.2.7] [64-bit] [smp:8:8] [jit]\nElixir 1.18.3 (compiled with Erlang/OTP 27)\n```\n\nAny recent Elixir ≥ 1.18 plus OTP 27 should work fine.\n\n---\n\n## 📁 Project Layout\n\n```\n.\n├── lib/                # One module per day (Day01, Day02…)\n├── priv/inputs/        # My puzzle inputs (yours will differ)\n├── stories/            # AI-generated dramatic summaries\n├── test/               # Asserted examples straight from AoC\n└── mix.exs             # Project configuration\n```\n\nEach day’s module contains `part1/0`, `part1/1`, `part2/0`, `part2/1`:\n\n```elixir\niex\u003e AOC2015.Day01.part1()\n232  # =\u003e Santa’s final floor\n\niex\u003e AOC2015.Day01.part2()\n1783 # =\u003e First position that hits the basement\n```\n\n---\n\n## 🧪 Running Tests\n\nTests mirror the official examples—nothing fancy, just *green or red*:\n\n```bash\nmix test\n```\n\n---\n\n## 📜 Inputs\n\nPuzzle inputs live in `priv/inputs/dayXX.txt`.  \nAdvent of Code gives each participant a unique file, so swap in yours if you’re comparing answers.\n\n---\n\n## 📚 AI Story Time\n\nBecause elves deserve fan-fiction, every solved day gets an **AI-generated, bite-sized, mildly poetic recap** in `stories/`. Imagine Santa starring in a Shakespearian ankle-deep snowdrift.\n\n---\n\n## 📝 My Post-Mortem on Elixir\n\nElixir is beautiful — succinct, expressive, and reads almost like pseudocode when you get into the flow with `Enum`, `map`, and `|\u003e`. The language encourages good habits: pure functions, clear flow, and testable components. `Task.async/await` and pattern matching made parallelism and control flow feel natural, not scary.\n\nThat said, I’ve only scratched the surface. Advent of Code taught me a lot about Elixir's syntax and idioms, but the real power lies deeper — in the BEAM VM, distributed systems, and the concurrent magic Elixir is known for.\n\nElixir doesn’t make implementing things easier — quite the opposite sometimes — but once it *works*, and you’ve got full test coverage, you can sleep well knowing it won’t break randomly.\n\nWould I recommend Elixir for AoC or competitive programming? Probably not. But if you want to learn Elixir, then doing something like AoC is a great playground. You'll pick up real intuition fast. The ecosystem (`mix`, docs, tests) supports that kind of exploration really well.\n\nAt the end of the day, Elixir is a functional language that encourages immutability, composability, and clean code. It won’t solve the problem for you — but it’ll make you feel clever solving it.\n\n\u003e For deeper thoughts, odd bugs, and Elixir lessons learned, see [MEMO.md](MEMO.md).\n\n---\n\n## ❌ License\n\n**Unlicense** — public domain. Copy it, fork it, tattoo it on a reindeer.\n\n---\n\nThanks for dropping by. May your recursion always find a base case, and may the pipes be ever in your favour. 🌟\n\n---\n\n\u003cp align=\"center\" style=\"margin-top: 2rem;\"\u003e\n  \u003cimg src=\"priv/AoC2015_tree.png\" alt=\"Completed AoC2015 Tree\" style=\"width: 100%; max-width: none;\"\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjiraroj-wir%2Faoc-2015-elixir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjiraroj-wir%2Faoc-2015-elixir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjiraroj-wir%2Faoc-2015-elixir/lists"}