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. Anar al repositori que v

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

bzr init

3. 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).

4. Per a vorer els canvis realitzats

bzr status

5. ¡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

bzr push lp:~edutictac/+junk/ratolijclic

Depenent de la brach "ratolijclic" canvia

Com podeu observar també podeu descarregar-la amb 

bzr branch lp:~edutictac/+junk/ratolijclic

Sincronitzar el nostre treball

Se parece a mezclar branches con tu grupo de trabajo: Primero lo subes a internete con bzr push, luego lo mezclas cambios de uno y otro con bzr merge, o alternativamente te bajas directamente en el que no tiene los nuevos con bzr pull.

Trabajar contra un repositorio compartido

Ver propuesta modelo desarrollo. Hay dos posibilidades, según tengas un "branch" o un "checkout". Con el primero haces commits locales sin internet; con el segundo no.

De fácil a difícil:

Con checkout (como svn)

Descargar

bzr checkout http://launchpad.net/~nombre-equipo/hdlorean/nombre-branch carpeta-destino
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…

Invito a todo alma indómita que se meta a probar que esto funciona, y explicarme exactamente cómo. YO NO HE PROBADO ESTE MÉTODO AÚN!!!

Con 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.

Descargar

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!!

Bajarse cambios

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.
Mezclar branches (se hace en LOCAL siempre)

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 archivos:

Lista de archivos 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…).

Incluso hay un plugin para eclipse; creo que falla con meter nombres de usuario y demás así que hay que tener la autenticación "automática", lo que es harina de otro percal:

Clave pública subida al launchpad
ssh-agent corriendo
"algo" para que se añada automáticamente al iniciar sesión, o al menos que pida contraseña (investigando, ayúdenme! XD). Por esto digo que es más lioso, si no sería adecuadísimo.
Ambos estoy probándolos aún.

Clave SSH - Necesario para subir Código

Mirad en el tutorial de launchpad, ya que es requisito del launchpad más que del propio bazaar.

Fuentes

Para el que quiera mirar por su cuenta:

Página oficial, wikipedia. Recomiendo empezar por Bazaar en 5 minutos y Workflows para enterarse de qué va esto.

También hay bastante en launchpad sobre su hosting de código, directamente aplicable a la propuesta modelo desarrollo: http://help.launchpad.net/FeatureHighlights/BazaarHosting y siguientes (2, 3 )

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