1
# Copyright (C) 2007, 2009-2012 Canonical Ltd.
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.
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.
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
from __future__ import absolute_import
19
# Original author: David Allouche
27
from .branch import Branch
28
from .i18n import gettext
29
from .trace import note
32
def _run_post_switch_hooks(control_dir, to_branch, force, revision_id):
33
from .branch import SwitchHookParams
34
hooks = Branch.hooks['post_switch']
37
params = SwitchHookParams(control_dir, to_branch, force, revision_id)
42
def switch(control_dir, to_branch, force=False, quiet=False, revision_id=None,
43
store_uncommitted=False):
44
"""Switch the branch associated with a checkout.
46
:param control_dir: ControlDir of the checkout to change
47
:param to_branch: branch that the checkout is to reference
48
:param force: skip the check for local commits in a heavy checkout
49
:param revision_id: revision ID to switch to.
50
:param store_uncommitted: If True, store uncommitted changes in the
53
_check_pending_merges(control_dir, force)
55
source_repository = control_dir.open_branch().repository
56
except errors.NotBranchError:
57
source_repository = to_branch.repository
59
with lock.write_locked(control_dir.open_workingtree()) as tree:
60
tree.store_uncommitted()
61
with to_branch.lock_read():
62
_set_branch_location(control_dir, to_branch, force)
63
tree = control_dir.open_workingtree()
64
_update(tree, source_repository, quiet, revision_id, store_uncommitted)
65
_run_post_switch_hooks(control_dir, to_branch, force, revision_id)
68
def _check_pending_merges(control, force=False):
69
"""Check that there are no outstanding pending merges before switching.
71
:param control: ControlDir of the branch to check
74
tree = control.open_workingtree()
75
except errors.NotBranchError as ex:
76
# Lightweight checkout and branch is no longer there
81
# XXX: Should the tree be locked for get_parent_ids?
82
existing_pending_merges = tree.get_parent_ids()[1:]
83
if len(existing_pending_merges) > 0:
84
raise errors.BzrCommandError(gettext('Pending merges must be '
85
'committed or reverted before using switch.'))
88
def _set_branch_location(control, to_branch, force=False):
89
"""Set location value of a branch reference.
91
:param control: ControlDir of the checkout to change
92
:param to_branch: branch that the checkout is to reference
93
:param force: skip the check for local commits in a heavy checkout
95
branch_format = control.find_branch_format()
96
if branch_format.get_reference(control) is not None:
97
# Lightweight checkout: update the branch reference
98
branch_format.set_reference(control, None, to_branch)
100
b = control.open_branch()
101
bound_branch = b.get_bound_location()
102
if bound_branch is not None:
103
# Heavyweight checkout: check all local commits
104
# have been pushed to the current bound branch then
105
# synchronise the local branch with the new remote branch
107
possible_transports = []
109
if not force and _any_local_commits(b, possible_transports):
110
raise errors.BzrCommandError(gettext(
111
'Cannot switch as local commits found in the checkout. '
112
'Commit these to the bound branch or use --force to '
114
except errors.BoundBranchConnectionFailure as e:
115
raise errors.BzrCommandError(gettext(
116
'Unable to connect to current master branch %(target)s: '
117
'%(error)s To switch anyway, use --force.') %
121
b.set_bound_location(None)
122
b.pull(to_branch, overwrite=True,
123
possible_transports=possible_transports)
124
b.set_bound_location(to_branch.base)
125
b.set_parent(b.get_master_branch().get_parent())
129
# If this is a standalone tree and the new branch
130
# is derived from this one, create a lightweight checkout.
132
graph = b.repository.get_graph(to_branch.repository)
133
if (b.controldir._format.colocated_branches and
134
(force or graph.is_ancestor(
135
b.last_revision(), to_branch.last_revision()))):
136
b.controldir.destroy_branch()
137
b.controldir.set_branch_reference(to_branch, name="")
139
raise errors.BzrCommandError(
140
gettext('Cannot switch a branch, only a checkout.'))
143
def _any_local_commits(this_branch, possible_transports):
144
"""Does this branch have any commits not in the master branch?"""
145
last_rev = revision.ensure_null(this_branch.last_revision())
146
if last_rev != revision.NULL_REVISION:
147
other_branch = this_branch.get_master_branch(possible_transports)
148
with this_branch.lock_read(), other_branch.lock_read():
149
other_last_rev = other_branch.last_revision()
150
graph = this_branch.repository.get_graph(
151
other_branch.repository)
152
if not graph.is_ancestor(last_rev, other_last_rev):
157
def _update(tree, source_repository, quiet=False, revision_id=None,
158
restore_uncommitted=False):
159
"""Update a working tree to the latest revision of its branch.
161
:param tree: the working tree
162
:param source_repository: repository holding the revisions
163
:param restore_uncommitted: restore any uncommitted changes in the branch.
165
if restore_uncommitted:
168
tree.lock_tree_write()
170
to_branch = tree.branch
171
if revision_id is None:
172
revision_id = to_branch.last_revision()
173
if tree.last_revision() == revision_id:
175
note(gettext("Tree is up to date at revision %d."),
178
base_tree = source_repository.revision_tree(tree.last_revision())
179
merge.Merge3Merger(tree, tree, base_tree,
180
to_branch.repository.revision_tree(revision_id))
181
tree.set_last_revision(to_branch.last_revision())
183
note(gettext('Updated to revision %d.') % to_branch.revno())
184
if restore_uncommitted:
185
tree.restore_uncommitted()