How sparklingbalz/advent_of_code_2023 works
Main Components
a. Solution Structure:
• Individual Day modules (Day 1 through Day 20)
• Input Processing System
• Solution Output System
┌─────────────────────────────────────────┐
• Advent of Code 2023 │
• ┘
• ↓ ↓
┌────────────────┐ ┌─────────────────┐
• Input Handler │ │ Solution Modules │
• ┘ └─────────────────┘
• ↘ ↙
• ┌──────────────┐
• Output │
• ┘
Key Elements to Highlight
• Blue: Core system components
• Green: Input processing
• Yellow: Solution modules
• Purple: Output handling
• Gray: Support utilities (like Day_5/location_finder.py)
b. Component Types:
• Use rectangles for main modules
Specific Implementation Details
a. Module Patterns:
• Single solution files (e.g., Day_7/code.py)
• Dual solution files (e.g., Day_1/code_1.py and code_2.py)
• Special utility modules (e.g., Day_5/location_finder.py)
b. Data Flow:
Input File → Input Handler → Solution Module → Output
Symbols:
→ : Data flow direction
⇢ : Module dependency
□ : Main component
○ : Support utility
▽ : Input/Output
Special Notes
• That inputs are not included in the repository (as stated in README)
• Python-centric nature of the solutions
• A note about the progressive nature of the solutions (Day 1-20)