Introducción al uso de Bazaar como SCV

Agenda

• Introducción al Sistema de Control de Versiones Bazaar [1].

• Ejemplos de uso de la herramienta:

  • Poner archivos bajo control de Bazaar.
  • Registro de cambios en repositorio local.
  • Publicación del repositorio.
  • Generación de ramas de un repositorio publicado.
  • Creación de un parche de cambios para un repositorio externo.

¿Qué es Bazaar?

• Una herramienta para que la gente pueda colaborar entre si fácilmente, y que maneja los cambios hechos a un grupo de archivos de manera que se pueda seguir la evolución de los mismos.

• Un VCS que permite diversos flujos de trabajo (inclusive más de uno a la vez):

  • En solitario o en pares.
  • Usando un modelo descentralizado.
  • Empleando un servidor/repositorio central.

Bazaar: Detalles Técnicos

• Bazaar está enteramente escrito en Python [2].
• Funciona en múltiples Sistemas Operativos: Linux, MS Windows, Mac OS X, etc.
• Puede publicar repositorios usando HTTP, FTP, SFTP o WebDAV (HTTP), así como usando un servidor dedicado (el cual puedes usar SSH).
• Tiene un API para integración con otras herramientas, como aplicativos para el control de pruebas de código, sistemas de gestión de defectos, etc.

Interfaces para Bazaar (1)

La línea de comando (rápida, potente y simple):

Comparando cambios:

$ bzr diff somefile.py

Registrando los cambios:

$ bzr commit -m "Fixed bug #124"

Extrayendo una rama de un repositorio externo:

$ bzr branch http://example.com/someproject

Interfaces para Bazaar (2)

Sistemas gráficos:

• Meld: Para ver diffs locales, soporta commit, update, etc.
• bzr-gtk: Plugin de Bazaar, para proveer interfaces gráficas a las operaciones.
• Integración con IDEs: Eclipse, Emacs, VIM, MonoDevelop, PIDA, MS Visual Studio, etc.
• Via interfaz web: BazaarHGWeb, LoggerHead, TracBzr (integración con Trac)

Para más información ver: http://bazaar-vcs.org/3rdPartyTools

Instalando Bazaar

• En Ubuntu Linux (Debian, etc.):

  $ sudo aptitude install bzr bzr-gtk bzrtools
  

• En MS Windows:

  • Descargar el instalador para Windows.
  • Instrucciones: http://bazaar-vcs.org/WindowsDownloads

• En Mac OS X:

  • Via los repositorios de Fink o MacPorts
  • Instalador para Mac OS X 10.5 (Instrucciones para 10.5)

Ejemplo práctico

Vamos a usar Bazaar en forma práctica.

Controlaremos las versiones de archivos correspondientes a esta presentación.

Usaré Ubuntu Linux como Sistema Operativo, se pueden hacer operaciones equivalentes en MS Windows, Mac OS X, etc.

Asumiré que ya tenemos Bazaar instalado y configurado correctamente.

Primeros pasos

• Creando el proyecto:

  $ mkdir 20080215_IntroBazaar
  $ cd 20080215_IntroBazaar
  

• Comenzando a editar la presentación en formato RST:

  $ gvim introbazaar.rst
  

• Diciéndole a Bazaar quienes somos:

  $ bzr whoami "Juan Perez <juanperez@example.com>"
  

Repositorio local

• Creando un repositorio local:

  $ bzr init
  

• Añadiendo los archivos al repositorio:

  $ bzr add
  

• Guardando la primera versión:

  $ bzr commit -m "Inicio del proyecto"
  

Viendo diferencias

• Editando más y viendo las diferencias:

  $ gvim introbazaar.rst
  $ bzr diff introbazaar.rst
  

• Viendo las diferencias coloreadas (bzrtools):

  $ bzr cdiff introbazaar.rst
  

• Viendo las diferencias en GUI (bzr-gtk):

  $ bzr gdiff introbazaar.rst
  

Registrando cambios

Cuando hemos terminado una sesión de cambios y queremos guardarlos.

• Podemos usar la interfaz gráfica (Olive):

  $ bzr gcommit
  

• O la línea de comando:

  $ bzr commit -m "Nuevo \
    material para presentación"
  

Publicando el repositorio

Un repositorio se puede publicar usando un servidor web previamente configurado, y transfiriendo los archivos mediante varios protocolos: FTP, SFTP, WebDAV, etc.

Usaremos SFTP:

$ bzr push sftp://usuario@servidor/ruta/al/repo

En este caso:

• El servidor es: dui-proyectos.upch.edu.pe
• Y la ruta al repositorio: /home/jesus/public_html/bzr/20080215_IntroBazaar

Usando una rama local (1)

Usaremos el repositorio creado anteriormente para obtener una rama en la cual podemos trabajar.

Como tenemos un servidor web podemos hacer, simplemente:

$ bzr branch http://servidor/ruta/al/repo

Editamos uno de los archivos y luego vemos el estado:

$ bzr status
modified:
  introbazaar.rst

Usando una rama local (2)

Podemos ver lo que hemos hecho usando diff:

$ bzr diff introbazaar.rst

Podemos editar la rama local cuanto queramos, y cuando estemos listos, combinar nuestros cambios con los de otra rama (no necesariamente la original):

$ bzr merge http://servidor/ruta/otra/rama

Preparando un parche

Asumiendo que hemos realizado los cambios que queríamos y estamos listos para enviar nuestros cambios (produciendo un parche)

• Primero, nos aseguramos de tener los últimos cambios (y resolvemos conflictos, si ocurren):

  $ bzr pull
  

• Finalmente creamos el parche, el cual puede ser enviado por email, ftp, etc.:

  $ bzr send -o miparche.txt
  

Etiquetado y empacando

Podemos etiquetar una version:

$ bzr tag VERSION_2

Se puede ver esta (y otra) información usando:

$ bzr log

Y podemos empacar todo en un archivo para distribución:

$ bzr export ../misoftware-2.0.0alpha.zip

Recuperándose de errores

Si borramos un archivo por error, lo podemos recuperar:

$ rm introbazaar.rst
$ bzr revert introbazaar.rst

Si añadimos el archivo equivocado al repositorio:

$ bzr add tempfile
$ bzr remove --keep tempfile

Si registramos algo por error:

$ bzr uncommit

Conclusiones

• Bazaar es un VCS que permite el manejo simple y robusto de árboles de directorios y archivos.
• Puede usarse en solitario, asi como en grupos pequeños o grandes ya sea colaborando en forma distribuido como centralizada.
• Permite el recuperarse fácilmente de errores, desde el borrar algo por equivocación, hasta el haber registrado incorrectamente algo.
• Manejar versiones puede ser complicado, pero Bazaar provee las herramientas para hacerlo sencillo.
• Bazaar es independiente de la plataforma y de que contienen los archivos. Su utilidad es universal.

Referencias: Bazaar

• Bazaar: http://bazaar-vcs.org

  • Documentación: http://bazaar-vcs.org/Documentation
  • Descargas: http://bazaar-vcs.org/Download
  • Integración: http://bazaar-vcs.org/3rdPartyTools

• PQM: http://bazaar-vcs.org/PatchQueueManager

• Multi-Tree Management: http://bazaar-vcs.org/ConfigManager

Referencias: Otros

• Python: http://www.python.org/

• Docutils: http://docutils.sourceforge.net/

  • rst (reStructuredText): http://docutils.sourceforge.net/rst.html

• S5: http://meyerweb.com/eric/tools/s5/

• VIM: http://vim.org/

• Ubuntu: http://www.ubuntu.com/

¡Gracias!

Por no aburrirse o asustarse demasiado.

Pueden encontrar esta (y otras) charla en:

http://talks.castagnetto.com/

¡Usen Bazaar!