13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
17
"""Commands for generating snapshot information about a bzr tree."""
19
19
from bzrlib.lazy_import import lazy_import
20
21
lazy_import(globals(), """
21
22
from bzrlib import (
47
49
class cmd_version_info(Command):
48
"""Show version information about this tree."""
50
takes_options = [Option('format', type=_parse_version_info_format,
51
help='Select the output format'),
52
Option('all', help='include all possible information'),
53
Option('check-clean', help='check if tree is clean'),
50
__doc__ = """Show version information about this tree.
52
You can use this command to add information about version into
53
source code of an application. The output can be in one of the
54
supported formats or in a custom format based on a template.
58
bzr version-info --custom \\
59
--template="#define VERSION_INFO \\"Project 1.2.3 (r{revno})\\"\\n"
61
will produce a C header file with formatted string containing the
62
current revision number. Other supported variables in templates are:
64
* {date} - date of the last revision
65
* {build_date} - current date
66
* {revno} - revision number
67
* {revision_id} - revision id
68
* {branch_nick} - branch nickname
69
* {clean} - 0 if the source tree contains uncommitted changes,
73
takes_options = [RegistryOption('format',
74
'Select the output format.',
76
lazy_registry=('bzrlib.version_info_formats',
78
Option('all', help='Include all possible information.'),
79
Option('check-clean', help='Check if tree is clean.'),
54
80
Option('include-history',
55
help='Include the revision-history'),
81
help='Include the revision-history.'),
56
82
Option('include-file-revisions',
57
help='Include the last revision for each file')
83
help='Include the last revision for each file.'),
84
Option('template', type=str, help='Template for the output.'),
59
86
takes_args = ['location?']
63
90
def run(self, location=None, format=None,
64
91
all=False, check_clean=False, include_history=False,
65
include_file_revisions=False):
92
include_file_revisions=False, template=None):
67
94
if location is None:
71
format = version_info_formats.get_builder(None)
98
format = version_info_formats.format_registry.get()
86
113
builder = format(b, working_tree=wt,
87
114
check_for_clean=check_clean,
88
115
include_revision_history=include_history,
89
include_file_revisions=include_file_revisions)
116
include_file_revisions=include_file_revisions,
90
118
builder.generate(self.outf)