← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/__init__.py

  • Committer: mbp at sourcefrog
  • Date: 2005-03-26 03:10:07 UTC
  • Revision ID: mbp@sourcefrog.net-20050326031007-ae4809099d7e6eca
update for release 0.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/__init__.py
1
 
# Copyright (C) 2005, 2006, 2007, 2008, 2009 Canonical Ltd
2
 
#
 
1
#! /usr/bin/env python
 
2
# -*- coding: UTF-8 -*-
 
3
 
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.
7
 
#
 
8
 
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.
12
 
#
 
13
 
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
16
17
 
17
18
"""bzr library"""
18
19
 
19
 
import time
20
 
 
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()
24
 
 
25
 
import sys
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()
33
 
 
34
 
from bzrlib.osutils import get_user_encoding
35
 
 
 
20
from inventory import Inventory, InventoryEntry
 
21
from branch import Branch, ScratchBranch
 
22
from osutils import format_date
 
23
from tree import Tree
 
24
from diff import diff_trees
 
25
from trace import mutter, warning
 
26
import add
 
27
 
 
28
BZRDIR = ".bzr"
 
29
 
 
30
DEFAULT_IGNORE = ['.*', '*~', '#*#', '*.tmp', '*.o', '*.a', '*.py[oc]',
 
31
                  '{arch}']
36
32
 
37
33
IGNORE_FILENAME = ".bzrignore"
38
34
 
39
35
 
40
 
# XXX: Deprecated as of bzr-1.17 use osutils.get_user_encoding() directly
41
 
user_encoding = get_user_encoding()
42
 
 
43
 
 
44
 
__copyright__ = "Copyright 2005, 2006, 2007, 2008, 2009 Canonical Ltd."
45
 
 
46
 
# same format as sys.version_info: "A tuple containing the five components of
47
 
# the version number: major, minor, micro, releaselevel, and serial. All
48
 
# values except releaselevel are integers; the release level is 'alpha',
49
 
# 'beta', 'candidate', or 'final'. The version_info value corresponding to the
50
 
# Python version 2.0 is (2, 0, 0, 'final', 0)."  Additionally we use a
51
 
# releaselevel of 'dev' for unreleased under-development code.
52
 
 
53
 
version_info = (2, 0, 4, 'dev', 0)
54
 
 
55
 
# API compatibility version: bzrlib is currently API compatible with 1.15.
56
 
api_minimum_version = (1, 17, 0)
57
 
 
58
 
def _format_version_tuple(version_info):
59
 
    """Turn a version number 2, 3 or 5-tuple into a short string.
60
 
 
61
 
    This format matches <http://docs.python.org/dist/meta-data.html>
62
 
    and the typical presentation used in Python output.
63
 
 
64
 
    This also checks that the version is reasonable: the sub-release must be
65
 
    zero for final releases.
66
 
 
67
 
    >>> print _format_version_tuple((1, 0, 0, 'final', 0))
68
 
    1.0.0
69
 
    >>> print _format_version_tuple((1, 2, 0, 'dev', 0))
70
 
    1.2.0dev
71
 
    >>> print bzrlib._format_version_tuple((1, 2, 0, 'dev', 1))
72
 
    1.2.0dev1
73
 
    >>> print _format_version_tuple((1, 1, 1, 'candidate', 2))
74
 
    1.1.1rc2
75
 
    >>> print bzrlib._format_version_tuple((2, 1, 0, 'beta', 1))
76
 
    2.1.0b1
77
 
    >>> print _format_version_tuple((1, 4, 0))
78
 
    1.4.0
79
 
    >>> print _format_version_tuple((1, 4))
80
 
    1.4
81
 
    >>> print bzrlib._format_version_tuple((2, 1, 0, 'final', 1))
82
 
    Traceback (most recent call last):
83
 
    ...
84
 
    ValueError: version_info (2, 1, 0, 'final', 1) not valid
85
 
    >>> print _format_version_tuple((1, 4, 0, 'wibble', 0))
86
 
    Traceback (most recent call last):
87
 
    ...
88
 
    ValueError: version_info (1, 4, 0, 'wibble', 0) not valid
89
 
    """
90
 
    if len(version_info) == 2:
91
 
        main_version = '%d.%d' % version_info[:2]
92
 
    else:
93
 
        main_version = '%d.%d.%d' % version_info[:3]
94
 
    if len(version_info) <= 3:
95
 
        return main_version
96
 
 
97
 
    release_type = version_info[3]
98
 
    sub = version_info[4]
99
 
 
100
 
    # check they're consistent
101
 
    if release_type == 'final' and sub == 0:
102
 
        sub_string = ''
103
 
    elif release_type == 'dev' and sub == 0:
104
 
        sub_string = 'dev'
105
 
    elif release_type == 'dev':
106
 
        sub_string = 'dev' + str(sub)
107
 
    elif release_type in ('alpha', 'beta'):
108
 
        sub_string = release_type[0] + str(sub)
109
 
    elif release_type == 'candidate':
110
 
        sub_string = 'rc' + str(sub)
111
 
    else:
112
 
        raise ValueError("version_info %r not valid" % (version_info,))
113
 
 
114
 
    return main_version + sub_string
115
 
 
116
 
 
117
 
__version__ = _format_version_tuple(version_info)
118
 
version_string = __version__
119
 
 
120
 
 
121
 
def test_suite():
122
 
    import tests
123
 
    return tests.test_suite()
 
36
__copyright__ = "Copyright 2005 Canonical Development Ltd."
 
37
__author__ = "Martin Pool <mbp@canonical.com>"
 
38
__version__ = '0.0.1'
 
39