Treballant amb Bazaar

Prerequisit estar registrat en http://launchpad.net i http://launchpad.net/~edutictac

També és necessari instal·lar bazaar. Amb ubuntu:

apt-get install bzr

Una lectura previa recomanable és Bazaar en cinco minutos

Configuració inicial

bzr whoami "Pedro Páramo <email@example.com>"

Així el commit té nom

Utilitzar un repositori LOCAL

Per fer el teu propi branch.

1. Arrancar el repositori (internament crea una carpeta oculta .bzr).

bzr init

2. Per afegir tot el que n'hi ha al directori

bzr add

Podem afegir no més el arxius que ens interesse amb (*.cpp *.h etc).

3. Per a vorer els canvis realitzats

bzr status

4. ¡APLICAR CAMBIS!: Afegir aquesta versió al repositori

bzr commit -m "mensaje"

El codi ja està baix versions. 

Pujar el codi a launchpad

Primer tenim que identificarnos

bzr launchpad-login EL-TEU-NOM-D'USUARI-EN-LAUNCHPAD

Ens col·loquem en la carpeta a on tenim el codi i escribim

bzr push lp:~edutictac/+junk/ratolijclic

Depenent de la branch "ratolijclic" canvia. En la pàgina del Launchpad indica el codi necessari per a cada branca si la branca ja existix n'hi ha que afegir --use-existing

bzr push --use-existing lp:~edutictac/+junk/ratolijclic 

Com podeu observar també podeu descarregar-la amb 

bzr branch lp:~edutictac/+junk/ratolijclic

Sincronitzar el nostre treball

N'hi ha varies opcions, pots pujar les modificacions a una nova branca de launchpad amb bzr push i després convinar els canvis amb bzr merge, també tens la opció de baixar directament els canvis amb bzr pull

Treballar amb un repositori compartit

N'hi ha dos possibilitats, "branch" o "checkout". Amb el primer pots fer commits locals sense internet; amb el segon no.

Anem de fàcil a més difícil

Amb checkout (como svn)

Baixar

bzr checkout http://launchpad.net/~nombre-equipo/hdlorean/nombre-branch carpeta-desti

Modificar

A partir de aquí, todo es igual que para un local repositorio local (bzr add, bzr commit, etc). Pero para hacer commit necesitas estar conectado a internet y te pedirá user / password.

Si al hacer commit alguien ha tocado en el repositorio ya, te obligará a bajarte los últimos cambios con update (y si hay conflictos te obliga a resolverlos) antes de subirlos.

CUIDADO! Si el checkout es del http, no debería dejarte subir nada salvo con bzr+ssh que va autenticado!!! Y no hemos especificado a dónde subirlo…

Amb branch

Lo que aquí cuento es aplicable a mezclar tu branch con el del equipo, y gestionar conflictos.
Hay dos formas de hacerlo: una, mezclar directamente sobre tu trabajo (parecido a svn update). La otra es bajarte el código del equipo en un branch y hacer un branch "de trabajo" de ese branch, para luego mezclarlos.

Baixar

bzr branch http://launchpad.net/nombre-equipo/hdlorean/branch-concreto

Lo de carpeta destino funciona por defecto. Alternativamente con bzr+ssh (más eficiente).
Desde este momento tienes un branch local que va asociado a dónde te lo has bajado.

Modificar

Igual que en local. Importante terminar con el commit, si no no has hecho nada!!

Baixar cambis

bzr pull

Solo funciona si no hay cambios locales (cuidado, esto no es svn update, el merge no es automático). Por ejemplo, si al acabar de currar has subido con push, el siguiente paso puede ser un pull.

Convinar branches (es fa en LOCAL sempre)

Pasar cambios de un branch a otro que tienes en el disco duro. Si un branch va en internet creo que se baja los últimos cambios, intenta mezclar con los tuyos y solo te avisa en los conflictos él solito.

bzr merge ruta-al-destino
bzr commit -m "mezclados branch sobre el que trabajaba en local y branch destino"
Atención al merge: ruta-al-destino es de dónde quieres coger los cambios. Por ejemplo:

Si tú tienes un origen (digamos un checkout de lo del equipo) y haces un branch para trabajar tú, el merge tendrías que hacerlo en el origen y contra el branch (cd origen; bzr merge ../branch-del-origen); al menos a mí me está funcionando así.
Si, sin embargo, estás trabajando contra el branch del equipo, los cambios los cogerías de ahí y por tanto tu ruta al destino sería bzr+ssh://<me>@bazaar.launchpad.net/~nombre-equipo/hdlorean/branch-concreto
Es el comando delicado así que hay que tener un poco de ojo hasta que nos aclaremos; recomiendo tener una copia de con lo que se trastee antes por si acaso…

Ejemplo práctico

Yo estoy trabajando con un compañero en una asignatura, y tengo un servidor en bzr+ssh://direccion/repo/asignatura . Desafortunadamente mi compañero usa eclipse 3.2 y yo tengo instalado ya el 3.3, así que si ponemos todo el workspace bajo control de versiones nos pisaríamos (ya que los proyectos de CDT 4 no son compatibles con los de 3.2; al abrir un proyecto antiguo lo actualiza). Sin embargo nos interesa tener el workspace con control de versiones porque así los pull se bajan todas las carpetas de las prácticas y no hay que ir una a una.

¿Solución? Una sería excluir cuando yo trabaje la configuración de los proyectos… O dejarme de eclipses nuevos y leches :). Pero hay otras.

Por ejemplo: hago el proyecto inicial en 3.2; creo el workspace, lo pongo bajo control de versiones, y lo subo con bzr push. Pero luego me creo un branch de ese workspace: bzr branch old-ws nuevo-ws. Ahora tengo una versión que "comparto" con mi compañero, old-ws, y una mía donde trabajo, nuevo-ws.

Mis commits van a mi versión local, y cuando quiero pasarle los cambios me voy a old-ws y hago bzr merge ../nuevo-ws. El resultado:

M pr1/.project
M pr1/.settings/org.eclipse.cdt.core.prefs
M pr1/Debug/makefile
M pr1/Debug/objects.mk
M pr1/Debug/sources.mk
M pr1/src/escena.cpp
M pr1/src/escena.h
M pr1/src/skel.cpp
All changes applied successfully.
Los cambios están en el workspace antiguo y podría subirlos con bzr push directamente. Pero ojo! está machacando el .proyect y las preferencias de cdt porque detecta que son más nuevos; volvemos al problema original!

No obstante puedo hacer: bzr revert pr1/.project y bzr revert pr1/.settings/org.eclipse.cdt.core.prefs, y ya solo subiría mis cambios en el código y no en los archivos de configuración del proyecto…

Siempre puedo ver qué está pasando con bzr status en cada repo.

En el antiguo:

bzr status
modified:
pr1/Debug/makefile
pr1/Debug/objects.mk
pr1/Debug/sources.mk
pr1/src/escena.cpp
pr1/src/escena.h
pr1/src/skel.cpp
pending merges:
Jisakiel 2007-11-04 funcionando anidar rectángulos
Jisakiel 2007-11-04 tocando lo de los rectángulos, por alguna razón no m...
Y en el nuevo, después de commitear en el antiguo y mergearme los cambios:

bzr status
unknown:
pr1/.cdtbuild_initial
pr1/.cproject
pr1/.project_initial
pending merges:
Jisakiel 2007-11-04 problema del bzignore apañado
Jisakiel 2007-11-04 problema del bzignore apañado
Los .project de ambos son diferentes no obstante!.

estoy trabajando sobre este ejemplo de uso, ya contaré novedades y aclararé mis ideas según avance

Subir cambios

bzr push bzr+ssh://<me>@bazaar.launchpad.net/~nombre-equipo/hdlorean/branch-concreto

Con el comando estás subiendo como usuario <me> al espacio del equipo. Si hay conflictos, al igual que pull, te avisa diciéndote que las versiones han divergido, que uses merge.

Comandaments útils

Vorer que ha canviat en un arxiu

bzr diff

Vorer història de revisions

bzr log

Des fer un canvi

bzr revert

Borrar un arxiu (queda versionat)

bzr remove

Per a borrar un arxiu i que no quede versionat:

bzr uncommit

Vorer conflictes

bzr conflicts

Marcar conflictes com a resolts

bzr resolve

Ignorar archius:

Llista arxius a ignorar

.bzignore

Útil para que no haya que excluirlos a mano cuando eliges qué versionas. Así no ocupamos espacio ni ancho de banda de más (y creedme, si empiezas a dejar los .exe y .obj se come un montonazo porque se generan muchos).

Por ejemplo:

• .o
  *~
  *.tmp
  *.py[co]

TODO: Escribir este archivo para nuestros chicos ;) Para que no haya que meter nada más de lo necesario (cuidado con las autotools que casi todo salvo configure.ac y Makefile.am se genera *solito* )

Ver qué has ignorado:

bzr ignored
Y otra cosa útil:

bzr add .bzrignore
bzr commit -m "Add ignore patterns"

Para que el archivo de ignore también esté versionado ;).

Interfaces gráficas (GUI)

El que lo tenga en sus repos: bzr-config con sus ventanitas para configurarlo (no hace mucha falta, con hacer la inicialización…).

También está bzr-gtk. Creo que es todo lo que he contado, pero más automático (pinta iconitos para ver qué ha cambiado, puede hacer los merge con una herramienta de diff…).

Adaptació de: http://hdlorean.wikidot.com/tutoriales:bazaar