/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
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
19
from .lazy_import import lazy_import
4792.8.4 by Martin Pool
Convert version-info to use TextUIOutputStream
20
1996.3.26 by John Arbash Meinel
Make cmd_version_info.py lazy import most other modules
21
lazy_import(globals(), """
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
22
from breezy import (
2022.1.3 by John Arbash Meinel
Remove unused imports
23
    branch,
4792.8.4 by Martin Pool
Convert version-info to use TextUIOutputStream
24
    version_info_formats,
2022.1.3 by John Arbash Meinel
Remove unused imports
25
    workingtree,
2022.1.1 by John Arbash Meinel
[merge] version-info plugin, and cleanup for layout in bzr
26
    )
6622.1.34 by Jelmer Vernooij
Rename brzlib => breezy.
27
from breezy.i18n import gettext
1996.3.26 by John Arbash Meinel
Make cmd_version_info.py lazy import most other modules
28
""")
4792.8.4 by Martin Pool
Convert version-info to use TextUIOutputStream
29
7413.8.11 by Jelmer Vernooij
Don't lazy-import errors.
30
from . import (
31
    errors,
32
    )
6624 by Jelmer Vernooij
Merge Python3 porting work ('py3 pokes')
33
from .commands import Command
34
from .option import Option, RegistryOption
0.8.2 by John Arbash Meinel
Have working rio output
35
36
37
def _parse_version_info_format(format):
2022.1.4 by John Arbash Meinel
test feedback from Robert.
38
    """Convert a string passed by the user into a VersionInfoFormat.
39
40
    This looks in the version info format registry, and if the format
41
    cannot be found, generates a useful error exception.
42
    """
0.8.2 by John Arbash Meinel
Have working rio output
43
    try:
0.8.21 by John Arbash Meinel
Splitting up the version info code into a lazy factory style.
44
        return version_info_formats.get_builder(format)
0.8.2 by John Arbash Meinel
Have working rio output
45
    except KeyError:
0.8.21 by John Arbash Meinel
Splitting up the version info code into a lazy factory style.
46
        formats = version_info_formats.get_builder_formats()
7490.61.1 by Jelmer Vernooij
Rename BzrCommandError to CommandError.
47
        raise errors.CommandError(
7143.15.5 by Jelmer Vernooij
More PEP8 fixes.
48
            gettext('No known version info format {0}.'
49
                    ' Supported types are: {1}').format(format, formats))
0.8.2 by John Arbash Meinel
Have working rio output
50
51
52
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
53
    __doc__ = """Show version information about this tree.
2948.4.2 by Lukáš Lalinský
Use registry for the list of formats. Documentation.
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
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
61
      brz version-info --custom \\
2948.4.3 by Lukáš Lalinský
Fix problems from Alexander's review.
62
        --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.
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
2948.4.3 by Lukáš Lalinský
Fix problems from Alexander's review.
72
      * {clean} - 0 if the source tree contains uncommitted changes,
73
                  otherwise 1
2948.4.2 by Lukáš Lalinský
Use registry for the list of formats. Documentation.
74
    """
75
76
    takes_options = [RegistryOption('format',
7143.15.2 by Jelmer Vernooij
Run autopep8.
77
                                    'Select the output format.',
78
                                    value_switches=True,
79
                                    lazy_registry=('breezy.version_info_formats',
80
                                                   'format_registry')),
2598.1.1 by Martin Pool
Add test for and documentation of option style, fix up existing options to comply
81
                     Option('all', help='Include all possible information.'),
82
                     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.
83
                     Option('include-history',
2598.1.1 by Martin Pool
Add test for and documentation of option style, fix up existing options to comply
84
                            help='Include the revision-history.'),
0.8.13 by John Arbash Meinel
Including file-revisions fields, updated test suite.
85
                     Option('include-file-revisions',
2948.4.1 by Lukáš Lalinský
Custom template-based version info formatter.
86
                            help='Include the last revision for each file.'),
7479.2.1 by Jelmer Vernooij
Drop python2 support.
87
                     Option('template', type=str,
7143.15.2 by Jelmer Vernooij
Run autopep8.
88
                            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
7045.2.19 by Jelmer Vernooij
Fix some more tests.
93
    encoding_type = 'replace'
0.8.20 by John Arbash Meinel
Updated version-info to the latest bzr.dev codebase. Changed to using VersionInfoBuilder, and made tests pass.
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:
7490.61.1 by Jelmer Vernooij
Rename BzrCommandError to CommandError.
101
            raise errors.CommandError(
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,
7143.15.2 by Jelmer Vernooij
Run autopep8.
135
                         check_for_clean=check_clean,
136
                         include_revision_history=include_history,
137
                         include_file_revisions=include_file_revisions,
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)