How quarbby/london-git works
Project Type and Purpose
• This is an open-source “visualization tool” that encodes the London Tube map as a Git commit/branch/merge graph.
• The core purpose is to run a shell script (london.sh) that emits Git commits in such a way that GitHub’s network view renders a stylized tube map.
File Structure Analysis
• Top level:
• README.md – project description and usage instructions
• london.sh – the only executable generator
• There is no separate frontend/backend directory structure. The entire logic lives in a single script.
• There are no build scripts, dependency files, or configuration beyond what’s in london.sh and Git itself.
README Insights
• The script generates commits and branches to represent individual lines and stations.
• Users run “./london.sh” locally, which creates commits in the local Git repo, and then they can view it in GitHub’s network graph.
• The project is inspired by similar “MetroGit” efforts.
a. Main Components
• Generator Script (london.sh)
• Local Git Repository (data store of commits/branches)
• Git Remote (GitHub)
• Visualizer (GitHub Network View UI)
• (Optional) Static assets folder (e.g., img/ for reference images)
b. Relationships & Interactions
1. Developer runs london.sh
2. Script writes commits and branches into the local Git repo
3. User pushes to GitHub remote
4. GitHub processes repository metadata and exposes the network graph
5. User opens GitHub Network View to see tube-map representation
c. Architectural Patterns and Principles
– Single-responsibility: The script solely handles mapping geometry → Git operations.
– Infrastructure-as-data: Using Git itself as the visualization medium.
– Minimal external dependencies: relies only on a POSIX shell and git CLI.
d. Key Technologies
– Bash (or sh) scripting
– Git CLI (commit, branch, push)
– GitHub Network Graph visualizer (web UI)
– (Optional) static image assets in img/ if expanded