/brz/remove-bazaar

# Copyright (C) 2007 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

"""Tests that branch classes implement hook callouts correctly."""

from bzrlib.branch import Branch, ChangeBranchTipParams

from bzrlib.errors import HookFailed, TipChangeRejected

from bzrlib.remote import RemoteBranch

from bzrlib.revision import NULL_REVISION

from bzrlib.smart import server

from bzrlib.tests import TestCaseWithMemoryTransport

class ChangeBranchTipTestCase(TestCaseWithMemoryTransport):

    """Base TestCase for testing pre/post_change_branch_tip hooks."""

    def install_logging_hook(self, prefix):

        """Add a hook that logs calls made to it.

        :returns: the list that the calls will be appended to.

        """

        hook_calls = []

        Branch.hooks.install_named_hook(

            prefix + '_change_branch_tip', hook_calls.append, None)

        return hook_calls

    def make_branch_with_revision_ids(self, *revision_ids):

        """Makes a branch with the given commits."""

        tree = self.make_branch_and_memory_tree('source')

        tree.lock_write()

        tree.add('')

        for revision_id in revision_ids:

            tree.commit(u'Message of ' + revision_id.decode('utf8'),

                        rev_id=revision_id)

        tree.unlock()

        branch = tree.branch

        return branch

    def assertHookCalls(self, expected_params, branch, hook_calls=None,

        pre=False):

        if hook_calls is None:

            hook_calls = self.hook_calls

        if isinstance(branch, RemoteBranch):

            # For a remote branch, both the server and the client will raise

            # this hook, and we see both in the test environment. The remote

            # instance comes in between the clients - the client doe pre, the

            # server does pre, the server does post, the client does post.

            if pre:

                offset = 0

            else:

                offset = 1

            self.assertEqual(expected_params, hook_calls[offset])

            self.assertEqual(2, len(hook_calls))

        else:

            self.assertEqual([expected_params], hook_calls)

class TestSetRevisionHistoryHook(ChangeBranchTipTestCase):

    def setUp(self):

        self.hook_calls = []

        TestCaseWithMemoryTransport.setUp(self)

    def capture_set_rh_hook(self, branch, rev_history):

        """Capture post set-rh hook calls to self.hook_calls.

        The call is logged, as is some state of the branch.

        """

        self.hook_calls.append(

            ('set_rh', branch, rev_history, branch.is_locked()))

    def test_set_rh_empty_history(self):

        branch = self.make_branch('source')

        Branch.hooks.install_named_hook('set_rh', self.capture_set_rh_hook,

                                        None)

        branch.set_revision_history([])

        expected_params = ('set_rh', branch, [], True)

        self.assertHookCalls(expected_params, branch)

    def test_set_rh_nonempty_history(self):

        tree = self.make_branch_and_memory_tree('source')

        tree.lock_write()

        tree.add('')

        tree.commit('another commit', rev_id='f\xc2\xb5')

        tree.commit('empty commit', rev_id='foo')

        tree.unlock()

        branch = tree.branch

        Branch.hooks.install_named_hook('set_rh', self.capture_set_rh_hook,

                                        None)

        # some branches require that their history be set to a revision in the

        # repository

        branch.set_revision_history(['f\xc2\xb5'])

        expected_params =('set_rh', branch, ['f\xc2\xb5'], True)

        self.assertHookCalls(expected_params, branch)

    def test_set_rh_branch_is_locked(self):

        branch = self.make_branch('source')

        Branch.hooks.install_named_hook('set_rh', self.capture_set_rh_hook,

                                        None)

        branch.set_revision_history([])

        expected_params = ('set_rh', branch, [], True)

        self.assertHookCalls(expected_params, branch)

    def test_set_rh_calls_all_hooks_no_errors(self):

        branch = self.make_branch('source')

        Branch.hooks.install_named_hook('set_rh', self.capture_set_rh_hook,

                                        None)

        Branch.hooks.install_named_hook('set_rh', self.capture_set_rh_hook,

                                        None)

        branch.set_revision_history([])

        expected_calls = [('set_rh', branch, [], True),

            ('set_rh', branch, [], True),

            ]

        if isinstance(branch, RemoteBranch):

            # For a remote branch, both the server and the client will raise

            # set_rh, and the server will do so first because that is where

            # the change takes place.

            self.assertEqual(expected_calls, self.hook_calls[2:])

            self.assertEqual(4, len(self.hook_calls))

        else:

            self.assertEqual(expected_calls, self.hook_calls)

class TestOpen(TestCaseWithMemoryTransport):

    def capture_hook(self, branch):

        self.hook_calls.append(branch)

    def install_hook(self):

        self.hook_calls = []

        Branch.hooks.install_named_hook('open', self.capture_hook, None)

    def test_create(self):

        self.install_hook()

        b = self.make_branch('.')

        if isinstance(b, RemoteBranch):

            # RemoteBranch creation:

            # - creates the branch via the VFS (for older servers)

            # - does a branch open (by creating a RemoteBranch object)

            # - this has the nearly the same behaviour as simple branch opening

            if (self.transport_readonly_server ==

                server.ReadonlySmartTCPServer_for_testing_v2_only):

                # Older servers:

                self.assertEqual(b._real_branch, self.hook_calls[0])

                self.assertOpenedRemoteBranch(self.hook_calls[1:], b)

            else:

                self.assertOpenedRemoteBranch(self.hook_calls, b,

                    remote_first=True)

        else:

            self.assertEqual([b], self.hook_calls)

    def test_open(self):

        branch_url = self.make_branch('.').bzrdir.root_transport.base

        self.install_hook()

        b = Branch.open(branch_url)

        if isinstance(b, RemoteBranch):

            self.assertOpenedRemoteBranch(self.hook_calls, b)

        else:

            self.assertEqual([b], self.hook_calls)

    def assertOpenedRemoteBranch(self, hook_calls, b, remote_first=False):

        """Assert that the expected calls were recorded for opening 'b'.

        :param remote_first: If True expect the server side operation to open

            the branch object first.

        """

        # RemoteBranch open always opens the backing branch to get stacking

        # details. As that is done remotely we can't see the branch object

        # nor even compare base url's etc. So we just assert that the first

        # branch returned is the RemoteBranch, and that the second is a

        # Branch but not a RemoteBranch.

        #

        # RemoteBranch *creation* on the other hand creates the branch object

        # on the server, and then creates the local proxy object in the client,

        # so it sees the reverse order.

        self.assertEqual(2, len(hook_calls))

        if remote_first:

            real_index = 0

            remote_index = 1

        else:

            real_index = 1

            remote_index = 0

        self.assertEqual(b, hook_calls[remote_index])

        self.assertIsInstance(hook_calls[real_index], Branch)

        self.assertFalse(isinstance(hook_calls[real_index], RemoteBranch))

class TestPreChangeBranchTip(ChangeBranchTipTestCase):

    """Tests for pre_change_branch_tip hook.

    Most of these tests are very similar to the tests in

    TestPostChangeBranchTip.

    """

    def test_hook_runs_before_change(self):

        """The hook runs *before* the branch's last_revision_info has changed.

        """

        branch = self.make_branch_with_revision_ids('revid-one')

        def assertBranchAtRevision1(params):

            self.assertEquals(

                (1, 'revid-one'), params.branch.last_revision_info())

        Branch.hooks.install_named_hook(

            'pre_change_branch_tip', assertBranchAtRevision1, None)

        branch.set_last_revision_info(0, NULL_REVISION)

    def test_hook_failure_prevents_change(self):

        """If a hook raises an exception, the change does not take effect.

        Also, a HookFailed exception will be raised.

        """

        branch = self.make_branch_with_revision_ids(

            'one-\xc2\xb5', 'two-\xc2\xb5')

        class PearShapedError(Exception):

            pass

        def hook_that_raises(params):

            raise PearShapedError()

        Branch.hooks.install_named_hook(

            'pre_change_branch_tip', hook_that_raises, None)

        hook_failed_exc = self.assertRaises(

            HookFailed, branch.set_last_revision_info, 0, NULL_REVISION)

        self.assertIsInstance(hook_failed_exc.exc_value, PearShapedError)

        # The revision info is unchanged.

        self.assertEqual((2, 'two-\xc2\xb5'), branch.last_revision_info())

    def test_empty_history(self):

        branch = self.make_branch('source')

        hook_calls = self.install_logging_hook('pre')

        branch.set_last_revision_info(0, NULL_REVISION)

        expected_params = ChangeBranchTipParams(

            branch, 0, 0, NULL_REVISION, NULL_REVISION)

        self.assertHookCalls(expected_params, branch, hook_calls, pre=True)

    def test_nonempty_history(self):

        # some branches require that their history be set to a revision in the

        # repository, so we need to make a branch with non-empty history for

        # this test.

        branch = self.make_branch_with_revision_ids(

            'one-\xc2\xb5', 'two-\xc2\xb5')

        hook_calls = self.install_logging_hook('pre')

        branch.set_last_revision_info(1, 'one-\xc2\xb5')

        expected_params = ChangeBranchTipParams(

            branch, 2, 1, 'two-\xc2\xb5', 'one-\xc2\xb5')

        self.assertHookCalls(expected_params, branch, hook_calls, pre=True)

    def test_branch_is_locked(self):

        branch = self.make_branch('source')

        def assertBranchIsLocked(params):

            self.assertTrue(params.branch.is_locked())

        Branch.hooks.install_named_hook(

            'pre_change_branch_tip', assertBranchIsLocked, None)

        branch.set_last_revision_info(0, NULL_REVISION)

    def test_calls_all_hooks_no_errors(self):

        """If multiple hooks are registered, all are called (if none raise

        errors).

        """

        branch = self.make_branch('source')

        hook_calls_1 = self.install_logging_hook('pre')

        hook_calls_2 = self.install_logging_hook('pre')

        self.assertIsNot(hook_calls_1, hook_calls_2)

        branch.set_last_revision_info(0, NULL_REVISION)

        # Both hooks are called.

        if isinstance(branch, RemoteBranch):

            count = 2

        else:

            count = 1

        self.assertEqual(len(hook_calls_1), count)

        self.assertEqual(len(hook_calls_2), count)

    def test_explicit_reject_by_hook(self):

        """If a hook raises TipChangeRejected, the change does not take effect.

        TipChangeRejected exceptions are propagated, not wrapped in HookFailed.

        """

        branch = self.make_branch_with_revision_ids(

            'one-\xc2\xb5', 'two-\xc2\xb5')

        def hook_that_rejects(params):

            raise TipChangeRejected('rejection message')

        Branch.hooks.install_named_hook(

            'pre_change_branch_tip', hook_that_rejects, None)

        self.assertRaises(

            TipChangeRejected, branch.set_last_revision_info, 0, NULL_REVISION)

        # The revision info is unchanged.

        self.assertEqual((2, 'two-\xc2\xb5'), branch.last_revision_info())

class TestPostChangeBranchTip(ChangeBranchTipTestCase):

    """Tests for post_change_branch_tip hook.

    Most of these tests are very similar to the tests in

    TestPostChangeBranchTip.

    """

    def test_hook_runs_after_change(self):

        """The hook runs *after* the branch's last_revision_info has changed.

        """

        branch = self.make_branch_with_revision_ids('revid-one')

        def assertBranchAtRevision1(params):

            self.assertEquals(

                (0, NULL_REVISION), params.branch.last_revision_info())

        Branch.hooks.install_named_hook(

            'post_change_branch_tip', assertBranchAtRevision1, None)

        branch.set_last_revision_info(0, NULL_REVISION)

    def test_empty_history(self):

        branch = self.make_branch('source')

        hook_calls = self.install_logging_hook('post')

        branch.set_last_revision_info(0, NULL_REVISION)

        expected_params = ChangeBranchTipParams(

            branch, 0, 0, NULL_REVISION, NULL_REVISION)

        self.assertHookCalls(expected_params, branch, hook_calls)

    def test_nonempty_history(self):

        # some branches require that their history be set to a revision in the

        # repository, so we need to make a branch with non-empty history for

        # this test.

        branch = self.make_branch_with_revision_ids(

            'one-\xc2\xb5', 'two-\xc2\xb5')

        hook_calls = self.install_logging_hook('post')

        branch.set_last_revision_info(1, 'one-\xc2\xb5')

        expected_params = ChangeBranchTipParams(

            branch, 2, 1, 'two-\xc2\xb5', 'one-\xc2\xb5')

        self.assertHookCalls(expected_params, branch, hook_calls)

    def test_branch_is_locked(self):

        """The branch passed to the hook is locked."""

        branch = self.make_branch('source')

        def assertBranchIsLocked(params):

            self.assertTrue(params.branch.is_locked())

        Branch.hooks.install_named_hook(

            'post_change_branch_tip', assertBranchIsLocked, None)

        branch.set_last_revision_info(0, NULL_REVISION)

    def test_calls_all_hooks_no_errors(self):

        """If multiple hooks are registered, all are called (if none raise

        errors).

        """

        branch = self.make_branch('source')

        hook_calls_1 = self.install_logging_hook('post')

        hook_calls_2 = self.install_logging_hook('post')

        self.assertIsNot(hook_calls_1, hook_calls_2)

        branch.set_last_revision_info(0, NULL_REVISION)

        # Both hooks are called.

        if isinstance(branch, RemoteBranch):

            count = 2

        else:

            count = 1

        self.assertEqual(len(hook_calls_1), count)

        self.assertEqual(len(hook_calls_2), count)

class TestAllMethodsThatChangeTipWillRunHooks(ChangeBranchTipTestCase):

    """Every method of Branch that changes a branch tip will invoke the

    pre/post_change_branch_tip hooks.

    """

    def setUp(self):

        ChangeBranchTipTestCase.setUp(self)

        self.installPreAndPostHooks()

    def installPreAndPostHooks(self):

        self.pre_hook_calls = self.install_logging_hook('pre')

        self.post_hook_calls = self.install_logging_hook('post')

    def resetHookCalls(self):

        del self.pre_hook_calls[:], self.post_hook_calls[:]

    def assertPreAndPostHooksWereInvoked(self, branch, smart_enabled):

        """assert that both pre and post hooks were called

        :param smart_enabled: The method invoked is one that should be

            smart server ready.

        """

        # Check for the number of invocations expected. One invocation is

        # local, one is remote (if the branch is remote).

        if smart_enabled and isinstance(branch, RemoteBranch):

            length = 2

        else:

            length = 1

        self.assertEqual(length, len(self.pre_hook_calls))

        self.assertEqual(length, len(self.post_hook_calls))

    def test_set_revision_history(self):

        branch = self.make_branch('')

        branch.set_revision_history([])

        self.assertPreAndPostHooksWereInvoked(branch, True)

    def test_set_last_revision_info(self):

        branch = self.make_branch('')

        branch.set_last_revision_info(0, NULL_REVISION)

        self.assertPreAndPostHooksWereInvoked(branch, True)

    def test_generate_revision_history(self):

        branch = self.make_branch('')

        branch.generate_revision_history(NULL_REVISION)

        # NB: for HPSS protocols < v3, the server does not invoke branch tip

        # change events on generate_revision_history, as the change is done

        # directly by the client over the VFS.

        self.assertPreAndPostHooksWereInvoked(branch, True)

    def test_pull(self):

        source_branch = self.make_branch_with_revision_ids('rev-1', 'rev-2')

        self.resetHookCalls()

        destination_branch = self.make_branch('destination')

        destination_branch.pull(source_branch)

        self.assertPreAndPostHooksWereInvoked(destination_branch, False)

    def test_push(self):

        source_branch = self.make_branch_with_revision_ids('rev-1', 'rev-2')

        self.resetHookCalls()

        destination_branch = self.make_branch('destination')

        source_branch.push(destination_branch)

        self.assertPreAndPostHooksWereInvoked(destination_branch, True)