Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Git5. GitHub e le pull requestp. 99

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 ◀── main

L'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

Terminale
git clone github.git progetto

clone 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:

Terminale
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:

Terminale
git push -u origin festivi

Si 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 solo origin/main; il tuo main resta dov'è.
  • git pull: è fetch e subito dopo merge. 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/main

Se 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:

Terminale
gh pr create --base main --fill

gh è 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:

  1. Leggi: nella scheda Files changed vedi riga per riga cosa cambia, in rosso e verde come git diff.
  2. Commenta: su una riga, con una domanda o un consiglio. Si commenta il codice, mai la persona.
  3. 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:

Terminale
git switch main
git pull
git branch -d festivi

pull 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 sta main online.
  • git clone scarica tutto. git push -u origin nome manda un branch nuovo e lo collega.
  • git fetch guarda e scarica, senza toccare la scrivania. git pull è fetch e merge.
  • Push respinto con fetch first: prima git pull, poi git 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.