1
# Copyright (C) 2005-2010 Canonical Ltd
2
# -*- coding: UTF-8 -*-
3
4
# This program is free software; you can redistribute it and/or modify
4
5
# it under the terms of the GNU General Public License as published by
5
6
# the Free Software Foundation; either version 2 of the License, or
6
7
# (at your option) any later version.
8
9
# This program is distributed in the hope that it will be useful,
9
10
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
11
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
12
# GNU General Public License for more details.
13
14
# You should have received a copy of the GNU General Public License
14
15
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21
# Keep track of when bzrlib was first imported, so that we can give rough
22
# timestamps relative to program start in the log file kept by bzrlib.trace.
23
_start_time = time.time()
26
if getattr(sys, '_bzr_lazy_regex', False):
27
# The 'bzr' executable sets _bzr_lazy_regex. We install the lazy regex
28
# hack as soon as possible so that as much of the standard library can
29
# benefit, including the 'string' module.
30
del sys._bzr_lazy_regex
31
import bzrlib.lazy_regex
32
bzrlib.lazy_regex.install_lazy_compile()
35
IGNORE_FILENAME = ".bzrignore"
38
__copyright__ = "Copyright 2005-2010 Canonical Ltd."
40
# same format as sys.version_info: "A tuple containing the five components of
41
# the version number: major, minor, micro, releaselevel, and serial. All
42
# values except releaselevel are integers; the release level is 'alpha',
43
# 'beta', 'candidate', or 'final'. The version_info value corresponding to the
44
# Python version 2.0 is (2, 0, 0, 'final', 0)." Additionally we use a
45
# releaselevel of 'dev' for unreleased under-development code.
47
version_info = (2, 2, 0, 'dev', 1)
49
# API compatibility version
50
api_minimum_version = (2, 2, 0)
53
def _format_version_tuple(version_info):
54
"""Turn a version number 2, 3 or 5-tuple into a short string.
56
This format matches <http://docs.python.org/dist/meta-data.html>
57
and the typical presentation used in Python output.
59
This also checks that the version is reasonable: the sub-release must be
60
zero for final releases.
62
>>> print _format_version_tuple((1, 0, 0, 'final', 0))
64
>>> print _format_version_tuple((1, 2, 0, 'dev', 0))
66
>>> print bzrlib._format_version_tuple((1, 2, 0, 'dev', 1))
68
>>> print _format_version_tuple((1, 1, 1, 'candidate', 2))
70
>>> print bzrlib._format_version_tuple((2, 1, 0, 'beta', 1))
72
>>> print _format_version_tuple((1, 4, 0))
74
>>> print _format_version_tuple((1, 4))
76
>>> print bzrlib._format_version_tuple((2, 1, 0, 'final', 1))
77
Traceback (most recent call last):
79
ValueError: version_info (2, 1, 0, 'final', 1) not valid
80
>>> print _format_version_tuple((1, 4, 0, 'wibble', 0))
81
Traceback (most recent call last):
83
ValueError: version_info (1, 4, 0, 'wibble', 0) not valid
85
if len(version_info) == 2:
86
main_version = '%d.%d' % version_info[:2]
88
main_version = '%d.%d.%d' % version_info[:3]
89
if len(version_info) <= 3:
92
release_type = version_info[3]
95
# check they're consistent
96
if release_type == 'final' and sub == 0:
98
elif release_type == 'dev' and sub == 0:
100
elif release_type == 'dev':
101
sub_string = 'dev' + str(sub)
102
elif release_type in ('alpha', 'beta'):
103
if version_info[2] == 0:
104
main_version = '%d.%d' % version_info[:2]
105
sub_string = release_type[0] + str(sub)
106
elif release_type == 'candidate':
107
sub_string = 'rc' + str(sub)
109
raise ValueError("version_info %r not valid" % (version_info,))
111
return main_version + sub_string
114
__version__ = _format_version_tuple(version_info)
115
version_string = __version__
120
return tests.test_suite()
125
stdin=None, stdout=None, stderr=None):
126
"""Set up everything needed for normal use of bzrlib.
128
Most applications that embed bzrlib, including bzr itself, should call
129
this function to initialize various subsystems.
131
More options may be added in future so callers should use named arguments.
133
:param setup_ui: If true (default) use a terminal UI; otherwise
134
something else must be put into `bzrlib.ui.ui_factory`.
135
:param stdin, stdout, stderr: If provided, use these for terminal IO;
136
otherwise use the files in `sys`.
138
# TODO: mention this in a guide to embedding bzrlib
140
# NB: This function tweaks so much global state it's hard to test it in
141
# isolation within the same interpreter. It's not reached on normal
142
# in-process run_bzr calls. If it's broken, we expect that
143
# TestRunBzrSubprocess may fail.
148
bzrlib.trace.enable_default_logging()
149
atexit.register(bzrlib.trace._flush_stdout_stderr)
150
atexit.register(bzrlib.trace._flush_trace)
161
bzrlib.ui.ui_factory = bzrlib.ui.make_ui_for_terminal(
162
stdin, stdout, stderr)
164
if bzrlib.version_info[3] == 'final':
165
from bzrlib.symbol_versioning import suppress_deprecation_warnings
166
suppress_deprecation_warnings(override=True)
168
import bzrlib.osutils
169
atexit.register(osutils.report_extension_load_failures)
20
from inventory import Inventory, InventoryEntry
21
from branch import Branch, ScratchBranch
22
from osutils import format_date
24
from diff import diff_trees
28
DEFAULT_IGNORE = ['.*', '*~', '#*#', '*.tmp', '*.o', '*.a']
added
removed
bzrlib/__init__.py
