🔀 Flip Flop Codes

This repository contains my solutions for Flip Flop Codes.

Flip Flop Codes is a coding puzzle series, with each puzzle split into three parts of increasing difficulty.

📊 Progress

Overall: 16/21 parts solved (76%)

2025

████████████████░░░░░ 16/21 parts solved (76%)

🛠️ Setup

Creating a Virtual Environment

python3 -m venv .venv

Activating the Virtual Environment

On macOS/Linux:

source .venv/bin/activate

On Windows:

.venv\Scripts\activate

Installing Dependencies

pip install -r requirements.txt

Deactivating the Virtual Environment

deactivate

✨ Creating a New Puzzle

To create a new puzzle structure, use the new_puzzle.sh script:

./new_puzzle.sh <year> <puzzle>

Example:

./new_puzzle.sh 2025 1

This will create:

• A folder structure: 2025/puzzle01/
• main.py with a template for part 1, part 2 and part 3
• input.txt for the puzzle input
• input_sample.txt for sample/test input

🚀 Running Solutions

You can run the solutions:

python3 -m 2025.puzzle01.main

Replace 2025 with the desired year and puzzle01 with the specific puzzle you want to run.

🔄 Updating Progress Summary

To update the progress summary in this README after solving new parts, run the generate_readme.py script:

python3 generate_readme.py