# Guida all'utilizzo Bitbucket (Git)

### N.B. la guida non è completa, sono presenti solo le operazioni base, le altre operazioni, saranno sviluppate successivamente

## Indice
- Bitbucket
- [Git](#Git)
- Guida all'installazione
- Comandi di base
- clone repo
- commit
- push
- pull
- Sourcetree
- [Clone da remoto](#Clone-da-remoto)
- [Clone mediante account Bitbucket](#Clone-mediante-account-Bitbucket)
- [Gestire un repository](#Gestire-un-repository)
- [Commit e Push](#Commit-e-Push)
- [Fetch e Pull](#Fetch-e-Pull)

## Bitbucket

Nella sezione **Repository**, sono presenti tutti le repository a cui si ha accesso.
Nella sezione **Progetti** si possono visualizzare tutti i progetti a cui si ha accesso, dove ogni progetto è un contenitore di repository.

### Creare una nuova Repository

Per creare una nuova Repository, da Bitbucket, si clicca sull'icona plus (+) presente sulla sinistra, dal menù che viene mostrato, selezionare l'opzione Repository.

Nella mascherà che verrà visualizzata, coorre indicare il Workspace e il Progetto a cui appartiene. Occorre poi indicare un nome per la repository.

## Git
Git, risulta essere uno dei più diffusi software di controllo versione, il che permette di versionare il codice realizzato e facilitare la collaborazione tra i diversi sviluppatori che lavoro allo stesso software.
Git è disponibile per le varie distribuzioni di sistemi operativi, è quindi disponibile per Windows, MacOs e Linux ed è scaricabile dal sito ufficiale:
- https://git-scm.com/

### Clone
Per clonare una repo, da riga di comando, occorre utilizzare il comando

`
git clone indirizzo_del_repository`

Il clone, esegue una copia del repository remoto in locale.

## Sourcetree
Sourcetree, è una delle tante interfaccie grafiche, per l'utilizzo di Git. Sourcetree è distribuito dalla stessa casa proprietaria di Bitbucket e risulta essere funzionante anche per GitHub.
### Clone da remoto
Per clonare un repository da remoto, mediante Sourcetree, aprire un nuovo Tab dal pulsante + in alto. Una volta in una nuova tab, la repo può essere clonata in due modi, mediante il proprio account Bitbucket, oppure mediante URL.


##### Clone mediante account Bitbucket
Per clonare un repository, mediante account Bitbucket, occorre cliccare sul pulsante Remote.


Verra mostrata una nuova maschera, dove verranno visualizzate una serie di repo, legate all'account remoto, organizzate sulla base del Workspace.
Una volta individuata la repo interessata dall'elenco, occorre cliccarre sull'opzione Clone, posta in basso a destra dell'emento interessato.


Dopo aver cliccato su Clone, verrà mostrata una maschera, dove si potrà decidere la destinazione in locale della repo. Una volta indicato il percorso in cui clonare la repo, si potrà proseguire, cliccando sul tasto clone.


### Gestire un repository
Dopo aver clonato una repository, mediante Sourcetree, e possibbile eseguire su di essa, le classiche orazioni di Fetch, Pull, Commit e Push.


#### Commit e Push
Quando vengo apportate delle modifiche a dei file, essere risultano visibili all'interno di Sourcetre.


Possono essere fatti anche più commit su file diversi, in tal caso se si vuore effettuare un unico commit con tutti i file (come con `git commit -A`), allora si potrà cliccare sul pulsante `Tutto in stage`, in caso contrario, si potranno inserire anche i songoli file cliccando sul pulsante `+` accanto ad ogni file.
Una volta messi in stage i file, si può eseguire il commit, cliccando sul `Commit`, in alto a sinistra.


La maschera che verrà visualizzata, mostrerà nuovamente i vari file modificati e sarà possibile aggiungere una descrizione del relativo Commit, nella textarea in basso. Dopo aver documententato il commit, sarà possibile cliccare sul tasto commit in basso a destra.

Una volta eseguiti i vari commit, per poter rendere visibili le modifiche, occerrerà effettuare l'operazione di `Push`, mediante il tasto `Invia`, presente nella parte alta.
una volta cliccato sul tasto inva, verrà visualizzato un modale, contentenente le infomazioni di riepilogo del Push.


Qui sarà necessario cliccare sul tasto `Invia`, per poter eseguire il Push.

#### Fetch e Pull
L'operazione di `Fetch`, permette di sincronizzare le modifiche presenti in remoto, con quelle in locale. Tale operazione tuttavian, non effettua un download delle modifiche, per tale motivo, per eseguire il download delle modifiche, occorre eseguire il Pull (in Sourcetree `Ricevi`).


Una volta eseguito l'operazione di Fetch, verranno mostrati i nuovi commit presenti sul repository remoto.


Sul pulsante Ricevi, verra visualizzato un counter che indica il numero di nuovi commit presenti in remoto.