Questo post è dedicato a chi, come me, ha un po' di repository su github e o collabora con un team, oppure ha più pc sui quali vuole passarsi le ultime novità.
Vi parlo di due funzioni che ho sviluppato che si sono rese necessrie (se non fondamentali) per tenere in ordine le repo locali.
Queste funzioni si chiamano repoinfo e topush, e si trovano nel file git-info.sh della repo su github. Vediamole assieme!

Repoinfo

Partiamo da repoinfo. Questa funzione è nata proprio perchè volevo sapere se l’ultimo commit pushato fosse stato fatto da un pc o da un’altro, in modo tale da sapere se dovessi pullare prima di mettermi a lavorare o meno.
Ma cosa fa? Il concetto è semplice: tramite l’API di github printa sullo schermo una riga per ogni repo di github, anche quelle private, contenente le seguenti informazioni sull'ultimo commit:
Nome repo: pushed by autore commit on data commit at ora: commit message.

Una volta scaricato il file, bisognerà prima settare 2 impostazioni:

La prima è il proprio token di github (se non sapete cosa sia o dove trovarlo, qui c'è la spiegazione), la seconda è il proprio username su github. Queste informazioni sono fondamentali per accedere all'API.

Una volta settati questi parametri, basterà lanciare il comando repoinfo sul terminale e il gioco è fatto. Ricordo di guardare il README.md file della mia repo per le istruzioni sulla corretta “installazione” delle funzioni.

Topush

Passiamo ora a topush. Questa funzione è nata con l’idea di vedere se ci fossero file untracked o commit da pushare tra le varie repo locali. In pratica, la funzione cerca tutte le repo git locali, e per ognuna vede se ci sono file non tracciati, non aggiunti al commit o commit da pushare.
Quello che viene printato a schermo è il risultato del comando git status -bs –ahead-behind per ogni repo, accompagnato dal nome della repo.

Ecco qui un esempio:

In immagine ho applicato un effetto blur sui dati "sensibili". Sotto il numero c'è il nome della repo, seguita dal nome della branch locale e di quella remota (riga sotto visibile). Poi vediamo come nella repo numero 1 ci sia un file modificato ma non aggiunto ad una commit; mentre la repo 2 è a posto e la 3 invece presenta file mai tracciati.

Importante: Per come funziona questa funzione, può essere che esca un file “temp-pull.txt” (che se notate bene è l’ultimo file in figura) come non tracciato. Non dovete preoccuparvi, esso è un file temporaneo che in realtà viene cancellato alla fine della funzione.

In questo caso c'èun solo settaggio da fare, ovvero quello di aggiungere eventuali nomi di cartelle da non tracciare nella funzione (si trova tutto scritto nello script). Questo per evitare che escano tutte le repository non vostre, ma che avete perchè utili per voi (per esempio plugin di vim o altre).

Miglioramenti futuri

Come ogni funzione che si rispetti, ci sono sicuramente delle migliorie apportabili. In questo caso riguardano le branch. Infatti, entrambe le funzioni tracciano solo le branch attive in quel momento.
Per quanto riguarda la funzione repoinfo, sarà più facile fare in modo di avere una lista di ogni repo ed ogni branch, mentre per la funzione topush questo è complicato, dal momento che non si può fare il checkout dalla branch attiva se ci sono file aggiunti ma non commit, o file neanche aggiunti o mai tracciati.
Sarà una bella “sfida”. Quindi, come al solito: stay tuned!