/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/upgrade.py

  • Committer: mernst at mit
  • Date: 2008-10-16 10:57:16 UTC
  • mto: This revision was merged to the branch mainline in revision 3799.
  • Revision ID: mernst@csail.mit.edu-20081016105716-v8x8n5t2pf7f6uds
Improved documentation of stacked and lightweight branches

These patches improve the User Guide's documentation of stacked and
lightweight branches.

Section "1.2.6 Putting the concepts together" should mention stacked
branches and the difference between them and lightweight branches.  It
should also contain links to further details of the common scenarios.

Section "5.3.4 Getting a lightweight checkout" should mention stacked
branches as an option, and should link to all the options, not just some of
them.  It should also clarify that lightweight only applies to checkouts,
not to arbitrary branches.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/upgrade.py
 
1
# Copyright (C) 2005, 2008 Canonical Ltd
 
2
#
 
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.
 
7
#
 
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.
 
12
#
 
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
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
"""bzr upgrade logic."""
 
18
 
 
19
# change upgrade from .bzr to create a '.bzr-new', then do a bait and switch.
 
20
 
 
21
 
 
22
from bzrlib.bzrdir import ConvertBzrDir4To5, ConvertBzrDir5To6, BzrDir, BzrDirFormat4, BzrDirFormat5, BzrDirFormat
 
23
import bzrlib.errors as errors
 
24
from bzrlib.remote import RemoteBzrDir
 
25
from bzrlib.transport import get_transport
 
26
import bzrlib.ui as ui
 
27
 
 
28
 
 
29
class Convert(object):
 
30
 
 
31
    def __init__(self, url, format):
 
32
        self.format = format
 
33
        self.bzrdir = BzrDir.open_unsupported(url)
 
34
        if isinstance(self.bzrdir, RemoteBzrDir):
 
35
            self.bzrdir._ensure_real()
 
36
            self.bzrdir = self.bzrdir._real_bzrdir
 
37
        if self.bzrdir.root_transport.is_readonly():
 
38
            raise errors.UpgradeReadonly
 
39
        self.transport = self.bzrdir.root_transport
 
40
        self.pb = ui.ui_factory.nested_progress_bar()
 
41
        try:
 
42
            self.convert()
 
43
        finally:
 
44
            self.pb.finished()
 
45
 
 
46
    def convert(self):
 
47
        try:
 
48
            branch = self.bzrdir.open_branch()
 
49
            if branch.bzrdir.root_transport.base != \
 
50
                self.bzrdir.root_transport.base:
 
51
                self.pb.note("This is a checkout. The branch (%s) needs to be "
 
52
                             "upgraded separately.",
 
53
                             branch.bzrdir.root_transport.base)
 
54
            del branch
 
55
        except (errors.NotBranchError, errors.IncompatibleRepositories):
 
56
            # might not be a format we can open without upgrading; see e.g. 
 
57
            # https://bugs.launchpad.net/bzr/+bug/253891
 
58
            pass
 
59
        if not self.bzrdir.needs_format_conversion(self.format):
 
60
            raise errors.UpToDateFormat(self.bzrdir._format)
 
61
        if not self.bzrdir.can_convert_format():
 
62
            raise errors.BzrError("cannot upgrade from bzrdir format %s" %
 
63
                           self.bzrdir._format)
 
64
        if self.format is None:
 
65
            target_format = BzrDirFormat.get_default_format()
 
66
        else:
 
67
            target_format = self.format
 
68
        self.bzrdir.check_conversion_target(target_format)
 
69
        self.pb.note('starting upgrade of %s', self.transport.base)
 
70
        self._backup_control_dir()
 
71
        while self.bzrdir.needs_format_conversion(self.format):
 
72
            converter = self.bzrdir._format.get_converter(self.format)
 
73
            self.bzrdir = converter.convert(self.bzrdir, self.pb)
 
74
        self.pb.note("finished")
 
75
 
 
76
    def _backup_control_dir(self):
 
77
        self.pb.note('making backup of tree history')
 
78
        self.transport.copy_tree('.bzr', 'backup.bzr')
 
79
        self.pb.note('%s.bzr has been backed up to %sbackup.bzr',
 
80
             self.transport.base,
 
81
             self.transport.base)
 
82
        self.pb.note('if conversion fails, you can move this directory back to .bzr')
 
83
        self.pb.note('if it succeeds, you can remove this directory if you wish')
 
84
 
 
85
def upgrade(url, format=None):
 
86
    """Upgrade to format, or the default bzrdir format if not supplied."""
 
87
    Convert(url, format)