GitHub e le pull request
L'album online, e come ci si arriva in squadra
- 12 minuti di lettura
Finora l'album era tuo: le foto stavano sul tuo computer, dentro .git. Se il computer si rompe, l'album va con lui. E se Lucia e Marta devono lavorare sullo stesso tabellone, come si passano le foto?
Si usa un album online: una copia dell'album, su un computer sempre acceso che tutti raggiungono. Il più usato si chiama GitHub. Questo capitolo spiega come si parla con l'album online, e come si chiede ai colleghi di unire il proprio lavoro.
Servono i capitoli Il grafo, Branch e merge e I conflitti: qui i disegni e i merge sono quelli.
Due album, un disegno
Il tuo album e quello online sono due repository separati, con le stesse foto. Git ti aiuta a tenerli allineati, ma lo fa solo quando glielo chiedi.
sul tuo computer
C1 ◀── C2 ◀── C3 ◀── main ◀── HEAD
▲
origin/main
su GitHub
C1 ◀── C2 ◀── C3 ◀── mainL'album online, per Git, ha un nome: origin («origine»). È il nome che Git dà al posto da cui hai preso l'album. E origin/main è un'etichetta tua: ricorda dove stava main su GitHub l'ultima volta che hai guardato. Non è main di GitHub in diretta: è una fotografia di com'era.
Scaricare l'album: git clone
git clone github.git progettoclone scarica tutto l'album (tutte le foto, tutti i branch) in una cartella nuova e ti mette su main. Con GitHub vero al posto di github.git c'è l'indirizzo che copi dal pulsante verde Code. Per vedere a cosa sei collegato:
git remote -v # chi è origin: l'indirizzo dell'album online
git branch -a # i branch tuoi e quelli remoti (origin/…)I branch remoti compaiono come remotes/origin/nome. Sono le etichette «com'era l'ultima volta», non branch su cui lavori.
Mandare un branch: git push
Il tuo branch nuovo esiste solo sul tuo computer. Per mandarlo sull'album online:
git push -u origin festiviSi legge: «manda festivi a origin». Il -u (da upstream, «a monte») fa una cosa in più: collega il tuo festivi al festivi online. Basta una volta: da lì in poi git push e git pull da soli sanno dove andare. Senza -u, un branch nuovo risponde has no upstream branch.
Controllare e scaricare: git fetch e git pull
Intanto un collega ha mandato qualcosa su GitHub. Il tuo album non lo sa. Due comandi:
git fetch: guarda su GitHub e scarica le foto nuove, senza toccare la scrivania. Si sposta soloorigin/main; il tuomainresta dov'è.git pull: èfetche subito dopomerge. Scarica e porta le novità nel branch su cui sei.
dopo git fetch
C1 ◀── C2 ◀── C3 ◀── C4 ◀── origin/main
▲
main ◀── HEAD
dopo git pull
C1 ◀── C2 ◀── C3 ◀── C4 ◀── main ◀── HEAD
▲
origin/mainSe hai dubbi, prima fetch e guarda (git status ti dice se sei indietro), poi decidi. pull è lo stesso merge di Branch e merge, e un conflitto con pull si risolve come quello del capitolo I conflitti.
Il push respinto
Hai un commit nuovo e fai git push, ma un collega è arrivato prima, sullo stesso branch:
! [rejected] festivi -> festivi (fetch first)Vuol dire: «sull'album online ci sono foto che tu non hai». Git non vuole cancellarle per fare spazio alle tue. La cura è sempre la stessa: git pull (arrivano le sue foto, si fa un merge), poi git push. Niente --force: è l'unico comando che le cancella davvero.
La pull request
Un branch su GitHub non entra da solo in main. Si fa una pull request (PR, «richiesta di tirare dentro»): «ho finito, controllate e unite il mio branch». Non è git pull, è un'altra cosa: una richiesta tra persone, fatta sul sito.
Una PR ha due estremi: la base, il branch che deve ricevere, e il compare, il tuo branch. Dopo un git push del tuo branch, su GitHub compare il pulsante Compare & pull request. Dal terminale:
gh pr create --base main --fillgh è lo strumento di GitHub da riga di comando. --base dice verso dove va la PR, --fill riempie titolo e testo con il messaggio del tuo commit. Se la PR deve andare a un branch di squadra, scrivi quello: --base squadra-menta.
Hai sbagliato la base? Su GitHub, in cima alla PR, il pulsante Edit cambia la base; da terminale gh pr edit --base squadra-menta. Non serve rifare il branch.
La review
Ernesto Pozzi, il capo deposito, è il revisore. La review («revisione») si fa in tre mosse:
- Leggi: nella scheda Files changed vedi riga per riga cosa cambia, in rosso e verde come
git diff. - Commenta: su una riga, con una domanda o un consiglio. Si commenta il codice, mai la persona.
- Decidi: Review changes → Approve (va bene) oppure Request changes (va cambiato qualcosa: chi ha fatto la PR corregge, fa push, e il revisore guarda di nuovo).
Con l'Approve compare Merge pull request: crea il commit di merge sul GitHub. Il pulsante può essere grigio: di solito manca l'approvazione, o c'è un conflitto (la PR dice This branch has conflicts that must be resolved: porta main nel tuo branch, risolvi, push).
I branch protetti
Sui progetti seri main è protetto: nessuno ci scrive direttamente, nemmeno chi è il capo. Chi prova con git push si sente rispondere:
remote: error: GH006: Protected branch update failed for refs/heads/main.Non è un guasto: è la regola. Si lavora su un branch (git switch -c nome: il commit che hai già fatto viene con te), si fa push di quello, si apre la PR.
Dopo il merge
La PR è stata unita su GitHub. Il tuo computer non lo sa. Tre comandi per rimettere in ordine:
git switch main
git pull
git branch -d festivipull porta su main il commit di merge (un fast-forward, se non hai fatto altro su main). branch -d butta l'etichetta del branch ormai unito.
Il GitHub finto degli esercizi
Negli esercizi di questo capitolo non c'è nessun sito: github.git è una cartella accanto al tuo progetto. Per Git è un album online come un altro: clone, push, fetch, pull funzionano uguale. La PR la fa lo script unisci-pr.sh: è Ernesto che approva e preme Merge pull request. Tu fai tutto il resto, comandi veri compresi.
Ricorda
- GitHub è un album online.
originè il suo nome per Git;origin/mainè dove tu sai che stamainonline. git clonescarica tutto.git push -u origin nomemanda un branch nuovo e lo collega.git fetchguarda e scarica, senza toccare la scrivania.git pullèfetche merge.- Push respinto con
fetch first: primagit pull, poigit push. Mai--force. - Una pull request ha una base (chi riceve) e un compare (il tuo branch). Si decide la base prima di aprirla.
- La review: leggi, commenta, Approve o Request changes. Poi Merge pull request.
- Dopo il merge:
git switch main,git pull,git branch -d nome.