55
67
class MergeHooks(hooks.Hooks):
57
69
def __init__(self):
58
hooks.Hooks.__init__(self)
59
self.create_hook(hooks.HookPoint('merge_file_content',
60
"Called with a bzrlib.merge.Merger object to create a per file "
70
hooks.Hooks.__init__(self, "breezy.merge", "Merger.hooks")
71
self.add_hook('merge_file_content',
72
"Called with a breezy.merge.Merger object to create a per file "
61
73
"merge object when starting a merge. "
62
74
"Should return either None or a subclass of "
63
"``bzrlib.merge.AbstractPerFileMerger``. "
75
"``breezy.merge.AbstractPerFileMerger``. "
64
76
"Such objects will then be called per file "
65
77
"that needs to be merged (including when one "
66
78
"side has deleted the file and the other has changed it). "
67
79
"See the AbstractPerFileMerger API docs for details on how it is "
82
self.add_hook('pre_merge',
83
'Called before a merge. '
84
'Receives a Merger object as the single argument.',
86
self.add_hook('post_merge',
87
'Called after a merge. '
88
'Receives a Merger object as the single argument. '
89
'The return value is ignored.',
72
93
class AbstractPerFileMerger(object):
73
"""PerFileMerger objects are used by plugins extending merge for bzrlib.
94
"""PerFileMerger objects are used by plugins extending merge for breezy.
75
See ``bzrlib.plugins.news_merge.news_merge`` for an example concrete class.
96
See ``breezy.plugins.news_merge.news_merge`` for an example concrete class.
77
98
:ivar merger: The Merge3Merger performing the merge.
333
352
_set_base_is_other_ancestor)
336
def from_uncommitted(tree, other_tree, pb=None, base_tree=None):
355
def from_uncommitted(tree, other_tree, base_tree=None):
337
356
"""Return a Merger for uncommitted changes in other_tree.
339
358
:param tree: The tree to merge into
340
359
:param other_tree: The tree to get uncommitted changes from
341
:param pb: A progress indicator
342
360
:param base_tree: The basis to use for the merge. If unspecified,
343
361
other_tree.basis_tree() will be used.
345
363
if base_tree is None:
346
364
base_tree = other_tree.basis_tree()
347
merger = Merger(tree.branch, other_tree, base_tree, tree, pb)
365
merger = Merger(tree.branch, other_tree, base_tree, tree)
348
366
merger.base_rev_id = merger.base_tree.get_revision_id()
349
367
merger.other_rev_id = None
350
368
merger.other_basis = merger.base_rev_id
354
def from_mergeable(klass, tree, mergeable, pb):
372
def from_mergeable(klass, tree, mergeable):
355
373
"""Return a Merger for a bundle or merge directive.
357
375
:param tree: The tree to merge changes into
358
376
:param mergeable: A merge directive or bundle
359
:param pb: A progress indicator
361
378
mergeable.install_revisions(tree.branch.repository)
362
379
base_revision_id, other_revision_id, verified =\
435
450
revision_id = _mod_revision.ensure_null(revision_id)
436
451
return branch, self.revision_tree(revision_id, branch)
438
@deprecated_method(deprecated_in((2, 1, 0)))
439
def ensure_revision_trees(self):
440
if self.this_revision_tree is None:
441
self.this_basis_tree = self.revision_tree(self.this_basis)
442
if self.this_basis == self.this_rev_id:
443
self.this_revision_tree = self.this_basis_tree
445
if self.other_rev_id is None:
446
other_basis_tree = self.revision_tree(self.other_basis)
447
if other_basis_tree.has_changes(self.other_tree):
448
raise errors.WorkingTreeNotRevision(self.this_tree)
449
other_rev_id = self.other_basis
450
self.other_tree = other_basis_tree
452
@deprecated_method(deprecated_in((2, 1, 0)))
453
def file_revisions(self, file_id):
454
self.ensure_revision_trees()
455
def get_id(tree, file_id):
456
revision_id = tree.inventory[file_id].revision
458
if self.this_rev_id is None:
459
if self.this_basis_tree.get_file_sha1(file_id) != \
460
self.this_tree.get_file_sha1(file_id):
461
raise errors.WorkingTreeNotRevision(self.this_tree)
463
trees = (self.this_basis_tree, self.other_tree)
464
return [get_id(tree, file_id) for tree in trees]
466
@deprecated_method(deprecated_in((2, 1, 0)))
467
def check_basis(self, check_clean, require_commits=True):
468
if self.this_basis is None and require_commits is True:
469
raise errors.BzrCommandError(
470
"This branch has no commits."
471
" (perhaps you would prefer 'bzr pull')")
474
if self.this_basis != self.this_rev_id:
475
raise errors.UncommittedChanges(self.this_tree)
477
@deprecated_method(deprecated_in((2, 1, 0)))
478
def compare_basis(self):
480
basis_tree = self.revision_tree(self.this_tree.last_revision())
481
except errors.NoSuchRevision:
482
basis_tree = self.this_tree.basis_tree()
483
if not self.this_tree.has_changes(basis_tree):
484
self.this_rev_id = self.this_basis
486
453
def set_interesting_files(self, file_list):
487
454
self.interesting_files = file_list
587
556
self.base_rev_id = self.revision_graph.find_unique_lca(
589
self._is_criss_cross = True
558
sorted_lca_keys = self.revision_graph.find_merge_order(
560
if self.base_rev_id == _mod_revision.NULL_REVISION:
561
self.base_rev_id = sorted_lca_keys[0]
590
563
if self.base_rev_id == _mod_revision.NULL_REVISION:
591
564
raise errors.UnrelatedBranches()
592
565
if self._is_criss_cross:
593
566
trace.warning('Warning: criss-cross merge encountered. See bzr'
594
567
' help criss-cross.')
595
568
trace.mutter('Criss-cross lcas: %r' % lcas)
596
interesting_revision_ids = [self.base_rev_id]
597
interesting_revision_ids.extend(lcas)
569
if self.base_rev_id in lcas:
570
trace.mutter('Unable to find unique lca. '
571
'Fallback %r as best option.'
573
interesting_revision_ids = set(lcas)
574
interesting_revision_ids.add(self.base_rev_id)
598
575
interesting_trees = dict((t.get_revision_id(), t)
599
576
for t in self.this_branch.repository.revision_trees(
600
577
interesting_revision_ids))
601
578
self._cached_trees.update(interesting_trees)
602
self.base_tree = interesting_trees.pop(self.base_rev_id)
603
sorted_lca_keys = self.revision_graph.find_merge_order(
579
if self.base_rev_id in lcas:
580
self.base_tree = interesting_trees[self.base_rev_id]
582
self.base_tree = interesting_trees.pop(self.base_rev_id)
605
583
self._lca_trees = [interesting_trees[key]
606
584
for key in sorted_lca_keys]
913
906
it then compares with THIS and BASE.
915
908
For the multi-valued entries, the format will be (BASE, [lca1, lca2])
916
:return: [(file_id, changed, parents, names, executable)]
917
file_id Simple file_id of the entry
918
changed Boolean, True if the kind or contents changed
920
parents ((base, [parent_id, in, lcas]), parent_id_other,
922
names ((base, [name, in, lcas]), name_in_other, name_in_this)
923
executable ((base, [exec, in, lcas]), exec_in_other, exec_in_this)
910
:return: [(file_id, changed, parents, names, executable)], where:
912
* file_id: Simple file_id of the entry
913
* changed: Boolean, True if the kind or contents changed else False
914
* parents: ((base, [parent_id, in, lcas]), parent_id_other,
916
* names: ((base, [name, in, lcas]), name_in_other, name_in_this)
917
* executable: ((base, [exec, in, lcas]), exec_in_other,
925
920
if self.interesting_files is not None:
926
921
lookup_trees = [self.this_tree, self.base_tree]
1077
self.tt.final_kind(self.tt.root)
1078
except errors.NoSuchFile:
1079
self.tt.cancel_deletion(self.tt.root)
1080
if self.tt.final_file_id(self.tt.root) is None:
1081
self.tt.version_file(self.tt.tree_file_id(self.tt.root),
1083
other_root_file_id = self.other_tree.get_root_id()
1084
if other_root_file_id is None:
1086
other_root = self.tt.trans_id_file_id(other_root_file_id)
1087
if other_root == self.tt.root:
1089
if self.other_tree.inventory.root.file_id in self.this_tree.inventory:
1090
# the other tree's root is a non-root in the current tree (as when
1091
# a previously unrelated branch is merged into another)
1094
self.tt.final_kind(other_root)
1095
other_root_is_present = True
1096
except errors.NoSuchFile:
1097
# other_root doesn't have a physical representation. We still need
1098
# to move any references to the actual root of the tree.
1099
other_root_is_present = False
1100
# 'other_tree.inventory.root' is not present in this tree. We are
1101
# calling adjust_path for children which *want* to be present with a
1102
# correct place to go.
1103
for thing, child in self.other_tree.inventory.root.children.iteritems():
1104
trans_id = self.tt.trans_id_file_id(child.file_id)
1105
if not other_root_is_present:
1106
# FIXME: Make final_kind returns None instead of raising
1107
# NoSuchFile to avoid the ugly construct below -- vila 20100402
1109
self.tt.final_kind(trans_id)
1110
# The item exist in the final tree and has a defined place
1113
except errors.NoSuchFile, e:
1115
# Move the item into the root
1116
self.tt.adjust_path(self.tt.final_name(trans_id),
1117
self.tt.root, trans_id)
1118
if other_root_is_present:
1119
self.tt.cancel_creation(other_root)
1120
self.tt.cancel_versioning(other_root)
1122
1069
def write_modified(self, results):
1123
1070
modified_hashes = {}
1124
1071
for path in results.modified_paths:
1125
file_id = self.this_tree.path2id(self.this_tree.relpath(path))
1072
file_id = self.working_tree.path2id(self.working_tree.relpath(path))
1126
1073
if file_id is None:
1128
hash = self.this_tree.get_file_sha1(file_id)
1075
hash = self.working_tree.get_file_sha1(file_id)
1129
1076
if hash is None:
1131
1078
modified_hashes[file_id] = hash
1132
self.this_tree.set_merge_modified(modified_hashes)
1079
self.working_tree.set_merge_modified(modified_hashes)
1135
1082
def parent(entry, file_id):
1299
1226
self._raw_conflicts.append(('path conflict', trans_id, file_id,
1300
1227
this_parent, this_name,
1301
1228
other_parent, other_name))
1302
if other_name is None:
1229
if not self.other_tree.has_id(file_id):
1303
1230
# it doesn't matter whether the result was 'other' or
1304
# 'conflict'-- if there's no 'other', we leave it alone.
1231
# 'conflict'-- if it has no file id, we leave it alone.
1306
1233
parent_id = parents[self.winner_idx[parent_id_winner]]
1307
if parent_id is not None:
1234
name = names[self.winner_idx[name_winner]]
1235
if parent_id is not None or name is not None:
1308
1236
# if we get here, name_winner and parent_winner are set to safe
1310
self.tt.adjust_path(names[self.winner_idx[name_winner]],
1311
self.tt.trans_id_file_id(parent_id),
1238
if parent_id is None and name is not None:
1239
# if parent_id is None and name is non-None, current file is
1241
if names[self.winner_idx[parent_id_winner]] != '':
1242
raise AssertionError(
1243
'File looks like a root, but named %s' %
1244
names[self.winner_idx[parent_id_winner]])
1245
parent_trans_id = transform.ROOT_PARENT
1247
parent_trans_id = self.tt.trans_id_file_id(parent_id)
1248
self.tt.adjust_path(name, parent_trans_id,
1312
1249
self.tt.trans_id_file_id(file_id))
1314
1251
def _do_merge_contents(self, file_id):
1315
1252
"""Performs a merge on file_id contents."""
1316
1253
def contents_pair(tree):
1317
if file_id not in tree:
1254
if not tree.has_id(file_id):
1318
1255
return (None, None)
1319
1256
kind = tree.kind(file_id)
1320
1257
if kind == "file":
1358
1295
if hook_status != 'not_applicable':
1359
1296
# Don't try any more hooks, this one applies.
1298
# If the merge ends up replacing the content of the file, we get rid of
1299
# it at the end of this method (this variable is used to track the
1300
# exceptions to this rule).
1361
1302
result = "modified"
1362
1303
if hook_status == 'not_applicable':
1363
# This is a contents conflict, because none of the available
1364
# functions could merge it.
1304
# No merge hook was able to resolve the situation. Two cases exist:
1305
# a content conflict or a duplicate one.
1366
1307
name = self.tt.final_name(trans_id)
1367
1308
parent_id = self.tt.final_parent(trans_id)
1368
if self.this_tree.has_id(file_id):
1369
self.tt.unversion_file(trans_id)
1370
file_group = self._dump_conflicts(name, parent_id, file_id,
1372
self._raw_conflicts.append(('contents conflict', file_group))
1310
inhibit_content_conflict = False
1311
if params.this_kind is None: # file_id is not in THIS
1312
# Is the name used for a different file_id ?
1313
dupe_path = self.other_tree.id2path(file_id)
1314
this_id = self.this_tree.path2id(dupe_path)
1315
if this_id is not None:
1316
# Two entries for the same path
1318
# versioning the merged file will trigger a duplicate
1320
self.tt.version_file(file_id, trans_id)
1321
transform.create_from_tree(
1322
self.tt, trans_id, self.other_tree, file_id,
1323
filter_tree_path=self._get_filter_tree_path(file_id))
1324
inhibit_content_conflict = True
1325
elif params.other_kind is None: # file_id is not in OTHER
1326
# Is the name used for a different file_id ?
1327
dupe_path = self.this_tree.id2path(file_id)
1328
other_id = self.other_tree.path2id(dupe_path)
1329
if other_id is not None:
1330
# Two entries for the same path again, but here, the other
1331
# entry will also be merged. We simply inhibit the
1332
# 'content' conflict creation because we know OTHER will
1333
# create (or has already created depending on ordering) an
1334
# entry at the same path. This will trigger a 'duplicate'
1337
inhibit_content_conflict = True
1338
if not inhibit_content_conflict:
1339
if params.this_kind is not None:
1340
self.tt.unversion_file(trans_id)
1341
# This is a contents conflict, because none of the available
1342
# functions could merge it.
1343
file_group = self._dump_conflicts(name, parent_id, file_id,
1345
self._raw_conflicts.append(('contents conflict', file_group))
1373
1346
elif hook_status == 'success':
1374
1347
self.tt.create_file(lines, trans_id)
1375
1348
elif hook_status == 'conflicted':
1391
1364
raise AssertionError('unknown hook_status: %r' % (hook_status,))
1392
1365
if not self.this_tree.has_id(file_id) and result == "modified":
1393
1366
self.tt.version_file(file_id, trans_id)
1394
# The merge has been performed, so the old contents should not be
1368
# The merge has been performed and produced a new content, so the
1369
# old contents should not be retained.
1397
1370
self.tt.delete_contents(trans_id)
1398
except errors.NoSuchFile:
1402
1373
def _default_other_winner_merge(self, merge_hook_params):
1403
1374
"""Replace this contents with other."""
1404
1375
file_id = merge_hook_params.file_id
1405
1376
trans_id = merge_hook_params.trans_id
1406
file_in_this = self.this_tree.has_id(file_id)
1407
1377
if self.other_tree.has_id(file_id):
1408
1378
# OTHER changed the file
1410
if wt.supports_content_filtering():
1411
# We get the path from the working tree if it exists.
1412
# That fails though when OTHER is adding a file, so
1413
# we fall back to the other tree to find the path if
1414
# it doesn't exist locally.
1416
filter_tree_path = wt.id2path(file_id)
1417
except errors.NoSuchId:
1418
filter_tree_path = self.other_tree.id2path(file_id)
1420
# Skip the id2path lookup for older formats
1421
filter_tree_path = None
1422
transform.create_from_tree(self.tt, trans_id,
1423
self.other_tree, file_id,
1424
filter_tree_path=filter_tree_path)
1379
transform.create_from_tree(
1380
self.tt, trans_id, self.other_tree, file_id,
1381
filter_tree_path=self._get_filter_tree_path(file_id))
1425
1382
return 'done', None
1383
elif self.this_tree.has_id(file_id):
1427
1384
# OTHER deleted the file
1428
1385
return 'delete', None
1750
1738
osutils.rmtree(temp_dir)
1741
class PathNotInTree(errors.BzrError):
1743
_fmt = """Merge-into failed because %(tree)s does not contain %(path)s."""
1745
def __init__(self, path, tree):
1746
errors.BzrError.__init__(self, path=path, tree=tree)
1749
class MergeIntoMerger(Merger):
1750
"""Merger that understands other_tree will be merged into a subdir.
1752
This also changes the Merger api so that it uses real Branch, revision_id,
1753
and RevisonTree objects, rather than using revision specs.
1756
def __init__(self, this_tree, other_branch, other_tree, target_subdir,
1757
source_subpath, other_rev_id=None):
1758
"""Create a new MergeIntoMerger object.
1760
source_subpath in other_tree will be effectively copied to
1761
target_subdir in this_tree.
1763
:param this_tree: The tree that we will be merging into.
1764
:param other_branch: The Branch we will be merging from.
1765
:param other_tree: The RevisionTree object we want to merge.
1766
:param target_subdir: The relative path where we want to merge
1767
other_tree into this_tree
1768
:param source_subpath: The relative path specifying the subtree of
1769
other_tree to merge into this_tree.
1771
# It is assumed that we are merging a tree that is not in our current
1772
# ancestry, which means we are using the "EmptyTree" as our basis.
1773
null_ancestor_tree = this_tree.branch.repository.revision_tree(
1774
_mod_revision.NULL_REVISION)
1775
super(MergeIntoMerger, self).__init__(
1776
this_branch=this_tree.branch,
1777
this_tree=this_tree,
1778
other_tree=other_tree,
1779
base_tree=null_ancestor_tree,
1781
self._target_subdir = target_subdir
1782
self._source_subpath = source_subpath
1783
self.other_branch = other_branch
1784
if other_rev_id is None:
1785
other_rev_id = other_tree.get_revision_id()
1786
self.other_rev_id = self.other_basis = other_rev_id
1787
self.base_is_ancestor = True
1788
self.backup_files = True
1789
self.merge_type = Merge3Merger
1790
self.show_base = False
1791
self.reprocess = False
1792
self.interesting_ids = None
1793
self.merge_type = _MergeTypeParameterizer(MergeIntoMergeType,
1794
target_subdir=self._target_subdir,
1795
source_subpath=self._source_subpath)
1796
if self._source_subpath != '':
1797
# If this isn't a partial merge make sure the revisions will be
1799
self._maybe_fetch(self.other_branch, self.this_branch,
1802
def set_pending(self):
1803
if self._source_subpath != '':
1805
Merger.set_pending(self)
1808
class _MergeTypeParameterizer(object):
1809
"""Wrap a merge-type class to provide extra parameters.
1811
This is hack used by MergeIntoMerger to pass some extra parameters to its
1812
merge_type. Merger.do_merge() sets up its own set of parameters to pass to
1813
the 'merge_type' member. It is difficult override do_merge without
1814
re-writing the whole thing, so instead we create a wrapper which will pass
1815
the extra parameters.
1818
def __init__(self, merge_type, **kwargs):
1819
self._extra_kwargs = kwargs
1820
self._merge_type = merge_type
1822
def __call__(self, *args, **kwargs):
1823
kwargs.update(self._extra_kwargs)
1824
return self._merge_type(*args, **kwargs)
1826
def __getattr__(self, name):
1827
return getattr(self._merge_type, name)
1830
class MergeIntoMergeType(Merge3Merger):
1831
"""Merger that incorporates a tree (or part of a tree) into another."""
1833
def __init__(self, *args, **kwargs):
1834
"""Initialize the merger object.
1836
:param args: See Merge3Merger.__init__'s args.
1837
:param kwargs: See Merge3Merger.__init__'s keyword args, except for
1838
source_subpath and target_subdir.
1839
:keyword source_subpath: The relative path specifying the subtree of
1840
other_tree to merge into this_tree.
1841
:keyword target_subdir: The relative path where we want to merge
1842
other_tree into this_tree
1844
# All of the interesting work happens during Merge3Merger.__init__(),
1845
# so we have have to hack in to get our extra parameters set.
1846
self._source_subpath = kwargs.pop('source_subpath')
1847
self._target_subdir = kwargs.pop('target_subdir')
1848
super(MergeIntoMergeType, self).__init__(*args, **kwargs)
1850
def _compute_transform(self):
1851
child_pb = ui.ui_factory.nested_progress_bar()
1853
entries = self._entries_to_incorporate()
1854
entries = list(entries)
1855
for num, (entry, parent_id) in enumerate(entries):
1856
child_pb.update(gettext('Preparing file merge'), num, len(entries))
1857
parent_trans_id = self.tt.trans_id_file_id(parent_id)
1858
trans_id = transform.new_by_entry(self.tt, entry,
1859
parent_trans_id, self.other_tree)
1862
self._finish_computing_transform()
1864
def _entries_to_incorporate(self):
1865
"""Yields pairs of (inventory_entry, new_parent)."""
1866
other_inv = self.other_tree.root_inventory
1867
subdir_id = other_inv.path2id(self._source_subpath)
1868
if subdir_id is None:
1869
# XXX: The error would be clearer if it gave the URL of the source
1870
# branch, but we don't have a reference to that here.
1871
raise PathNotInTree(self._source_subpath, "Source tree")
1872
subdir = other_inv[subdir_id]
1873
parent_in_target = osutils.dirname(self._target_subdir)
1874
target_id = self.this_tree.path2id(parent_in_target)
1875
if target_id is None:
1876
raise PathNotInTree(self._target_subdir, "Target tree")
1877
name_in_target = osutils.basename(self._target_subdir)
1878
merge_into_root = subdir.copy()
1879
merge_into_root.name = name_in_target
1880
if self.this_tree.has_id(merge_into_root.file_id):
1881
# Give the root a new file-id.
1882
# This can happen fairly easily if the directory we are
1883
# incorporating is the root, and both trees have 'TREE_ROOT' as
1884
# their root_id. Users will expect this to Just Work, so we
1885
# change the file-id here.
1886
# Non-root file-ids could potentially conflict too. That's really
1887
# an edge case, so we don't do anything special for those. We let
1888
# them cause conflicts.
1889
merge_into_root.file_id = generate_ids.gen_file_id(name_in_target)
1890
yield (merge_into_root, target_id)
1891
if subdir.kind != 'directory':
1892
# No children, so we are done.
1894
for ignored_path, entry in other_inv.iter_entries_by_dir(subdir_id):
1895
parent_id = entry.parent_id
1896
if parent_id == subdir.file_id:
1897
# The root's parent ID has changed, so make sure children of
1898
# the root refer to the new ID.
1899
parent_id = merge_into_root.file_id
1900
yield (entry, parent_id)
1753
1903
def merge_inner(this_branch, other_tree, base_tree, ignore_zero=False,
1754
1904
backup_files=False,
1755
1905
merge_type=Merge3Merger,