/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/merge.py

  • Committer: Robert Collins
  • Date: 2007-07-12 12:07:13 UTC
  • mto: This revision was merged to the branch mainline in revision 2610.
  • Revision ID: robertc@robertcollins.net-20070712120713-c2vfm2n61l63wt6s
(robertc) Introduce a pack command.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Copyright (C) 2005, 2006 Canonical Ltd
 
2
#
 
3
# This program is free software; you can redistribute it and/or modify
 
4
# it under the terms of the GNU General Public License as published by
 
5
# the Free Software Foundation; either version 2 of the License, or
 
6
# (at your option) any later version.
 
7
#
 
8
# This program is distributed in the hope that it will be useful,
 
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
11
# GNU General Public License for more details.
 
12
#
 
13
# You should have received a copy of the GNU General Public License
 
14
# along with this program; if not, write to the Free Software
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
 
 
18
import os
 
19
import errno
 
20
import warnings
 
21
 
 
22
from bzrlib import (
 
23
    osutils,
 
24
    registry,
 
25
    )
 
26
from bzrlib.branch import Branch
 
27
from bzrlib.conflicts import ConflictList, Conflict
 
28
from bzrlib.errors import (BzrCommandError,
 
29
                           BzrError,
 
30
                           NoCommonAncestor,
 
31
                           NoCommits,
 
32
                           NoSuchRevision,
 
33
                           NoSuchFile,
 
34
                           NotBranchError,
 
35
                           NotVersionedError,
 
36
                           UnrelatedBranches,
 
37
                           UnsupportedOperation,
 
38
                           WorkingTreeNotRevision,
 
39
                           BinaryFile,
 
40
                           )
 
41
from bzrlib.merge3 import Merge3
 
42
from bzrlib.osutils import rename, pathjoin
 
43
from progress import DummyProgress, ProgressPhase
 
44
from bzrlib.revision import (is_ancestor, NULL_REVISION, ensure_null)
 
45
from bzrlib.textfile import check_text_lines
 
46
from bzrlib.trace import mutter, warning, note
 
47
from bzrlib.transform import (TreeTransform, resolve_conflicts, cook_conflicts,
 
48
                              conflict_pass, FinalPaths, create_by_entry,
 
49
                              unique_add, ROOT_PARENT)
 
50
from bzrlib.versionedfile import WeaveMerge
 
51
from bzrlib import ui
 
52
 
 
53
# TODO: Report back as changes are merged in
 
54
 
 
55
def _get_tree(treespec, local_branch=None):
 
56
    from bzrlib import workingtree
 
57
    location, revno = treespec
 
58
    if revno is None:
 
59
        tree = workingtree.WorkingTree.open_containing(location)[0]
 
60
        return tree.branch, tree
 
61
    branch = Branch.open_containing(location)[0]
 
62
    if revno == -1:
 
63
        revision_id = branch.last_revision()
 
64
    else:
 
65
        revision_id = branch.get_rev_id(revno)
 
66
    if revision_id is None:
 
67
        revision_id = NULL_REVISION
 
68
    return branch, _get_revid_tree(branch, revision_id, local_branch)
 
69
 
 
70
 
 
71
def _get_revid_tree(branch, revision_id, local_branch):
 
72
    if revision_id is None:
 
73
        base_tree = branch.bzrdir.open_workingtree()
 
74
    else:
 
75
        if local_branch is not None:
 
76
            if local_branch.base != branch.base:
 
77
                local_branch.fetch(branch, revision_id)
 
78
            base_tree = local_branch.repository.revision_tree(revision_id)
 
79
        else:
 
80
            base_tree = branch.repository.revision_tree(revision_id)
 
81
    return base_tree
 
82
 
 
83
 
 
84
def _get_revid_tree_from_tree(tree, revision_id, local_branch):
 
85
    if revision_id is None:
 
86
        return tree
 
87
    if local_branch is not None:
 
88
        if local_branch.base != tree.branch.base:
 
89
            local_branch.fetch(tree.branch, revision_id)
 
90
        return local_branch.repository.revision_tree(revision_id)
 
91
    return tree.branch.repository.revision_tree(revision_id)
 
92
 
 
93
 
 
94
def transform_tree(from_tree, to_tree, interesting_ids=None):
 
95
    merge_inner(from_tree.branch, to_tree, from_tree, ignore_zero=True,
 
96
                interesting_ids=interesting_ids, this_tree=from_tree)
 
97
 
 
98
 
 
99
class Merger(object):
 
100
    def __init__(self, this_branch, other_tree=None, base_tree=None,
 
101
                 this_tree=None, pb=DummyProgress(), change_reporter=None,
 
102
                 recurse='down'):
 
103
        object.__init__(self)
 
104
        assert this_tree is not None, "this_tree is required"
 
105
        self.this_branch = this_branch
 
106
        self.this_basis = this_branch.last_revision()
 
107
        self.this_rev_id = None
 
108
        self.this_tree = this_tree
 
109
        self.this_revision_tree = None
 
110
        self.this_basis_tree = None
 
111
        self.other_tree = other_tree
 
112
        self.other_branch = None
 
113
        self.base_tree = base_tree
 
114
        self.ignore_zero = False
 
115
        self.backup_files = False
 
116
        self.interesting_ids = None
 
117
        self.interesting_files = None
 
118
        self.show_base = False
 
119
        self.reprocess = False
 
120
        self._pb = pb
 
121
        self.pp = None
 
122
        self.recurse = recurse
 
123
        self.change_reporter = change_reporter
 
124
 
 
125
    def revision_tree(self, revision_id):
 
126
        return self.this_branch.repository.revision_tree(revision_id)
 
127
 
 
128
    def ensure_revision_trees(self):
 
129
        if self.this_revision_tree is None:
 
130
            self.this_basis_tree = self.this_branch.repository.revision_tree(
 
131
                self.this_basis)
 
132
            if self.this_basis == self.this_rev_id:
 
133
                self.this_revision_tree = self.this_basis_tree
 
134
 
 
135
        if self.other_rev_id is None:
 
136
            other_basis_tree = self.revision_tree(self.other_basis)
 
137
            changes = other_basis_tree.changes_from(self.other_tree)
 
138
            if changes.has_changed():
 
139
                raise WorkingTreeNotRevision(self.this_tree)
 
140
            other_rev_id = self.other_basis
 
141
            self.other_tree = other_basis_tree
 
142
 
 
143
    def file_revisions(self, file_id):
 
144
        self.ensure_revision_trees()
 
145
        def get_id(tree, file_id):
 
146
            revision_id = tree.inventory[file_id].revision
 
147
            assert revision_id is not None
 
148
            return revision_id
 
149
        if self.this_rev_id is None:
 
150
            if self.this_basis_tree.get_file_sha1(file_id) != \
 
151
                self.this_tree.get_file_sha1(file_id):
 
152
                raise WorkingTreeNotRevision(self.this_tree)
 
153
 
 
154
        trees = (self.this_basis_tree, self.other_tree)
 
155
        return [get_id(tree, file_id) for tree in trees]
 
156
 
 
157
    def check_basis(self, check_clean, require_commits=True):
 
158
        if self.this_basis is None and require_commits is True:
 
159
            raise BzrCommandError("This branch has no commits."
 
160
                                  " (perhaps you would prefer 'bzr pull')")
 
161
        if check_clean:
 
162
            self.compare_basis()
 
163
            if self.this_basis != self.this_rev_id:
 
164
                raise BzrCommandError("Working tree has uncommitted changes.")
 
165
 
 
166
    def compare_basis(self):
 
167
        changes = self.this_tree.changes_from(self.this_tree.basis_tree())
 
168
        if not changes.has_changed():
 
169
            self.this_rev_id = self.this_basis
 
170
 
 
171
    def set_interesting_files(self, file_list):
 
172
        self.interesting_files = file_list
 
173
 
 
174
    def _set_interesting_files(self, file_list):
 
175
        """Set the list of interesting ids from a list of files."""
 
176
        if file_list is None:
 
177
            self.interesting_ids = None
 
178
            return
 
179
 
 
180
        interesting_ids = set()
 
181
        for path in file_list:
 
182
            found_id = False
 
183
            # TODO: jam 20070226 The trees are not locked at this time,
 
184
            #       wouldn't it make merge faster if it locks everything in the
 
185
            #       beginning? It locks at do_merge time, but this happens
 
186
            #       before that.
 
187
            for tree in (self.this_tree, self.base_tree, self.other_tree):
 
188
                file_id = tree.path2id(path)
 
189
                if file_id is not None:
 
190
                    interesting_ids.add(file_id)
 
191
                    found_id = True
 
192
            if not found_id:
 
193
                raise NotVersionedError(path=path)
 
194
        self.interesting_ids = interesting_ids
 
195
 
 
196
    def set_pending(self):
 
197
        if not self.base_is_ancestor:
 
198
            return
 
199
        if self.other_rev_id is None:
 
200
            return
 
201
        ancestry = set(self.this_branch.repository.get_ancestry(
 
202
            self.this_basis, topo_sorted=False))
 
203
        if self.other_rev_id in ancestry:
 
204
            return
 
205
        self.this_tree.add_parent_tree((self.other_rev_id, self.other_tree))
 
206
 
 
207
    def set_other(self, other_revision):
 
208
        """Set the revision and tree to merge from.
 
209
 
 
210
        This sets the other_tree, other_rev_id, other_basis attributes.
 
211
 
 
212
        :param other_revision: The [path, revision] list to merge from.
 
213
        """
 
214
        self.other_branch, self.other_tree = _get_tree(other_revision,
 
215
                                                  self.this_branch)
 
216
        if other_revision[1] == -1:
 
217
            self.other_rev_id = self.other_branch.last_revision()
 
218
            if self.other_rev_id is None:
 
219
                raise NoCommits(self.other_branch)
 
220
            self.other_basis = self.other_rev_id
 
221
        elif other_revision[1] is not None:
 
222
            self.other_rev_id = self.other_branch.get_rev_id(other_revision[1])
 
223
            self.other_basis = self.other_rev_id
 
224
        else:
 
225
            self.other_rev_id = None
 
226
            self.other_basis = self.other_branch.last_revision()
 
227
            if self.other_basis is None:
 
228
                raise NoCommits(self.other_branch)
 
229
        if self.other_branch.base != self.this_branch.base:
 
230
            self.this_branch.fetch(self.other_branch,
 
231
                                   last_revision=self.other_basis)
 
232
 
 
233
    def set_other_revision(self, revision_id, other_branch):
 
234
        """Set 'other' based on a branch and revision id
 
235
 
 
236
        :param revision_id: The revision to use for a tree
 
237
        :param other_branch: The branch containing this tree
 
238
        """
 
239
        self.other_rev_id = revision_id
 
240
        self.other_branch = other_branch
 
241
        self.this_branch.fetch(other_branch, self.other_rev_id)
 
242
        self.other_tree = self.revision_tree(revision_id)
 
243
        self.other_basis = revision_id
 
244
 
 
245
    def find_base(self):
 
246
        self.set_base([None, None])
 
247
 
 
248
    def set_base(self, base_revision):
 
249
        """Set the base revision to use for the merge.
 
250
 
 
251
        :param base_revision: A 2-list containing a path and revision number.
 
252
        """
 
253
        mutter("doing merge() with no base_revision specified")
 
254
        if base_revision == [None, None]:
 
255
            try:
 
256
                pb = ui.ui_factory.nested_progress_bar()
 
257
                try:
 
258
                    this_repo = self.this_branch.repository
 
259
                    graph = this_repo.get_graph()
 
260
                    revisions = [ensure_null(self.this_basis),
 
261
                                 ensure_null(self.other_basis)]
 
262
                    if NULL_REVISION in revisions:
 
263
                        self.base_rev_id = NULL_REVISION
 
264
                    else:
 
265
                        self.base_rev_id = graph.find_unique_lca(*revisions)
 
266
                        if self.base_rev_id == NULL_REVISION:
 
267
                            raise UnrelatedBranches()
 
268
                finally:
 
269
                    pb.finished()
 
270
            except NoCommonAncestor:
 
271
                raise UnrelatedBranches()
 
272
            self.base_tree = _get_revid_tree_from_tree(self.this_tree,
 
273
                                                       self.base_rev_id,
 
274
                                                       None)
 
275
            self.base_is_ancestor = True
 
276
        else:
 
277
            base_branch, self.base_tree = _get_tree(base_revision)
 
278
            if base_revision[1] == -1:
 
279
                self.base_rev_id = base_branch.last_revision()
 
280
            elif base_revision[1] is None:
 
281
                self.base_rev_id = None
 
282
            else:
 
283
                self.base_rev_id = base_branch.get_rev_id(base_revision[1])
 
284
            if self.this_branch.base != base_branch.base:
 
285
                self.this_branch.fetch(base_branch)
 
286
            self.base_is_ancestor = is_ancestor(self.this_basis, 
 
287
                                                self.base_rev_id,
 
288
                                                self.this_branch)
 
289
 
 
290
    def do_merge(self):
 
291
        kwargs = {'working_tree':self.this_tree, 'this_tree': self.this_tree,
 
292
                  'other_tree': self.other_tree,
 
293
                  'interesting_ids': self.interesting_ids,
 
294
                  'interesting_files': self.interesting_files,
 
295
                  'pp': self.pp}
 
296
        if self.merge_type.requires_base:
 
297
            kwargs['base_tree'] = self.base_tree
 
298
        if self.merge_type.supports_reprocess:
 
299
            kwargs['reprocess'] = self.reprocess
 
300
        elif self.reprocess:
 
301
            raise BzrError("Conflict reduction is not supported for merge"
 
302
                                  " type %s." % self.merge_type)
 
303
        if self.merge_type.supports_show_base:
 
304
            kwargs['show_base'] = self.show_base
 
305
        elif self.show_base:
 
306
            raise BzrError("Showing base is not supported for this"
 
307
                                  " merge type. %s" % self.merge_type)
 
308
        self.this_tree.lock_tree_write()
 
309
        if self.base_tree is not None:
 
310
            self.base_tree.lock_read()
 
311
        if self.other_tree is not None:
 
312
            self.other_tree.lock_read()
 
313
        try:
 
314
            merge = self.merge_type(pb=self._pb,
 
315
                                    change_reporter=self.change_reporter,
 
316
                                    **kwargs)
 
317
            if self.recurse == 'down':
 
318
                for path, file_id in self.this_tree.iter_references():
 
319
                    sub_tree = self.this_tree.get_nested_tree(file_id, path)
 
320
                    other_revision = self.other_tree.get_reference_revision(
 
321
                        file_id, path)
 
322
                    if  other_revision == sub_tree.last_revision():
 
323
                        continue
 
324
                    sub_merge = Merger(sub_tree.branch, this_tree=sub_tree)
 
325
                    sub_merge.merge_type = self.merge_type
 
326
                    relpath = self.this_tree.relpath(path)
 
327
                    other_branch = self.other_branch.reference_parent(file_id, relpath)
 
328
                    sub_merge.set_other_revision(other_revision, other_branch)
 
329
                    base_revision = self.base_tree.get_reference_revision(file_id)
 
330
                    sub_merge.base_tree = \
 
331
                        sub_tree.branch.repository.revision_tree(base_revision)
 
332
                    sub_merge.do_merge()
 
333
 
 
334
        finally:
 
335
            if self.other_tree is not None:
 
336
                self.other_tree.unlock()
 
337
            if self.base_tree is not None:
 
338
                self.base_tree.unlock()
 
339
            self.this_tree.unlock()
 
340
        if len(merge.cooked_conflicts) == 0:
 
341
            if not self.ignore_zero:
 
342
                note("All changes applied successfully.")
 
343
        else:
 
344
            note("%d conflicts encountered." % len(merge.cooked_conflicts))
 
345
 
 
346
        return len(merge.cooked_conflicts)
 
347
 
 
348
    def regen_inventory(self, new_entries):
 
349
        old_entries = self.this_tree.read_working_inventory()
 
350
        new_inventory = {}
 
351
        by_path = {}
 
352
        new_entries_map = {} 
 
353
        for path, file_id in new_entries:
 
354
            if path is None:
 
355
                continue
 
356
            new_entries_map[file_id] = path
 
357
 
 
358
        def id2path(file_id):
 
359
            path = new_entries_map.get(file_id)
 
360
            if path is not None:
 
361
                return path
 
362
            entry = old_entries[file_id]
 
363
            if entry.parent_id is None:
 
364
                return entry.name
 
365
            return pathjoin(id2path(entry.parent_id), entry.name)
 
366
            
 
367
        for file_id in old_entries:
 
368
            entry = old_entries[file_id]
 
369
            path = id2path(file_id)
 
370
            if file_id in self.base_tree.inventory:
 
371
                executable = getattr(self.base_tree.inventory[file_id], 'executable', False)
 
372
            else:
 
373
                executable = getattr(entry, 'executable', False)
 
374
            new_inventory[file_id] = (path, file_id, entry.parent_id, 
 
375
                                      entry.kind, executable)
 
376
                                      
 
377
            by_path[path] = file_id
 
378
        
 
379
        deletions = 0
 
380
        insertions = 0
 
381
        new_path_list = []
 
382
        for path, file_id in new_entries:
 
383
            if path is None:
 
384
                del new_inventory[file_id]
 
385
                deletions += 1
 
386
            else:
 
387
                new_path_list.append((path, file_id))
 
388
                if file_id not in old_entries:
 
389
                    insertions += 1
 
390
        # Ensure no file is added before its parent
 
391
        new_path_list.sort()
 
392
        for path, file_id in new_path_list:
 
393
            if path == '':
 
394
                parent = None
 
395
            else:
 
396
                parent = by_path[os.path.dirname(path)]
 
397
            abspath = pathjoin(self.this_tree.basedir, path)
 
398
            kind = osutils.file_kind(abspath)
 
399
            if file_id in self.base_tree.inventory:
 
400
                executable = getattr(self.base_tree.inventory[file_id], 'executable', False)
 
401
            else:
 
402
                executable = False
 
403
            new_inventory[file_id] = (path, file_id, parent, kind, executable)
 
404
            by_path[path] = file_id 
 
405
 
 
406
        # Get a list in insertion order
 
407
        new_inventory_list = new_inventory.values()
 
408
        mutter ("""Inventory regeneration:
 
409
    old length: %i insertions: %i deletions: %i new_length: %i"""\
 
410
            % (len(old_entries), insertions, deletions, 
 
411
               len(new_inventory_list)))
 
412
        assert len(new_inventory_list) == len(old_entries) + insertions\
 
413
            - deletions
 
414
        new_inventory_list.sort()
 
415
        return new_inventory_list
 
416
 
 
417
 
 
418
class Merge3Merger(object):
 
419
    """Three-way merger that uses the merge3 text merger"""
 
420
    requires_base = True
 
421
    supports_reprocess = True
 
422
    supports_show_base = True
 
423
    history_based = False
 
424
    winner_idx = {"this": 2, "other": 1, "conflict": 1}
 
425
 
 
426
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
 
427
                 interesting_ids=None, reprocess=False, show_base=False,
 
428
                 pb=DummyProgress(), pp=None, change_reporter=None,
 
429
                 interesting_files=None):
 
430
        """Initialize the merger object and perform the merge.
 
431
 
 
432
        :param working_tree: The working tree to apply the merge to
 
433
        :param this_tree: The local tree in the merge operation
 
434
        :param base_tree: The common tree in the merge operation
 
435
        :param other_tree: The other other tree to merge changes from
 
436
        :param interesting_ids: The file_ids of files that should be
 
437
            participate in the merge.  May not be combined with
 
438
            interesting_files.
 
439
        :param: reprocess If True, perform conflict-reduction processing.
 
440
        :param show_base: If True, show the base revision in text conflicts.
 
441
            (incompatible with reprocess)
 
442
        :param pb: A Progress bar
 
443
        :param pp: A ProgressPhase object
 
444
        :param change_reporter: An object that should report changes made
 
445
        :param interesting_files: The tree-relative paths of files that should
 
446
            participate in the merge.  If these paths refer to directories,
 
447
            the contents of those directories will also be included.  May not
 
448
            be combined with interesting_ids.  If neither interesting_files nor
 
449
            interesting_ids is specified, all files may participate in the
 
450
            merge.
 
451
        """
 
452
        object.__init__(self)
 
453
        if interesting_files is not None:
 
454
            assert interesting_ids is None
 
455
        self.interesting_ids = interesting_ids
 
456
        self.interesting_files = interesting_files
 
457
        self.this_tree = working_tree
 
458
        self.this_tree.lock_tree_write()
 
459
        self.base_tree = base_tree
 
460
        self.base_tree.lock_read()
 
461
        self.other_tree = other_tree
 
462
        self.other_tree.lock_read()
 
463
        self._raw_conflicts = []
 
464
        self.cooked_conflicts = []
 
465
        self.reprocess = reprocess
 
466
        self.show_base = show_base
 
467
        self.pb = pb
 
468
        self.pp = pp
 
469
        self.change_reporter = change_reporter
 
470
        if self.pp is None:
 
471
            self.pp = ProgressPhase("Merge phase", 3, self.pb)
 
472
 
 
473
        self.tt = TreeTransform(working_tree, self.pb)
 
474
        try:
 
475
            self.pp.next_phase()
 
476
            entries = self._entries3()
 
477
            child_pb = ui.ui_factory.nested_progress_bar()
 
478
            try:
 
479
                for num, (file_id, changed, parents3, names3,
 
480
                          executable3) in enumerate(entries):
 
481
                    child_pb.update('Preparing file merge', num, len(entries))
 
482
                    self._merge_names(file_id, parents3, names3)
 
483
                    if changed:
 
484
                        file_status = self.merge_contents(file_id)
 
485
                    else:
 
486
                        file_status = 'unmodified'
 
487
                    self._merge_executable(file_id,
 
488
                        executable3, file_status)
 
489
            finally:
 
490
                child_pb.finished()
 
491
            self.fix_root()
 
492
            self.pp.next_phase()
 
493
            child_pb = ui.ui_factory.nested_progress_bar()
 
494
            try:
 
495
                fs_conflicts = resolve_conflicts(self.tt, child_pb,
 
496
                    lambda t, c: conflict_pass(t, c, self.other_tree))
 
497
            finally:
 
498
                child_pb.finished()
 
499
            if change_reporter is not None:
 
500
                from bzrlib import delta
 
501
                delta.report_changes(self.tt._iter_changes(), change_reporter)
 
502
            self.cook_conflicts(fs_conflicts)
 
503
            for conflict in self.cooked_conflicts:
 
504
                warning(conflict)
 
505
            self.pp.next_phase()
 
506
            results = self.tt.apply()
 
507
            self.write_modified(results)
 
508
            try:
 
509
                working_tree.add_conflicts(self.cooked_conflicts)
 
510
            except UnsupportedOperation:
 
511
                pass
 
512
        finally:
 
513
            self.tt.finalize()
 
514
            self.other_tree.unlock()
 
515
            self.base_tree.unlock()
 
516
            self.this_tree.unlock()
 
517
            self.pb.clear()
 
518
 
 
519
    def _entries3(self):
 
520
        """Gather data about files modified between three trees.
 
521
 
 
522
        Return a list of tuples of file_id, changed, parents3, names3,
 
523
        executable3.  changed is a boolean indicating whether the file contents
 
524
        or kind were changed.  parents3 is a tuple of parent ids for base,
 
525
        other and this.  names3 is a tuple of names for base, other and this.
 
526
        executable3 is a tuple of execute-bit values for base, other and this.
 
527
        """
 
528
        result = []
 
529
        iterator = self.other_tree._iter_changes(self.base_tree,
 
530
                include_unchanged=True, specific_files=self.interesting_files,
 
531
                extra_trees=[self.this_tree])
 
532
        for (file_id, paths, changed, versioned, parents, names, kind,
 
533
             executable) in iterator:
 
534
            if (self.interesting_ids is not None and
 
535
                file_id not in self.interesting_ids):
 
536
                continue
 
537
            if file_id in self.this_tree.inventory:
 
538
                entry = self.this_tree.inventory[file_id]
 
539
                this_name = entry.name
 
540
                this_parent = entry.parent_id
 
541
                this_executable = entry.executable
 
542
            else:
 
543
                this_name = None
 
544
                this_parent = None
 
545
                this_executable = None
 
546
            parents3 = parents + (this_parent,)
 
547
            names3 = names + (this_name,)
 
548
            executable3 = executable + (this_executable,)
 
549
            result.append((file_id, changed, parents3, names3, executable3))
 
550
        return result
 
551
 
 
552
    def fix_root(self):
 
553
        try:
 
554
            self.tt.final_kind(self.tt.root)
 
555
        except NoSuchFile:
 
556
            self.tt.cancel_deletion(self.tt.root)
 
557
        if self.tt.final_file_id(self.tt.root) is None:
 
558
            self.tt.version_file(self.tt.tree_file_id(self.tt.root), 
 
559
                                 self.tt.root)
 
560
        if self.other_tree.inventory.root is None:
 
561
            return
 
562
        other_root_file_id = self.other_tree.inventory.root.file_id
 
563
        other_root = self.tt.trans_id_file_id(other_root_file_id)
 
564
        if other_root == self.tt.root:
 
565
            return
 
566
        try:
 
567
            self.tt.final_kind(other_root)
 
568
        except NoSuchFile:
 
569
            return
 
570
        self.reparent_children(self.other_tree.inventory.root, self.tt.root)
 
571
        self.tt.cancel_creation(other_root)
 
572
        self.tt.cancel_versioning(other_root)
 
573
 
 
574
    def reparent_children(self, ie, target):
 
575
        for thing, child in ie.children.iteritems():
 
576
            trans_id = self.tt.trans_id_file_id(child.file_id)
 
577
            self.tt.adjust_path(self.tt.final_name(trans_id), target, trans_id)
 
578
 
 
579
    def write_modified(self, results):
 
580
        modified_hashes = {}
 
581
        for path in results.modified_paths:
 
582
            file_id = self.this_tree.path2id(self.this_tree.relpath(path))
 
583
            if file_id is None:
 
584
                continue
 
585
            hash = self.this_tree.get_file_sha1(file_id)
 
586
            if hash is None:
 
587
                continue
 
588
            modified_hashes[file_id] = hash
 
589
        self.this_tree.set_merge_modified(modified_hashes)
 
590
 
 
591
    @staticmethod
 
592
    def parent(entry, file_id):
 
593
        """Determine the parent for a file_id (used as a key method)"""
 
594
        if entry is None:
 
595
            return None
 
596
        return entry.parent_id
 
597
 
 
598
    @staticmethod
 
599
    def name(entry, file_id):
 
600
        """Determine the name for a file_id (used as a key method)"""
 
601
        if entry is None:
 
602
            return None
 
603
        return entry.name
 
604
    
 
605
    @staticmethod
 
606
    def contents_sha1(tree, file_id):
 
607
        """Determine the sha1 of the file contents (used as a key method)."""
 
608
        if file_id not in tree:
 
609
            return None
 
610
        return tree.get_file_sha1(file_id)
 
611
 
 
612
    @staticmethod
 
613
    def executable(tree, file_id):
 
614
        """Determine the executability of a file-id (used as a key method)."""
 
615
        if file_id not in tree:
 
616
            return None
 
617
        if tree.kind(file_id) != "file":
 
618
            return False
 
619
        return tree.is_executable(file_id)
 
620
 
 
621
    @staticmethod
 
622
    def kind(tree, file_id):
 
623
        """Determine the kind of a file-id (used as a key method)."""
 
624
        if file_id not in tree:
 
625
            return None
 
626
        return tree.kind(file_id)
 
627
 
 
628
    @staticmethod
 
629
    def _three_way(base, other, this):
 
630
        #if base == other, either they all agree, or only THIS has changed.
 
631
        if base == other:
 
632
            return 'this'
 
633
        elif this not in (base, other):
 
634
            return 'conflict'
 
635
        # "Ambiguous clean merge" -- both sides have made the same change.
 
636
        elif this == other:
 
637
            return "this"
 
638
        # this == base: only other has changed.
 
639
        else:
 
640
            return "other"
 
641
 
 
642
    @staticmethod
 
643
    def scalar_three_way(this_tree, base_tree, other_tree, file_id, key):
 
644
        """Do a three-way test on a scalar.
 
645
        Return "this", "other" or "conflict", depending whether a value wins.
 
646
        """
 
647
        key_base = key(base_tree, file_id)
 
648
        key_other = key(other_tree, file_id)
 
649
        #if base == other, either they all agree, or only THIS has changed.
 
650
        if key_base == key_other:
 
651
            return "this"
 
652
        key_this = key(this_tree, file_id)
 
653
        if key_this not in (key_base, key_other):
 
654
            return "conflict"
 
655
        # "Ambiguous clean merge"
 
656
        elif key_this == key_other:
 
657
            return "this"
 
658
        else:
 
659
            assert key_this == key_base
 
660
            return "other"
 
661
 
 
662
    def merge_names(self, file_id):
 
663
        def get_entry(tree):
 
664
            if file_id in tree.inventory:
 
665
                return tree.inventory[file_id]
 
666
            else:
 
667
                return None
 
668
        this_entry = get_entry(self.this_tree)
 
669
        other_entry = get_entry(self.other_tree)
 
670
        base_entry = get_entry(self.base_tree)
 
671
        entries = (base_entry, other_entry, this_entry)
 
672
        names = []
 
673
        parents = []
 
674
        for entry in entries:
 
675
            if entry is None:
 
676
                names.append(None)
 
677
                parents.append(None)
 
678
            else:
 
679
                names.append(entry.name)
 
680
                parents.append(entry.parent_id)
 
681
        return self._merge_names(file_id, parents, names)
 
682
 
 
683
    def _merge_names(self, file_id, parents, names):
 
684
        """Perform a merge on file_id names and parents"""
 
685
        base_name, other_name, this_name = names
 
686
        base_parent, other_parent, this_parent = parents
 
687
 
 
688
        name_winner = self._three_way(*names)
 
689
 
 
690
        parent_id_winner = self._three_way(*parents)
 
691
        if this_name is None:
 
692
            if name_winner == "this":
 
693
                name_winner = "other"
 
694
            if parent_id_winner == "this":
 
695
                parent_id_winner = "other"
 
696
        if name_winner == "this" and parent_id_winner == "this":
 
697
            return
 
698
        if name_winner == "conflict":
 
699
            trans_id = self.tt.trans_id_file_id(file_id)
 
700
            self._raw_conflicts.append(('name conflict', trans_id, 
 
701
                                        this_name, other_name))
 
702
        if parent_id_winner == "conflict":
 
703
            trans_id = self.tt.trans_id_file_id(file_id)
 
704
            self._raw_conflicts.append(('parent conflict', trans_id, 
 
705
                                        this_parent, other_parent))
 
706
        if other_name is None:
 
707
            # it doesn't matter whether the result was 'other' or 
 
708
            # 'conflict'-- if there's no 'other', we leave it alone.
 
709
            return
 
710
        # if we get here, name_winner and parent_winner are set to safe values.
 
711
        trans_id = self.tt.trans_id_file_id(file_id)
 
712
        parent_id = parents[self.winner_idx[parent_id_winner]]
 
713
        if parent_id is not None:
 
714
            parent_trans_id = self.tt.trans_id_file_id(parent_id)
 
715
            self.tt.adjust_path(names[self.winner_idx[name_winner]],
 
716
                                parent_trans_id, trans_id)
 
717
 
 
718
    def merge_contents(self, file_id):
 
719
        """Performa a merge on file_id contents."""
 
720
        def contents_pair(tree):
 
721
            if file_id not in tree:
 
722
                return (None, None)
 
723
            kind = tree.kind(file_id)
 
724
            if kind == "file":
 
725
                contents = tree.get_file_sha1(file_id)
 
726
            elif kind == "symlink":
 
727
                contents = tree.get_symlink_target(file_id)
 
728
            else:
 
729
                contents = None
 
730
            return kind, contents
 
731
 
 
732
        def contents_conflict():
 
733
            trans_id = self.tt.trans_id_file_id(file_id)
 
734
            name = self.tt.final_name(trans_id)
 
735
            parent_id = self.tt.final_parent(trans_id)
 
736
            if file_id in self.this_tree.inventory:
 
737
                self.tt.unversion_file(trans_id)
 
738
                if file_id in self.this_tree:
 
739
                    self.tt.delete_contents(trans_id)
 
740
            file_group = self._dump_conflicts(name, parent_id, file_id, 
 
741
                                              set_version=True)
 
742
            self._raw_conflicts.append(('contents conflict', file_group))
 
743
 
 
744
        # See SPOT run.  run, SPOT, run.
 
745
        # So we're not QUITE repeating ourselves; we do tricky things with
 
746
        # file kind...
 
747
        base_pair = contents_pair(self.base_tree)
 
748
        other_pair = contents_pair(self.other_tree)
 
749
        if base_pair == other_pair:
 
750
            # OTHER introduced no changes
 
751
            return "unmodified"
 
752
        this_pair = contents_pair(self.this_tree)
 
753
        if this_pair == other_pair:
 
754
            # THIS and OTHER introduced the same changes
 
755
            return "unmodified"
 
756
        else:
 
757
            trans_id = self.tt.trans_id_file_id(file_id)
 
758
            if this_pair == base_pair:
 
759
                # only OTHER introduced changes
 
760
                if file_id in self.this_tree:
 
761
                    # Remove any existing contents
 
762
                    self.tt.delete_contents(trans_id)
 
763
                if file_id in self.other_tree:
 
764
                    # OTHER changed the file
 
765
                    create_by_entry(self.tt, 
 
766
                                    self.other_tree.inventory[file_id], 
 
767
                                    self.other_tree, trans_id)
 
768
                    if file_id not in self.this_tree.inventory:
 
769
                        self.tt.version_file(file_id, trans_id)
 
770
                    return "modified"
 
771
                elif file_id in self.this_tree.inventory:
 
772
                    # OTHER deleted the file
 
773
                    self.tt.unversion_file(trans_id)
 
774
                    return "deleted"
 
775
            #BOTH THIS and OTHER introduced changes; scalar conflict
 
776
            elif this_pair[0] == "file" and other_pair[0] == "file":
 
777
                # THIS and OTHER are both files, so text merge.  Either
 
778
                # BASE is a file, or both converted to files, so at least we
 
779
                # have agreement that output should be a file.
 
780
                try:
 
781
                    self.text_merge(file_id, trans_id)
 
782
                except BinaryFile:
 
783
                    return contents_conflict()
 
784
                if file_id not in self.this_tree.inventory:
 
785
                    self.tt.version_file(file_id, trans_id)
 
786
                try:
 
787
                    self.tt.tree_kind(trans_id)
 
788
                    self.tt.delete_contents(trans_id)
 
789
                except NoSuchFile:
 
790
                    pass
 
791
                return "modified"
 
792
            else:
 
793
                # Scalar conflict, can't text merge.  Dump conflicts
 
794
                return contents_conflict()
 
795
 
 
796
    def get_lines(self, tree, file_id):
 
797
        """Return the lines in a file, or an empty list."""
 
798
        if file_id in tree:
 
799
            return tree.get_file(file_id).readlines()
 
800
        else:
 
801
            return []
 
802
 
 
803
    def text_merge(self, file_id, trans_id):
 
804
        """Perform a three-way text merge on a file_id"""
 
805
        # it's possible that we got here with base as a different type.
 
806
        # if so, we just want two-way text conflicts.
 
807
        if file_id in self.base_tree and \
 
808
            self.base_tree.kind(file_id) == "file":
 
809
            base_lines = self.get_lines(self.base_tree, file_id)
 
810
        else:
 
811
            base_lines = []
 
812
        other_lines = self.get_lines(self.other_tree, file_id)
 
813
        this_lines = self.get_lines(self.this_tree, file_id)
 
814
        m3 = Merge3(base_lines, this_lines, other_lines)
 
815
        start_marker = "!START OF MERGE CONFLICT!" + "I HOPE THIS IS UNIQUE"
 
816
        if self.show_base is True:
 
817
            base_marker = '|' * 7
 
818
        else:
 
819
            base_marker = None
 
820
 
 
821
        def iter_merge3(retval):
 
822
            retval["text_conflicts"] = False
 
823
            for line in m3.merge_lines(name_a = "TREE", 
 
824
                                       name_b = "MERGE-SOURCE", 
 
825
                                       name_base = "BASE-REVISION",
 
826
                                       start_marker=start_marker, 
 
827
                                       base_marker=base_marker,
 
828
                                       reprocess=self.reprocess):
 
829
                if line.startswith(start_marker):
 
830
                    retval["text_conflicts"] = True
 
831
                    yield line.replace(start_marker, '<' * 7)
 
832
                else:
 
833
                    yield line
 
834
        retval = {}
 
835
        merge3_iterator = iter_merge3(retval)
 
836
        self.tt.create_file(merge3_iterator, trans_id)
 
837
        if retval["text_conflicts"] is True:
 
838
            self._raw_conflicts.append(('text conflict', trans_id))
 
839
            name = self.tt.final_name(trans_id)
 
840
            parent_id = self.tt.final_parent(trans_id)
 
841
            file_group = self._dump_conflicts(name, parent_id, file_id, 
 
842
                                              this_lines, base_lines,
 
843
                                              other_lines)
 
844
            file_group.append(trans_id)
 
845
 
 
846
    def _dump_conflicts(self, name, parent_id, file_id, this_lines=None, 
 
847
                        base_lines=None, other_lines=None, set_version=False,
 
848
                        no_base=False):
 
849
        """Emit conflict files.
 
850
        If this_lines, base_lines, or other_lines are omitted, they will be
 
851
        determined automatically.  If set_version is true, the .OTHER, .THIS
 
852
        or .BASE (in that order) will be created as versioned files.
 
853
        """
 
854
        data = [('OTHER', self.other_tree, other_lines), 
 
855
                ('THIS', self.this_tree, this_lines)]
 
856
        if not no_base:
 
857
            data.append(('BASE', self.base_tree, base_lines))
 
858
        versioned = False
 
859
        file_group = []
 
860
        for suffix, tree, lines in data:
 
861
            if file_id in tree:
 
862
                trans_id = self._conflict_file(name, parent_id, tree, file_id,
 
863
                                               suffix, lines)
 
864
                file_group.append(trans_id)
 
865
                if set_version and not versioned:
 
866
                    self.tt.version_file(file_id, trans_id)
 
867
                    versioned = True
 
868
        return file_group
 
869
           
 
870
    def _conflict_file(self, name, parent_id, tree, file_id, suffix, 
 
871
                       lines=None):
 
872
        """Emit a single conflict file."""
 
873
        name = name + '.' + suffix
 
874
        trans_id = self.tt.create_path(name, parent_id)
 
875
        entry = tree.inventory[file_id]
 
876
        create_by_entry(self.tt, entry, tree, trans_id, lines)
 
877
        return trans_id
 
878
 
 
879
    def merge_executable(self, file_id, file_status):
 
880
        """Perform a merge on the execute bit."""
 
881
        executable = [self.executable(t, file_id) for t in (self.base_tree,
 
882
                      self.other_tree, self.this_tree)]
 
883
        self._merge_executable(file_id, executable, file_status)
 
884
 
 
885
    def _merge_executable(self, file_id, executable, file_status):
 
886
        """Perform a merge on the execute bit."""
 
887
        base_executable, other_executable, this_executable = executable
 
888
        if file_status == "deleted":
 
889
            return
 
890
        trans_id = self.tt.trans_id_file_id(file_id)
 
891
        try:
 
892
            if self.tt.final_kind(trans_id) != "file":
 
893
                return
 
894
        except NoSuchFile:
 
895
            return
 
896
        winner = self._three_way(*executable)
 
897
        if winner == "conflict":
 
898
        # There must be a None in here, if we have a conflict, but we
 
899
        # need executability since file status was not deleted.
 
900
            if self.executable(self.other_tree, file_id) is None:
 
901
                winner = "this"
 
902
            else:
 
903
                winner = "other"
 
904
        if winner == "this":
 
905
            if file_status == "modified":
 
906
                executability = this_executable
 
907
                if executability is not None:
 
908
                    trans_id = self.tt.trans_id_file_id(file_id)
 
909
                    self.tt.set_executability(executability, trans_id)
 
910
        else:
 
911
            assert winner == "other"
 
912
            if file_id in self.other_tree:
 
913
                executability = other_executable
 
914
            elif file_id in self.this_tree:
 
915
                executability = this_executable
 
916
            elif file_id in self.base_tree:
 
917
                executability = base_executable
 
918
            if executability is not None:
 
919
                trans_id = self.tt.trans_id_file_id(file_id)
 
920
                self.tt.set_executability(executability, trans_id)
 
921
 
 
922
    def cook_conflicts(self, fs_conflicts):
 
923
        """Convert all conflicts into a form that doesn't depend on trans_id"""
 
924
        from conflicts import Conflict
 
925
        name_conflicts = {}
 
926
        self.cooked_conflicts.extend(cook_conflicts(fs_conflicts, self.tt))
 
927
        fp = FinalPaths(self.tt)
 
928
        for conflict in self._raw_conflicts:
 
929
            conflict_type = conflict[0]
 
930
            if conflict_type in ('name conflict', 'parent conflict'):
 
931
                trans_id = conflict[1]
 
932
                conflict_args = conflict[2:]
 
933
                if trans_id not in name_conflicts:
 
934
                    name_conflicts[trans_id] = {}
 
935
                unique_add(name_conflicts[trans_id], conflict_type, 
 
936
                           conflict_args)
 
937
            if conflict_type == 'contents conflict':
 
938
                for trans_id in conflict[1]:
 
939
                    file_id = self.tt.final_file_id(trans_id)
 
940
                    if file_id is not None:
 
941
                        break
 
942
                path = fp.get_path(trans_id)
 
943
                for suffix in ('.BASE', '.THIS', '.OTHER'):
 
944
                    if path.endswith(suffix):
 
945
                        path = path[:-len(suffix)]
 
946
                        break
 
947
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
 
948
                self.cooked_conflicts.append(c)
 
949
            if conflict_type == 'text conflict':
 
950
                trans_id = conflict[1]
 
951
                path = fp.get_path(trans_id)
 
952
                file_id = self.tt.final_file_id(trans_id)
 
953
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
 
954
                self.cooked_conflicts.append(c)
 
955
 
 
956
        for trans_id, conflicts in name_conflicts.iteritems():
 
957
            try:
 
958
                this_parent, other_parent = conflicts['parent conflict']
 
959
                assert this_parent != other_parent
 
960
            except KeyError:
 
961
                this_parent = other_parent = \
 
962
                    self.tt.final_file_id(self.tt.final_parent(trans_id))
 
963
            try:
 
964
                this_name, other_name = conflicts['name conflict']
 
965
                assert this_name != other_name
 
966
            except KeyError:
 
967
                this_name = other_name = self.tt.final_name(trans_id)
 
968
            other_path = fp.get_path(trans_id)
 
969
            if this_parent is not None and this_name is not None:
 
970
                this_parent_path = \
 
971
                    fp.get_path(self.tt.trans_id_file_id(this_parent))
 
972
                this_path = pathjoin(this_parent_path, this_name)
 
973
            else:
 
974
                this_path = "<deleted>"
 
975
            file_id = self.tt.final_file_id(trans_id)
 
976
            c = Conflict.factory('path conflict', path=this_path,
 
977
                                 conflict_path=other_path, file_id=file_id)
 
978
            self.cooked_conflicts.append(c)
 
979
        self.cooked_conflicts.sort(key=Conflict.sort_key)
 
980
 
 
981
 
 
982
class WeaveMerger(Merge3Merger):
 
983
    """Three-way tree merger, text weave merger."""
 
984
    supports_reprocess = True
 
985
    supports_show_base = False
 
986
 
 
987
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
 
988
                 interesting_ids=None, pb=DummyProgress(), pp=None,
 
989
                 reprocess=False, change_reporter=None,
 
990
                 interesting_files=None):
 
991
        self.this_revision_tree = self._get_revision_tree(this_tree)
 
992
        self.other_revision_tree = self._get_revision_tree(other_tree)
 
993
        super(WeaveMerger, self).__init__(working_tree, this_tree, 
 
994
                                          base_tree, other_tree, 
 
995
                                          interesting_ids=interesting_ids, 
 
996
                                          pb=pb, pp=pp, reprocess=reprocess,
 
997
                                          change_reporter=change_reporter)
 
998
 
 
999
    def _get_revision_tree(self, tree):
 
1000
        """Return a revision tree related to this tree.
 
1001
        If the tree is a WorkingTree, the basis will be returned.
 
1002
        """
 
1003
        if getattr(tree, 'get_weave', False) is False:
 
1004
            # If we have a WorkingTree, try using the basis
 
1005
            return tree.branch.basis_tree()
 
1006
        else:
 
1007
            return tree
 
1008
 
 
1009
    def _check_file(self, file_id):
 
1010
        """Check that the revision tree's version of the file matches."""
 
1011
        for tree, rt in ((self.this_tree, self.this_revision_tree), 
 
1012
                         (self.other_tree, self.other_revision_tree)):
 
1013
            if rt is tree:
 
1014
                continue
 
1015
            if tree.get_file_sha1(file_id) != rt.get_file_sha1(file_id):
 
1016
                raise WorkingTreeNotRevision(self.this_tree)
 
1017
 
 
1018
    def _merged_lines(self, file_id):
 
1019
        """Generate the merged lines.
 
1020
        There is no distinction between lines that are meant to contain <<<<<<<
 
1021
        and conflicts.
 
1022
        """
 
1023
        weave = self.this_revision_tree.get_weave(file_id)
 
1024
        this_revision_id = self.this_revision_tree.inventory[file_id].revision
 
1025
        other_revision_id = \
 
1026
            self.other_revision_tree.inventory[file_id].revision
 
1027
        wm = WeaveMerge(weave, this_revision_id, other_revision_id, 
 
1028
                        '<<<<<<< TREE\n', '>>>>>>> MERGE-SOURCE\n')
 
1029
        return wm.merge_lines(self.reprocess)
 
1030
 
 
1031
    def text_merge(self, file_id, trans_id):
 
1032
        """Perform a (weave) text merge for a given file and file-id.
 
1033
        If conflicts are encountered, .THIS and .OTHER files will be emitted,
 
1034
        and a conflict will be noted.
 
1035
        """
 
1036
        self._check_file(file_id)
 
1037
        lines, conflicts = self._merged_lines(file_id)
 
1038
        lines = list(lines)
 
1039
        # Note we're checking whether the OUTPUT is binary in this case, 
 
1040
        # because we don't want to get into weave merge guts.
 
1041
        check_text_lines(lines)
 
1042
        self.tt.create_file(lines, trans_id)
 
1043
        if conflicts:
 
1044
            self._raw_conflicts.append(('text conflict', trans_id))
 
1045
            name = self.tt.final_name(trans_id)
 
1046
            parent_id = self.tt.final_parent(trans_id)
 
1047
            file_group = self._dump_conflicts(name, parent_id, file_id, 
 
1048
                                              no_base=True)
 
1049
            file_group.append(trans_id)
 
1050
 
 
1051
 
 
1052
class Diff3Merger(Merge3Merger):
 
1053
    """Three-way merger using external diff3 for text merging"""
 
1054
 
 
1055
    def dump_file(self, temp_dir, name, tree, file_id):
 
1056
        out_path = pathjoin(temp_dir, name)
 
1057
        out_file = open(out_path, "wb")
 
1058
        try:
 
1059
            in_file = tree.get_file(file_id)
 
1060
            for line in in_file:
 
1061
                out_file.write(line)
 
1062
        finally:
 
1063
            out_file.close()
 
1064
        return out_path
 
1065
 
 
1066
    def text_merge(self, file_id, trans_id):
 
1067
        """Perform a diff3 merge using a specified file-id and trans-id.
 
1068
        If conflicts are encountered, .BASE, .THIS. and .OTHER conflict files
 
1069
        will be dumped, and a will be conflict noted.
 
1070
        """
 
1071
        import bzrlib.patch
 
1072
        temp_dir = osutils.mkdtemp(prefix="bzr-")
 
1073
        try:
 
1074
            new_file = pathjoin(temp_dir, "new")
 
1075
            this = self.dump_file(temp_dir, "this", self.this_tree, file_id)
 
1076
            base = self.dump_file(temp_dir, "base", self.base_tree, file_id)
 
1077
            other = self.dump_file(temp_dir, "other", self.other_tree, file_id)
 
1078
            status = bzrlib.patch.diff3(new_file, this, base, other)
 
1079
            if status not in (0, 1):
 
1080
                raise BzrError("Unhandled diff3 exit code")
 
1081
            f = open(new_file, 'rb')
 
1082
            try:
 
1083
                self.tt.create_file(f, trans_id)
 
1084
            finally:
 
1085
                f.close()
 
1086
            if status == 1:
 
1087
                name = self.tt.final_name(trans_id)
 
1088
                parent_id = self.tt.final_parent(trans_id)
 
1089
                self._dump_conflicts(name, parent_id, file_id)
 
1090
                self._raw_conflicts.append(('text conflict', trans_id))
 
1091
        finally:
 
1092
            osutils.rmtree(temp_dir)
 
1093
 
 
1094
 
 
1095
def merge_inner(this_branch, other_tree, base_tree, ignore_zero=False,
 
1096
                backup_files=False,
 
1097
                merge_type=Merge3Merger,
 
1098
                interesting_ids=None,
 
1099
                show_base=False,
 
1100
                reprocess=False,
 
1101
                other_rev_id=None,
 
1102
                interesting_files=None,
 
1103
                this_tree=None,
 
1104
                pb=DummyProgress(),
 
1105
                change_reporter=None):
 
1106
    """Primary interface for merging. 
 
1107
 
 
1108
        typical use is probably 
 
1109
        'merge_inner(branch, branch.get_revision_tree(other_revision),
 
1110
                     branch.get_revision_tree(base_revision))'
 
1111
        """
 
1112
    if this_tree is None:
 
1113
        raise BzrError("bzrlib.merge.merge_inner requires a this_tree "
 
1114
            "parameter as of bzrlib version 0.8.")
 
1115
    merger = Merger(this_branch, other_tree, base_tree, this_tree=this_tree,
 
1116
                    pb=pb, change_reporter=change_reporter)
 
1117
    merger.backup_files = backup_files
 
1118
    merger.merge_type = merge_type
 
1119
    merger.interesting_ids = interesting_ids
 
1120
    merger.ignore_zero = ignore_zero
 
1121
    if interesting_files:
 
1122
        assert not interesting_ids, ('Only supply interesting_ids'
 
1123
                                     ' or interesting_files')
 
1124
        merger.interesting_files = interesting_files
 
1125
    merger.show_base = show_base
 
1126
    merger.reprocess = reprocess
 
1127
    merger.other_rev_id = other_rev_id
 
1128
    merger.other_basis = other_rev_id
 
1129
    return merger.do_merge()
 
1130
 
 
1131
def get_merge_type_registry():
 
1132
    """Merge type registry is in bzrlib.option to avoid circular imports.
 
1133
 
 
1134
    This method provides a sanctioned way to retrieve it.
 
1135
    """
 
1136
    from bzrlib import option
 
1137
    return option._merge_type_registry