39
from bzrlib.cleanup import OperationWithCleanups
40
from bzrlib.symbol_versioning import (
39
from breezy.bzr import (
43
from breezy.i18n import gettext
44
51
# TODO: Report back as changes are merged in
47
def transform_tree(from_tree, to_tree, interesting_ids=None):
48
from_tree.lock_tree_write()
49
operation = OperationWithCleanups(merge_inner)
50
operation.add_cleanup(from_tree.unlock)
51
operation.run_simple(from_tree.branch, to_tree, from_tree,
52
ignore_zero=True, interesting_ids=interesting_ids, this_tree=from_tree)
54
def transform_tree(from_tree, to_tree, interesting_files=None):
55
with from_tree.lock_tree_write():
56
merge_inner(from_tree.branch, to_tree, from_tree,
57
ignore_zero=True, this_tree=from_tree,
58
interesting_files=interesting_files)
55
61
class MergeHooks(hooks.Hooks):
57
63
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 "
61
"merge object when starting a merge. "
62
"Should return either None or a subclass of "
63
"``bzrlib.merge.AbstractPerFileMerger``. "
64
"Such objects will then be called per file "
65
"that needs to be merged (including when one "
66
"side has deleted the file and the other has changed it). "
67
"See the AbstractPerFileMerger API docs for details on how it is "
64
hooks.Hooks.__init__(self, "breezy.merge", "Merger.hooks")
65
self.add_hook('merge_file_content',
66
"Called with a breezy.merge.Merger object to create a per file "
67
"merge object when starting a merge. "
68
"Should return either None or a subclass of "
69
"``breezy.merge.AbstractPerFileMerger``. "
70
"Such objects will then be called per file "
71
"that needs to be merged (including when one "
72
"side has deleted the file and the other has changed it). "
73
"See the AbstractPerFileMerger API docs for details on how it is "
76
self.add_hook('pre_merge',
77
'Called before a merge. '
78
'Receives a Merger object as the single argument.',
80
self.add_hook('post_merge',
81
'Called after a merge. '
82
'Receives a Merger object as the single argument. '
83
'The return value is ignored.',
72
87
class AbstractPerFileMerger(object):
73
"""PerFileMerger objects are used by plugins extending merge for bzrlib.
75
See ``bzrlib.plugins.news_merge.news_merge`` for an example concrete class.
88
"""PerFileMerger objects are used by plugins extending merge for breezy.
90
See ``breezy.plugins.news_merge.news_merge`` for an example concrete class.
77
92
:ivar merger: The Merge3Merger performing the merge.
435
431
revision_id = _mod_revision.ensure_null(revision_id)
436
432
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
434
def set_interesting_files(self, file_list):
487
435
self.interesting_files = file_list
489
437
def set_pending(self):
490
438
if (not self.base_is_ancestor or not self.base_is_other_ancestor
491
or self.other_rev_id is None):
439
or self.other_rev_id is None):
493
441
self._add_parent()
495
443
def _add_parent(self):
496
444
new_parents = self.this_tree.get_parent_ids() + [self.other_rev_id]
497
445
new_parent_trees = []
498
operation = OperationWithCleanups(self.this_tree.set_parent_trees)
499
for revision_id in new_parents:
501
tree = self.revision_tree(revision_id)
502
except errors.NoSuchRevision:
506
operation.add_cleanup(tree.unlock)
507
new_parent_trees.append((revision_id, tree))
508
operation.run_simple(new_parent_trees, allow_leftmost_as_ghost=True)
446
with contextlib.ExitStack() as stack:
447
for revision_id in new_parents:
449
tree = self.revision_tree(revision_id)
450
except errors.NoSuchRevision:
453
stack.enter_context(tree.lock_read())
454
new_parent_trees.append((revision_id, tree))
455
self.this_tree.set_parent_trees(new_parent_trees, allow_leftmost_as_ghost=True)
510
457
def set_other(self, other_revision, possible_transports=None):
511
458
"""Set the revision and tree to merge from.
792
751
self.cherrypick = cherrypick
796
warnings.warn("pp argument to Merge3Merger is deprecated")
798
warnings.warn("pb argument to Merge3Merger is deprecated")
800
755
def do_merge(self):
801
operation = OperationWithCleanups(self._do_merge)
802
self.this_tree.lock_tree_write()
803
operation.add_cleanup(self.this_tree.unlock)
804
self.base_tree.lock_read()
805
operation.add_cleanup(self.base_tree.unlock)
806
self.other_tree.lock_read()
807
operation.add_cleanup(self.other_tree.unlock)
810
def _do_merge(self, operation):
811
self.tt = transform.TreeTransform(self.this_tree, None)
812
operation.add_cleanup(self.tt.finalize)
813
self._compute_transform()
814
results = self.tt.apply(no_conflicts=True)
815
self.write_modified(results)
817
self.this_tree.add_conflicts(self.cooked_conflicts)
818
except errors.UnsupportedOperation:
756
with contextlib.ExitStack() as stack:
757
stack.enter_context(self.working_tree.lock_tree_write())
758
stack.enter_context(self.this_tree.lock_read())
759
stack.enter_context(self.base_tree.lock_read())
760
stack.enter_context(self.other_tree.lock_read())
761
self.tt = self.working_tree.get_transform()
762
stack.enter_context(self.tt)
763
self._compute_transform()
764
results = self.tt.apply(no_conflicts=True)
765
self.write_modified(results)
767
self.working_tree.add_conflicts(self.cooked_conflicts)
768
except errors.UnsupportedOperation:
821
771
def make_preview_transform(self):
822
operation = OperationWithCleanups(self._make_preview_transform)
823
self.base_tree.lock_read()
824
operation.add_cleanup(self.base_tree.unlock)
825
self.other_tree.lock_read()
826
operation.add_cleanup(self.other_tree.unlock)
827
return operation.run_simple()
829
def _make_preview_transform(self):
830
self.tt = transform.TransformPreview(self.this_tree)
831
self._compute_transform()
772
with self.base_tree.lock_read(), self.other_tree.lock_read():
773
self.tt = transform.TransformPreview(self.working_tree)
774
self._compute_transform()
834
777
def _compute_transform(self):
835
778
if self._lca_trees is None:
839
782
entries = self._entries_lca()
840
783
resolver = self._lca_multi_way
841
child_pb = ui.ui_factory.nested_progress_bar()
843
factories = Merger.hooks['merge_file_content']
844
hooks = [factory(self) for factory in factories] + [self]
845
self.active_hooks = [hook for hook in hooks if hook is not None]
846
for num, (file_id, changed, parents3, names3,
784
# Prepare merge hooks
785
factories = Merger.hooks['merge_file_content']
786
# One hook for each registered one plus our default merger
787
hooks = [factory(self) for factory in factories] + [self]
788
self.active_hooks = [hook for hook in hooks if hook is not None]
789
with ui.ui_factory.nested_progress_bar() as child_pb:
790
for num, (file_id, changed, paths3, parents3, names3,
847
791
executable3) in enumerate(entries):
848
child_pb.update('Preparing file merge', num, len(entries))
849
self._merge_names(file_id, parents3, names3, resolver=resolver)
792
trans_id = self.tt.trans_id_file_id(file_id)
794
# Try merging each entry
795
child_pb.update(gettext('Preparing file merge'),
797
self._merge_names(trans_id, file_id, paths3, parents3,
798
names3, resolver=resolver)
851
file_status = self._do_merge_contents(file_id)
800
file_status = self._do_merge_contents(paths3, trans_id, file_id)
853
802
file_status = 'unmodified'
854
self._merge_executable(file_id,
855
executable3, file_status, resolver=resolver)
859
child_pb = ui.ui_factory.nested_progress_bar()
861
fs_conflicts = transform.resolve_conflicts(self.tt, child_pb,
803
self._merge_executable(paths3, trans_id, executable3,
804
file_status, resolver=resolver)
805
self.tt.fixup_new_roots()
806
self._finish_computing_transform()
808
def _finish_computing_transform(self):
809
"""Finalize the transform and report the changes.
811
This is the second half of _compute_transform.
813
with ui.ui_factory.nested_progress_bar() as child_pb:
814
fs_conflicts = transform.resolve_conflicts(
862
816
lambda t, c: transform.conflict_pass(t, c, self.other_tree))
865
817
if self.change_reporter is not None:
866
from bzrlib import delta
818
from breezy import delta
867
819
delta.report_changes(
868
820
self.tt.iter_changes(), self.change_reporter)
869
821
self.cook_conflicts(fs_conflicts)
870
822
for conflict in self.cooked_conflicts:
871
trace.warning(conflict)
823
trace.warning('%s', conflict.describe())
873
825
def _entries3(self):
874
826
"""Gather data about files modified between three trees.
883
835
iterator = self.other_tree.iter_changes(self.base_tree,
884
include_unchanged=True, specific_files=self.interesting_files,
885
extra_trees=[self.this_tree])
886
this_entries = dict((e.file_id, e) for p, e in
887
self.this_tree.iter_entries_by_dir(
888
self.interesting_ids))
889
for (file_id, paths, changed, versioned, parents, names, kind,
890
executable) in iterator:
891
if (self.interesting_ids is not None and
892
file_id not in self.interesting_ids):
894
entry = this_entries.get(file_id)
895
if entry is not None:
896
this_name = entry.name
897
this_parent = entry.parent_id
898
this_executable = entry.executable
836
specific_files=self.interesting_files,
837
extra_trees=[self.this_tree])
838
this_interesting_files = self.this_tree.find_related_paths_across_trees(
839
self.interesting_files, trees=[self.other_tree])
840
this_entries = dict(self.this_tree.iter_entries_by_dir(
841
specific_files=this_interesting_files))
842
for change in iterator:
843
if change.path[0] is not None:
844
this_path = _mod_tree.find_previous_path(
845
self.base_tree, self.this_tree, change.path[0])
847
this_path = _mod_tree.find_previous_path(
848
self.other_tree, self.this_tree, change.path[1])
849
this_entry = this_entries.get(this_path)
850
if this_entry is not None:
851
this_name = this_entry.name
852
this_parent = this_entry.parent_id
853
this_executable = this_entry.executable
901
856
this_parent = None
902
857
this_executable = None
903
parents3 = parents + (this_parent,)
904
names3 = names + (this_name,)
905
executable3 = executable + (this_executable,)
906
result.append((file_id, changed, parents3, names3, executable3))
858
parents3 = change.parent_id + (this_parent,)
859
names3 = change.name + (this_name,)
860
paths3 = change.path + (this_path, )
861
executable3 = change.executable + (this_executable,)
863
(change.file_id, change.changed_content, paths3,
864
parents3, names3, executable3))
909
867
def _entries_lca(self):
913
871
it then compares with THIS and BASE.
915
873
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)
875
:return: [(file_id, changed, paths, parents, names, executable)], where:
877
* file_id: Simple file_id of the entry
878
* changed: Boolean, True if the kind or contents changed else False
879
* paths: ((base, [path, in, lcas]), path_other, path_this)
880
* parents: ((base, [parent_id, in, lcas]), parent_id_other,
882
* names: ((base, [name, in, lcas]), name_in_other, name_in_this)
883
* executable: ((base, [exec, in, lcas]), exec_in_other,
925
886
if self.interesting_files is not None:
926
887
lookup_trees = [self.this_tree, self.base_tree]
927
888
lookup_trees.extend(self._lca_trees)
928
889
# I think we should include the lca trees as well
929
interesting_ids = self.other_tree.paths2ids(self.interesting_files,
890
interesting_files = self.other_tree.find_related_paths_across_trees(
891
self.interesting_files, lookup_trees)
932
interesting_ids = self.interesting_ids
893
interesting_files = None
934
walker = _mod_tree.MultiWalker(self.other_tree, self._lca_trees)
895
from .multiwalker import MultiWalker
896
walker = MultiWalker(self.other_tree, self._lca_trees)
936
base_inventory = self.base_tree.inventory
937
this_inventory = self.this_tree.inventory
938
for path, file_id, other_ie, lca_values in walker.iter_all():
898
for other_path, file_id, other_ie, lca_values in walker.iter_all():
939
899
# Is this modified at all from any of the other trees?
940
900
if other_ie is None:
941
901
other_ie = _none_entry
942
if interesting_ids is not None and file_id not in interesting_ids:
903
if interesting_files is not None and other_path not in interesting_files:
945
906
# If other_revision is found in any of the lcas, that means this
1023
995
(base_ie.executable, lca_executable),
1024
996
other_ie.executable, this_ie.executable)
1025
997
if (parent_id_winner == 'this' and name_winner == 'this'
1026
and sha1_winner == 'this' and exec_winner == 'this'):
998
and sha1_winner == 'this' and exec_winner == 'this'):
1027
999
# No kind, parent, name, exec, or content change for
1028
1000
# OTHER, so this node is not considered interesting
1030
1002
if sha1_winner == 'this':
1031
1003
content_changed = False
1032
1004
elif other_ie.kind == 'symlink':
1033
def get_target(ie, tree):
1005
def get_target(ie, tree, path):
1034
1006
if ie.kind != 'symlink':
1036
return tree.get_symlink_target(file_id)
1037
base_target = get_target(base_ie, self.base_tree)
1038
lca_targets = [get_target(ie, tree) for ie, tree
1039
in zip(lca_entries, self._lca_trees)]
1040
this_target = get_target(this_ie, self.this_tree)
1041
other_target = get_target(other_ie, self.other_tree)
1008
return tree.get_symlink_target(path)
1009
base_target = get_target(base_ie, self.base_tree, base_path)
1010
lca_targets = [get_target(ie, tree, lca_path) for ie, tree, lca_path
1011
in zip(lca_entries, self._lca_trees, lca_paths)]
1012
this_target = get_target(
1013
this_ie, self.this_tree, this_path)
1014
other_target = get_target(
1015
other_ie, self.other_tree, other_path)
1042
1016
target_winner = self._lca_multi_way(
1043
1017
(base_target, lca_targets),
1044
1018
other_target, this_target)
1045
1019
if (parent_id_winner == 'this' and name_winner == 'this'
1046
and target_winner == 'this'):
1020
and target_winner == 'this'):
1047
1021
# No kind, parent, name, or symlink target change
1048
1022
# not interesting
1063
1037
# If we have gotten this far, that means something has changed
1064
1038
result.append((file_id, content_changed,
1039
((base_path, lca_paths),
1040
other_path, this_path),
1065
1041
((base_ie.parent_id, lca_parent_ids),
1066
1042
other_ie.parent_id, this_ie.parent_id),
1067
1043
((base_ie.name, lca_names),
1068
1044
other_ie.name, this_ie.name),
1069
1045
((base_ie.executable, lca_executable),
1070
1046
other_ie.executable, this_ie.executable)
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
1050
def write_modified(self, results):
1051
if not self.working_tree.supports_merge_modified():
1123
1053
modified_hashes = {}
1124
1054
for path in results.modified_paths:
1125
file_id = self.this_tree.path2id(self.this_tree.relpath(path))
1055
wt_relpath = self.working_tree.relpath(path)
1056
if not self.working_tree.is_versioned(wt_relpath):
1128
hash = self.this_tree.get_file_sha1(file_id)
1058
hash = self.working_tree.get_file_sha1(wt_relpath)
1129
1059
if hash is None:
1131
modified_hashes[file_id] = hash
1132
self.this_tree.set_merge_modified(modified_hashes)
1061
modified_hashes[wt_relpath] = hash
1062
self.working_tree.set_merge_modified(modified_hashes)
1135
def parent(entry, file_id):
1136
1066
"""Determine the parent for a file_id (used as a key method)"""
1137
1067
if entry is None:
1139
1069
return entry.parent_id
1142
def name(entry, file_id):
1143
1073
"""Determine the name for a file_id (used as a key method)"""
1144
1074
if entry is None:
1146
1076
return entry.name
1149
def contents_sha1(tree, file_id):
1079
def contents_sha1(tree, path):
1150
1080
"""Determine the sha1 of the file contents (used as a key method)."""
1151
if file_id not in tree:
1082
return tree.get_file_sha1(path)
1083
except errors.NoSuchFile:
1153
return tree.get_file_sha1(file_id)
1156
def executable(tree, file_id):
1087
def executable(tree, path):
1157
1088
"""Determine the executability of a file-id (used as a key method)."""
1158
if not tree.has_id(file_id):
1090
if tree.kind(path) != "file":
1092
except errors.NoSuchFile:
1160
if tree.kind(file_id) != "file":
1162
return tree.is_executable(file_id)
1094
return tree.is_executable(path)
1165
def kind(tree, file_id):
1097
def kind(tree, path):
1166
1098
"""Determine the kind of a file-id (used as a key method)."""
1167
if not tree.has_id(file_id):
1100
return tree.kind(path)
1101
except errors.NoSuchFile:
1169
return tree.kind(file_id)
1172
1105
def _three_way(base, other, this):
1234
1167
# At this point, the lcas disagree, and the tip disagree
1235
1168
return 'conflict'
1238
@deprecated_method(deprecated_in((2, 2, 0)))
1239
def scalar_three_way(this_tree, base_tree, other_tree, file_id, key):
1240
"""Do a three-way test on a scalar.
1241
Return "this", "other" or "conflict", depending whether a value wins.
1243
key_base = key(base_tree, file_id)
1244
key_other = key(other_tree, file_id)
1245
#if base == other, either they all agree, or only THIS has changed.
1246
if key_base == key_other:
1248
key_this = key(this_tree, file_id)
1249
# "Ambiguous clean merge"
1250
if key_this == key_other:
1252
elif key_this == key_base:
1257
def merge_names(self, file_id):
1258
def get_entry(tree):
1259
if tree.has_id(file_id):
1260
return tree.inventory[file_id]
1263
this_entry = get_entry(self.this_tree)
1264
other_entry = get_entry(self.other_tree)
1265
base_entry = get_entry(self.base_tree)
1266
entries = (base_entry, other_entry, this_entry)
1269
for entry in entries:
1272
parents.append(None)
1274
names.append(entry.name)
1275
parents.append(entry.parent_id)
1276
return self._merge_names(file_id, parents, names,
1277
resolver=self._three_way)
1279
def _merge_names(self, file_id, parents, names, resolver):
1280
"""Perform a merge on file_id names and parents"""
1170
def _merge_names(self, trans_id, file_id, paths, parents, names, resolver):
1171
"""Perform a merge on file names and parents"""
1281
1172
base_name, other_name, this_name = names
1282
1173
base_parent, other_parent, this_parent = parents
1174
unused_base_path, other_path, this_path = paths
1284
1176
name_winner = resolver(*names)
1295
1187
# Creating helpers (.OTHER or .THIS) here cause problems down the
1296
1188
# road if a ContentConflict needs to be created so we should not do
1298
trans_id = self.tt.trans_id_file_id(file_id)
1299
1190
self._raw_conflicts.append(('path conflict', trans_id, file_id,
1300
1191
this_parent, this_name,
1301
1192
other_parent, other_name))
1302
if other_name is None:
1193
if other_path is None:
1303
1194
# it doesn't matter whether the result was 'other' or
1304
# 'conflict'-- if there's no 'other', we leave it alone.
1195
# 'conflict'-- if it has no file id, we leave it alone.
1306
1197
parent_id = parents[self.winner_idx[parent_id_winner]]
1307
if parent_id is not None:
1198
name = names[self.winner_idx[name_winner]]
1199
if parent_id is not None or name is not None:
1308
1200
# 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),
1312
self.tt.trans_id_file_id(file_id))
1202
if parent_id is None and name is not None:
1203
# if parent_id is None and name is non-None, current file is
1205
if names[self.winner_idx[parent_id_winner]] != '':
1206
raise AssertionError(
1207
'File looks like a root, but named %s' %
1208
names[self.winner_idx[parent_id_winner]])
1209
parent_trans_id = transform.ROOT_PARENT
1211
parent_trans_id = self.tt.trans_id_file_id(parent_id)
1212
self.tt.adjust_path(name, parent_trans_id, trans_id)
1314
def _do_merge_contents(self, file_id):
1214
def _do_merge_contents(self, paths, trans_id, file_id):
1315
1215
"""Performs a merge on file_id contents."""
1316
def contents_pair(tree):
1317
if file_id not in tree:
1319
kind = tree.kind(file_id)
1216
def contents_pair(tree, path):
1220
kind = tree.kind(path)
1221
except errors.NoSuchFile:
1320
1223
if kind == "file":
1321
contents = tree.get_file_sha1(file_id)
1224
contents = tree.get_file_sha1(path)
1322
1225
elif kind == "symlink":
1323
contents = tree.get_symlink_target(file_id)
1226
contents = tree.get_symlink_target(path)
1325
1228
contents = None
1326
1229
return kind, contents
1231
base_path, other_path, this_path = paths
1328
1232
# See SPOT run. run, SPOT, run.
1329
1233
# So we're not QUITE repeating ourselves; we do tricky things with
1331
base_pair = contents_pair(self.base_tree)
1332
other_pair = contents_pair(self.other_tree)
1235
other_pair = contents_pair(self.other_tree, other_path)
1236
this_pair = contents_pair(self.this_tree, this_path)
1333
1237
if self._lca_trees:
1334
this_pair = contents_pair(self.this_tree)
1335
lca_pairs = [contents_pair(tree) for tree in self._lca_trees]
1238
(base_path, lca_paths) = base_path
1239
base_pair = contents_pair(self.base_tree, base_path)
1240
lca_pairs = [contents_pair(tree, path)
1241
for tree, path in zip(self._lca_trees, lca_paths)]
1336
1242
winner = self._lca_multi_way((base_pair, lca_pairs), other_pair,
1337
1243
this_pair, allow_overriding_lca=False)
1245
base_pair = contents_pair(self.base_tree, base_path)
1339
1246
if base_pair == other_pair:
1340
1247
winner = 'this'
1342
1249
# We delayed evaluating this_pair as long as we can to avoid
1343
1250
# unnecessary sha1 calculation
1344
this_pair = contents_pair(self.this_tree)
1251
this_pair = contents_pair(self.this_tree, this_path)
1345
1252
winner = self._three_way(base_pair, other_pair, this_pair)
1346
1253
if winner == 'this':
1347
1254
# No interesting changes introduced by OTHER
1348
1255
return "unmodified"
1349
1256
# We have a hypothetical conflict, but if we have files, then we
1350
1257
# can try to merge the content
1351
trans_id = self.tt.trans_id_file_id(file_id)
1352
params = MergeHookParams(self, file_id, trans_id, this_pair[0],
1258
params = MergeFileHookParams(
1259
self, (base_path, other_path, this_path), trans_id, this_pair[0],
1353
1260
other_pair[0], winner)
1354
1261
hooks = self.active_hooks
1355
1262
hook_status = 'not_applicable'
1358
1265
if hook_status != 'not_applicable':
1359
1266
# Don't try any more hooks, this one applies.
1268
# If the merge ends up replacing the content of the file, we get rid of
1269
# it at the end of this method (this variable is used to track the
1270
# exceptions to this rule).
1361
1272
result = "modified"
1362
1273
if hook_status == 'not_applicable':
1363
# This is a contents conflict, because none of the available
1364
# functions could merge it.
1274
# No merge hook was able to resolve the situation. Two cases exist:
1275
# a content conflict or a duplicate one.
1366
1277
name = self.tt.final_name(trans_id)
1367
1278
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))
1279
inhibit_content_conflict = False
1280
if params.this_kind is None: # file_id is not in THIS
1281
# Is the name used for a different file_id ?
1282
if self.this_tree.is_versioned(other_path):
1283
# Two entries for the same path
1285
# versioning the merged file will trigger a duplicate
1287
self.tt.version_file(file_id, trans_id)
1288
transform.create_from_tree(
1289
self.tt, trans_id, self.other_tree,
1291
filter_tree_path=self._get_filter_tree_path(other_path))
1292
inhibit_content_conflict = True
1293
elif params.other_kind is None: # file_id is not in OTHER
1294
# Is the name used for a different file_id ?
1295
if self.other_tree.is_versioned(this_path):
1296
# Two entries for the same path again, but here, the other
1297
# entry will also be merged. We simply inhibit the
1298
# 'content' conflict creation because we know OTHER will
1299
# create (or has already created depending on ordering) an
1300
# entry at the same path. This will trigger a 'duplicate'
1303
inhibit_content_conflict = True
1304
if not inhibit_content_conflict:
1305
if params.this_kind is not None:
1306
self.tt.unversion_file(trans_id)
1307
# This is a contents conflict, because none of the available
1308
# functions could merge it.
1309
file_group = self._dump_conflicts(
1310
name, (base_path, other_path, this_path), parent_id,
1311
file_id, set_version=True)
1312
self._raw_conflicts.append(('contents conflict', file_group))
1373
1313
elif hook_status == 'success':
1374
1314
self.tt.create_file(lines, trans_id)
1375
1315
elif hook_status == 'conflicted':
1391
1332
raise AssertionError('unknown hook_status: %r' % (hook_status,))
1392
if not self.this_tree.has_id(file_id) and result == "modified":
1333
if not this_path and result == "modified":
1393
1334
self.tt.version_file(file_id, trans_id)
1394
# The merge has been performed, so the old contents should not be
1336
# The merge has been performed and produced a new content, so the
1337
# old contents should not be retained.
1397
1338
self.tt.delete_contents(trans_id)
1398
except errors.NoSuchFile:
1402
1341
def _default_other_winner_merge(self, merge_hook_params):
1403
1342
"""Replace this contents with other."""
1404
file_id = merge_hook_params.file_id
1405
1343
trans_id = merge_hook_params.trans_id
1406
file_in_this = self.this_tree.has_id(file_id)
1407
if self.other_tree.has_id(file_id):
1344
if merge_hook_params.other_path is not None:
1408
1345
# 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)
1346
transform.create_from_tree(
1347
self.tt, trans_id, self.other_tree,
1348
merge_hook_params.other_path,
1349
filter_tree_path=self._get_filter_tree_path(merge_hook_params.other_path))
1425
1350
return 'done', None
1351
elif merge_hook_params.this_path is not None:
1427
1352
# OTHER deleted the file
1428
1353
return 'delete', None
1430
1355
raise AssertionError(
1431
'winner is OTHER, but file_id %r not in THIS or OTHER tree'
1356
'winner is OTHER, but file %r not in THIS or OTHER tree'
1357
% (merge_hook_params.base_path,))
1434
1359
def merge_contents(self, merge_hook_params):
1435
1360
"""Fallback merge logic after user installed hooks."""
1436
1361
# This function is used in merge hooks as the fallback instance.
1437
# Perhaps making this function and the functions it calls be a
1362
# Perhaps making this function and the functions it calls be a
1438
1363
# a separate class would be better.
1439
1364
if merge_hook_params.winner == 'other':
1440
1365
# OTHER is a straight winner, so replace this contents with other
1444
1369
# BASE is a file, or both converted to files, so at least we
1445
1370
# have agreement that output should be a file.
1447
self.text_merge(merge_hook_params.file_id,
1448
merge_hook_params.trans_id)
1372
self.text_merge(merge_hook_params.trans_id,
1373
merge_hook_params.paths)
1449
1374
except errors.BinaryFile:
1450
1375
return 'not_applicable', None
1451
1376
return 'done', None
1453
1378
return 'not_applicable', None
1455
def get_lines(self, tree, file_id):
1380
def get_lines(self, tree, path):
1456
1381
"""Return the lines in a file, or an empty list."""
1457
if tree.has_id(file_id):
1458
return tree.get_file(file_id).readlines()
1385
kind = tree.kind(path)
1386
except errors.NoSuchFile:
1391
return tree.get_file_lines(path)
1462
def text_merge(self, file_id, trans_id):
1463
"""Perform a three-way text merge on a file_id"""
1393
def text_merge(self, trans_id, paths):
1394
"""Perform a three-way text merge on a file"""
1464
1395
# it's possible that we got here with base as a different type.
1465
1396
# if so, we just want two-way text conflicts.
1466
if self.base_tree.has_id(file_id) and \
1467
self.base_tree.kind(file_id) == "file":
1468
base_lines = self.get_lines(self.base_tree, file_id)
1471
other_lines = self.get_lines(self.other_tree, file_id)
1472
this_lines = self.get_lines(self.this_tree, file_id)
1397
base_path, other_path, this_path = paths
1398
base_lines = self.get_lines(self.base_tree, base_path)
1399
other_lines = self.get_lines(self.other_tree, other_path)
1400
this_lines = self.get_lines(self.this_tree, this_path)
1473
1401
m3 = merge3.Merge3(base_lines, this_lines, other_lines,
1474
1402
is_cherrypick=self.cherrypick)
1475
start_marker = "!START OF MERGE CONFLICT!" + "I HOPE THIS IS UNIQUE"
1403
start_marker = b"!START OF MERGE CONFLICT!" + b"I HOPE THIS IS UNIQUE"
1476
1404
if self.show_base is True:
1477
base_marker = '|' * 7
1405
base_marker = b'|' * 7
1479
1407
base_marker = None
1481
1409
def iter_merge3(retval):
1482
1410
retval["text_conflicts"] = False
1483
for line in m3.merge_lines(name_a = "TREE",
1484
name_b = "MERGE-SOURCE",
1485
name_base = "BASE-REVISION",
1411
for line in m3.merge_lines(name_a=b"TREE",
1412
name_b=b"MERGE-SOURCE",
1413
name_base=b"BASE-REVISION",
1486
1414
start_marker=start_marker,
1487
1415
base_marker=base_marker,
1488
1416
reprocess=self.reprocess):
1489
1417
if line.startswith(start_marker):
1490
1418
retval["text_conflicts"] = True
1491
yield line.replace(start_marker, '<' * 7)
1419
yield line.replace(start_marker, b'<' * 7)
1532
1476
versioned = False
1533
1477
file_group = []
1534
for suffix, tree, lines in data:
1535
if tree.has_id(file_id):
1536
trans_id = self._conflict_file(name, parent_id, tree, file_id,
1537
suffix, lines, filter_tree_path)
1478
for suffix, tree, path, lines in data:
1479
if path is not None:
1480
trans_id = self._conflict_file(
1481
name, parent_id, path, tree, suffix, lines,
1538
1483
file_group.append(trans_id)
1539
1484
if set_version and not versioned:
1540
1485
self.tt.version_file(file_id, trans_id)
1541
1486
versioned = True
1542
1487
return file_group
1544
def _conflict_file(self, name, parent_id, tree, file_id, suffix,
1489
def _conflict_file(self, name, parent_id, path, tree, suffix,
1545
1490
lines=None, filter_tree_path=None):
1546
1491
"""Emit a single conflict file."""
1547
1492
name = name + '.' + suffix
1548
1493
trans_id = self.tt.create_path(name, parent_id)
1549
transform.create_from_tree(self.tt, trans_id, tree, file_id, lines,
1494
transform.create_from_tree(
1495
self.tt, trans_id, tree, path,
1497
filter_tree_path=filter_tree_path)
1551
1498
return trans_id
1553
def merge_executable(self, file_id, file_status):
1554
"""Perform a merge on the execute bit."""
1555
executable = [self.executable(t, file_id) for t in (self.base_tree,
1556
self.other_tree, self.this_tree)]
1557
self._merge_executable(file_id, executable, file_status,
1558
resolver=self._three_way)
1560
def _merge_executable(self, file_id, executable, file_status,
1500
def _merge_executable(self, paths, trans_id, executable, file_status,
1562
1502
"""Perform a merge on the execute bit."""
1563
1503
base_executable, other_executable, this_executable = executable
1504
base_path, other_path, this_path = paths
1564
1505
if file_status == "deleted":
1566
1507
winner = resolver(*executable)
1567
1508
if winner == "conflict":
1568
# There must be a None in here, if we have a conflict, but we
1569
# need executability since file status was not deleted.
1570
if self.executable(self.other_tree, file_id) is None:
1509
# There must be a None in here, if we have a conflict, but we
1510
# need executability since file status was not deleted.
1511
if other_path is None:
1571
1512
winner = "this"
1573
1514
winner = "other"
1574
1515
if winner == 'this' and file_status != "modified":
1576
trans_id = self.tt.trans_id_file_id(file_id)
1578
if self.tt.final_kind(trans_id) != "file":
1580
except errors.NoSuchFile:
1517
if self.tt.final_kind(trans_id) != "file":
1582
1519
if winner == "this":
1583
1520
executability = this_executable
1585
if self.other_tree.has_id(file_id):
1522
if other_path is not None:
1586
1523
executability = other_executable
1587
elif self.this_tree.has_id(file_id):
1524
elif this_path is not None:
1588
1525
executability = this_executable
1589
elif self.base_tree_has_id(file_id):
1526
elif base_path is not None:
1590
1527
executability = base_executable
1591
1528
if executability is not None:
1592
trans_id = self.tt.trans_id_file_id(file_id)
1593
1529
self.tt.set_executability(executability, trans_id)
1595
1531
def cook_conflicts(self, fs_conflicts):
1596
1532
"""Convert all conflicts into a form that doesn't depend on trans_id"""
1597
self.cooked_conflicts.extend(transform.cook_conflicts(
1598
fs_conflicts, self.tt))
1533
content_conflict_file_ids = set()
1534
cooked_conflicts = transform.cook_conflicts(fs_conflicts, self.tt)
1599
1535
fp = transform.FinalPaths(self.tt)
1600
1536
for conflict in self._raw_conflicts:
1601
1537
conflict_type = conflict[0]
1602
1538
if conflict_type == 'path conflict':
1603
1539
(trans_id, file_id,
1604
this_parent, this_name,
1605
other_parent, other_name) = conflict[1:]
1540
this_parent, this_name,
1541
other_parent, other_name) = conflict[1:]
1606
1542
if this_parent is None or this_name is None:
1607
1543
this_path = '<deleted>'
1609
parent_path = fp.get_path(
1545
parent_path = fp.get_path(
1610
1546
self.tt.trans_id_file_id(this_parent))
1611
1547
this_path = osutils.pathjoin(parent_path, this_name)
1612
1548
if other_parent is None or other_name is None:
1613
1549
other_path = '<deleted>'
1615
parent_path = fp.get_path(
1616
self.tt.trans_id_file_id(other_parent))
1551
if other_parent == self.other_tree.path2id(''):
1552
# The tree transform doesn't know about the other root,
1553
# so we special case here to avoid a NoFinalPath
1557
parent_path = fp.get_path(
1558
self.tt.trans_id_file_id(other_parent))
1617
1559
other_path = osutils.pathjoin(parent_path, other_name)
1618
1560
c = _mod_conflicts.Conflict.factory(
1619
1561
'path conflict', path=this_path,
1704
1663
class LCAMerger(WeaveMerger):
1706
def _generate_merge_plan(self, file_id, base):
1707
return self.this_tree.plan_file_lca_merge(file_id, self.other_tree,
1665
requires_file_merge_plan = True
1667
def _generate_merge_plan(self, this_path, base):
1668
return self.this_tree.plan_file_lca_merge(this_path, self.other_tree,
1710
1672
class Diff3Merger(Merge3Merger):
1711
1673
"""Three-way merger using external diff3 for text merging"""
1713
def dump_file(self, temp_dir, name, tree, file_id):
1675
requires_file_merge_plan = False
1677
def dump_file(self, temp_dir, name, tree, path):
1714
1678
out_path = osutils.pathjoin(temp_dir, name)
1715
out_file = open(out_path, "wb")
1717
in_file = tree.get_file(file_id)
1679
with open(out_path, "wb") as out_file:
1680
in_file = tree.get_file(path)
1718
1681
for line in in_file:
1719
1682
out_file.write(line)
1722
1683
return out_path
1724
def text_merge(self, file_id, trans_id):
1685
def text_merge(self, trans_id, paths):
1725
1686
"""Perform a diff3 merge using a specified file-id and trans-id.
1726
1687
If conflicts are encountered, .BASE, .THIS. and .OTHER conflict files
1727
1688
will be dumped, and a will be conflict noted.
1691
base_path, other_path, this_path = paths
1730
1692
temp_dir = osutils.mkdtemp(prefix="bzr-")
1732
1694
new_file = osutils.pathjoin(temp_dir, "new")
1733
this = self.dump_file(temp_dir, "this", self.this_tree, file_id)
1734
base = self.dump_file(temp_dir, "base", self.base_tree, file_id)
1735
other = self.dump_file(temp_dir, "other", self.other_tree, file_id)
1736
status = bzrlib.patch.diff3(new_file, this, base, other)
1695
this = self.dump_file(
1696
temp_dir, "this", self.this_tree, this_path)
1697
base = self.dump_file(
1698
temp_dir, "base", self.base_tree, base_path)
1699
other = self.dump_file(
1700
temp_dir, "other", self.other_tree, other_path)
1701
status = breezy.patch.diff3(new_file, this, base, other)
1737
1702
if status not in (0, 1):
1738
1703
raise errors.BzrError("Unhandled diff3 exit code")
1739
f = open(new_file, 'rb')
1704
with open(new_file, 'rb') as f:
1741
1705
self.tt.create_file(f, trans_id)
1744
1706
if status == 1:
1745
1707
name = self.tt.final_name(trans_id)
1746
1708
parent_id = self.tt.final_parent(trans_id)
1747
self._dump_conflicts(name, parent_id, file_id)
1709
file_id = self.tt.final_file_id(trans_id)
1710
self._dump_conflicts(name, paths, parent_id, file_id)
1748
1711
self._raw_conflicts.append(('text conflict', trans_id))
1750
1713
osutils.rmtree(temp_dir)
1716
class PathNotInTree(errors.BzrError):
1718
_fmt = """Merge-into failed because %(tree)s does not contain %(path)s."""
1720
def __init__(self, path, tree):
1721
errors.BzrError.__init__(self, path=path, tree=tree)
1724
class MergeIntoMerger(Merger):
1725
"""Merger that understands other_tree will be merged into a subdir.
1727
This also changes the Merger api so that it uses real Branch, revision_id,
1728
and RevisonTree objects, rather than using revision specs.
1731
def __init__(self, this_tree, other_branch, other_tree, target_subdir,
1732
source_subpath, other_rev_id=None):
1733
"""Create a new MergeIntoMerger object.
1735
source_subpath in other_tree will be effectively copied to
1736
target_subdir in this_tree.
1738
:param this_tree: The tree that we will be merging into.
1739
:param other_branch: The Branch we will be merging from.
1740
:param other_tree: The RevisionTree object we want to merge.
1741
:param target_subdir: The relative path where we want to merge
1742
other_tree into this_tree
1743
:param source_subpath: The relative path specifying the subtree of
1744
other_tree to merge into this_tree.
1746
# It is assumed that we are merging a tree that is not in our current
1747
# ancestry, which means we are using the "EmptyTree" as our basis.
1748
null_ancestor_tree = this_tree.branch.repository.revision_tree(
1749
_mod_revision.NULL_REVISION)
1750
super(MergeIntoMerger, self).__init__(
1751
this_branch=this_tree.branch,
1752
this_tree=this_tree,
1753
other_tree=other_tree,
1754
base_tree=null_ancestor_tree,
1756
self._target_subdir = target_subdir
1757
self._source_subpath = source_subpath
1758
self.other_branch = other_branch
1759
if other_rev_id is None:
1760
other_rev_id = other_tree.get_revision_id()
1761
self.other_rev_id = self.other_basis = other_rev_id
1762
self.base_is_ancestor = True
1763
self.backup_files = True
1764
self.merge_type = Merge3Merger
1765
self.show_base = False
1766
self.reprocess = False
1767
self.interesting_files = None
1768
self.merge_type = _MergeTypeParameterizer(MergeIntoMergeType,
1769
target_subdir=self._target_subdir,
1770
source_subpath=self._source_subpath)
1771
if self._source_subpath != '':
1772
# If this isn't a partial merge make sure the revisions will be
1774
self._maybe_fetch(self.other_branch, self.this_branch,
1777
def set_pending(self):
1778
if self._source_subpath != '':
1780
Merger.set_pending(self)
1783
class _MergeTypeParameterizer(object):
1784
"""Wrap a merge-type class to provide extra parameters.
1786
This is hack used by MergeIntoMerger to pass some extra parameters to its
1787
merge_type. Merger.do_merge() sets up its own set of parameters to pass to
1788
the 'merge_type' member. It is difficult override do_merge without
1789
re-writing the whole thing, so instead we create a wrapper which will pass
1790
the extra parameters.
1793
def __init__(self, merge_type, **kwargs):
1794
self._extra_kwargs = kwargs
1795
self._merge_type = merge_type
1797
def __call__(self, *args, **kwargs):
1798
kwargs.update(self._extra_kwargs)
1799
return self._merge_type(*args, **kwargs)
1801
def __getattr__(self, name):
1802
return getattr(self._merge_type, name)
1805
class MergeIntoMergeType(Merge3Merger):
1806
"""Merger that incorporates a tree (or part of a tree) into another."""
1808
def __init__(self, *args, **kwargs):
1809
"""Initialize the merger object.
1811
:param args: See Merge3Merger.__init__'s args.
1812
:param kwargs: See Merge3Merger.__init__'s keyword args, except for
1813
source_subpath and target_subdir.
1814
:keyword source_subpath: The relative path specifying the subtree of
1815
other_tree to merge into this_tree.
1816
:keyword target_subdir: The relative path where we want to merge
1817
other_tree into this_tree
1819
# All of the interesting work happens during Merge3Merger.__init__(),
1820
# so we have have to hack in to get our extra parameters set.
1821
self._source_subpath = kwargs.pop('source_subpath')
1822
self._target_subdir = kwargs.pop('target_subdir')
1823
super(MergeIntoMergeType, self).__init__(*args, **kwargs)
1825
def _compute_transform(self):
1826
with ui.ui_factory.nested_progress_bar() as child_pb:
1827
entries = self._entries_to_incorporate()
1828
entries = list(entries)
1829
for num, (entry, parent_id, relpath) in enumerate(entries):
1830
child_pb.update(gettext('Preparing file merge'),
1832
parent_trans_id = self.tt.trans_id_file_id(parent_id)
1833
path = osutils.pathjoin(self._source_subpath, relpath)
1834
trans_id = transform.new_by_entry(path, self.tt, entry,
1835
parent_trans_id, self.other_tree)
1836
self._finish_computing_transform()
1838
def _entries_to_incorporate(self):
1839
"""Yields pairs of (inventory_entry, new_parent)."""
1840
subdir_id = self.other_tree.path2id(self._source_subpath)
1841
if subdir_id is None:
1842
# XXX: The error would be clearer if it gave the URL of the source
1843
# branch, but we don't have a reference to that here.
1844
raise PathNotInTree(self._source_subpath, "Source tree")
1845
subdir = next(self.other_tree.iter_entries_by_dir(
1846
specific_files=[self._source_subpath]))[1]
1847
parent_in_target = osutils.dirname(self._target_subdir)
1848
target_id = self.this_tree.path2id(parent_in_target)
1849
if target_id is None:
1850
raise PathNotInTree(self._target_subdir, "Target tree")
1851
name_in_target = osutils.basename(self._target_subdir)
1852
merge_into_root = subdir.copy()
1853
merge_into_root.name = name_in_target
1855
self.this_tree.id2path(merge_into_root.file_id)
1856
except errors.NoSuchId:
1859
# Give the root a new file-id.
1860
# This can happen fairly easily if the directory we are
1861
# incorporating is the root, and both trees have 'TREE_ROOT' as
1862
# their root_id. Users will expect this to Just Work, so we
1863
# change the file-id here.
1864
# Non-root file-ids could potentially conflict too. That's really
1865
# an edge case, so we don't do anything special for those. We let
1866
# them cause conflicts.
1867
merge_into_root.file_id = generate_ids.gen_file_id(name_in_target)
1868
yield (merge_into_root, target_id, '')
1869
if subdir.kind != 'directory':
1870
# No children, so we are done.
1872
for path, entry in self.other_tree.root_inventory.iter_entries_by_dir(subdir_id):
1873
parent_id = entry.parent_id
1874
if parent_id == subdir.file_id:
1875
# The root's parent ID has changed, so make sure children of
1876
# the root refer to the new ID.
1877
parent_id = merge_into_root.file_id
1878
yield (entry, parent_id, path)
1753
1881
def merge_inner(this_branch, other_tree, base_tree, ignore_zero=False,
1754
1882
backup_files=False,
1755
1883
merge_type=Merge3Merger,
1756
interesting_ids=None,
1757
1884
show_base=False,
1758
1885
reprocess=False,
1759
1886
other_rev_id=None,
1760
1887
interesting_files=None,
1761
1888
this_tree=None,
1763
1889
change_reporter=None):
1764
1890
"""Primary interface for merging.
1766
typical use is probably
1767
'merge_inner(branch, branch.get_revision_tree(other_revision),
1768
branch.get_revision_tree(base_revision))'
1892
Typical use is probably::
1894
merge_inner(branch, branch.get_revision_tree(other_revision),
1895
branch.get_revision_tree(base_revision))
1770
1897
if this_tree is None:
1771
raise errors.BzrError("bzrlib.merge.merge_inner requires a this_tree "
1772
"parameter as of bzrlib version 0.8.")
1898
raise errors.BzrError("breezy.merge.merge_inner requires a this_tree "
1773
1900
merger = Merger(this_branch, other_tree, base_tree, this_tree=this_tree,
1774
pb=pb, change_reporter=change_reporter)
1901
change_reporter=change_reporter)
1775
1902
merger.backup_files = backup_files
1776
1903
merger.merge_type = merge_type
1777
merger.interesting_ids = interesting_ids
1778
1904
merger.ignore_zero = ignore_zero
1779
if interesting_files:
1781
raise ValueError('Only supply interesting_ids'
1782
' or interesting_files')
1783
merger.interesting_files = interesting_files
1905
merger.interesting_files = interesting_files
1784
1906
merger.show_base = show_base
1785
1907
merger.reprocess = reprocess
1786
1908
merger.other_rev_id = other_rev_id