~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/merge.py

  • Committer: Robert Collins
  • Date: 2007-03-01 01:50:05 UTC
  • mto: (2255.11.3 dirstate)
  • mto: This revision was merged to the branch mainline in revision 2322.
  • Revision ID: robertc@robertcollins.net-20070301015005-ydqud90417giqbhg
Tweak pathjoin to be correct in its assertion about parameter types.

Show diffs side-by-side

added added

removed removed

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