/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()
7143.15.5 by Jelmer Vernooij
More PEP8 fixes.
48
        raise errors.BzrCommandError(
49
            gettext('No known version info format {0}.'
50
                    ' Supported types are: {1}').format(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',
7143.15.2 by Jelmer Vernooij
Run autopep8.
78
                                    'Select the output format.',
79
                                    value_switches=True,
80
                                    lazy_registry=('breezy.version_info_formats',
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.'),
7143.15.2 by Jelmer Vernooij
Run autopep8.
88
                     Option('template', type=text_type,
89
                            help='Template for the output.'),
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
90
                     'revision',
0.8.2 by John Arbash Meinel
Have working rio output
91
                     ]
92
    takes_args = ['location?']
93
7045.2.19 by Jelmer Vernooij
Fix some more tests.
94
    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.
95
0.8.2 by John Arbash Meinel
Have working rio output
96
    def run(self, location=None, format=None,
0.8.3 by John Arbash Meinel
Playing around with some formats
97
            all=False, check_clean=False, include_history=False,
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
98
            include_file_revisions=False, template=None,
99
            revision=None):
100
101
        if revision and len(revision) > 1:
102
            raise errors.BzrCommandError(
6622.1.28 by Jelmer Vernooij
More renames; commands in output, environment variables.
103
                gettext('brz version-info --revision takes exactly'
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
104
                        ' one revision specifier'))
0.8.2 by John Arbash Meinel
Have working rio output
105
106
        if location is None:
2022.1.4 by John Arbash Meinel
test feedback from Robert.
107
            location = '.'
0.8.2 by John Arbash Meinel
Have working rio output
108
109
        if format is None:
2948.4.2 by Lukáš Lalinský
Use registry for the list of formats. Documentation.
110
            format = version_info_formats.format_registry.get()
0.8.2 by John Arbash Meinel
Have working rio output
111
0.8.20 by John Arbash Meinel
Updated version-info to the latest bzr.dev codebase. Changed to using VersionInfoBuilder, and made tests pass.
112
        try:
2022.1.3 by John Arbash Meinel
Remove unused imports
113
            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
114
        except errors.NoWorkingTree:
2022.1.3 by John Arbash Meinel
Remove unused imports
115
            b = branch.Branch.open(location)
6406.1.2 by Jelmer Vernooij
Simplify code a bit.
116
            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.
117
        else:
118
            b = wt.branch
0.8.2 by John Arbash Meinel
Have working rio output
119
6234.3.2 by Lawrence Mitchell
Only set check_clean if {clean} is asked for in template
120
        if all:
0.8.2 by John Arbash Meinel
Have working rio output
121
            include_history = True
122
            check_clean = True
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
123
            include_file_revisions = True
6234.3.2 by Lawrence Mitchell
Only set check_clean if {clean} is asked for in template
124
        if template:
125
            include_history = True
126
            include_file_revisions = True
127
            if '{clean}' in template:
128
                check_clean = True
6196.1.1 by Jelmer Vernooij
Add --revision argument to 'bzr version-info'.
129
130
        if revision is not None:
131
            revision_id = revision[0].as_revision_id(b)
132
        else:
133
            revision_id = None
0.8.2 by John Arbash Meinel
Have working rio output
134
0.8.20 by John Arbash Meinel
Updated version-info to the latest bzr.dev codebase. Changed to using VersionInfoBuilder, and made tests pass.
135
        builder = format(b, working_tree=wt,
7143.15.2 by Jelmer Vernooij
Run autopep8.
136
                         check_for_clean=check_clean,
137
                         include_revision_history=include_history,
138
                         include_file_revisions=include_file_revisions,
139
                         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(...)'
140
        builder.generate(self.outf)