1
# Copyright (C) 2005, 2006 Canonical Ltd
 
 
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.
 
 
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.
 
 
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
 
 
20
from tempfile import mkdtemp
 
 
23
from bzrlib.branch import Branch
 
 
24
from bzrlib.conflicts import ConflictList, Conflict
 
 
25
from bzrlib.errors import (BzrCommandError,
 
 
35
                           WorkingTreeNotRevision,
 
 
38
from bzrlib.merge3 import Merge3
 
 
40
from bzrlib.osutils import rename, pathjoin, rmtree
 
 
41
from progress import DummyProgress, ProgressPhase
 
 
42
from bzrlib.revision import common_ancestor, is_ancestor, NULL_REVISION
 
 
43
from bzrlib.textfile import check_text_lines
 
 
44
from bzrlib.trace import mutter, warning, note
 
 
45
from bzrlib.transform import (TreeTransform, resolve_conflicts, cook_conflicts,
 
 
46
                              FinalPaths, create_by_entry, unique_add)
 
 
47
from bzrlib.versionedfile import WeaveMerge
 
 
50
# TODO: Report back as changes are merged in
 
 
52
def _get_tree(treespec, local_branch=None):
 
 
53
    location, revno = treespec
 
 
54
    branch = Branch.open_containing(location)[0]
 
 
58
        revision = branch.last_revision()
 
 
60
        revision = branch.get_rev_id(revno)
 
 
62
            revision = NULL_REVISION
 
 
63
    return branch, _get_revid_tree(branch, revision, local_branch)
 
 
66
def _get_revid_tree(branch, revision, local_branch):
 
 
68
        base_tree = branch.bzrdir.open_workingtree()
 
 
70
        if local_branch is not None:
 
 
71
            if local_branch.base != branch.base:
 
 
72
                local_branch.fetch(branch, revision)
 
 
73
            base_tree = local_branch.repository.revision_tree(revision)
 
 
75
            base_tree = branch.repository.revision_tree(revision)
 
 
79
def transform_tree(from_tree, to_tree, interesting_ids=None):
 
 
80
    merge_inner(from_tree.branch, to_tree, from_tree, ignore_zero=True,
 
 
81
                interesting_ids=interesting_ids, this_tree=from_tree)
 
 
85
    def __init__(self, this_branch, other_tree=None, base_tree=None, 
 
 
86
                 this_tree=None, pb=DummyProgress()):
 
 
88
        assert this_tree is not None, "this_tree is required"
 
 
89
        self.this_branch = this_branch
 
 
90
        self.this_basis = this_branch.last_revision()
 
 
91
        self.this_rev_id = None
 
 
92
        self.this_tree = this_tree
 
 
93
        self.this_revision_tree = None
 
 
94
        self.this_basis_tree = None
 
 
95
        self.other_tree = other_tree
 
 
96
        self.base_tree = base_tree
 
 
97
        self.ignore_zero = False
 
 
98
        self.backup_files = False
 
 
99
        self.interesting_ids = None
 
 
100
        self.show_base = False
 
 
101
        self.reprocess = False
 
 
106
    def revision_tree(self, revision_id):
 
 
107
        return self.this_branch.repository.revision_tree(revision_id)
 
 
109
    def ensure_revision_trees(self):
 
 
110
        if self.this_revision_tree is None:
 
 
111
            self.this_basis_tree = self.this_branch.repository.revision_tree(
 
 
113
            if self.this_basis == self.this_rev_id:
 
 
114
                self.this_revision_tree = self.this_basis_tree
 
 
116
        if self.other_rev_id is None:
 
 
117
            other_basis_tree = self.revision_tree(self.other_basis)
 
 
118
            changes = other_basis_tree.changes_from(self.other_tree)
 
 
119
            if changes.has_changed():
 
 
120
                raise WorkingTreeNotRevision(self.this_tree)
 
 
121
            other_rev_id = self.other_basis
 
 
122
            self.other_tree = other_basis_tree
 
 
124
    def file_revisions(self, file_id):
 
 
125
        self.ensure_revision_trees()
 
 
126
        def get_id(tree, file_id):
 
 
127
            revision_id = tree.inventory[file_id].revision
 
 
128
            assert revision_id is not None
 
 
130
        if self.this_rev_id is None:
 
 
131
            if self.this_basis_tree.get_file_sha1(file_id) != \
 
 
132
                self.this_tree.get_file_sha1(file_id):
 
 
133
                raise WorkingTreeNotRevision(self.this_tree)
 
 
135
        trees = (self.this_basis_tree, self.other_tree)
 
 
136
        return [get_id(tree, file_id) for tree in trees]
 
 
138
    def check_basis(self, check_clean, require_commits=True):
 
 
139
        if self.this_basis is None and require_commits is True:
 
 
140
            raise BzrCommandError("This branch has no commits")
 
 
143
            if self.this_basis != self.this_rev_id:
 
 
144
                raise BzrCommandError("Working tree has uncommitted changes.")
 
 
146
    def compare_basis(self):
 
 
147
        changes = self.this_tree.changes_from(self.this_tree.basis_tree())
 
 
148
        if not changes.has_changed():
 
 
149
            self.this_rev_id = self.this_basis
 
 
151
    def set_interesting_files(self, file_list):
 
 
153
            self._set_interesting_files(file_list)
 
 
154
        except NotVersionedError, e:
 
 
155
            raise BzrCommandError("%s is not a source file in any"
 
 
158
    def _set_interesting_files(self, file_list):
 
 
159
        """Set the list of interesting ids from a list of files."""
 
 
160
        if file_list is None:
 
 
161
            self.interesting_ids = None
 
 
164
        interesting_ids = set()
 
 
165
        for path in file_list:
 
 
167
            for tree in (self.this_tree, self.base_tree, self.other_tree):
 
 
168
                file_id = tree.inventory.path2id(path)
 
 
169
                if file_id is not None:
 
 
170
                    interesting_ids.add(file_id)
 
 
173
                raise NotVersionedError(path=path)
 
 
174
        self.interesting_ids = interesting_ids
 
 
176
    def set_pending(self):
 
 
177
        if not self.base_is_ancestor:
 
 
179
        if self.other_rev_id is None:
 
 
181
        ancestry = self.this_branch.repository.get_ancestry(self.this_basis)
 
 
182
        if self.other_rev_id in ancestry:
 
 
184
        self.this_tree.add_pending_merge(self.other_rev_id)
 
 
186
    def set_other(self, other_revision):
 
 
187
        other_branch, self.other_tree = _get_tree(other_revision, 
 
 
189
        if other_revision[1] == -1:
 
 
190
            self.other_rev_id = other_branch.last_revision()
 
 
191
            if self.other_rev_id is None:
 
 
192
                raise NoCommits(other_branch)
 
 
193
            self.other_basis = self.other_rev_id
 
 
194
        elif other_revision[1] is not None:
 
 
195
            self.other_rev_id = other_branch.get_rev_id(other_revision[1])
 
 
196
            self.other_basis = self.other_rev_id
 
 
198
            self.other_rev_id = None
 
 
199
            self.other_basis = other_branch.last_revision()
 
 
200
            if self.other_basis is None:
 
 
201
                raise NoCommits(other_branch)
 
 
202
        if other_branch.base != self.this_branch.base:
 
 
203
            self.this_branch.fetch(other_branch, last_revision=self.other_basis)
 
 
206
        self.set_base([None, None])
 
 
208
    def set_base(self, base_revision):
 
 
209
        mutter("doing merge() with no base_revision specified")
 
 
210
        if base_revision == [None, None]:
 
 
212
                pb = bzrlib.ui.ui_factory.nested_progress_bar()
 
 
214
                    this_repo = self.this_branch.repository
 
 
215
                    self.base_rev_id = common_ancestor(self.this_basis, 
 
 
220
            except NoCommonAncestor:
 
 
221
                raise UnrelatedBranches()
 
 
222
            self.base_tree = _get_revid_tree(self.this_branch, self.base_rev_id,
 
 
224
            self.base_is_ancestor = True
 
 
226
            base_branch, self.base_tree = _get_tree(base_revision)
 
 
227
            if base_revision[1] == -1:
 
 
228
                self.base_rev_id = base_branch.last_revision()
 
 
229
            elif base_revision[1] is None:
 
 
230
                self.base_rev_id = None
 
 
232
                self.base_rev_id = base_branch.get_rev_id(base_revision[1])
 
 
233
            if self.this_branch.base != base_branch.base:
 
 
234
                self.this_branch.fetch(base_branch)
 
 
235
            self.base_is_ancestor = is_ancestor(self.this_basis, 
 
 
240
        kwargs = {'working_tree':self.this_tree, 'this_tree': self.this_tree, 
 
 
241
                  'other_tree': self.other_tree, 
 
 
242
                  'interesting_ids': self.interesting_ids,
 
 
244
        if self.merge_type.requires_base:
 
 
245
            kwargs['base_tree'] = self.base_tree
 
 
246
        if self.merge_type.supports_reprocess:
 
 
247
            kwargs['reprocess'] = self.reprocess
 
 
249
            raise BzrError("Conflict reduction is not supported for merge"
 
 
250
                                  " type %s." % self.merge_type)
 
 
251
        if self.merge_type.supports_show_base:
 
 
252
            kwargs['show_base'] = self.show_base
 
 
254
            raise BzrError("Showing base is not supported for this"
 
 
255
                                  " merge type. %s" % self.merge_type)
 
 
256
        merge = self.merge_type(pb=self._pb, **kwargs)
 
 
257
        if len(merge.cooked_conflicts) == 0:
 
 
258
            if not self.ignore_zero:
 
 
259
                note("All changes applied successfully.")
 
 
261
            note("%d conflicts encountered." % len(merge.cooked_conflicts))
 
 
263
        return len(merge.cooked_conflicts)
 
 
265
    def regen_inventory(self, new_entries):
 
 
266
        old_entries = self.this_tree.read_working_inventory()
 
 
270
        for path, file_id in new_entries:
 
 
273
            new_entries_map[file_id] = path
 
 
275
        def id2path(file_id):
 
 
276
            path = new_entries_map.get(file_id)
 
 
279
            entry = old_entries[file_id]
 
 
280
            if entry.parent_id is None:
 
 
282
            return pathjoin(id2path(entry.parent_id), entry.name)
 
 
284
        for file_id in old_entries:
 
 
285
            entry = old_entries[file_id]
 
 
286
            path = id2path(file_id)
 
 
287
            if file_id in self.base_tree.inventory:
 
 
288
                executable = getattr(self.base_tree.inventory[file_id], 'executable', False)
 
 
290
                executable = getattr(entry, 'executable', False)
 
 
291
            new_inventory[file_id] = (path, file_id, entry.parent_id, 
 
 
292
                                      entry.kind, executable)
 
 
294
            by_path[path] = file_id
 
 
299
        for path, file_id in new_entries:
 
 
301
                del new_inventory[file_id]
 
 
304
                new_path_list.append((path, file_id))
 
 
305
                if file_id not in old_entries:
 
 
307
        # Ensure no file is added before its parent
 
 
309
        for path, file_id in new_path_list:
 
 
313
                parent = by_path[os.path.dirname(path)]
 
 
314
            abspath = pathjoin(self.this_tree.basedir, path)
 
 
315
            kind = bzrlib.osutils.file_kind(abspath)
 
 
316
            if file_id in self.base_tree.inventory:
 
 
317
                executable = getattr(self.base_tree.inventory[file_id], 'executable', False)
 
 
320
            new_inventory[file_id] = (path, file_id, parent, kind, executable)
 
 
321
            by_path[path] = file_id 
 
 
323
        # Get a list in insertion order
 
 
324
        new_inventory_list = new_inventory.values()
 
 
325
        mutter ("""Inventory regeneration:
 
 
326
    old length: %i insertions: %i deletions: %i new_length: %i"""\
 
 
327
            % (len(old_entries), insertions, deletions, 
 
 
328
               len(new_inventory_list)))
 
 
329
        assert len(new_inventory_list) == len(old_entries) + insertions\
 
 
331
        new_inventory_list.sort()
 
 
332
        return new_inventory_list
 
 
335
class Merge3Merger(object):
 
 
336
    """Three-way merger that uses the merge3 text merger"""
 
 
338
    supports_reprocess = True
 
 
339
    supports_show_base = True
 
 
340
    history_based = False
 
 
342
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
 
 
343
                 interesting_ids=None, reprocess=False, show_base=False,
 
 
344
                 pb=DummyProgress(), pp=None):
 
 
345
        """Initialize the merger object and perform the merge."""
 
 
346
        object.__init__(self)
 
 
347
        self.this_tree = working_tree
 
 
348
        self.base_tree = base_tree
 
 
349
        self.other_tree = other_tree
 
 
350
        self._raw_conflicts = []
 
 
351
        self.cooked_conflicts = []
 
 
352
        self.reprocess = reprocess
 
 
353
        self.show_base = show_base
 
 
357
            self.pp = ProgressPhase("Merge phase", 3, self.pb)
 
 
359
        if interesting_ids is not None:
 
 
360
            all_ids = interesting_ids
 
 
362
            all_ids = set(base_tree)
 
 
363
            all_ids.update(other_tree)
 
 
364
        working_tree.lock_write()
 
 
365
        self.tt = TreeTransform(working_tree, self.pb)
 
 
368
            child_pb = ui.ui_factory.nested_progress_bar()
 
 
370
                for num, file_id in enumerate(all_ids):
 
 
371
                    child_pb.update('Preparing file merge', num, len(all_ids))
 
 
372
                    self.merge_names(file_id)
 
 
373
                    file_status = self.merge_contents(file_id)
 
 
374
                    self.merge_executable(file_id, file_status)
 
 
379
            child_pb = ui.ui_factory.nested_progress_bar()
 
 
381
                fs_conflicts = resolve_conflicts(self.tt, child_pb)
 
 
384
            self.cook_conflicts(fs_conflicts)
 
 
385
            for conflict in self.cooked_conflicts:
 
 
388
            results = self.tt.apply()
 
 
389
            self.write_modified(results)
 
 
391
                working_tree.add_conflicts(self.cooked_conflicts)
 
 
392
            except UnsupportedOperation:
 
 
396
            working_tree.unlock()
 
 
399
    def write_modified(self, results):
 
 
401
        for path in results.modified_paths:
 
 
402
            file_id = self.this_tree.path2id(self.this_tree.relpath(path))
 
 
405
            hash = self.this_tree.get_file_sha1(file_id)
 
 
408
            modified_hashes[file_id] = hash
 
 
409
        self.this_tree.set_merge_modified(modified_hashes)
 
 
412
    def parent(entry, file_id):
 
 
413
        """Determine the parent for a file_id (used as a key method)"""
 
 
416
        return entry.parent_id
 
 
419
    def name(entry, file_id):
 
 
420
        """Determine the name for a file_id (used as a key method)"""
 
 
426
    def contents_sha1(tree, file_id):
 
 
427
        """Determine the sha1 of the file contents (used as a key method)."""
 
 
428
        if file_id not in tree:
 
 
430
        return tree.get_file_sha1(file_id)
 
 
433
    def executable(tree, file_id):
 
 
434
        """Determine the executability of a file-id (used as a key method)."""
 
 
435
        if file_id not in tree:
 
 
437
        if tree.kind(file_id) != "file":
 
 
439
        return tree.is_executable(file_id)
 
 
442
    def kind(tree, file_id):
 
 
443
        """Determine the kind of a file-id (used as a key method)."""
 
 
444
        if file_id not in tree:
 
 
446
        return tree.kind(file_id)
 
 
449
    def scalar_three_way(this_tree, base_tree, other_tree, file_id, key):
 
 
450
        """Do a three-way test on a scalar.
 
 
451
        Return "this", "other" or "conflict", depending whether a value wins.
 
 
453
        key_base = key(base_tree, file_id)
 
 
454
        key_other = key(other_tree, file_id)
 
 
455
        #if base == other, either they all agree, or only THIS has changed.
 
 
456
        if key_base == key_other:
 
 
458
        key_this = key(this_tree, file_id)
 
 
459
        if key_this not in (key_base, key_other):
 
 
461
        # "Ambiguous clean merge"
 
 
462
        elif key_this == key_other:
 
 
465
            assert key_this == key_base
 
 
468
    def merge_names(self, file_id):
 
 
469
        """Perform a merge on file_id names and parents"""
 
 
471
            if file_id in tree.inventory:
 
 
472
                return tree.inventory[file_id]
 
 
475
        this_entry = get_entry(self.this_tree)
 
 
476
        other_entry = get_entry(self.other_tree)
 
 
477
        base_entry = get_entry(self.base_tree)
 
 
478
        name_winner = self.scalar_three_way(this_entry, base_entry, 
 
 
479
                                            other_entry, file_id, self.name)
 
 
480
        parent_id_winner = self.scalar_three_way(this_entry, base_entry, 
 
 
481
                                                 other_entry, file_id, 
 
 
483
        if this_entry is None:
 
 
484
            if name_winner == "this":
 
 
485
                name_winner = "other"
 
 
486
            if parent_id_winner == "this":
 
 
487
                parent_id_winner = "other"
 
 
488
        if name_winner == "this" and parent_id_winner == "this":
 
 
490
        if name_winner == "conflict":
 
 
491
            trans_id = self.tt.trans_id_file_id(file_id)
 
 
492
            self._raw_conflicts.append(('name conflict', trans_id, 
 
 
493
                                        self.name(this_entry, file_id), 
 
 
494
                                        self.name(other_entry, file_id)))
 
 
495
        if parent_id_winner == "conflict":
 
 
496
            trans_id = self.tt.trans_id_file_id(file_id)
 
 
497
            self._raw_conflicts.append(('parent conflict', trans_id, 
 
 
498
                                        self.parent(this_entry, file_id), 
 
 
499
                                        self.parent(other_entry, file_id)))
 
 
500
        if other_entry is None:
 
 
501
            # it doesn't matter whether the result was 'other' or 
 
 
502
            # 'conflict'-- if there's no 'other', we leave it alone.
 
 
504
        # if we get here, name_winner and parent_winner are set to safe values.
 
 
505
        winner_entry = {"this": this_entry, "other": other_entry, 
 
 
506
                        "conflict": other_entry}
 
 
507
        trans_id = self.tt.trans_id_file_id(file_id)
 
 
508
        parent_id = winner_entry[parent_id_winner].parent_id
 
 
509
        parent_trans_id = self.tt.trans_id_file_id(parent_id)
 
 
510
        self.tt.adjust_path(winner_entry[name_winner].name, parent_trans_id,
 
 
513
    def merge_contents(self, file_id):
 
 
514
        """Performa a merge on file_id contents."""
 
 
515
        def contents_pair(tree):
 
 
516
            if file_id not in tree:
 
 
518
            kind = tree.kind(file_id)
 
 
519
            if kind == "root_directory":
 
 
522
                contents = tree.get_file_sha1(file_id)
 
 
523
            elif kind == "symlink":
 
 
524
                contents = tree.get_symlink_target(file_id)
 
 
527
            return kind, contents
 
 
529
        def contents_conflict():
 
 
530
            trans_id = self.tt.trans_id_file_id(file_id)
 
 
531
            name = self.tt.final_name(trans_id)
 
 
532
            parent_id = self.tt.final_parent(trans_id)
 
 
533
            if file_id in self.this_tree.inventory:
 
 
534
                self.tt.unversion_file(trans_id)
 
 
535
                self.tt.delete_contents(trans_id)
 
 
536
            file_group = self._dump_conflicts(name, parent_id, file_id, 
 
 
538
            self._raw_conflicts.append(('contents conflict', file_group))
 
 
540
        # See SPOT run.  run, SPOT, run.
 
 
541
        # So we're not QUITE repeating ourselves; we do tricky things with
 
 
543
        base_pair = contents_pair(self.base_tree)
 
 
544
        other_pair = contents_pair(self.other_tree)
 
 
545
        if base_pair == other_pair:
 
 
546
            # OTHER introduced no changes
 
 
548
        this_pair = contents_pair(self.this_tree)
 
 
549
        if this_pair == other_pair:
 
 
550
            # THIS and OTHER introduced the same changes
 
 
553
            trans_id = self.tt.trans_id_file_id(file_id)
 
 
554
            if this_pair == base_pair:
 
 
555
                # only OTHER introduced changes
 
 
556
                if file_id in self.this_tree:
 
 
557
                    # Remove any existing contents
 
 
558
                    self.tt.delete_contents(trans_id)
 
 
559
                if file_id in self.other_tree:
 
 
560
                    # OTHER changed the file
 
 
561
                    create_by_entry(self.tt, 
 
 
562
                                    self.other_tree.inventory[file_id], 
 
 
563
                                    self.other_tree, trans_id)
 
 
564
                    if file_id not in self.this_tree.inventory:
 
 
565
                        self.tt.version_file(file_id, trans_id)
 
 
567
                elif file_id in self.this_tree.inventory:
 
 
568
                    # OTHER deleted the file
 
 
569
                    self.tt.unversion_file(trans_id)
 
 
571
            #BOTH THIS and OTHER introduced changes; scalar conflict
 
 
572
            elif this_pair[0] == "file" and other_pair[0] == "file":
 
 
573
                # THIS and OTHER are both files, so text merge.  Either
 
 
574
                # BASE is a file, or both converted to files, so at least we
 
 
575
                # have agreement that output should be a file.
 
 
577
                    self.text_merge(file_id, trans_id)
 
 
579
                    return contents_conflict()
 
 
580
                if file_id not in self.this_tree.inventory:
 
 
581
                    self.tt.version_file(file_id, trans_id)
 
 
583
                    self.tt.tree_kind(trans_id)
 
 
584
                    self.tt.delete_contents(trans_id)
 
 
589
                # Scalar conflict, can't text merge.  Dump conflicts
 
 
590
                return contents_conflict()
 
 
592
    def get_lines(self, tree, file_id):
 
 
593
        """Return the lines in a file, or an empty list."""
 
 
595
            return tree.get_file(file_id).readlines()
 
 
599
    def text_merge(self, file_id, trans_id):
 
 
600
        """Perform a three-way text merge on a file_id"""
 
 
601
        # it's possible that we got here with base as a different type.
 
 
602
        # if so, we just want two-way text conflicts.
 
 
603
        if file_id in self.base_tree and \
 
 
604
            self.base_tree.kind(file_id) == "file":
 
 
605
            base_lines = self.get_lines(self.base_tree, file_id)
 
 
608
        other_lines = self.get_lines(self.other_tree, file_id)
 
 
609
        this_lines = self.get_lines(self.this_tree, file_id)
 
 
610
        m3 = Merge3(base_lines, this_lines, other_lines)
 
 
611
        start_marker = "!START OF MERGE CONFLICT!" + "I HOPE THIS IS UNIQUE"
 
 
612
        if self.show_base is True:
 
 
613
            base_marker = '|' * 7
 
 
617
        def iter_merge3(retval):
 
 
618
            retval["text_conflicts"] = False
 
 
619
            for line in m3.merge_lines(name_a = "TREE", 
 
 
620
                                       name_b = "MERGE-SOURCE", 
 
 
621
                                       name_base = "BASE-REVISION",
 
 
622
                                       start_marker=start_marker, 
 
 
623
                                       base_marker=base_marker,
 
 
624
                                       reprocess=self.reprocess):
 
 
625
                if line.startswith(start_marker):
 
 
626
                    retval["text_conflicts"] = True
 
 
627
                    yield line.replace(start_marker, '<' * 7)
 
 
631
        merge3_iterator = iter_merge3(retval)
 
 
632
        self.tt.create_file(merge3_iterator, trans_id)
 
 
633
        if retval["text_conflicts"] is True:
 
 
634
            self._raw_conflicts.append(('text conflict', trans_id))
 
 
635
            name = self.tt.final_name(trans_id)
 
 
636
            parent_id = self.tt.final_parent(trans_id)
 
 
637
            file_group = self._dump_conflicts(name, parent_id, file_id, 
 
 
638
                                              this_lines, base_lines,
 
 
640
            file_group.append(trans_id)
 
 
642
    def _dump_conflicts(self, name, parent_id, file_id, this_lines=None, 
 
 
643
                        base_lines=None, other_lines=None, set_version=False,
 
 
645
        """Emit conflict files.
 
 
646
        If this_lines, base_lines, or other_lines are omitted, they will be
 
 
647
        determined automatically.  If set_version is true, the .OTHER, .THIS
 
 
648
        or .BASE (in that order) will be created as versioned files.
 
 
650
        data = [('OTHER', self.other_tree, other_lines), 
 
 
651
                ('THIS', self.this_tree, this_lines)]
 
 
653
            data.append(('BASE', self.base_tree, base_lines))
 
 
656
        for suffix, tree, lines in data:
 
 
658
                trans_id = self._conflict_file(name, parent_id, tree, file_id,
 
 
660
                file_group.append(trans_id)
 
 
661
                if set_version and not versioned:
 
 
662
                    self.tt.version_file(file_id, trans_id)
 
 
666
    def _conflict_file(self, name, parent_id, tree, file_id, suffix, 
 
 
668
        """Emit a single conflict file."""
 
 
669
        name = name + '.' + suffix
 
 
670
        trans_id = self.tt.create_path(name, parent_id)
 
 
671
        entry = tree.inventory[file_id]
 
 
672
        create_by_entry(self.tt, entry, tree, trans_id, lines)
 
 
675
    def merge_executable(self, file_id, file_status):
 
 
676
        """Perform a merge on the execute bit."""
 
 
677
        if file_status == "deleted":
 
 
679
        trans_id = self.tt.trans_id_file_id(file_id)
 
 
681
            if self.tt.final_kind(trans_id) != "file":
 
 
685
        winner = self.scalar_three_way(self.this_tree, self.base_tree, 
 
 
686
                                       self.other_tree, file_id, 
 
 
688
        if winner == "conflict":
 
 
689
        # There must be a None in here, if we have a conflict, but we
 
 
690
        # need executability since file status was not deleted.
 
 
691
            if self.executable(self.other_tree, file_id) is None:
 
 
696
            if file_status == "modified":
 
 
697
                executability = self.this_tree.is_executable(file_id)
 
 
698
                if executability is not None:
 
 
699
                    trans_id = self.tt.trans_id_file_id(file_id)
 
 
700
                    self.tt.set_executability(executability, trans_id)
 
 
702
            assert winner == "other"
 
 
703
            if file_id in self.other_tree:
 
 
704
                executability = self.other_tree.is_executable(file_id)
 
 
705
            elif file_id in self.this_tree:
 
 
706
                executability = self.this_tree.is_executable(file_id)
 
 
707
            elif file_id in self.base_tree:
 
 
708
                executability = self.base_tree.is_executable(file_id)
 
 
709
            if executability is not None:
 
 
710
                trans_id = self.tt.trans_id_file_id(file_id)
 
 
711
                self.tt.set_executability(executability, trans_id)
 
 
713
    def cook_conflicts(self, fs_conflicts):
 
 
714
        """Convert all conflicts into a form that doesn't depend on trans_id"""
 
 
715
        from conflicts import Conflict
 
 
717
        self.cooked_conflicts.extend(cook_conflicts(fs_conflicts, self.tt))
 
 
718
        fp = FinalPaths(self.tt)
 
 
719
        for conflict in self._raw_conflicts:
 
 
720
            conflict_type = conflict[0]
 
 
721
            if conflict_type in ('name conflict', 'parent conflict'):
 
 
722
                trans_id = conflict[1]
 
 
723
                conflict_args = conflict[2:]
 
 
724
                if trans_id not in name_conflicts:
 
 
725
                    name_conflicts[trans_id] = {}
 
 
726
                unique_add(name_conflicts[trans_id], conflict_type, 
 
 
728
            if conflict_type == 'contents conflict':
 
 
729
                for trans_id in conflict[1]:
 
 
730
                    file_id = self.tt.final_file_id(trans_id)
 
 
731
                    if file_id is not None:
 
 
733
                path = fp.get_path(trans_id)
 
 
734
                for suffix in ('.BASE', '.THIS', '.OTHER'):
 
 
735
                    if path.endswith(suffix):
 
 
736
                        path = path[:-len(suffix)]
 
 
738
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
 
 
739
                self.cooked_conflicts.append(c)
 
 
740
            if conflict_type == 'text conflict':
 
 
741
                trans_id = conflict[1]
 
 
742
                path = fp.get_path(trans_id)
 
 
743
                file_id = self.tt.final_file_id(trans_id)
 
 
744
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
 
 
745
                self.cooked_conflicts.append(c)
 
 
747
        for trans_id, conflicts in name_conflicts.iteritems():
 
 
749
                this_parent, other_parent = conflicts['parent conflict']
 
 
750
                assert this_parent != other_parent
 
 
752
                this_parent = other_parent = \
 
 
753
                    self.tt.final_file_id(self.tt.final_parent(trans_id))
 
 
755
                this_name, other_name = conflicts['name conflict']
 
 
756
                assert this_name != other_name
 
 
758
                this_name = other_name = self.tt.final_name(trans_id)
 
 
759
            other_path = fp.get_path(trans_id)
 
 
760
            if this_parent is not None:
 
 
762
                    fp.get_path(self.tt.trans_id_file_id(this_parent))
 
 
763
                this_path = pathjoin(this_parent_path, this_name)
 
 
765
                this_path = "<deleted>"
 
 
766
            file_id = self.tt.final_file_id(trans_id)
 
 
767
            c = Conflict.factory('path conflict', path=this_path,
 
 
768
                                 conflict_path=other_path, file_id=file_id)
 
 
769
            self.cooked_conflicts.append(c)
 
 
770
        self.cooked_conflicts.sort(key=Conflict.sort_key)
 
 
773
class WeaveMerger(Merge3Merger):
 
 
774
    """Three-way tree merger, text weave merger."""
 
 
775
    supports_reprocess = True
 
 
776
    supports_show_base = False
 
 
778
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
 
 
779
                 interesting_ids=None, pb=DummyProgress(), pp=None,
 
 
781
        self.this_revision_tree = self._get_revision_tree(this_tree)
 
 
782
        self.other_revision_tree = self._get_revision_tree(other_tree)
 
 
783
        super(WeaveMerger, self).__init__(working_tree, this_tree, 
 
 
784
                                          base_tree, other_tree, 
 
 
785
                                          interesting_ids=interesting_ids, 
 
 
786
                                          pb=pb, pp=pp, reprocess=reprocess)
 
 
788
    def _get_revision_tree(self, tree):
 
 
789
        """Return a revision tree related to this tree.
 
 
790
        If the tree is a WorkingTree, the basis will be returned.
 
 
792
        if getattr(tree, 'get_weave', False) is False:
 
 
793
            # If we have a WorkingTree, try using the basis
 
 
794
            return tree.branch.basis_tree()
 
 
798
    def _check_file(self, file_id):
 
 
799
        """Check that the revision tree's version of the file matches."""
 
 
800
        for tree, rt in ((self.this_tree, self.this_revision_tree), 
 
 
801
                         (self.other_tree, self.other_revision_tree)):
 
 
804
            if tree.get_file_sha1(file_id) != rt.get_file_sha1(file_id):
 
 
805
                raise WorkingTreeNotRevision(self.this_tree)
 
 
807
    def _merged_lines(self, file_id):
 
 
808
        """Generate the merged lines.
 
 
809
        There is no distinction between lines that are meant to contain <<<<<<<
 
 
812
        weave = self.this_revision_tree.get_weave(file_id)
 
 
813
        this_revision_id = self.this_revision_tree.inventory[file_id].revision
 
 
814
        other_revision_id = \
 
 
815
            self.other_revision_tree.inventory[file_id].revision
 
 
816
        wm = WeaveMerge(weave, this_revision_id, other_revision_id, 
 
 
817
                        '<<<<<<< TREE\n', '>>>>>>> MERGE-SOURCE\n')
 
 
818
        return wm.merge_lines(self.reprocess)
 
 
820
    def text_merge(self, file_id, trans_id):
 
 
821
        """Perform a (weave) text merge for a given file and file-id.
 
 
822
        If conflicts are encountered, .THIS and .OTHER files will be emitted,
 
 
823
        and a conflict will be noted.
 
 
825
        self._check_file(file_id)
 
 
826
        lines, conflicts = self._merged_lines(file_id)
 
 
828
        # Note we're checking whether the OUTPUT is binary in this case, 
 
 
829
        # because we don't want to get into weave merge guts.
 
 
830
        check_text_lines(lines)
 
 
831
        self.tt.create_file(lines, trans_id)
 
 
833
            self._raw_conflicts.append(('text conflict', trans_id))
 
 
834
            name = self.tt.final_name(trans_id)
 
 
835
            parent_id = self.tt.final_parent(trans_id)
 
 
836
            file_group = self._dump_conflicts(name, parent_id, file_id, 
 
 
838
            file_group.append(trans_id)
 
 
841
class Diff3Merger(Merge3Merger):
 
 
842
    """Three-way merger using external diff3 for text merging"""
 
 
844
    def dump_file(self, temp_dir, name, tree, file_id):
 
 
845
        out_path = pathjoin(temp_dir, name)
 
 
846
        out_file = open(out_path, "wb")
 
 
848
            in_file = tree.get_file(file_id)
 
 
855
    def text_merge(self, file_id, trans_id):
 
 
856
        """Perform a diff3 merge using a specified file-id and trans-id.
 
 
857
        If conflicts are encountered, .BASE, .THIS. and .OTHER conflict files
 
 
858
        will be dumped, and a will be conflict noted.
 
 
861
        temp_dir = mkdtemp(prefix="bzr-")
 
 
863
            new_file = pathjoin(temp_dir, "new")
 
 
864
            this = self.dump_file(temp_dir, "this", self.this_tree, file_id)
 
 
865
            base = self.dump_file(temp_dir, "base", self.base_tree, file_id)
 
 
866
            other = self.dump_file(temp_dir, "other", self.other_tree, file_id)
 
 
867
            status = bzrlib.patch.diff3(new_file, this, base, other)
 
 
868
            if status not in (0, 1):
 
 
869
                raise BzrError("Unhandled diff3 exit code")
 
 
870
            f = open(new_file, 'rb')
 
 
872
                self.tt.create_file(f, trans_id)
 
 
876
                name = self.tt.final_name(trans_id)
 
 
877
                parent_id = self.tt.final_parent(trans_id)
 
 
878
                self._dump_conflicts(name, parent_id, file_id)
 
 
879
            self._raw_conflicts.append(('text conflict', trans_id))
 
 
884
def merge_inner(this_branch, other_tree, base_tree, ignore_zero=False,
 
 
886
                merge_type=Merge3Merger, 
 
 
887
                interesting_ids=None, 
 
 
891
                interesting_files=None,
 
 
894
    """Primary interface for merging. 
 
 
896
        typical use is probably 
 
 
897
        'merge_inner(branch, branch.get_revision_tree(other_revision),
 
 
898
                     branch.get_revision_tree(base_revision))'
 
 
900
    if this_tree is None:
 
 
901
        warnings.warn("bzrlib.merge.merge_inner requires a this_tree parameter as of "
 
 
902
             "bzrlib version 0.8.",
 
 
905
        this_tree = this_branch.bzrdir.open_workingtree()
 
 
906
    merger = Merger(this_branch, other_tree, base_tree, this_tree=this_tree, 
 
 
908
    merger.backup_files = backup_files
 
 
909
    merger.merge_type = merge_type
 
 
910
    merger.interesting_ids = interesting_ids
 
 
911
    merger.ignore_zero = ignore_zero
 
 
912
    if interesting_files:
 
 
913
        assert not interesting_ids, ('Only supply interesting_ids'
 
 
914
                                     ' or interesting_files')
 
 
915
        merger._set_interesting_files(interesting_files)
 
 
916
    merger.show_base = show_base 
 
 
917
    merger.reprocess = reprocess
 
 
918
    merger.other_rev_id = other_rev_id
 
 
919
    merger.other_basis = other_rev_id
 
 
920
    return merger.do_merge()
 
 
923
merge_types = {     "merge3": (Merge3Merger, "Native diff3-style merge"), 
 
 
924
                     "diff3": (Diff3Merger,  "Merge using external diff3"),
 
 
925
                     'weave': (WeaveMerger, "Weave-based merge")
 
 
929
def merge_type_help():
 
 
930
    templ = '%s%%7s: %%s' % (' '*12)
 
 
931
    lines = [templ % (f[0], f[1][1]) for f in merge_types.iteritems()]
 
 
932
    return '\n'.join(lines)