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

-  ⇤ ← Versione 6 del 22/09/2012 19.09.58 → 
  Dimensione: 4540
  Autore: pietroalbini
  Commento:
+   ← Versione 22 del 24/02/2019 19.15.27 → ⇥
  Dimensione: 5802
  Autore: dd3my
  Commento: nuovo stile note/avvisi/suggerimenti
-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?f=46&t=535359"; 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:
-== Gestione 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:
-=== add ===
+= Gestione di file =
-Linea 47:
+Linea 48:
-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.
+== add ==
-Linea 49:
+Linea 50:
-{{{
+ * 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 53:
+Linea 54:
-=== remove ===
+== remove ==
-Linea 55:
+Linea 56:
-Il comando [[http://doc.bazaar.canonical.com/bzr.dev/user-reference/remove-help.html|remove]] rimuove un file al controllo di versione.

{{{
+ * Il comando [[http://doc.bazaar.canonical.com/bzr.dev//en/user-reference/remove-help.html|remove]] rimuove un file al controllo di versione.{{{
-Linea 61:
+Linea 60:
+= Gestione delle revisioni =
-Linea 63:
+Linea 64:
-Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/commit-help.html|commit]] salva un'istantanea (detta revisione) dei files sotto il controllo di versione.<<BR>>
La sintassi è la seguente:

{{{
+ * 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 70:
+Linea 68:
-Se si vuole semplicemente lasciare un messaggio nei log bisogna dare quest'altro comando:
{{{
+ * Per lasciare un semplice messaggio nei log è sufficiente digitare:{{{
-Linea 77:
+Linea 74:
-Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/uncommit-help.html|uncommit]] rimuove una revisione dai log.
Il comando da utilizzare è questo:

{{{
+ * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/uncommit-help.html|uncommit]] rimuove una revisione dai log.{{{
-Linea 86:
+Linea 80:
-Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/log-help.html|log]] visualizza i log del branch.

{{{
+ * Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/log-help.html|log]] visualizza i log del branch.{{{
-Linea 94:
+Linea 86:
-Il comando [[http://doc.bazaar.canonical.com/bzr.dev/en/user-reference/diff-help.html|diff]], nella sua sintassi base, confronta i files attuali con quelli dell'ultima revisione.

{{{
+ * 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.{{{
-Linea 100:
+Linea 90:
-È possibile indicare con che revisione confrontare con la seguente sintassi:

{{{
+ * Per indicare con quale revisione effettuare il confronto, utilizzare la seguente sintassi:{{{
-Linea 106:
+Linea 94:
-C'è anche l'opzione per confrontare due revisioni:

{{{
+ * Per confrontare due revisioni qualsiasi digitare:{{{
-Linea 112:
+Linea 98:
-= Interazione con launchpad.net =
+= Unione di branch =
-Linea 114:
+Linea 100:
-[[https://launchpad.net|launchpad.net]] è il sito di sviluppo di Ubuntu. Tutto il codice è ospitato tramite Bazaar.
+== merge ==
-Linea 116:
+Linea 102:
-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/merge-help.html|merge]] combina le revisioni di due branch diversi.{{{
bzr merge directory_del_branch_da_unire
-Linea 125:
+Linea 106:
-== Upload di un branch ==
+== pull ==
-Linea 127:
+Linea 108:
-||<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/pull-help.html|pull]] aggiorna le revisioni di un altro branch con quelle del branch in uso.{{{
bzr pull directory_del_branch_da_aggiornare
}}}
-Linea 129:
+Linea 112:
-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
+{{{#!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 141:
+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 145:
+Linea 156:
-CategoryNuoviDocumenti
+CategoryProgrammazione