← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/__init__.py

  • Committer: Neil Martinsen-Burrell
  • Date: 2008-08-19 03:12:55 UTC
  • mto: (3644.1.2 bzr.dev)
  • mto: This revision was merged to the branch mainline in revision 3646.
  • Revision ID: nmb@wartburg.edu-20080819031255-bs3kjjz8aresvu92
Use a registry for mail clients.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/__init__.py
1
 
#! /usr/bin/env python
2
 
# -*- coding: UTF-8 -*-
3
 
 
 
1
# Copyright (C) 2005, 2006, 2007, 2008 Canonical Ltd
 
2
#
4
3
# This program is free software; you can redistribute it and/or modify
5
4
# it under the terms of the GNU General Public License as published by
6
5
# the Free Software Foundation; either version 2 of the License, or
7
6
# (at your option) any later version.
8
 
 
 
7
#
9
8
# This program is distributed in the hope that it will be useful,
10
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12
11
# GNU General Public License for more details.
13
 
 
 
12
#
14
13
# You should have received a copy of the GNU General Public License
15
14
# along with this program; if not, write to the Free Software
16
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17
16
 
18
17
"""bzr library"""
19
18
 
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
 
 
26
 
BZRDIR = ".bzr"
27
 
 
28
 
DEFAULT_IGNORE = ['.*', '*~', '#*#', '*.tmp', '*.o', '*.a', '*.py[oc]',
29
 
                  '{arch}']
 
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
from bzrlib.osutils import get_user_encoding
 
26
 
30
27
 
31
28
IGNORE_FILENAME = ".bzrignore"
32
29
 
33
30
 
 
31
# XXX: Compatibility. This should probably be deprecated
 
32
user_encoding = get_user_encoding()
 
33
 
 
34
 
 
35
__copyright__ = "Copyright 2005, 2006, 2007, 2008 Canonical Ltd."
 
36
 
 
37
# same format as sys.version_info: "A tuple containing the five components of
 
38
# the version number: major, minor, micro, releaselevel, and serial. All
 
39
# values except releaselevel are integers; the release level is 'alpha',
 
40
# 'beta', 'candidate', or 'final'. The version_info value corresponding to the
 
41
# Python version 2.0 is (2, 0, 0, 'final', 0)."  Additionally we use a
 
42
# releaselevel of 'dev' for unreleased under-development code.
 
43
 
 
44
version_info = (1, 7, 0, 'dev', 0)
 
45
 
 
46
 
 
47
# API compatibility version: bzrlib is currently API compatible with 1.7.
 
48
api_minimum_version = (1, 7, 0)
 
49
 
 
50
 
 
51
def _format_version_tuple(version_info):
 
52
    """Turn a version number 3-tuple or 5-tuple into a short string.
 
53
 
 
54
    This format matches <http://docs.python.org/dist/meta-data.html>
 
55
    and the typical presentation used in Python output.
 
56
 
 
57
    This also checks that the version is reasonable: the sub-release must be
 
58
    zero for final releases, and non-zero for alpha, beta and preview.
 
59
 
 
60
    >>> print _format_version_tuple((1, 0, 0, 'final', 0))
 
61
    1.0
 
62
    >>> print _format_version_tuple((1, 2, 0, 'dev', 0))
 
63
    1.2dev
 
64
    >>> print _format_version_tuple((1, 1, 1, 'candidate', 2))
 
65
    1.1.1rc2
 
66
    >>> print _format_version_tuple((1, 4, 0))
 
67
    1.4
 
68
    """
 
69
    if version_info[2] == 0:
 
70
        main_version = '%d.%d' % version_info[:2]
 
71
    else:
 
72
        main_version = '%d.%d.%d' % version_info[:3]
 
73
    if len(version_info) <= 3:
 
74
        return main_version
 
75
 
 
76
    __release_type = version_info[3]
 
77
    __sub = version_info[4]
 
78
 
 
79
    # check they're consistent
 
80
    if __release_type == 'final' and __sub == 0:
 
81
        __sub_string = ''
 
82
    elif __release_type == 'dev' and __sub == 0:
 
83
        __sub_string = 'dev'
 
84
    elif __release_type in ('alpha', 'beta') and __sub != 0:
 
85
        __sub_string = __release_type[0] + str(__sub)
 
86
    elif __release_type == 'candidate' and __sub != 0:
 
87
        __sub_string = 'rc' + str(__sub)
 
88
    else:
 
89
        raise AssertionError("version_info %r not valid" % version_info)
 
90
 
 
91
    version_string = '%d.%d.%d.%s.%d' % version_info
 
92
    return main_version + __sub_string
 
93
 
 
94
__version__ = _format_version_tuple(version_info)
 
95
version_string = __version__
 
96
 
 
97
 
 
98
# allow bzrlib plugins to be imported.
 
99
import bzrlib.plugin
 
100
bzrlib.plugin.set_plugins_path()
 
101
 
 
102
 
 
103
def test_suite():
 
104
    import tests
 
105
    return tests.test_suite()