Introduzione

Bazaar è un sistema di controllo di versione distribuito creato da Canonical ed utilizzato anche su Launchpad per lo sviluppo dei progetti software.

Installazione

Installare il pacchetto bzr.

È necessario identificarsi digitando il seguente comando in una finestra di terminale:

bzr whoami "Nome Cognome <indirizzo_email>"

Per verificare l'identità impostata digitare il comando:

bzr whoami

Creazione di un nuovo progetto

Creazione di un repository

Per creare un nuovo repository occorre utilizzare il comando init-repo:
```
bzr init-repo nome_del_repo
```

Creazione di un branch

Per creare un branch, duplicato del progetto sul quale poter apportare modifiche parallelamente al ramo principale, viene utilizzato il comando init.
Occorre posizionarsi nella directory del repository e digitare il comando:
```
bzr init nome_del_repo/nome_del_branch
```

Gestione del branch

Nei successivi capitoli vengono passate in rassegna le operazioni più comuni sulla gestione dei branch: aggiungere/rimuovere file al controllo di revisione, confrontare i file delle diverse revisioni, ecc..

Nei seguenti comandi si suppone di essere posizionati all'interno della directory che contiene il branch, di solito ~/nome_del_repo/nome_del_branch.

Gestione di file

add

Il comando add serve per aggiungere un file al controllo di versione.
```
bzr add nome_del_file
```

remove

Il comando remove rimuove un file al controllo di versione.
```
bzr remove nome_del_file
```

Gestione delle revisioni

commit

Il comando commit salva un'istantanea (detta revisione) dei file sotto il controllo di versione. La sintassi è la seguente:
```
bzr commit -m "Descrizione delle modifiche fatte"
```
Per lasciare un semplice messaggio nei log è sufficiente digitare:
```
bzr commit -m "Messaggio" --unchanged
```

uncommit

Il comando uncommit rimuove una revisione dai log.
```
bzr uncommit numero_della_revisione
```

log

Il comando log visualizza i log del branch.
```
bzr log
```

diff

Il comando diff, nella sua sintassi base, confronta i file attuali con quelli dell'ultima revisione.
```
bzr diff
```
Per indicare con quale revisione effettuare il confronto, utilizzare la seguente sintassi:
```
bzr diff -r[numero_di_revisione]
```

Per confrontare due revisioni qualsiasi digitare:

bzr diff -r[numero_di_revisione_1]..[numero_di_revisione_2]

Unione di branch

merge

Il comando merge combina le revisioni di due branch diversi.
```
bzr merge directory_del_branch_da_unire
```

pull

Il comando pull aggiorna le revisioni di un altro branch con quelle del branch in uso.
```
bzr pull directory_del_branch_da_aggiornare
```

Funziona solo se il branch da aggiornare ha meno revisioni di quello in uso.

Interazione con branch esterni

Il comando launchpad-login effettua il login su Launchpad tramite ssh.
```
bzr launchpad-login nick_launchpad
```
Prima di poterlo usare bisogna aver configurato una chiave ssh a questo indirizzo.

branch

Il comando branch scarica un branch esterno sul computer.
```
bzr branch url
```
Per l'utilizzo tramite Launchpad occorre aver effettuato il login e quindi sfruttare questa particolare sintassi:
```
bzr branch lp:~proprietario/progetto/branch
```

push

Il comando push carica un branch in un server esterno.
```
bzr push url
```
Per l'utilizzo tramite Launchpad occorre aver effettuato il login e quindi sfruttare questa particolare sintassi:
```
bzr push lp:~proprietario/progetto/branch
```

Ulteriori risorse

CategoryProgrammazione CategoryDaRevisionare

-  ⇤ ← Versione 1 del 15/09/2012 16.31.11 → 
  Dimensione: 3764
  Autore: PietroAlbini
  Commento:
+   ← Versione 23 del 13/10/2021 16.44.40 → ⇥
  Dimensione: 5824
  Autore: ivantu
  Commento:
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 1:
+## page was renamed from pietro98-albini/Prove/Bazaar
-Linea 5:
+Linea 6:
-<<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?t=511838"; rilasci="12.04")>>
+<<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?f=46&t=535359"; rilasci="12.04 17.04 17.10")>>
-Linea 9:
+Linea 10:
-[[http://bazaar.canonical.com/|Bazaar]] è il sistema di controllo di versione distribuito creato da Canonical e scritto in Python.

Bazaar è usato da [[https://launchpad.net|launchpad.net]] come sistema per la memorizzazione del codice.

Lo strumento per la gestione di Bazaar è '''bzr'''.
+'''Bazaar''' è un sistema di controllo di versione [[http://it.wikipedia.org/wiki/Controllo_versione_distribuito|distribuito]] creato da Canonical ed utilizzato anche su [[https://launchpad.net|Launchpad]] per lo sviluppo dei progetti software.
-Linea 17:
+Linea 14:
-Per prima cosa [[AmministrazioneSistema/InstallareProgrammi|installare]] il pacchetto [[apt://bzr|bzr]].
+[[AmministrazioneSistema/InstallareProgrammi|Installare]] il pacchetto [[apt://bzr|bzr]].
-Linea 19:
+Linea 16:
-Dopo aver installato il pacchetto bisogna identificarsi con questo comando, da eseguire in una finestra di [[AmministrazioneSistema/RigaDiComando|terminale]]:
+È necessario identificarsi digitando il seguente comando in una finestra di [[AmministrazioneSistema/RigaDiComando|terminale]]:
-Linea 23:
+Linea 20:
-Per verificare l'identità impostata bisogna dare quest'altro comando:
+Per verificare l'identità impostata digitare il comando:
-Linea 30:
+Linea 27:
-Per creare un nuovo repository Bazaar bisogna dare il seguente comando:
{{{
+== Creazione di un repository ==

 * Per creare un nuovo [[Repository|repository]] occorre utilizzare il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/init-repository-help.html|init-repo]]:{{{
-Linea 34:
+Linea 32:
-Poi, per la creazione di un branch eseguire il comando questo comando:
{{{
+== Creazione di un branch ==

 * Per creare un '''branch''', duplicato del progetto sul quale poter apportare modifiche parallelamente al ramo principale, viene utilizzato il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/init-help.html|init]].<<BR>>Occorre posizionarsi nella directory del repository e digitare il comando:{{{
 Linea 41:
-Per gestire un branch bisogna per prima cosa posizionarsi nella directory che lo contiene, di solito `~/nome_del_repo/nome_del_branch`
+Nei successivi capitoli vengono passate in rassegna le operazioni più comuni sulla gestione dei branch: aggiungere/rimuovere file al controllo di revisione, confrontare i file delle diverse revisioni, ecc..
 Linea 43:
-== Aggiunta di files ==
+{{{#!wiki note
Nei seguenti comandi si suppone di essere posizionati all'interno della directory che contiene il branch, di solito `~/nome_del_repo/nome_del_branch`.}}}
-Linea 45:
+Linea 46:
-Per aggiungere un nuovo file nel branch copiarlo nella cartella del branch e dare il seguente comando:
{{{
+= Gestione di file =

== add ==

 * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/add-help.html|add]] serve per aggiungere un file al controllo di versione.{{{
-Linea 50:
+Linea 54:
-== Modifica e rimozione di files ==
+== remove ==
-Linea 52:
+Linea 56:
-Per la modifica e rimozione dei files basta modificarli/eliminarli senza eseguire alcun comando.
+ * Il comando [[http://doc.bazaar.canonical.com/bzr.dev//en/user-reference/remove-help.html|remove]] rimuove un file al controllo di versione.{{{
bzr remove nome_del_file
}}}
-Linea 54:
+Linea 60:
-== Salvataggio delle modifiche ==
+= Gestione delle revisioni =
-Linea 56:
+Linea 62:
-Ogni volta che si ha modificato qualcosa è buona norma salvare le modifiche effettuate dando questo comando:
{{{
+== commit ==

 * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/commit-help.html|commit]] salva un'istantanea (detta revisione) dei file sotto il controllo di versione. La sintassi è la seguente:{{{
-Linea 61:
+Linea 68:
-||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/warning.png,,center)>> ||<style="padding:0.5em; border:none;">'''Una volta salvate, le modifiche non possono essere annullate.''' ||

Se si vuole semplicemente lasciare un messaggio nel branch (per esempio l'annuncio della fine del supporto del branch) bisogna dare quest'altro comando:
{{{
+ * Per lasciare un semplice messaggio nei log è sufficiente digitare:{{{
-Linea 68:
+Linea 72:
-= Interazione con launchpad.net =
+== uncommit ==
-Linea 70:
+Linea 74:
-[[https://launchpad.net|launchpad.net]] è il sito di sviluppo di Ubuntu. Tutto il codice è ospitato tramite Bazaar.

Prima di poter interagire con Bazaar bisogna aver un account [[https://login.ubuntu.com|Ubuntu SSO]]/launchpad.net e aver configurato sul proprio account una chiave ssh.

== Download di un branch ==

Per poter scaricare un branch da launchpad.net bisogna dare questo comando:
{{{
bzr branch lp:~nome_del_proprietario/progetto/branch
+ * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/uncommit-help.html|uncommit]] rimuove una revisione dai log.{{{
bzr uncommit numero_della_revisione
-Linea 81:
+Linea 78:
-== Upload di un branch ==
+== log ==
-Linea 83:
+Linea 80:
-||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/warning.png,,center)>> ||<style="padding:0.5em; border:none;">'''Assicurarsi di avere i permessi prima di caricare un branch.''' ||
+ * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/log-help.html|log]] visualizza i log del branch.{{{
bzr log
}}}
-Linea 85:
+Linea 84:
-Per caricare un branch posizionarsi nella root del branch e dare i seguenti comandi:
{{{
bzr launchpad-login tuo_nome_su_launchpad
bzr push lp:~tuo_nome_su_launchpad/progetto/branch
+== diff ==

 * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/diff-help.html|diff]], nella sua sintassi base, confronta i file attuali con quelli dell'ultima revisione.{{{
bzr diff
}}}

 * Per indicare con quale revisione effettuare il confronto, utilizzare la seguente sintassi:{{{
bzr diff -r[numero_di_revisione]
}}}

 * Per confrontare due revisioni qualsiasi digitare:{{{
bzr diff -r[numero_di_revisione_1]..[numero_di_revisione_2]
}}}

= Unione di branch =

== merge ==

 * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/merge-help.html|merge]] combina le revisioni di due branch diversi.{{{
bzr merge directory_del_branch_da_unire
}}}

== pull ==

 * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/pull-help.html|pull]] aggiorna le revisioni di un altro branch con quelle del branch in uso.{{{
bzr pull directory_del_branch_da_aggiornare
}}}

{{{#!wiki important
Funziona solo se il branch da aggiornare ha meno revisioni di quello in uso.}}}

= Interazione con branch esterni =

<<Anchor(launchpad_login)>>
== launchpad-login ==

 * Il comando [[http://doc.bazaar.canonical.com/plugins/en/launchpad-plugin.html#launchpad-login|launchpad-login]] effettua il login su Launchpad tramite ssh.{{{
bzr launchpad-login nick_launchpad
}}}

 Prima di poterlo usare bisogna aver configurato una chiave ssh a [[https://launchpad.net/people/+me/+editsshkeys|questo]] indirizzo.

== branch ==

 * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/branch-help.html|branch]] scarica un branch esterno sul computer.{{{
bzr branch url
}}}

 * Per l'utilizzo tramite [[https://launchpad.net|Launchpad]] occorre aver effettuato il [[#launchpad_login|login]] e quindi sfruttare questa particolare sintassi:
 {{{
bzr branch lp:~proprietario/progetto/branch
}}}

== push ==

 * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/push-help.html|push]] carica un branch in un server esterno.{{{
bzr push url
}}}

 * Per l'utilizzo tramite [[https://launchpad.net|Launchpad]] occorre aver effettuato il [[#launchpad_login|login]] e quindi sfruttare questa particolare sintassi:
 {{{
bzr push lp:~proprietario/progetto/branch
-Linea 97:
+Linea 154:
- * [[https://login.launchpad.net/+new_account|Registrazione a launchpad.net]]
 * [[https://launchpad.net/people/+me/+editsshkeys|Aggiungere una chiave ssh a launchpad.net]]
-Linea 101:
+Linea 156:
-CategoryNuoviDocumenti
+CategoryProgrammazione CategoryDaRevisionare