Fork e Pull Request in Git

Codegrind Team•Aug 28 2024

Fork e pull request sono strumenti essenziali per contribuire a progetti open source e per collaborare su GitHub, GitLab, e altre piattaforme di hosting Git. Quando desideri proporre modifiche a un progetto su cui non hai accesso diretto, fai un fork del repository, crei le modifiche nel tuo fork e poi invii una pull request per proporre le tue modifiche al repository originale. In questa guida, esploreremo come utilizzare fork e pull request in Git, con esempi pratici per contribuire in modo efficace a progetti collaborativi.

Cos’è un Fork?

Un fork è una copia di un repository che si trova sotto il tuo account GitHub o GitLab. Quando fai un fork di un repository, crei una copia completa del progetto, compresa la cronologia di commit, i branch, e i tag. Questa copia è indipendente dal repository originale, il che ti permette di sperimentare e apportare modifiche senza influenzare il progetto principale.

Creare un Fork di un Repository

Per creare un fork di un repository, segui questi passaggi:

Creare un Fork su GitHub

Trova il Repository: Vai al repository che desideri forkare su GitHub.
Clicca su Fork: In alto a destra della pagina del repository, clicca sul pulsante Fork.
Seleziona l’Account: Se hai accesso a più account o organizzazioni, scegli dove vuoi creare il fork.
Fork Completo: GitHub creerà una copia del repository nel tuo account. Ora hai un repository forkato che puoi modificare liberamente.

Clonare il Fork Localmente

Dopo aver creato il fork, puoi clonare il repository forkato sul tuo computer per iniziare a lavorare:

git clone https://github.com/tuoaccount/nome-repository.git

Questo comando clona il repository forkato nella tua macchina locale.

Fare Modifiche nel Fork

Ora che hai il repository forkato localmente, puoi iniziare a fare modifiche al codice. Ecco un flusso di lavoro tipico:

Creare un Nuovo Branch

Prima di fare modifiche significative, crea un nuovo branch per isolare il tuo lavoro:

git checkout -b nome-branch

Apportare le Modifiche

Fai le modifiche necessarie nel codice. Una volta completate, aggiungi le modifiche all’area di staging e crea un commit:

git add .
git commit -m "Descrizione delle modifiche"

Pushing del Branch al Fork

Invia il tuo branch modificato al tuo fork su GitHub:

git push origin nome-branch

Questo comando invia il branch modificato al repository remoto (il tuo fork).

Creare una Pull Request

Una volta che hai apportato le modifiche nel tuo fork e le hai inviate a GitHub, puoi creare una pull request per proporre le tue modifiche al repository originale.

Creare una Pull Request su GitHub

Vai al Repository Forkato: Sul tuo account GitHub, vai al repository forkato.
Clicca su Contribute: Vedrai un pulsante Contribute o Compare & pull request. Cliccalo.
Rivedi le Modifiche: Controlla che le modifiche siano quelle che desideri proporre.
Aggiungi un Titolo e una Descrizione: Fornisci un titolo chiaro e una descrizione dettagliata della tua pull request.
Clicca su Create Pull Request: Quando sei pronto, clicca sul pulsante per creare la pull request.

Specificare la Base e la Destinazione della Pull Request

Quando crei una pull request, specifichi il branch di destinazione nel repository originale (ad esempio, main) e il branch di base nel tuo fork (ad esempio, nome-branch).

Gestire e Aggiornare la Pull Request

Dopo aver creato la pull request, potrebbe essere necessario rispondere ai commenti dei manutentori del progetto o apportare ulteriori modifiche.

Aggiornare una Pull Request

Se ti viene richiesto di apportare modifiche alla tua pull request:

Fai le Modifiche nel Branch: Torna al branch su cui hai lavorato, apporta le modifiche richieste, e fai un commit.
Invia le Modifiche Aggiornate: Esegui il push del branch aggiornato al tuo fork:
```
git push origin nome-branch
```

Le modifiche verranno automaticamente aggiunte alla pull request esistente.

Chiudere o Cancellare una Pull Request

Se la tua pull request non è più necessaria o vuoi ritirarla, puoi chiuderla direttamente dalla pagina della pull request su GitHub.

Sincronizzare il Fork con il Repository Originale

Col tempo, il repository originale potrebbe ricevere nuove modifiche. È importante mantenere il tuo fork aggiornato rispetto al repository originale.

Aggiungere il Repository Originale come Remote

Per sincronizzare il tuo fork, devi prima aggiungere il repository originale come remote nel tuo repository locale:

git remote add upstream https://github.com/originaluser/original-repository.git

Eseguire Fetch e Merge

Recupera le ultime modifiche dal repository originale:

git fetch upstream

Unisci le modifiche nel tuo branch locale:

git checkout main
git merge upstream/main

Pushing delle Modifiche al Fork

Infine, invia le modifiche aggiornate al tuo fork:

git push origin main

Best Practices per Fork e Pull Request

Crea Branch Descrittivi: Usa nomi di branch che descrivono chiaramente lo scopo del lavoro, come feature/login-page o bugfix/issue-123.
Mantieni il Fork Aggiornato: Sincronizza regolarmente il tuo fork con il repository originale per evitare conflitti e mantenere il tuo lavoro aggiornato.
Scrivi Messaggi di Commit Chiari: Ogni commit dovrebbe avere un messaggio chiaro e descrittivo che spieghi cosa è stato fatto.
Rispondi ai Feedback: Se i manutentori del progetto ti forniscono feedback, rispondi prontamente e apporta le modifiche richieste.

Risolvere Problemi Comuni

Conflitti Durante il Merge

Se riscontri conflitti durante il merge del repository originale nel tuo fork, risolvi i conflitti manualmente e completa il merge:

git add .
git commit

Pull Request Rifiutata

Se la tua pull request viene rifiutata, non scoraggiarti. Leggi attentamente il feedback, apporta le modifiche necessarie e invia una nuova pull request.

Conclusione

Fork e pull request sono strumenti potenti che ti permettono di contribuire a progetti open source e collaborare in modo efficiente su GitHub e altre piattaforme Git. Seguendo i passaggi descritti in questa guida, sarai in grado di fare un fork di un repository, apportare modifiche, e inviare pull request in modo efficace. Questo processo non solo ti aiuta a contribuire a progetti esistenti, ma migliora anche le tue competenze nel lavorare in ambienti collaborativi.