https://github.com/andrewbrennanfr/advent-of-code-2024

My (very 🤪) opinionated TypeScript repository for Advent of Code 2024!
https://github.com/andrewbrennanfr/advent-of-code-2024

advent-of-code bun functional-programming typescript

Last synced: 20 days ago
JSON representation

My (very 🤪) opinionated TypeScript repository for Advent of Code 2024!

• Host: GitHub
• URL: https://github.com/andrewbrennanfr/advent-of-code-2024
• Owner: andrewbrennanfr
• Created: 2024-10-22T05:58:56.000Z (3 months ago)
• Default Branch: master
• Last Pushed: 2024-12-22T16:14:55.000Z (about 1 month ago)
• Last Synced: 2024-12-22T17:21:42.276Z (about 1 month ago)
• Topics: advent-of-code, bun, functional-programming, typescript
• Language: TypeScript
• Homepage: https://adventofcode.com/
• Size: 252 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 🎄 Advent of Code 2024 🎄

Welcome to my **Advent of Code 2024** repository! Built with **TypeScript** and grounded in **functional programming** and **immutability**.

---

## ⚡ Why Bun?

This project uses **Bun**, a fast JavaScript runtime ideal for Advent of Code:

- **Tail Call Optimization (TCO)**: Enables deep recursion without stack overflow.

- **High Performance**: Optimized JIT for complex Advent of Code computations.

- **Built-In Test Runner**: Allows easy test setup and validation of solutions.

- **Native TypeScript Support**: Type-safe coding without extra compilation.

For more, visit [Bun's website](https://bun.sh/).

## 📦 Getting Started

1. **Clone the Repository:**

    ```sh

    git clone https://github.com/andrewbrennanfr/advent-of-code-2024.git

    cd advent-of-code-2024

    ```

2. **Install Dependencies:**

    ```sh

    bun install

    ```

3. **Set Up Git Hooks (using Husky):**

    ```sh

    bun husky

    ```

## 🚀 Key Scripts

- **`bun check`** – TypeScript type-checking.

- **`bun format`** – Code formatting with Prettier.

- **`bun lint`** – Linting with ESLint.

- **`bun new NN`** – Creates a new puzzle directory and starts tests.

- **`bun start`** – Runs all tests in watch mode.

- **`bun start NN`** – Runs tests in directory `NN` in watch mode.

- **`bun test`** – Runs all tests once.

- **`bun test NN`** – Runs tests in directory `NN` once.

---

## 📁 Puzzle Inputs

Puzzle input files are excluded from version control per [Advent of Code's guidelines](https://adventofcode.com/2024/about).

---

## 📜 License

Licensed under the MIT License.

---

**🎅 Happy solving!**