Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexaegis/advent-of-code
My solutions for Advent of Code
https://github.com/alexaegis/advent-of-code
advent-of-code advent-of-code-2015 advent-of-code-2016 advent-of-code-2017 advent-of-code-2018 advent-of-code-2019 advent-of-code-2020 advent-of-code-2021 advent-of-code-2022 advent-of-code-2023 advent-of-code-javascript advent-of-code-python advent-of-code-rust advent-of-code-typescript python rust typescript
Last synced: 4 days ago
JSON representation
My solutions for Advent of Code
- Host: GitHub
- URL: https://github.com/alexaegis/advent-of-code
- Owner: AlexAegis
- License: mit
- Created: 2018-12-11T10:22:20.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-01-01T17:03:34.000Z (23 days ago)
- Last Synced: 2025-01-13T08:07:11.425Z (11 days ago)
- Topics: advent-of-code, advent-of-code-2015, advent-of-code-2016, advent-of-code-2017, advent-of-code-2018, advent-of-code-2019, advent-of-code-2020, advent-of-code-2021, advent-of-code-2022, advent-of-code-2023, advent-of-code-javascript, advent-of-code-python, advent-of-code-rust, advent-of-code-typescript, python, rust, typescript
- Language: TypeScript
- Homepage: https://adventofcode.com/
- Size: 5.94 MB
- Stars: 66
- Watchers: 5
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- Funding: .github/funding.yml
- License: license
Awesome Lists containing this project
README
# [Advent of Code](https://adventofcode.com/)
[](https://github.com/AlexAegis/advent-of-code/actions/workflows/cicd.yml)
[](https://github.com/AlexAegis/advent-of-code/actions/workflows/rust.yml)
[](https://github.com/AlexAegis/advent-of-code/actions/workflows/python.yml)
[](https://www.codacy.com/gh/AlexAegis/advent-of-code/dashboard?utm_source=github.com&utm_medium=referral&utm_content=AlexAegis/advent-of-code&utm_campaign=Badge_Grade)
[](https://codeclimate.com/github/AlexAegis/advent-of-code/maintainability)
[](https://codeclimate.com/github/AlexAegis/advent-of-code/test_coverage)
[](https://codecov.io/gh/AlexAegis/advent-of-code)
[](https://coveralls.io/github/AlexAegis/advent-of-code?branch=master)
[](https://github.com/AlexAegis/advent-of-code)
[](https://github.com/prettier/prettier)
> This is a multi-language repository, for easy usage, all of them share the
> same root level. You need to individually set up each language you wish to
> use.
## Usage
The repository does not contain task inputs as my own inputs are located in a
private repository. If you wish to use this repository with your own inputs
provide them in the following folder structure:
```sh
resources
├── 2015
│ ├── 01
│ │ └── input.txt
│ ├── 02
│ │ └── input.txt
│ │ ...
│ └── 25
│ └── input.txt
│ ...
└── 2024
├── 01
│ ├── example.1.txt
│ ├── example.2.txt
│ └── input.txt
│ ...
└── 25
└── input.txt
```
### Cloning
> Reference for myself, cloning with my private inputs
```sh
git clone --recurse-submodules -j8 [email protected]:AlexAegis/advent-of-code.git
```
[Why and how](#working-with-private-files)
## [TypeScript](./solutions/typescript)
[](/solutions/typescript/2024/)
[](/solutions/typescript/2023/)
[](/solutions/typescript/2022/)
[](/solutions/typescript/2021/)
[](/solutions/typescript/2020/)
[](/solutions/typescript/2019/)
[](/solutions/typescript/2018/)
[](/solutions/typescript/2017/)
[](/solutions/typescript/2016/)
[](/solutions/typescript/2015/)
### Setup TypeScript workspace
Install latest stable `node` and `pnpm`
```sh
pnpm install
```
### Running individual TypeScript solutions
```sh
# Navigate to the solution
cd solutions/typescript/2024/01
pnpm p1
pnpm p2
```
### Debugging TypeScript solutions using VS Code
Open the solutions file, then run the `[TS] Current File` debug profile.
### Testing all TypeScript solutions
```sh
pnpm test
```
### Testing individual TypeScript solutions
```sh
# Navigate to the solution
cd solutions/typescript/2024/01
pnpm test
```
### Benchmarking individual TypeScript solutions
```sh
# Navigate to the solution
cd solutions/typescript/2024/01
pnpm bench
```
### Linting all TypeScript solutions
```sh
pnpm lint
```
### Linting individual TypeScript solutions
```sh
# Navigate to the solution
cd solutions/typescript/2024/01
pnpm lint:tsc
pnpm lint:es
pnpm lint:format
```
## [Rust](./solutions/rust)
[](/solutions/rust/2019/)
[](/solutions/rust/2018/)
[](/solutions/rust/2017/)
[](/solutions/rust/2016/)
[](/solutions/rust/2015/)
## [Python](./solutions/python)
[](/solutions/python/year2022/)
### Setup Python workspace
Install latest stable `python` and `pipenv`
```sh
pipenv install
pipenv shell
```
## Working with private files
If you wish to replicate the same input setup that I have so that it's compliant
with [Advent of Code](https://adventofcode.com/)'s rules, you should not keep
your inputs in a publicly hosted repository. I think the best solution to this
is to keep them in a private submodule, keeping your inputs private, but your
solutions public and keeping your CI happy and operational.
### Why?
See the _"Can I copy/redistribute part of Advent of Code?"_ section at
### How?
1. Collect your input files into a new "advent-of-code-inputs" repository
2. Get a fresh clone of your repository!
3. [Install `git-filter-repo`](https://github.com/newren/git-filter-repo/blob/main/INSTALL.md)
> You will completely rewrite your repository's history, so first educate
> yourself on how
> [`git-filter-repo`](https://github.com/newren/git-filter-repo) works. (The
> tool you might find for this first is the BFG Repo cleaner, however
> git-filter-repo is much more capable and can clean out huge repositories in
> just milliseconds.)
4. Clean out the repository:
`git filter-repo --invert-paths --path-glob '*.txt' --path inputs`
> This is just an example command, add more globs or paths if needed
5. Verify that apart from the unwanted files everything is in order. Check older
commits too!
> Maybe in previous years you stored these files differently, and/or you
> refactored them at some point!
6. Add back your inputs as a git submodule:
```sh
git submodule add [email protected]:AlexAegis/advent-of-code-inputs.git resources
git commit -m 'added inputs submodule'
```
7. Adjust your CI so that it checks out submodules too.
> If you're using GitHub Actions and actions/checkout:
```yaml
- name: checkout
uses: actions/checkout@v4
with:
fetch-depth: 1
submodules: true
```
8. Verify if everything works locally
9. If everything looks right, re-add your remote and force push the changes.
(Since you started with a fresh clone, your old can be used to restore it if
anything goes wrong at any point)
```sh
git remote add origin [email protected]:AlexAegis/advent-of-code.git
git push --force
```
10. Clean out remaining branches by either force pushing them too or just
removing them.
## Disclaimer
[Advent of Code](https://adventofcode.com/) is made by
[Eric Wastl](http://was.tl/).