~bzr-pqm/bzr/bzr.dev

# Copyright (C) 2006 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

"""Tests for reconciliation of repositories."""

import bzrlib

import bzrlib.errors as errors

from bzrlib.inventory import Inventory

from bzrlib.reconcile import reconcile, Reconciler

from bzrlib.repofmt.knitrepo import RepositoryFormatKnit

from bzrlib.revision import Revision

from bzrlib.tests import TestSkipped, TestNotApplicable

from bzrlib.tests.per_repository.helpers import (

    TestCaseWithBrokenRevisionIndex,

    )

from bzrlib.tests.per_repository import (

    TestCaseWithRepository,

    )

from bzrlib.transport import get_transport

from bzrlib.uncommit import uncommit

class TestReconcile(TestCaseWithRepository):

    def checkUnreconciled(self, d, reconciler):

        """Check that d did not get reconciled."""

        # nothing should have been fixed yet:

        self.assertEqual(0, reconciler.inconsistent_parents)

        # and no garbage inventories

        self.assertEqual(0, reconciler.garbage_inventories)

        self.checkNoBackupInventory(d)

    def checkNoBackupInventory(self, aBzrDir):

        """Check that there is no backup inventory in aBzrDir."""

        repo = aBzrDir.open_repository()

        # Remote repository, and possibly others, do not have

        # _transport.

        if getattr(repo, '_transport', None) is not None:

            for path in repo._transport.list_dir('.'):

                self.assertFalse('inventory.backup' in path)

class TestsNeedingReweave(TestReconcile):

    def setUp(self):

        super(TestsNeedingReweave, self).setUp()

        t = get_transport(self.get_url())

        # an empty inventory with no revision for testing with.

        repo = self.make_repository('inventory_without_revision')

        repo.lock_write()

        repo.start_write_group()

        inv = Inventory(revision_id='missing')

        inv.root.revision = 'missing'

        repo.add_inventory('missing', inv, [])

        repo.commit_write_group()

        repo.unlock()

        def add_commit(repo, revision_id, parent_ids):

            repo.lock_write()

            repo.start_write_group()

            inv = Inventory(revision_id=revision_id)

            inv.root.revision = revision_id

            root_id = inv.root.file_id

            sha1 = repo.add_inventory(revision_id, inv, parent_ids)

            repo.texts.add_lines((root_id, revision_id), [], [])

            rev = bzrlib.revision.Revision(timestamp=0,

                                           timezone=None,

                                           committer="Foo Bar <foo@example.com>",

                                           message="Message",

                                           inventory_sha1=sha1,

                                           revision_id=revision_id)

            rev.parent_ids = parent_ids

            repo.add_revision(revision_id, rev)

            repo.commit_write_group()

            repo.unlock()

        # an empty inventory with no revision for testing with.

        # this is referenced by 'references_missing' to let us test

        # that all the cached data is correctly converted into ghost links

        # and the referenced inventory still cleaned.

        repo = self.make_repository('inventory_without_revision_and_ghost')

        repo.lock_write()

        repo.start_write_group()

        repo.add_inventory('missing', inv, [])

        repo.commit_write_group()

        repo.unlock()

        add_commit(repo, 'references_missing', ['missing'])

        # a inventory with no parents and the revision has parents..

        # i.e. a ghost.

        repo = self.make_repository('inventory_one_ghost')

        add_commit(repo, 'ghost', ['the_ghost'])

        # a inventory with a ghost that can be corrected now.

        t.copy_tree('inventory_one_ghost', 'inventory_ghost_present')

        bzrdir_url = self.get_url('inventory_ghost_present')

        bzrdir = bzrlib.bzrdir.BzrDir.open(bzrdir_url)

        repo = bzrdir.open_repository()

        add_commit(repo, 'the_ghost', [])

    def checkEmptyReconcile(self, **kwargs):

        """Check a reconcile on an empty repository."""

        self.make_repository('empty')

        d = bzrlib.bzrdir.BzrDir.open(self.get_url('empty'))

        # calling on a empty repository should do nothing

        reconciler = d.find_repository().reconcile(**kwargs)

        # no inconsistent parents should have been found

        self.assertEqual(0, reconciler.inconsistent_parents)

        # and no garbage inventories

        self.assertEqual(0, reconciler.garbage_inventories)

        # and no backup weave should have been needed/made.

        self.checkNoBackupInventory(d)

    def test_reconcile_empty(self):

        # in an empty repo, theres nothing to do.

        self.checkEmptyReconcile()

    def test_repo_has_reconcile_does_inventory_gc_attribute(self):

        repo = self.make_repository('repo')

        self.assertNotEqual(None, repo._reconcile_does_inventory_gc)

    def test_reconcile_empty_thorough(self):

        # reconcile should accept thorough=True

        self.checkEmptyReconcile(thorough=True)

    def test_convenience_reconcile_inventory_without_revision_reconcile(self):

        # smoke test for the all in one ui tool

        bzrdir_url = self.get_url('inventory_without_revision')

        bzrdir = bzrlib.bzrdir.BzrDir.open(bzrdir_url)

        repo = bzrdir.open_repository()

        if not repo._reconcile_does_inventory_gc:

            raise TestSkipped('Irrelevant test')

        reconcile(bzrdir)

        # now the backup should have it but not the current inventory

        repo = bzrdir.open_repository()

        self.check_missing_was_removed(repo)

    def test_reweave_inventory_without_revision(self):

        # an excess inventory on its own is only reconciled by using thorough

        d_url = self.get_url('inventory_without_revision')

        d = bzrlib.bzrdir.BzrDir.open(d_url)

        repo = d.open_repository()

        if not repo._reconcile_does_inventory_gc:

            raise TestSkipped('Irrelevant test')

        self.checkUnreconciled(d, repo.reconcile())

        reconciler = repo.reconcile(thorough=True)

        # no bad parents

        self.assertEqual(0, reconciler.inconsistent_parents)

        # and one garbage inventory

        self.assertEqual(1, reconciler.garbage_inventories)

        self.check_missing_was_removed(repo)

    def check_thorough_reweave_missing_revision(self, aBzrDir, reconcile,

            **kwargs):

        # actual low level test.

        repo = aBzrDir.open_repository()

        if ([None, 'missing', 'references_missing']

            != repo.get_ancestry('references_missing')):

            # the repo handles ghosts without corruption, so reconcile has

            # nothing to do here. Specifically, this test has the inventory

            # 'missing' present and the revision 'missing' missing, so clearly

            # 'missing' cannot be reported in the present ancestry -> missing

            # is something that can be filled as a ghost.

            expected_inconsistent_parents = 0

        else:

            expected_inconsistent_parents = 1

        reconciler = reconcile(**kwargs)

        # some number of inconsistent parents should have been found

        self.assertEqual(expected_inconsistent_parents,

                         reconciler.inconsistent_parents)

        # and one garbage inventories

        self.assertEqual(1, reconciler.garbage_inventories)

        # now the backup should have it but not the current inventory

        repo = aBzrDir.open_repository()

        self.check_missing_was_removed(repo)

        # and the parent list for 'references_missing' should have that

        # revision a ghost now.

        self.assertEqual([None, 'references_missing'],

                         repo.get_ancestry('references_missing'))

    def check_missing_was_removed(self, repo):

        if repo._reconcile_backsup_inventory:

            backed_up = False

            for path in repo._transport.list_dir('.'):

                if 'inventory.backup' in path:

                    backed_up = True

            self.assertTrue(backed_up)

            # Not clear how to do this at an interface level:

            # self.assertTrue('missing' in backup.versions())

        self.assertRaises(errors.NoSuchRevision, repo.get_inventory, 'missing')

    def test_reweave_inventory_without_revision_reconciler(self):

        # smoke test for the all in one Reconciler class,

        # other tests use the lower level repo.reconcile()

        d_url = self.get_url('inventory_without_revision_and_ghost')

        d = bzrlib.bzrdir.BzrDir.open(d_url)

        if not d.open_repository()._reconcile_does_inventory_gc:

            raise TestSkipped('Irrelevant test')

        def reconcile():

            reconciler = Reconciler(d)

            reconciler.reconcile()

            return reconciler

        self.check_thorough_reweave_missing_revision(d, reconcile)

    def test_reweave_inventory_without_revision_and_ghost(self):

        # actual low level test.

        d_url = self.get_url('inventory_without_revision_and_ghost')

        d = bzrlib.bzrdir.BzrDir.open(d_url)

        repo = d.open_repository()

        if not repo._reconcile_does_inventory_gc:

            raise TestSkipped('Irrelevant test')

        # nothing should have been altered yet : inventories without

        # revisions are not data loss incurring for current format

        self.check_thorough_reweave_missing_revision(d, repo.reconcile,

            thorough=True)

    def test_reweave_inventory_preserves_a_revision_with_ghosts(self):

        d = bzrlib.bzrdir.BzrDir.open(self.get_url('inventory_one_ghost'))

        reconciler = d.open_repository().reconcile(thorough=True)

        # no inconsistent parents should have been found:

        # the lack of a parent for ghost is normal

        self.assertEqual(0, reconciler.inconsistent_parents)

        # and one garbage inventories

        self.assertEqual(0, reconciler.garbage_inventories)

        # now the current inventory should still have 'ghost'

        repo = d.open_repository()

        repo.get_inventory('ghost')

        self.assertEqual([None, 'ghost'], repo.get_ancestry('ghost'))

    def test_reweave_inventory_fixes_ancestryfor_a_present_ghost(self):

        d = bzrlib.bzrdir.BzrDir.open(self.get_url('inventory_ghost_present'))

        repo = d.open_repository()

        ghost_ancestry = repo.get_ancestry('ghost')

        if ghost_ancestry == [None, 'the_ghost', 'ghost']:

            # the repo handles ghosts without corruption, so reconcile has

            # nothing to do

            return

        self.assertEqual([None, 'ghost'], ghost_ancestry)

        reconciler = repo.reconcile()

        # this is a data corrupting error, so a normal reconcile should fix it.

        # one inconsistent parents should have been found : the

        # available but not reference parent for ghost.

        self.assertEqual(1, reconciler.inconsistent_parents)

        # and no garbage inventories

        self.assertEqual(0, reconciler.garbage_inventories)

        # now the current inventory should still have 'ghost'

        repo = d.open_repository()

        repo.get_inventory('ghost')

        repo.get_inventory('the_ghost')

        self.assertEqual([None, 'the_ghost', 'ghost'], repo.get_ancestry('ghost'))

        self.assertEqual([None, 'the_ghost'], repo.get_ancestry('the_ghost'))

class TestReconcileWithIncorrectRevisionCache(TestReconcile):

    """Ancestry data gets cached in knits and weaves should be reconcilable.

    This class tests that reconcile can correct invalid caches (such as after

    a reconcile).

    """

    def setUp(self):

        self.reduceLockdirTimeout()

        super(TestReconcileWithIncorrectRevisionCache, self).setUp()

        t = get_transport(self.get_url())

        # we need a revision with two parents in the wrong order

        # which should trigger reinsertion.

        # and another with the first one correct but the other two not

        # which should not trigger reinsertion.

        # these need to be in different repositories so that we don't

        # trigger a reconcile based on the other case.

        # there is no api to construct a broken knit repository at

        # this point. if we ever encounter a bad graph in a knit repo

        # we should add a lower level api to allow constructing such cases.

        # first off the common logic:

        tree = self.make_branch_and_tree('wrong-first-parent')

        second_tree = self.make_branch_and_tree('reversed-secondary-parents')

        for t in [tree, second_tree]:

            t.commit('1', rev_id='1')

            uncommit(t.branch, tree=t)

            t.commit('2', rev_id='2')

            uncommit(t.branch, tree=t)

            t.commit('3', rev_id='3')

            uncommit(t.branch, tree=t)

        #second_tree = self.make_branch_and_tree('reversed-secondary-parents')

        #second_tree.pull(tree) # XXX won't copy the repo?

        repo_secondary = second_tree.branch.repository

        # now setup the wrong-first parent case

        repo = tree.branch.repository

        repo.lock_write()

        repo.start_write_group()

        inv = Inventory(revision_id='wrong-first-parent')

        inv.root.revision = 'wrong-first-parent'

        sha1 = repo.add_inventory('wrong-first-parent', inv, ['2', '1'])

        rev = Revision(timestamp=0,

                       timezone=None,

                       committer="Foo Bar <foo@example.com>",

                       message="Message",

                       inventory_sha1=sha1,

                       revision_id='wrong-first-parent')

        rev.parent_ids = ['1', '2']

        repo.add_revision('wrong-first-parent', rev)

        repo.commit_write_group()

        repo.unlock()

        # now setup the wrong-secondary parent case

        repo = repo_secondary

        repo.lock_write()

        repo.start_write_group()

        inv = Inventory(revision_id='wrong-secondary-parent')

        inv.root.revision = 'wrong-secondary-parent'

        if repo.supports_rich_root():

            root_id = inv.root.file_id

            repo.texts.add_lines((root_id, 'wrong-secondary-parent'), [], [])

        sha1 = repo.add_inventory('wrong-secondary-parent', inv, ['1', '3', '2'])

        rev = Revision(timestamp=0,

                       timezone=None,

                       committer="Foo Bar <foo@example.com>",

                       message="Message",

                       inventory_sha1=sha1,

                       revision_id='wrong-secondary-parent')

        rev.parent_ids = ['1', '2', '3']

        repo.add_revision('wrong-secondary-parent', rev)

        repo.commit_write_group()

        repo.unlock()

    def test_reconcile_wrong_order(self):

        # a wrong order in primary parents is optionally correctable

        t = get_transport(self.get_url()).clone('wrong-first-parent')

        d = bzrlib.bzrdir.BzrDir.open_from_transport(t)

        repo = d.open_repository()

        repo.lock_read()

        try:

            g = repo.get_graph()

            if g.get_parent_map(['wrong-first-parent'])['wrong-first-parent'] \

                == ('1', '2'):

                raise TestSkipped('wrong-first-parent is not setup for testing')

        finally:

            repo.unlock()

        self.checkUnreconciled(d, repo.reconcile())

        # nothing should have been altered yet : inventories without

        # revisions are not data loss incurring for current format

        reconciler = repo.reconcile(thorough=True)

        # these show up as inconsistent parents

        self.assertEqual(1, reconciler.inconsistent_parents)

        # and no garbage inventories

        self.assertEqual(0, reconciler.garbage_inventories)

        # and should have been fixed:

        repo.lock_read()

        self.addCleanup(repo.unlock)

        g = repo.get_graph()

        self.assertEqual(

            {'wrong-first-parent':('1', '2')},

            g.get_parent_map(['wrong-first-parent']))

    def test_reconcile_wrong_order_secondary_inventory(self):

        # a wrong order in the parents for inventories is ignored.

        t = get_transport(self.get_url()).clone('reversed-secondary-parents')

        d = bzrlib.bzrdir.BzrDir.open_from_transport(t)

        repo = d.open_repository()

        self.checkUnreconciled(d, repo.reconcile())

        self.checkUnreconciled(d, repo.reconcile(thorough=True))

class TestBadRevisionParents(TestCaseWithBrokenRevisionIndex):

    def test_aborts_if_bad_parents_in_index(self):

        """Reconcile refuses to proceed if the revision index is wrong when

        checked against the revision texts, so that it does not generate broken

        data.

        Ideally reconcile would fix this, but until we implement that we just

        make sure we safely detect this problem.

        """

        repo = self.make_repo_with_extra_ghost_index()

        reconciler = repo.reconcile(thorough=True)

        self.assertTrue(reconciler.aborted,

            "reconcile should have aborted due to bad parents.")

    def test_does_not_abort_on_clean_repo(self):

        repo = self.make_repository('.')

        reconciler = repo.reconcile(thorough=True)

        self.assertFalse(reconciler.aborted,

            "reconcile should not have aborted on an unbroken repository.")

class TestRepeatedReconcile(TestReconcile):

    def test_trivial_two_reconciles_no_error(self):

        tree = self.make_branch_and_tree('.')

        tree.commit('first post')

        tree.branch.repository.reconcile(thorough=True)

        tree.branch.repository.reconcile(thorough=True)