← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/cmd_version_info.py

  • Committer: John Arbash Meinel
  • Date: 2013-05-19 14:29:37 UTC
  • mfrom: (6437.63.9 2.5)
  • mto: (6437.63.10 2.5)
  • mto: This revision was merged to the branch mainline in revision 6575.
  • Revision ID: john@arbash-meinel.com-20130519142937-21ykz2n2y2f22za9
Merge in the actual 2.5 branch. It seems I failed before

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/cmd_version_info.py
1
 
# Copyright (C) 2005, 2006 Canonical Ltd
 
1
# Copyright (C) 2005-2011 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
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
16
16
 
17
17
"""Commands for generating snapshot information about a bzr tree."""
18
18
 
 
19
from __future__ import absolute_import
 
20
 
19
21
from bzrlib.lazy_import import lazy_import
 
22
 
20
23
lazy_import(globals(), """
21
24
from bzrlib import (
22
25
    branch,
24
27
    version_info_formats,
25
28
    workingtree,
26
29
    )
 
30
from bzrlib.i18n import gettext
27
31
""")
 
32
 
28
33
from bzrlib.commands import Command
29
 
from bzrlib.option import Option
 
34
from bzrlib.option import Option, RegistryOption
30
35
 
31
36
 
32
37
def _parse_version_info_format(format):
39
44
        return version_info_formats.get_builder(format)
40
45
    except KeyError:
41
46
        formats = version_info_formats.get_builder_formats()
42
 
        raise errors.BzrCommandError('No known version info format %s.'
43
 
                                     ' Supported types are: %s'
44
 
                                     % (format, formats))
 
47
        raise errors.BzrCommandError(gettext('No known version info format {0}.'
 
48
                                     ' Supported types are: {1}').format(
 
49
                                     format, formats))
45
50
 
46
51
 
47
52
class cmd_version_info(Command):
48
 
    """Show version information about this tree."""
49
 
 
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'),
 
53
    __doc__ = """Show version information about this tree.
 
54
 
 
55
    You can use this command to add information about version into
 
56
    source code of an application. The output can be in one of the
 
57
    supported formats or in a custom format based on a template.
 
58
 
 
59
    For example::
 
60
 
 
61
      bzr version-info --custom \\
 
62
        --template="#define VERSION_INFO \\"Project 1.2.3 (r{revno})\\"\\n"
 
63
 
 
64
    will produce a C header file with formatted string containing the
 
65
    current revision number. Other supported variables in templates are:
 
66
 
 
67
      * {date} - date of the last revision
 
68
      * {build_date} - current date
 
69
      * {revno} - revision number
 
70
      * {revision_id} - revision id
 
71
      * {branch_nick} - branch nickname
 
72
      * {clean} - 0 if the source tree contains uncommitted changes,
 
73
                  otherwise 1
 
74
    """
 
75
 
 
76
    takes_options = [RegistryOption('format',
 
77
                            'Select the output format.',
 
78
                            value_switches=True,
 
79
                            lazy_registry=('bzrlib.version_info_formats',
 
80
                                           'format_registry')),
 
81
                     Option('all', help='Include all possible information.'),
 
82
                     Option('check-clean', help='Check if tree is clean.'),
54
83
                     Option('include-history',
55
 
                            help='Include the revision-history'),
 
84
                            help='Include the revision-history.'),
56
85
                     Option('include-file-revisions',
57
 
                            help='Include the last revision for each file')
 
86
                            help='Include the last revision for each file.'),
 
87
                     Option('template', type=str, help='Template for the output.'),
 
88
                     'revision',
58
89
                     ]
59
90
    takes_args = ['location?']
60
91
 
62
93
 
63
94
    def run(self, location=None, format=None,
64
95
            all=False, check_clean=False, include_history=False,
65
 
            include_file_revisions=False):
 
96
            include_file_revisions=False, template=None,
 
97
            revision=None):
 
98
 
 
99
        if revision and len(revision) > 1:
 
100
            raise errors.BzrCommandError(
 
101
                gettext('bzr version-info --revision takes exactly'
 
102
                        ' one revision specifier'))
66
103
 
67
104
        if location is None:
68
105
            location = '.'
69
106
 
70
107
        if format is None:
71
 
            format = version_info_formats.get_builder(None)
 
108
            format = version_info_formats.format_registry.get()
72
109
 
73
 
        wt = None
74
110
        try:
75
111
            wt = workingtree.WorkingTree.open_containing(location)[0]
76
112
        except errors.NoWorkingTree:
77
113
            b = branch.Branch.open(location)
 
114
            wt = None
78
115
        else:
79
116
            b = wt.branch
80
117
 
81
118
        if all:
82
119
            include_history = True
83
120
            check_clean = True
84
 
            include_file_revisions=True
 
121
            include_file_revisions = True
 
122
        if template:
 
123
            include_history = True
 
124
            include_file_revisions = True
 
125
            if '{clean}' in template:
 
126
                check_clean = True
 
127
 
 
128
        if revision is not None:
 
129
            revision_id = revision[0].as_revision_id(b)
 
130
        else:
 
131
            revision_id = None
85
132
 
86
133
        builder = format(b, working_tree=wt,
87
134
                check_for_clean=check_clean,
88
135
                include_revision_history=include_history,
89
 
                include_file_revisions=include_file_revisions)
 
136
                include_file_revisions=include_file_revisions,
 
137
                template=template, revision_id=revision_id)
90
138
        builder.generate(self.outf)