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