===========================
Usando ``bzr version-info``
===========================
Repaso General
==============
Este documento describe las formas de usar ``bzr version-info`` como
parte del proceso de embeber la informacion de vesion a un proyecto.
Projecto Python
===============
TODO: Figure out how to attach into ``setup.py``
Si usa un archivo Makefile para construir su proyecto, puede generar un
archivo on la informacion de version tan simple como::
library/_version.py:
bzr version-info --format=python > library/_version.py
Eso genera un archivo que contiene 3 diccionarios:
* `version_info`: Un diccionario conteniendo informacion basica sobre el
estado actual
* `revisions`: Un diccionario listando todas las revisiones en
el historial del tree, junto con los tiempos y los mensajes de
los commits. Esto por defecto esta en blanco salvi que use ``--all``
o `--include-history`` es provisto. Esto es util si quiere seguir
que bugs arregla el lanzamiento de esa version. Para muchos proyectos
es mas informacion de la que se va a necesitar.
* `file_revisions`: Un diccionario listando la revision que modifico
por ultima vez todos los archivos del proyecto. Esto puede ser usado
similarmente a como se usan las palabras claves ``$Id$`` en los
archivos controlados en CVS. La ultima fecha de modificacion puede
ser determinada mirando en el mapa de ``revisions``. Esto tambien
esta vacio por defecto, y habilitado solo por ``--all`` o
``--include-file-revisions``.
Check Clean
===========
La mayoria de la informacion sobre el contenido del proyecto puede
ser determinada a muy bajo costo con solo leer las entradas de revisiones.
Sin embargo, puede ser util si el working tree fue actualizado completamente
cuando fue empaquetado, o si hubo alguna modificacion local. Al proveer
``--all`` o ``--check-clean``, ``bzr`` va a inspeccionar el working tree,
y definir el ``clean`` flag en ``version_info``, al igual que definir
entradas en ``file_revisions`` como ``modified`` donde es apropiado.
