# Copyright (C) 2007-2010 Canonical Ltd # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA """Reconfigure a controldir into a new tree/branch/repository layout. Various types of reconfiguration operation are available either by constructing a class or using a factory method on Reconfigure. """ from __future__ import absolute_import from bzrlib import ( branch, controldir, errors, trace, ui, urlutils, ) from bzrlib.i18n import gettext # TODO: common base class for all reconfigure operations, making no # assumptions about what kind of change will be done. class ReconfigureStackedOn(object): """Reconfigures a branch to be stacked on another branch.""" def apply(self, bzrdir, stacked_on_url): branch = bzrdir.open_branch() # it may be a path relative to the cwd or a url; the branch wants # a path relative to itself... on_url = urlutils.relative_url(branch.base, urlutils.normalize_url(stacked_on_url)) branch.lock_write() try: branch.set_stacked_on_url(on_url) if not trace.is_quiet(): ui.ui_factory.note(gettext( "{0} is now stacked on {1}\n").format( branch.base, branch.get_stacked_on_url())) finally: branch.unlock() class ReconfigureUnstacked(object): def apply(self, bzrdir): branch = bzrdir.open_branch() branch.lock_write() try: branch.set_stacked_on_url(None) if not trace.is_quiet(): ui.ui_factory.note(gettext( "%s is now not stacked\n") % (branch.base,)) finally: branch.unlock() class Reconfigure(object): def __init__(self, bzrdir, new_bound_location=None): self.bzrdir = bzrdir self.new_bound_location = new_bound_location self.local_repository = None try: self.repository = self.bzrdir.find_repository() except errors.NoRepositoryPresent: self.repository = None self.local_repository = None else: if (self.repository.user_url == self.bzrdir.user_url): self.local_repository = self.repository else: self.local_repository = None try: branch = self.bzrdir.open_branch() if branch.user_url == bzrdir.user_url: self.local_branch = branch self.referenced_branch = None else: self.local_branch = None self.referenced_branch = branch except errors.NotBranchError: self.local_branch = None self.referenced_branch = None try: self.tree = bzrdir.open_workingtree() except errors.NoWorkingTree: self.tree = None self._unbind = False self._bind = False self._destroy_reference = False self._create_reference = False self._destroy_branch = False self._create_branch = False self._destroy_tree = False self._create_tree = False self._create_repository = False self._destroy_repository = False self._repository_trees = None @staticmethod def to_branch(bzrdir): """Return a Reconfiguration to convert this bzrdir into a branch :param bzrdir: The bzrdir to reconfigure :raise errors.AlreadyBranch: if bzrdir is already a branch """ reconfiguration = Reconfigure(bzrdir) reconfiguration._plan_changes(want_tree=False, want_branch=True, want_bound=False, want_reference=False) if not reconfiguration.changes_planned(): raise errors.AlreadyBranch(bzrdir) return reconfiguration @staticmethod def to_tree(bzrdir): """Return a Reconfiguration to convert this bzrdir into a tree :param bzrdir: The bzrdir to reconfigure :raise errors.AlreadyTree: if bzrdir is already a tree """ reconfiguration = Reconfigure(bzrdir) reconfiguration._plan_changes(want_tree=True, want_branch=True, want_bound=False, want_reference=False) if not reconfiguration.changes_planned(): raise errors.AlreadyTree(bzrdir) return reconfiguration @staticmethod def to_checkout(bzrdir, bound_location=None): """Return a Reconfiguration to convert this bzrdir into a checkout :param bzrdir: The bzrdir to reconfigure :param bound_location: The location the checkout should be bound to. :raise errors.AlreadyCheckout: if bzrdir is already a checkout """ reconfiguration = Reconfigure(bzrdir, bound_location) reconfiguration._plan_changes(want_tree=True, want_branch=True, want_bound=True, want_reference=False) if not reconfiguration.changes_planned(): raise errors.AlreadyCheckout(bzrdir) return reconfiguration @classmethod def to_lightweight_checkout(klass, bzrdir, reference_location=None): """Make a Reconfiguration to convert bzrdir into a lightweight checkout :param bzrdir: The bzrdir to reconfigure :param bound_location: The location the checkout should be bound to. :raise errors.AlreadyLightweightCheckout: if bzrdir is already a lightweight checkout """ reconfiguration = klass(bzrdir, reference_location) reconfiguration._plan_changes(want_tree=True, want_branch=False, want_bound=False, want_reference=True) if not reconfiguration.changes_planned(): raise errors.AlreadyLightweightCheckout(bzrdir) return reconfiguration @classmethod def to_use_shared(klass, bzrdir): """Convert a standalone branch into a repository branch""" reconfiguration = klass(bzrdir) reconfiguration._set_use_shared(use_shared=True) if not reconfiguration.changes_planned(): raise errors.AlreadyUsingShared(bzrdir) return reconfiguration @classmethod def to_standalone(klass, bzrdir): """Convert a repository branch into a standalone branch""" reconfiguration = klass(bzrdir) reconfiguration._set_use_shared(use_shared=False) if not reconfiguration.changes_planned(): raise errors.AlreadyStandalone(bzrdir) return reconfiguration @classmethod def set_repository_trees(klass, bzrdir, with_trees): """Adjust a repository's working tree presence default""" reconfiguration = klass(bzrdir) if not reconfiguration.repository.is_shared(): raise errors.ReconfigurationNotSupported(reconfiguration.bzrdir) if with_trees and reconfiguration.repository.make_working_trees(): raise errors.AlreadyWithTrees(bzrdir) elif (not with_trees and not reconfiguration.repository.make_working_trees()): raise errors.AlreadyWithNoTrees(bzrdir) else: reconfiguration._repository_trees = with_trees return reconfiguration def _plan_changes(self, want_tree, want_branch, want_bound, want_reference): """Determine which changes are needed to assume the configuration""" if not want_branch and not want_reference: raise errors.ReconfigurationNotSupported(self.bzrdir) if want_branch and want_reference: raise errors.ReconfigurationNotSupported(self.bzrdir) if self.repository is None: if not want_reference: self._create_repository = True else: if want_reference and ( self.repository.user_url == self.bzrdir.user_url): if not self.repository.is_shared(): self._destroy_repository = True if self.referenced_branch is None: if want_reference: self._create_reference = True if self.local_branch is not None: self._destroy_branch = True else: if not want_reference: self._destroy_reference = True if self.local_branch is None: if want_branch is True: self._create_branch = True if want_bound: self._bind = True else: if want_bound: if self.local_branch.get_bound_location() is None: self._bind = True else: if self.local_branch.get_bound_location() is not None: self._unbind = True if not want_tree and self.tree is not None: self._destroy_tree = True if want_tree and self.tree is None: self._create_tree = True def _set_use_shared(self, use_shared=None): if use_shared is None: return if use_shared: if self.local_repository is not None: self._destroy_repository = True else: if self.local_repository is None: self._create_repository = True def changes_planned(self): """Return True if changes are planned, False otherwise""" return (self._unbind or self._bind or self._destroy_tree or self._create_tree or self._destroy_reference or self._create_branch or self._create_repository or self._create_reference or self._destroy_repository) def _check(self): """Raise if reconfiguration would destroy local changes""" if self._destroy_tree and self.tree.has_changes(): raise errors.UncommittedChanges(self.tree) if self._create_reference and self.local_branch is not None: reference_branch = branch.Branch.open(self._select_bind_location()) if (reference_branch.last_revision() != self.local_branch.last_revision()): raise errors.UnsyncedBranches(self.bzrdir, reference_branch) def _select_bind_location(self): """Select a location to bind or create a reference to. Preference is: 1. user specified location 2. branch reference location (it's a kind of bind location) 3. current bind location 4. previous bind location (it was a good choice once) 5. push location (it's writeable, so committable) 6. parent location (it's pullable, so update-from-able) """ if self.new_bound_location is not None: return self.new_bound_location if self.local_branch is not None: bound = self.local_branch.get_bound_location() if bound is not None: return bound old_bound = self.local_branch.get_old_bound_location() if old_bound is not None: return old_bound push_location = self.local_branch.get_push_location() if push_location is not None: return push_location parent = self.local_branch.get_parent() if parent is not None: return parent elif self.referenced_branch is not None: return self.referenced_branch.base raise errors.NoBindLocation(self.bzrdir) def apply(self, force=False): """Apply the reconfiguration :param force: If true, the reconfiguration is applied even if it will destroy local changes. :raise errors.UncommittedChanges: if the local tree is to be destroyed but contains uncommitted changes. :raise errors.NoBindLocation: if no bind location was specified and none could be autodetected. """ if not force: self._check() if self._create_repository: if self.local_branch and not self._destroy_branch: old_repo = self.local_branch.repository elif self._create_branch and self.referenced_branch is not None: old_repo = self.referenced_branch.repository else: old_repo = None if old_repo is not None: repository_format = old_repo._format else: repository_format = None if repository_format is not None: repo = repository_format.initialize(self.bzrdir) else: repo = self.bzrdir.create_repository() if self.local_branch and not self._destroy_branch: repo.fetch(self.local_branch.repository, self.local_branch.last_revision()) else: repo = self.repository if self._create_branch and self.referenced_branch is not None: repo.fetch(self.referenced_branch.repository, self.referenced_branch.last_revision()) if self._create_reference: reference_branch = branch.Branch.open(self._select_bind_location()) if self._destroy_repository: if self._create_reference: reference_branch.repository.fetch(self.repository) elif self.local_branch is not None and not self._destroy_branch: up = self.local_branch.user_transport.clone('..') up_bzrdir = controldir.ControlDir.open_containing_from_transport( up)[0] new_repo = up_bzrdir.find_repository() new_repo.fetch(self.repository) last_revision_info = None if self._destroy_reference: last_revision_info = self.referenced_branch.last_revision_info() self.bzrdir.destroy_branch() if self._destroy_branch: last_revision_info = self.local_branch.last_revision_info() if self._create_reference: self.local_branch.tags.merge_to(reference_branch.tags) self.bzrdir.destroy_branch() if self._create_branch: local_branch = self.bzrdir.create_branch() if last_revision_info is not None: local_branch.set_last_revision_info(*last_revision_info) if self._destroy_reference: self.referenced_branch.tags.merge_to(local_branch.tags) self.referenced_branch.update_references(local_branch) else: local_branch = self.local_branch if self._create_reference: self.bzrdir.set_branch_reference(reference_branch) if self._destroy_tree: self.bzrdir.destroy_workingtree() if self._create_tree: self.bzrdir.create_workingtree() if self._unbind: self.local_branch.unbind() if self._bind: bind_location = self._select_bind_location() local_branch.bind(branch.Branch.open(bind_location)) if self._destroy_repository: self.bzrdir.destroy_repository() if self._repository_trees is not None: repo.set_make_working_trees(self._repository_trees)