Repo Visualizer: guarda come è cresciuto il tuo codice nel tempo

Repo Visualizer è uno strumento open source che trasforma la storia git di un repository in un'animazione: file, import e funzionalità che nascono commit dopo commit, con un inspector per capire cosa dipende da cosa.

Hai presente quando sei così stanca che l’unica cosa sensata da fare sarebbe andare a letto, e invece il cervello decide che è il momento perfetto per un’idea nuova di zecca? Ecco, Repo Visualizer è nato più o meno così.

Patcherly è nato come proof of concept per la mia tesi in Informatica, una piccola demo con una manciata di file. 8 mesi di lavoro giorno e notte dopo, è un SaaS completo con diverse centinaia di file, centinaia di dipendenze e migliaia di import che tengono insieme il tutto.

Ne ero orgogliosa, ma ero anche arrivata al punto in cui non riuscivo più a tenerlo tutto in testa. Così ho iniziato a chiedermi che aspetto avrebbero avuto quegli 8 mesi, se avessi potuto guardarli davvero: non un grafo piatto delle dipendenze fermo a un singolo momento (li abbiamo visti tutti, sembrano un piatto di spaghetti lanciato contro una lavagna), ma un film. Tutta la storia dal primo commit a oggi, con ogni file che compare il giorno in cui è stato scritto davvero, e ogni import disegnato nel momento in cui due file hanno iniziato a parlarsi.

Dopotutto ogni repository ha una storia: il primo commit, la settimana in cui è arrivato il modulo di autenticazione, il refactoring che ha diviso una funzionalità in tre, il lento accumularsi dei test intorno alle parti che tutti avevano paura di toccare.

Quindi, essendo già esausta, ho fatto la cosa più ovvia e ho iniziato un secondo progetto… e poi l’ho reso open source.

Demo online: repovisualizer.netlify.app
Codice sorgente: github.com/Jany-M/repo-visualizer

Repo Visualizer: animazione della storia di un repository


Ogni file del repository è un nodo (o una stella, se usi il tema Galaxy, cosa che ti consiglio). Ogni import tra due file è un collegamento, e ogni cartella di primo livello diventa un gruppo a sé (auth, payments, api, ui), disposto su un anello morbido da una simulazione d3-force .

Premi play e la timeline percorre il log di git, un commit alla volta. I file compaiono il giorno in cui sono stati aggiunti per la prima volta, e da ogni file toccato da un commit parte un’onda verso l’esterno. Vedi le funzionalità arrivare in tempo reale, scopri quali aree cambiano di più (sì, quel file che continui a “sistemare al volo” si noterà parecchio), e ti accorgi di quando un nuovo modulo viene adottato dal resto del sistema.

La funzione che uso di più: l’inspector dei file

Lo ammetto, l’ho costruito per l’animazione. Volevo qualcosa di bello da guardare, e qualcosa da poter finalmente mostrare ad amici e parenti, che non avevano idea di cosa mi stesse ossessionando da mesi.

Poi ho aggiunto una piccola cosa: clicchi su un nodo qualsiasi e vedi Depends on (da cosa dipende) e Imported in (dove viene importato) per quel file, più i commit recenti che lo hanno modificato. Indovina quale parte apro ogni giorno adesso?

Con un codice delle dimensioni che ha raggiunto Patcherly, è il modo in cui rispondo in fretta alla domanda “cosa si rompe se cambio questo?” senza cercare con grep tra centinaia di file. Puoi anche cliccare su un gruppo nella legenda e l’intera cartella si illumina mentre tutto il resto si attenua, comodo quando ti stai chiedendo “con cosa parla davvero il modulo dei pagamenti?” e vuoi la risposta a colpo d’occhio.

Quindi l’animazione è la parte bella, e l’inspector è quella che si guadagna il posto… cosa che non era affatto nei piani.

Quattro temi, da cambiare al volo

Stessi dati, quattro look completamente diversi, perché una volta costruito il motore sarebbe stato un delitto non farlo (e perché evidentemente non avevo già abbastanza da fare).

  • Galaxy: spazio profondo, stelle luminose, onde da supernova. È il tema predefinito, e il mio preferito.
  • Organic: cellule bioluminescenti che respirano in un azzurro tenue, particelle di luce che scorrono lungo i filamenti.
  • Neural: geometrie al neon su una griglia da circuito stampato, onde d’urto esagonali a ogni commit.
  • Minimal: carta color crema, inchiostro sobrio, tipografia curata. Quello “serio”, per quando devi mostrarlo in riunione.

Cos’altro c’è dentro

  • Timeline con play e pausa, velocità variabile e salto in un clic allo stato finale del repository.
  • Inquadratura automatica che tiene sempre in vista il grafo mentre cresce, più zoom e spostamento su desktop e mobile.
  • WebGL quando il grafo diventa grande (territorio Patcherly), e Canvas, con un bagliore più bello, per i repository più piccoli.
  • Esportazione dell’animazione come video WebM o GIF animata, con nome del repository, data del commit e autore principale impressi sopra. Perfetta per un post, una presentazione, o per spiegare finalmente agli amici non sviluppatori che cosa fai tutto il giorno.

Provalo sul tuo repository

La demo online usa un set di dati sintetico, così puoi giocare subito con i temi. Per usarlo sul tuo codice basta un minuto:

git clone https://github.com/Jany-M/repo-visualizer
cd repo-visualizer
npm install
npm run analyze -- /path/to/your/repo
npm run dev

L’analizzatore percorre l’intera storia di git, legge gli import in JS/TS, Python, Go, Rust, Java/Kotlin, Ruby, PHP e CSS/SCSS e scrive il risultato in public/data/history.json . La web app lo carica al refresh successivo.

Non c’è nessun server, niente esce dal tuo computer, e con un file repovisualizer.config.json puoi escludere i percorsi che non vuoi nel quadro.

È distribuito con licenza GPL3, quindi provalo pure sul tuo repository, e se il risultato è bello mandami una clip! Mi piacerebbe un sacco vedere il tuo codice sotto forma di galassia.


Il progetto da cui è partito tutto, Patcherly, è disponibile! Intercetta i bug in produzione e li corregge in tempo reale, in pochi secondi.

Jany Martelli · Shambix

Scritto dal CTO del team di ingegneri Shambix: app su misura, agenti AI, WordPress e WooCommerce, cloud e AI privata dal 2009.

Jany Martelli progetta i sistemi dietro i business digitali: architetture cloud, piattaforme e-commerce e agenti AI che fanno lavoro reale. Oltre 17 anni e più di 250 progetti con Shambix, per team che vanno da Xiaomi a Hilton. Una formazione in informatica, l'insegnamento e Patcherly, l'AI che corregge da sola i bug in produzione.

App Custom

Hai un progetto in mente? Realizziamolo nel modo giusto.

Raccontaci i tuoi obiettivi. Al resto pensiamo noi.

  • Ogni richiesta viene letta da un ingegnere senior
  • Se non siamo i partner giusti, ve lo diciamo
  • info@shambix.com
Nome

Di solito rispondiamo entro 24 ore. Niente newsletter, niente spam.