# test_missing_obj_finder.py -- tests for MissingObjectFinder # Copyright (C) 2012 syntevo GmbH # # SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later # Dulwich is dual-licensed under the Apache License, Version 2.0 and the GNU # General Public License as public by the Free Software Foundation; version 2.0 # or (at your option) any later version. You can redistribute it and/or # modify it under the terms of either of these two licenses. # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # # You should have received a copy of the licenses; if not, see # for a copy of the GNU General Public License # and for a copy of the Apache # License, Version 2.0. # from dulwich.object_store import MemoryObjectStore, MissingObjectFinder from dulwich.objects import Blob from dulwich.tests.utils import build_commit_graph, make_object, make_tag from . import TestCase class MissingObjectFinderTest(TestCase): def setUp(self) -> None: super().setUp() self.store = MemoryObjectStore() self.commits = [] def cmt(self, n): return self.commits[n - 1] def assertMissingMatch(self, haves, wants, expected) -> None: for sha, path in MissingObjectFinder(self.store, haves, wants, shallow=set()): self.assertIn( sha, expected, f"({sha},{path}) erroneously reported as missing" ) expected.remove(sha) self.assertEqual( len(expected), 0, f"some objects are not reported as missing: {expected}", ) class MOFLinearRepoTest(MissingObjectFinderTest): def setUp(self) -> None: super().setUp() # present in 1, removed in 3 f1_1 = make_object(Blob, data=b"f1") # present in all revisions, changed in 2 and 3 f2_1 = make_object(Blob, data=b"f2") f2_2 = make_object(Blob, data=b"f2-changed") f2_3 = make_object(Blob, data=b"f2-changed-again") # added in 2, left unmodified in 3 f3_2 = make_object(Blob, data=b"f3") commit_spec = [[1], [2, 1], [3, 2]] trees = { 1: [(b"f1", f1_1), (b"f2", f2_1)], 2: [(b"f1", f1_1), (b"f2", f2_2), (b"f3", f3_2)], 3: [(b"f2", f2_3), (b"f3", f3_2)], } # commit 1: f1 and f2 # commit 2: f3 added, f2 changed. Missing shall report commit id and a # tree referenced by commit # commit 3: f1 removed, f2 changed. Commit sha and root tree sha shall # be reported as modified self.commits = build_commit_graph(self.store, commit_spec, trees) self.missing_1_2 = [self.cmt(2).id, self.cmt(2).tree, f2_2.id, f3_2.id] self.missing_2_3 = [self.cmt(3).id, self.cmt(3).tree, f2_3.id] self.missing_1_3 = [ self.cmt(2).id, self.cmt(3).id, self.cmt(2).tree, self.cmt(3).tree, f2_2.id, f3_2.id, f2_3.id, ] def test_1_to_2(self) -> None: self.assertMissingMatch([self.cmt(1).id], [self.cmt(2).id], self.missing_1_2) def test_2_to_3(self) -> None: self.assertMissingMatch([self.cmt(2).id], [self.cmt(3).id], self.missing_2_3) def test_1_to_3(self) -> None: self.assertMissingMatch([self.cmt(1).id], [self.cmt(3).id], self.missing_1_3) def test_bogus_haves(self) -> None: """Ensure non-existent SHA in haves are tolerated.""" bogus_sha = self.cmt(2).id[::-1] haves = [self.cmt(1).id, bogus_sha] wants = [self.cmt(3).id] self.assertMissingMatch(haves, wants, self.missing_1_3) def test_bogus_wants_failure(self) -> None: """Ensure non-existent SHA in wants are not tolerated.""" bogus_sha = self.cmt(2).id[::-1] haves = [self.cmt(1).id] wants = [self.cmt(3).id, bogus_sha] self.assertRaises( KeyError, MissingObjectFinder, self.store, haves, wants, shallow=set() ) def test_no_changes(self) -> None: self.assertMissingMatch([self.cmt(3).id], [self.cmt(3).id], []) class MOFMergeForkRepoTest(MissingObjectFinderTest): # 1 --- 2 --- 4 --- 6 --- 7 # \ / # 3 --- # \ # 5 def setUp(self) -> None: super().setUp() f1_1 = make_object(Blob, data=b"f1") f1_2 = make_object(Blob, data=b"f1-2") f1_4 = make_object(Blob, data=b"f1-4") f1_7 = make_object(Blob, data=b"f1-2") # same data as in rev 2 f2_1 = make_object(Blob, data=b"f2") f2_3 = make_object(Blob, data=b"f2-3") f3_3 = make_object(Blob, data=b"f3") f3_5 = make_object(Blob, data=b"f3-5") commit_spec = [[1], [2, 1], [3, 2], [4, 2], [5, 3], [6, 3, 4], [7, 6]] trees = { 1: [(b"f1", f1_1), (b"f2", f2_1)], 2: [(b"f1", f1_2), (b"f2", f2_1)], # f1 changed # f3 added, f2 changed 3: [(b"f1", f1_2), (b"f2", f2_3), (b"f3", f3_3)], 4: [(b"f1", f1_4), (b"f2", f2_1)], # f1 changed 5: [(b"f1", f1_2), (b"f3", f3_5)], # f2 removed, f3 changed # merged 3 and 4 6: [(b"f1", f1_4), (b"f2", f2_3), (b"f3", f3_3)], # f1 changed to match rev2. f3 removed 7: [(b"f1", f1_7), (b"f2", f2_3)], } self.commits = build_commit_graph(self.store, commit_spec, trees) self.f1_2_id = f1_2.id self.f1_4_id = f1_4.id self.f1_7_id = f1_7.id self.f2_3_id = f2_3.id self.f3_3_id = f3_3.id self.assertEqual(f1_2.id, f1_7.id, "[sanity]") def test_have6_want7(self) -> None: # have 6, want 7. Ideally, shall not report f1_7 as it's the same as # f1_2, however, to do so, MissingObjectFinder shall not record trees # of common commits only, but also all parent trees and tree items, # which is an overkill (i.e. in sha_done it records f1_4 as known, and # doesn't record f1_2 was known prior to that, hence can't detect f1_7 # is in fact f1_2 and shall not be reported) self.assertMissingMatch( [self.cmt(6).id], [self.cmt(7).id], [self.cmt(7).id, self.cmt(7).tree, self.f1_7_id], ) def test_have4_want7(self) -> None: # have 4, want 7. Shall not include rev5 as it is not in the tree # between 4 and 7 (well, it is, but its SHA's are irrelevant for 4..7 # commit hierarchy) self.assertMissingMatch( [self.cmt(4).id], [self.cmt(7).id], [ self.cmt(7).id, self.cmt(6).id, self.cmt(3).id, self.cmt(7).tree, self.cmt(6).tree, self.cmt(3).tree, self.f2_3_id, self.f3_3_id, ], ) def test_have1_want6(self) -> None: # have 1, want 6. Shall not include rev5 self.assertMissingMatch( [self.cmt(1).id], [self.cmt(6).id], [ self.cmt(6).id, self.cmt(4).id, self.cmt(3).id, self.cmt(2).id, self.cmt(6).tree, self.cmt(4).tree, self.cmt(3).tree, self.cmt(2).tree, self.f1_2_id, self.f1_4_id, self.f2_3_id, self.f3_3_id, ], ) def test_have3_want6(self) -> None: # have 3, want 7. Shall not report rev2 and its tree, because # haves(3) means has parents, i.e. rev2, too # BUT shall report any changes descending rev2 (excluding rev3) # Shall NOT report f1_7 as it's technically == f1_2 self.assertMissingMatch( [self.cmt(3).id], [self.cmt(7).id], [ self.cmt(7).id, self.cmt(6).id, self.cmt(4).id, self.cmt(7).tree, self.cmt(6).tree, self.cmt(4).tree, self.f1_4_id, ], ) def test_have5_want7(self) -> None: # have 5, want 7. Common parent is rev2, hence children of rev2 from # a descent line other than rev5 shall be reported # expects f1_4 from rev6. f3_5 is known in rev5; # f1_7 shall be the same as f1_2 (known, too) self.assertMissingMatch( [self.cmt(5).id], [self.cmt(7).id], [ self.cmt(7).id, self.cmt(6).id, self.cmt(4).id, self.cmt(7).tree, self.cmt(6).tree, self.cmt(4).tree, self.f1_4_id, ], ) class MOFTagsTest(MissingObjectFinderTest): def setUp(self) -> None: super().setUp() f1_1 = make_object(Blob, data=b"f1") commit_spec = [[1]] trees = {1: [(b"f1", f1_1)]} self.commits = build_commit_graph(self.store, commit_spec, trees) self._normal_tag = make_tag(self.cmt(1)) self.store.add_object(self._normal_tag) self._tag_of_tag = make_tag(self._normal_tag) self.store.add_object(self._tag_of_tag) self._tag_of_tree = make_tag(self.store[self.cmt(1).tree]) self.store.add_object(self._tag_of_tree) self._tag_of_blob = make_tag(f1_1) self.store.add_object(self._tag_of_blob) self._tag_of_tag_of_blob = make_tag(self._tag_of_blob) self.store.add_object(self._tag_of_tag_of_blob) self.f1_1_id = f1_1.id def test_tagged_commit(self) -> None: # The user already has the tagged commit, all they want is the tag, # so send them only the tag object. self.assertMissingMatch( [self.cmt(1).id], [self._normal_tag.id], [self._normal_tag.id] ) # The remaining cases are unusual, but do happen in the wild. def test_tagged_tag(self) -> None: # User already has tagged tag, send only tag of tag self.assertMissingMatch( [self._normal_tag.id], [self._tag_of_tag.id], [self._tag_of_tag.id] ) # User needs both tags, but already has commit self.assertMissingMatch( [self.cmt(1).id], [self._tag_of_tag.id], [self._normal_tag.id, self._tag_of_tag.id], ) def test_tagged_tree(self) -> None: self.assertMissingMatch( [], [self._tag_of_tree.id], [self._tag_of_tree.id, self.cmt(1).tree, self.f1_1_id], ) def test_tagged_blob(self) -> None: self.assertMissingMatch( [], [self._tag_of_blob.id], [self._tag_of_blob.id, self.f1_1_id] ) def test_tagged_tagged_blob(self) -> None: self.assertMissingMatch( [], [self._tag_of_tag_of_blob.id], [self._tag_of_tag_of_blob.id, self._tag_of_blob.id, self.f1_1_id], )