/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
5752.3.8 by John Arbash Meinel
Merge bzr.dev 5764 to resolve release-notes (aka NEWS) conflicts
1
# Copyright (C) 2005-2011 Canonical Ltd
0.8.21 by John Arbash Meinel
Splitting up the version info code into a lazy factory style.
2
#
0.8.1 by John Arbash Meinel
Creating a plugin to ease generating version information from a tree.
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
0.8.21 by John Arbash Meinel
Splitting up the version info code into a lazy factory style.
7
#
0.8.1 by John Arbash Meinel
Creating a plugin to ease generating version information from a tree.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
# GNU General Public License for more details.
0.8.21 by John Arbash Meinel
Splitting up the version info code into a lazy factory style.
12
#
0.8.1 by John Arbash Meinel
Creating a plugin to ease generating version information from a tree.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
4183.7.1 by Sabin Iacob
update FSF mailing address
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
0.8.1 by John Arbash Meinel
Creating a plugin to ease generating version information from a tree.
16
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
17
"""Commands for generating snapshot information about a brz tree."""
6379.6.7 by Jelmer Vernooij
Move importing from future until after doc string, otherwise the doc string will disappear.
18
6379.6.1 by Jelmer Vernooij
Import absolute_import in a few places.
19
from __future__ import absolute_import
20
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
21
from .lazy_import import lazy_import
4792.8.4 by Martin Pool
Convert version-info to use TextUIOutputStream
22
1996.3.26 by John Arbash Meinel
Make cmd_version_info.py lazy import most other modules
23
lazy_import(globals(), """
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
24
from breezy import (
2022.1.3 by John Arbash Meinel
Remove unused imports
25
    branch,
2030.1.4 by John Arbash Meinel
Add a test that we can find the version info when we only have a branch
26
    errors,
4792.8.4 by Martin Pool
Convert version-info to use TextUIOutputStream
27
    version_info_formats,
2022.1.3 by John Arbash Meinel
Remove unused imports
28
    workingtree,
2022.1.1 by John Arbash Meinel
[merge] version-info plugin, and cleanup for layout in bzr
29
    )
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
30
from breezy.i18n import gettext
1996.3.26 by John Arbash Meinel
Make cmd_version_info.py lazy import most other modules
31
""")
4792.8.4 by Martin Pool
Convert version-info to use TextUIOutputStream
32
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
33
from .commands import Command
34
from .option import Option, RegistryOption
6808 by Jelmer Vernooij
merge lp:~jelmer/brz/options-unicode/
35
from .sixish import text_type
0.8.2 by John Arbash Meinel
Have working rio output
36
37
38
def _parse_version_info_format(format):
2022.1.4 by John Arbash Meinel
test feedback from Robert.
39
    """Convert a string passed by the user into a VersionInfoFormat.
40
41
    This looks in the version info format registry, and if the format
42
    cannot be found, generates a useful error exception.
43
    """
0.8.2 by John Arbash Meinel
Have working rio output
44
    try:
0.8.21 by John Arbash Meinel
Splitting up the version info code into a lazy factory style.
45
        return version_info_formats.get_builder(format)
0.8.2 by John Arbash Meinel
Have working rio output
46
    except KeyError:
0.8.21 by John Arbash Meinel
Splitting up the version info code into a lazy factory style.
47
        formats = version_info_formats.get_builder_formats()
6138.3.8 by Jonathan Riddell
more error gettext()ing
48
        raise errors.BzrCommandError(gettext('No known version info format {0}.'
49
                                     ' Supported types are: {1}').format(
50
                                     format, formats))
0.8.2 by John Arbash Meinel
Have working rio output
51
52
53
class cmd_version_info(Command):
5131.2.1 by Martin
Permit bzrlib to run under python -OO by explictly assigning to __doc__ for user-visible docstrings
54
    __doc__ = """Show version information about this tree.
2948.4.2 by Lukáš Lalinský
Use registry for the list of formats. Documentation.
55
56
    You can use this command to add information about version into
57
    source code of an application. The output can be in one of the
58
    supported formats or in a custom format based on a template.
59
60
    For example::
61
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
62
      brz version-info --custom \\
2948.4.3 by Lukáš Lalinský
Fix problems from Alexander's review.
63
        --template="#define VERSION_INFO \\"Project 1.2.3 (r{revno})\\"\\n"
2948.4.2 by Lukáš Lalinský
Use registry for the list of formats. Documentation.
64
65
    will produce a C header file with formatted string containing the
66
    current revision number. Other supported variables in templates are:
67
68
      * {date} - date of the last revision
69
      * {build_date} - current date
70
      * {revno} - revision number
71
      * {revision_id} - revision id
72
      * {branch_nick} - branch nickname
2948.4.3 by Lukáš Lalinský
Fix problems from Alexander's review.
73
      * {clean} - 0 if the source tree contains uncommitted changes,
74
                  otherwise 1
2948.4.2 by Lukáš Lalinský
Use registry for the list of formats. Documentation.
75
    """
76
77
    takes_options = [RegistryOption('format',
78
                            'Select the output format.',
3224.5.1 by Andrew Bennetts
Lots of assorted hackery to reduce the number of imports for common operations. Improves 'rocks', 'st' and 'help' times by ~50ms on my laptop.
79
                            value_switches=True,
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
80
                            lazy_registry=('breezy.version_info_formats',
3224.5.1 by Andrew Bennetts
Lots of assorted hackery to reduce the number of imports for common operations. Improves 'rocks', 'st' and 'help' times by ~50ms on my laptop.
81
                                           'format_registry')),
2598.1.1 by Martin Pool
Add test for and documentation of option style, fix up existing options to comply
82
                     Option('all', help='Include all possible information.'),
83
                     Option('check-clean', help='Check if tree is clean.'),
0.8.21 by John Arbash Meinel
Splitting up the version info code into a lazy factory style.
84
                     Option('include-history',
2598.1.1 by Martin Pool
Add test for and documentation of option style, fix up existing options to comply
85
                            help='Include the revision-history.'),
0.8.13 by John Arbash Meinel
Including file-revisions fields, updated test suite.
86
                     Option('include-file-revisions',
2948.4.1 by Lukáš Lalinský
Custom template-based version info formatter.
87
                            help='Include the last revision for each file.'),
6805.1.2 by Jelmer Vernooij
Text type.
88
                     Option('template', type=text_type, help='Template for the output.'),
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
89
                     'revision',
0.8.2 by John Arbash Meinel
Have working rio output
90
                     ]
91
    takes_args = ['location?']
92
0.8.20 by John Arbash Meinel
Updated version-info to the latest bzr.dev codebase. Changed to using VersionInfoBuilder, and made tests pass.
93
    encoding_type = 'exact'
94
0.8.2 by John Arbash Meinel
Have working rio output
95
    def run(self, location=None, format=None,
0.8.3 by John Arbash Meinel
Playing around with some formats
96
            all=False, check_clean=False, include_history=False,
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
97
            include_file_revisions=False, template=None,
98
            revision=None):
99
100
        if revision and len(revision) > 1:
101
            raise errors.BzrCommandError(
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
102
                gettext('brz version-info --revision takes exactly'
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
103
                        ' one revision specifier'))
0.8.2 by John Arbash Meinel
Have working rio output
104
105
        if location is None:
2022.1.4 by John Arbash Meinel
test feedback from Robert.
106
            location = '.'
0.8.2 by John Arbash Meinel
Have working rio output
107
108
        if format is None:
2948.4.2 by Lukáš Lalinský
Use registry for the list of formats. Documentation.
109
            format = version_info_formats.format_registry.get()
0.8.2 by John Arbash Meinel
Have working rio output
110
0.8.20 by John Arbash Meinel
Updated version-info to the latest bzr.dev codebase. Changed to using VersionInfoBuilder, and made tests pass.
111
        try:
2022.1.3 by John Arbash Meinel
Remove unused imports
112
            wt = workingtree.WorkingTree.open_containing(location)[0]
2030.1.4 by John Arbash Meinel
Add a test that we can find the version info when we only have a branch
113
        except errors.NoWorkingTree:
2022.1.3 by John Arbash Meinel
Remove unused imports
114
            b = branch.Branch.open(location)
6406.1.2 by Jelmer Vernooij
Simplify code a bit.
115
            wt = None
0.8.20 by John Arbash Meinel
Updated version-info to the latest bzr.dev codebase. Changed to using VersionInfoBuilder, and made tests pass.
116
        else:
117
            b = wt.branch
0.8.2 by John Arbash Meinel
Have working rio output
118
6234.3.2 by Lawrence Mitchell
Only set check_clean if {clean} is asked for in template
119
        if all:
0.8.2 by John Arbash Meinel
Have working rio output
120
            include_history = True
121
            check_clean = True
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
122
            include_file_revisions = True
6234.3.2 by Lawrence Mitchell
Only set check_clean if {clean} is asked for in template
123
        if template:
124
            include_history = True
125
            include_file_revisions = True
126
            if '{clean}' in template:
127
                check_clean = True
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
128
129
        if revision is not None:
130
            revision_id = revision[0].as_revision_id(b)
131
        else:
132
            revision_id = None
0.8.2 by John Arbash Meinel
Have working rio output
133
0.8.20 by John Arbash Meinel
Updated version-info to the latest bzr.dev codebase. Changed to using VersionInfoBuilder, and made tests pass.
134
        builder = format(b, working_tree=wt,
0.8.2 by John Arbash Meinel
Have working rio output
135
                check_for_clean=check_clean,
0.8.13 by John Arbash Meinel
Including file-revisions fields, updated test suite.
136
                include_revision_history=include_history,
2948.4.1 by Lukáš Lalinský
Custom template-based version info formatter.
137
                include_file_revisions=include_file_revisions,
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
138
                template=template, revision_id=revision_id)
5436.1.6 by Andrej A Antonov
code simplification: object 'ui.ui_factory.make_output_stream(encoding_type=self.encoding_type)' already created as 'self.outf' in function 'Command._setup_outf(...)'
139
        builder.generate(self.outf)