~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/merge.py

  • Committer: Aaron Bentley
  • Date: 2007-02-06 14:52:16 UTC
  • mfrom: (2266 +trunk)
  • mto: This revision was merged to the branch mainline in revision 2268.
  • Revision ID: abentley@panoramicfeedback.com-20070206145216-fcpi8o3ufvuzwbp9
Merge bzr.dev

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006, 2008 Canonical Ltd
 
1
# Copyright (C) 2005, 2006 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
 
 
18
import os
18
19
import errno
19
 
from itertools import chain
20
 
import os
21
20
import warnings
22
21
 
23
22
from bzrlib import (
24
 
    debug,
25
 
    errors,
26
 
    graph as _mod_graph,
27
23
    osutils,
28
 
    patiencediff,
29
 
    registry,
30
 
    revision as _mod_revision,
31
 
    tsort,
32
24
    )
33
25
from bzrlib.branch import Branch
34
26
from bzrlib.conflicts import ConflictList, Conflict
45
37
                           WorkingTreeNotRevision,
46
38
                           BinaryFile,
47
39
                           )
48
 
from bzrlib.graph import Graph
49
40
from bzrlib.merge3 import Merge3
50
41
from bzrlib.osutils import rename, pathjoin
51
42
from progress import DummyProgress, ProgressPhase
52
 
from bzrlib.revision import (NULL_REVISION, ensure_null)
 
43
from bzrlib.revision import common_ancestor, is_ancestor, NULL_REVISION
53
44
from bzrlib.textfile import check_text_lines
54
 
from bzrlib.trace import mutter, warning, note, is_quiet
55
 
from bzrlib.transform import (TransformPreview, TreeTransform,
56
 
                              resolve_conflicts, cook_conflicts,
57
 
                              conflict_pass, FinalPaths, create_by_entry,
58
 
                              unique_add, ROOT_PARENT)
59
 
from bzrlib.versionedfile import PlanWeaveMerge
 
45
from bzrlib.trace import mutter, warning, note
 
46
from bzrlib.transform import (TreeTransform, resolve_conflicts, cook_conflicts,
 
47
                              FinalPaths, create_by_entry, unique_add,
 
48
                              ROOT_PARENT)
 
49
from bzrlib.versionedfile import WeaveMerge
60
50
from bzrlib import ui
61
51
 
62
52
# TODO: Report back as changes are merged in
63
53
 
 
54
def _get_tree(treespec, local_branch=None):
 
55
    from bzrlib import workingtree
 
56
    location, revno = treespec
 
57
    if revno is None:
 
58
        tree = workingtree.WorkingTree.open_containing(location)[0]
 
59
        return tree.branch, tree
 
60
    branch = Branch.open_containing(location)[0]
 
61
    if revno == -1:
 
62
        revision = branch.last_revision()
 
63
    else:
 
64
        revision = branch.get_rev_id(revno)
 
65
        if revision is None:
 
66
            revision = NULL_REVISION
 
67
    return branch, _get_revid_tree(branch, revision, local_branch)
 
68
 
 
69
 
 
70
def _get_revid_tree(branch, revision, local_branch):
 
71
    if revision is None:
 
72
        base_tree = branch.bzrdir.open_workingtree()
 
73
    else:
 
74
        if local_branch is not None:
 
75
            if local_branch.base != branch.base:
 
76
                local_branch.fetch(branch, revision)
 
77
            base_tree = local_branch.repository.revision_tree(revision)
 
78
        else:
 
79
            base_tree = branch.repository.revision_tree(revision)
 
80
    return base_tree
 
81
 
64
82
 
65
83
def transform_tree(from_tree, to_tree, interesting_ids=None):
66
84
    merge_inner(from_tree.branch, to_tree, from_tree, ignore_zero=True,
68
86
 
69
87
 
70
88
class Merger(object):
71
 
    def __init__(self, this_branch, other_tree=None, base_tree=None,
72
 
                 this_tree=None, pb=DummyProgress(), change_reporter=None,
73
 
                 recurse='down', revision_graph=None):
 
89
    def __init__(self, this_branch, other_tree=None, base_tree=None, 
 
90
                 this_tree=None, pb=DummyProgress()):
74
91
        object.__init__(self)
 
92
        assert this_tree is not None, "this_tree is required"
75
93
        self.this_branch = this_branch
76
 
        self.this_basis = _mod_revision.ensure_null(
77
 
            this_branch.last_revision())
 
94
        self.this_basis = this_branch.last_revision()
78
95
        self.this_rev_id = None
79
96
        self.this_tree = this_tree
80
97
        self.this_revision_tree = None
81
98
        self.this_basis_tree = None
82
99
        self.other_tree = other_tree
83
 
        self.other_branch = None
84
100
        self.base_tree = base_tree
85
101
        self.ignore_zero = False
86
102
        self.backup_files = False
87
103
        self.interesting_ids = None
88
 
        self.interesting_files = None
89
104
        self.show_base = False
90
105
        self.reprocess = False
91
 
        self._pb = pb
 
106
        self._pb = pb 
92
107
        self.pp = None
93
 
        self.recurse = recurse
94
 
        self.change_reporter = change_reporter
95
 
        self._cached_trees = {}
96
 
        self._revision_graph = revision_graph
97
 
        self._base_is_ancestor = None
98
 
        self._base_is_other_ancestor = None
99
 
 
100
 
    @property
101
 
    def revision_graph(self):
102
 
        if self._revision_graph is None:
103
 
            self._revision_graph = self.this_branch.repository.get_graph()
104
 
        return self._revision_graph
105
 
 
106
 
    def _set_base_is_ancestor(self, value):
107
 
        self._base_is_ancestor = value
108
 
 
109
 
    def _get_base_is_ancestor(self):
110
 
        if self._base_is_ancestor is None:
111
 
            self._base_is_ancestor = self.revision_graph.is_ancestor(
112
 
                self.base_rev_id, self.this_basis)
113
 
        return self._base_is_ancestor
114
 
 
115
 
    base_is_ancestor = property(_get_base_is_ancestor, _set_base_is_ancestor)
116
 
 
117
 
    def _set_base_is_other_ancestor(self, value):
118
 
        self._base_is_other_ancestor = value
119
 
 
120
 
    def _get_base_is_other_ancestor(self):
121
 
        if self._base_is_other_ancestor is None:
122
 
            if self.other_basis is None:
123
 
                return True
124
 
            self._base_is_other_ancestor = self.revision_graph.is_ancestor(
125
 
                self.base_rev_id, self.other_basis)
126
 
        return self._base_is_other_ancestor
127
 
 
128
 
    base_is_other_ancestor = property(_get_base_is_other_ancestor,
129
 
                                      _set_base_is_other_ancestor)
130
 
 
131
 
    @staticmethod
132
 
    def from_uncommitted(tree, other_tree, pb):
133
 
        """Return a Merger for uncommitted changes in other_tree.
134
 
 
135
 
        :param tree: The tree to merge into
136
 
        :param other_tree: The tree to get uncommitted changes from
137
 
        :param pb: A progress indicator
138
 
        """
139
 
        merger = Merger(tree.branch, other_tree, other_tree.basis_tree(), tree,
140
 
                        pb)
141
 
        merger.base_rev_id = merger.base_tree.get_revision_id()
142
 
        merger.other_rev_id = None
143
 
        merger.other_basis = merger.base_rev_id
144
 
        return merger
145
 
 
146
 
    @classmethod
147
 
    def from_mergeable(klass, tree, mergeable, pb):
148
 
        """Return a Merger for a bundle or merge directive.
149
 
 
150
 
        :param tree: The tree to merge changes into
151
 
        :param mergeable: A merge directive or bundle
152
 
        :param pb: A progress indicator
153
 
        """
154
 
        mergeable.install_revisions(tree.branch.repository)
155
 
        base_revision_id, other_revision_id, verified =\
156
 
            mergeable.get_merge_request(tree.branch.repository)
157
 
        revision_graph = tree.branch.repository.get_graph()
158
 
        if base_revision_id is not None:
159
 
            if (base_revision_id != _mod_revision.NULL_REVISION and
160
 
                revision_graph.is_ancestor(
161
 
                base_revision_id, tree.branch.last_revision())):
162
 
                base_revision_id = None
163
 
            else:
164
 
                warning('Performing cherrypick')
165
 
        merger = klass.from_revision_ids(pb, tree, other_revision_id,
166
 
                                         base_revision_id, revision_graph=
167
 
                                         revision_graph)
168
 
        return merger, verified
169
 
 
170
 
    @staticmethod
171
 
    def from_revision_ids(pb, tree, other, base=None, other_branch=None,
172
 
                          base_branch=None, revision_graph=None):
173
 
        """Return a Merger for revision-ids.
174
 
 
175
 
        :param tree: The tree to merge changes into
176
 
        :param other: The revision-id to use as OTHER
177
 
        :param base: The revision-id to use as BASE.  If not specified, will
178
 
            be auto-selected.
179
 
        :param other_branch: A branch containing the other revision-id.  If
180
 
            not supplied, tree.branch is used.
181
 
        :param base_branch: A branch containing the base revision-id.  If
182
 
            not supplied, other_branch or tree.branch will be used.
183
 
        :param revision_graph: If you have a revision_graph precomputed, pass
184
 
            it in, otherwise it will be created for you.
185
 
        :param pb: A progress indicator
186
 
        """
187
 
        merger = Merger(tree.branch, this_tree=tree, pb=pb,
188
 
                        revision_graph=revision_graph)
189
 
        if other_branch is None:
190
 
            other_branch = tree.branch
191
 
        merger.set_other_revision(other, other_branch)
192
 
        if base is None:
193
 
            merger.find_base()
194
 
        else:
195
 
            if base_branch is None:
196
 
                base_branch = other_branch
197
 
            merger.set_base_revision(base, base_branch)
198
 
        return merger
199
 
 
200
 
    def revision_tree(self, revision_id, branch=None):
201
 
        if revision_id not in self._cached_trees:
202
 
            if branch is None:
203
 
                branch = self.this_branch
204
 
            try:
205
 
                tree = self.this_tree.revision_tree(revision_id)
206
 
            except errors.NoSuchRevisionInTree:
207
 
                tree = branch.repository.revision_tree(revision_id)
208
 
            self._cached_trees[revision_id] = tree
209
 
        return self._cached_trees[revision_id]
210
 
 
211
 
    def _get_tree(self, treespec, possible_transports=None):
212
 
        from bzrlib import workingtree
213
 
        location, revno = treespec
214
 
        if revno is None:
215
 
            tree = workingtree.WorkingTree.open_containing(location)[0]
216
 
            return tree.branch, tree
217
 
        branch = Branch.open_containing(location, possible_transports)[0]
218
 
        if revno == -1:
219
 
            revision_id = branch.last_revision()
220
 
        else:
221
 
            revision_id = branch.get_rev_id(revno)
222
 
        revision_id = ensure_null(revision_id)
223
 
        return branch, self.revision_tree(revision_id, branch)
 
108
 
 
109
 
 
110
    def revision_tree(self, revision_id):
 
111
        return self.this_branch.repository.revision_tree(revision_id)
224
112
 
225
113
    def ensure_revision_trees(self):
226
114
        if self.this_revision_tree is None:
227
 
            self.this_basis_tree = self.revision_tree(self.this_basis)
 
115
            self.this_basis_tree = self.this_branch.repository.revision_tree(
 
116
                self.this_basis)
228
117
            if self.this_basis == self.this_rev_id:
229
118
                self.this_revision_tree = self.this_basis_tree
230
119
 
240
129
        self.ensure_revision_trees()
241
130
        def get_id(tree, file_id):
242
131
            revision_id = tree.inventory[file_id].revision
 
132
            assert revision_id is not None
243
133
            return revision_id
244
134
        if self.this_rev_id is None:
245
135
            if self.this_basis_tree.get_file_sha1(file_id) != \
256
146
        if check_clean:
257
147
            self.compare_basis()
258
148
            if self.this_basis != self.this_rev_id:
259
 
                raise errors.UncommittedChanges(self.this_tree)
 
149
                raise BzrCommandError("Working tree has uncommitted changes.")
260
150
 
261
151
    def compare_basis(self):
262
 
        try:
263
 
            basis_tree = self.revision_tree(self.this_tree.last_revision())
264
 
        except errors.NoSuchRevision:
265
 
            basis_tree = self.this_tree.basis_tree()
266
 
        changes = self.this_tree.changes_from(basis_tree)
 
152
        changes = self.this_tree.changes_from(self.this_tree.basis_tree())
267
153
        if not changes.has_changed():
268
154
            self.this_rev_id = self.this_basis
269
155
 
270
156
    def set_interesting_files(self, file_list):
271
 
        self.interesting_files = file_list
 
157
        try:
 
158
            self._set_interesting_files(file_list)
 
159
        except NotVersionedError, e:
 
160
            raise BzrCommandError("%s is not a source file in any"
 
161
                                      " tree." % e.path)
 
162
 
 
163
    def _set_interesting_files(self, file_list):
 
164
        """Set the list of interesting ids from a list of files."""
 
165
        if file_list is None:
 
166
            self.interesting_ids = None
 
167
            return
 
168
 
 
169
        interesting_ids = set()
 
170
        for path in file_list:
 
171
            found_id = False
 
172
            for tree in (self.this_tree, self.base_tree, self.other_tree):
 
173
                file_id = tree.inventory.path2id(path)
 
174
                if file_id is not None:
 
175
                    interesting_ids.add(file_id)
 
176
                    found_id = True
 
177
            if not found_id:
 
178
                raise NotVersionedError(path=path)
 
179
        self.interesting_ids = interesting_ids
272
180
 
273
181
    def set_pending(self):
274
 
        if not self.base_is_ancestor or not self.base_is_other_ancestor or self.other_rev_id is None:
275
 
            return
276
 
        self._add_parent()
277
 
 
278
 
    def _add_parent(self):
279
 
        new_parents = self.this_tree.get_parent_ids() + [self.other_rev_id]
280
 
        new_parent_trees = []
281
 
        for revision_id in new_parents:
282
 
            try:
283
 
                tree = self.revision_tree(revision_id)
284
 
            except errors.NoSuchRevision:
285
 
                tree = None
286
 
            else:
287
 
                tree.lock_read()
288
 
            new_parent_trees.append((revision_id, tree))
289
 
        try:
290
 
            self.this_tree.set_parent_trees(new_parent_trees,
291
 
                                            allow_leftmost_as_ghost=True)
292
 
        finally:
293
 
            for _revision_id, tree in new_parent_trees:
294
 
                if tree is not None:
295
 
                    tree.unlock()
296
 
 
297
 
    def set_other(self, other_revision, possible_transports=None):
 
182
        if not self.base_is_ancestor:
 
183
            return
 
184
        if self.other_rev_id is None:
 
185
            return
 
186
        ancestry = self.this_branch.repository.get_ancestry(self.this_basis)
 
187
        if self.other_rev_id in ancestry:
 
188
            return
 
189
        self.this_tree.add_parent_tree((self.other_rev_id, self.other_tree))
 
190
 
 
191
    def set_other(self, other_revision):
298
192
        """Set the revision and tree to merge from.
299
193
 
300
194
        This sets the other_tree, other_rev_id, other_basis attributes.
301
195
 
302
196
        :param other_revision: The [path, revision] list to merge from.
303
197
        """
304
 
        self.other_branch, self.other_tree = self._get_tree(other_revision,
305
 
                                                            possible_transports)
 
198
        other_branch, self.other_tree = _get_tree(other_revision,
 
199
                                                  self.this_branch)
306
200
        if other_revision[1] == -1:
307
 
            self.other_rev_id = _mod_revision.ensure_null(
308
 
                self.other_branch.last_revision())
309
 
            if _mod_revision.is_null(self.other_rev_id):
310
 
                raise NoCommits(self.other_branch)
 
201
            self.other_rev_id = other_branch.last_revision()
 
202
            if self.other_rev_id is None:
 
203
                raise NoCommits(other_branch)
311
204
            self.other_basis = self.other_rev_id
312
205
        elif other_revision[1] is not None:
313
 
            self.other_rev_id = self.other_branch.get_rev_id(other_revision[1])
 
206
            self.other_rev_id = other_branch.get_rev_id(other_revision[1])
314
207
            self.other_basis = self.other_rev_id
315
208
        else:
316
209
            self.other_rev_id = None
317
 
            self.other_basis = self.other_branch.last_revision()
 
210
            self.other_basis = other_branch.last_revision()
318
211
            if self.other_basis is None:
319
 
                raise NoCommits(self.other_branch)
320
 
        if self.other_rev_id is not None:
321
 
            self._cached_trees[self.other_rev_id] = self.other_tree
322
 
        self._maybe_fetch(self.other_branch,self.this_branch, self.other_basis)
323
 
 
324
 
    def set_other_revision(self, revision_id, other_branch):
325
 
        """Set 'other' based on a branch and revision id
326
 
 
327
 
        :param revision_id: The revision to use for a tree
328
 
        :param other_branch: The branch containing this tree
329
 
        """
330
 
        self.other_rev_id = revision_id
331
 
        self.other_branch = other_branch
332
 
        self._maybe_fetch(other_branch, self.this_branch, self.other_rev_id)
333
 
        self.other_tree = self.revision_tree(revision_id)
334
 
        self.other_basis = revision_id
335
 
 
336
 
    def set_base_revision(self, revision_id, branch):
337
 
        """Set 'base' based on a branch and revision id
338
 
 
339
 
        :param revision_id: The revision to use for a tree
340
 
        :param branch: The branch containing this tree
341
 
        """
342
 
        self.base_rev_id = revision_id
343
 
        self.base_branch = branch
344
 
        self._maybe_fetch(branch, self.this_branch, revision_id)
345
 
        self.base_tree = self.revision_tree(revision_id)
346
 
 
347
 
    def _maybe_fetch(self, source, target, revision_id):
348
 
        if not source.repository.has_same_location(target.repository):
349
 
            target.fetch(source, revision_id)
 
212
                raise NoCommits(other_branch)
 
213
        if other_branch.base != self.this_branch.base:
 
214
            self.this_branch.fetch(other_branch, last_revision=self.other_basis)
350
215
 
351
216
    def find_base(self):
352
 
        revisions = [ensure_null(self.this_basis),
353
 
                     ensure_null(self.other_basis)]
354
 
        if NULL_REVISION in revisions:
355
 
            self.base_rev_id = NULL_REVISION
356
 
        else:
357
 
            self.base_rev_id, steps = self.revision_graph.find_unique_lca(
358
 
                revisions[0], revisions[1], count_steps=True)
359
 
            if self.base_rev_id == NULL_REVISION:
360
 
                raise UnrelatedBranches()
361
 
            if steps > 1:
362
 
                warning('Warning: criss-cross merge encountered.  See bzr'
363
 
                        ' help criss-cross.')
364
 
        self.base_tree = self.revision_tree(self.base_rev_id)
365
 
        self.base_is_ancestor = True
366
 
        self.base_is_other_ancestor = True
 
217
        self.set_base([None, None])
367
218
 
368
219
    def set_base(self, base_revision):
369
220
        """Set the base revision to use for the merge.
372
223
        """
373
224
        mutter("doing merge() with no base_revision specified")
374
225
        if base_revision == [None, None]:
375
 
            self.find_base()
 
226
            try:
 
227
                pb = ui.ui_factory.nested_progress_bar()
 
228
                try:
 
229
                    this_repo = self.this_branch.repository
 
230
                    self.base_rev_id = common_ancestor(self.this_basis, 
 
231
                                                       self.other_basis, 
 
232
                                                       this_repo, pb)
 
233
                finally:
 
234
                    pb.finished()
 
235
            except NoCommonAncestor:
 
236
                raise UnrelatedBranches()
 
237
            self.base_tree = _get_revid_tree(self.this_branch, self.base_rev_id,
 
238
                                            None)
 
239
            self.base_is_ancestor = True
376
240
        else:
377
 
            base_branch, self.base_tree = self._get_tree(base_revision)
 
241
            base_branch, self.base_tree = _get_tree(base_revision)
378
242
            if base_revision[1] == -1:
379
243
                self.base_rev_id = base_branch.last_revision()
380
244
            elif base_revision[1] is None:
381
 
                self.base_rev_id = _mod_revision.NULL_REVISION
 
245
                self.base_rev_id = None
382
246
            else:
383
 
                self.base_rev_id = _mod_revision.ensure_null(
384
 
                    base_branch.get_rev_id(base_revision[1]))
385
 
            self._maybe_fetch(base_branch, self.this_branch, self.base_rev_id)
 
247
                self.base_rev_id = base_branch.get_rev_id(base_revision[1])
 
248
            if self.this_branch.base != base_branch.base:
 
249
                self.this_branch.fetch(base_branch)
 
250
            self.base_is_ancestor = is_ancestor(self.this_basis, 
 
251
                                                self.base_rev_id,
 
252
                                                self.this_branch)
386
253
 
387
 
    def make_merger(self):
388
 
        kwargs = {'working_tree':self.this_tree, 'this_tree': self.this_tree,
389
 
                  'other_tree': self.other_tree,
 
254
    def do_merge(self):
 
255
        kwargs = {'working_tree':self.this_tree, 'this_tree': self.this_tree, 
 
256
                  'other_tree': self.other_tree, 
390
257
                  'interesting_ids': self.interesting_ids,
391
 
                  'interesting_files': self.interesting_files,
392
 
                  'pp': self.pp,
393
 
                  'do_merge': False}
 
258
                  'pp': self.pp}
394
259
        if self.merge_type.requires_base:
395
260
            kwargs['base_tree'] = self.base_tree
396
261
        if self.merge_type.supports_reprocess:
402
267
            kwargs['show_base'] = self.show_base
403
268
        elif self.show_base:
404
269
            raise BzrError("Showing base is not supported for this"
405
 
                           " merge type. %s" % self.merge_type)
406
 
        if (not getattr(self.merge_type, 'supports_reverse_cherrypick', True)
407
 
            and not self.base_is_other_ancestor):
408
 
            raise errors.CannotReverseCherrypick()
409
 
        if self.merge_type.supports_cherrypick:
410
 
            kwargs['cherrypick'] = (not self.base_is_ancestor or
411
 
                                    not self.base_is_other_ancestor)
412
 
        return self.merge_type(pb=self._pb,
413
 
                               change_reporter=self.change_reporter,
414
 
                               **kwargs)
415
 
 
416
 
    def do_merge(self):
417
 
        self.this_tree.lock_tree_write()
418
 
        if self.base_tree is not None:
419
 
            self.base_tree.lock_read()
420
 
        if self.other_tree is not None:
421
 
            self.other_tree.lock_read()
422
 
        try:
423
 
            merge = self.make_merger()
424
 
            merge.do_merge()
425
 
            if self.recurse == 'down':
426
 
                for relpath, file_id in self.this_tree.iter_references():
427
 
                    sub_tree = self.this_tree.get_nested_tree(file_id, relpath)
428
 
                    other_revision = self.other_tree.get_reference_revision(
429
 
                        file_id, relpath)
430
 
                    if  other_revision == sub_tree.last_revision():
431
 
                        continue
432
 
                    sub_merge = Merger(sub_tree.branch, this_tree=sub_tree)
433
 
                    sub_merge.merge_type = self.merge_type
434
 
                    other_branch = self.other_branch.reference_parent(file_id, relpath)
435
 
                    sub_merge.set_other_revision(other_revision, other_branch)
436
 
                    base_revision = self.base_tree.get_reference_revision(file_id)
437
 
                    sub_merge.base_tree = \
438
 
                        sub_tree.branch.repository.revision_tree(base_revision)
439
 
                    sub_merge.base_rev_id = base_revision
440
 
                    sub_merge.do_merge()
441
 
 
442
 
        finally:
443
 
            if self.other_tree is not None:
444
 
                self.other_tree.unlock()
445
 
            if self.base_tree is not None:
446
 
                self.base_tree.unlock()
447
 
            self.this_tree.unlock()
 
270
                                  " merge type. %s" % self.merge_type)
 
271
        merge = self.merge_type(pb=self._pb, **kwargs)
448
272
        if len(merge.cooked_conflicts) == 0:
449
 
            if not self.ignore_zero and not is_quiet():
 
273
            if not self.ignore_zero:
450
274
                note("All changes applied successfully.")
451
275
        else:
452
276
            note("%d conflicts encountered." % len(merge.cooked_conflicts))
453
277
 
454
278
        return len(merge.cooked_conflicts)
455
279
 
 
280
    def regen_inventory(self, new_entries):
 
281
        old_entries = self.this_tree.read_working_inventory()
 
282
        new_inventory = {}
 
283
        by_path = {}
 
284
        new_entries_map = {} 
 
285
        for path, file_id in new_entries:
 
286
            if path is None:
 
287
                continue
 
288
            new_entries_map[file_id] = path
 
289
 
 
290
        def id2path(file_id):
 
291
            path = new_entries_map.get(file_id)
 
292
            if path is not None:
 
293
                return path
 
294
            entry = old_entries[file_id]
 
295
            if entry.parent_id is None:
 
296
                return entry.name
 
297
            return pathjoin(id2path(entry.parent_id), entry.name)
 
298
            
 
299
        for file_id in old_entries:
 
300
            entry = old_entries[file_id]
 
301
            path = id2path(file_id)
 
302
            if file_id in self.base_tree.inventory:
 
303
                executable = getattr(self.base_tree.inventory[file_id], 'executable', False)
 
304
            else:
 
305
                executable = getattr(entry, 'executable', False)
 
306
            new_inventory[file_id] = (path, file_id, entry.parent_id, 
 
307
                                      entry.kind, executable)
 
308
                                      
 
309
            by_path[path] = file_id
 
310
        
 
311
        deletions = 0
 
312
        insertions = 0
 
313
        new_path_list = []
 
314
        for path, file_id in new_entries:
 
315
            if path is None:
 
316
                del new_inventory[file_id]
 
317
                deletions += 1
 
318
            else:
 
319
                new_path_list.append((path, file_id))
 
320
                if file_id not in old_entries:
 
321
                    insertions += 1
 
322
        # Ensure no file is added before its parent
 
323
        new_path_list.sort()
 
324
        for path, file_id in new_path_list:
 
325
            if path == '':
 
326
                parent = None
 
327
            else:
 
328
                parent = by_path[os.path.dirname(path)]
 
329
            abspath = pathjoin(self.this_tree.basedir, path)
 
330
            kind = osutils.file_kind(abspath)
 
331
            if file_id in self.base_tree.inventory:
 
332
                executable = getattr(self.base_tree.inventory[file_id], 'executable', False)
 
333
            else:
 
334
                executable = False
 
335
            new_inventory[file_id] = (path, file_id, parent, kind, executable)
 
336
            by_path[path] = file_id 
 
337
 
 
338
        # Get a list in insertion order
 
339
        new_inventory_list = new_inventory.values()
 
340
        mutter ("""Inventory regeneration:
 
341
    old length: %i insertions: %i deletions: %i new_length: %i"""\
 
342
            % (len(old_entries), insertions, deletions, 
 
343
               len(new_inventory_list)))
 
344
        assert len(new_inventory_list) == len(old_entries) + insertions\
 
345
            - deletions
 
346
        new_inventory_list.sort()
 
347
        return new_inventory_list
 
348
 
456
349
 
457
350
class Merge3Merger(object):
458
351
    """Three-way merger that uses the merge3 text merger"""
460
353
    supports_reprocess = True
461
354
    supports_show_base = True
462
355
    history_based = False
463
 
    supports_cherrypick = True
464
 
    supports_reverse_cherrypick = True
465
 
    winner_idx = {"this": 2, "other": 1, "conflict": 1}
466
356
 
467
357
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
468
358
                 interesting_ids=None, reprocess=False, show_base=False,
469
 
                 pb=DummyProgress(), pp=None, change_reporter=None,
470
 
                 interesting_files=None, do_merge=True,
471
 
                 cherrypick=False):
472
 
        """Initialize the merger object and perform the merge.
473
 
 
474
 
        :param working_tree: The working tree to apply the merge to
475
 
        :param this_tree: The local tree in the merge operation
476
 
        :param base_tree: The common tree in the merge operation
477
 
        :param other_tree: The other other tree to merge changes from
478
 
        :param interesting_ids: The file_ids of files that should be
479
 
            participate in the merge.  May not be combined with
480
 
            interesting_files.
481
 
        :param: reprocess If True, perform conflict-reduction processing.
482
 
        :param show_base: If True, show the base revision in text conflicts.
483
 
            (incompatible with reprocess)
484
 
        :param pb: A Progress bar
485
 
        :param pp: A ProgressPhase object
486
 
        :param change_reporter: An object that should report changes made
487
 
        :param interesting_files: The tree-relative paths of files that should
488
 
            participate in the merge.  If these paths refer to directories,
489
 
            the contents of those directories will also be included.  May not
490
 
            be combined with interesting_ids.  If neither interesting_files nor
491
 
            interesting_ids is specified, all files may participate in the
492
 
            merge.
493
 
        """
 
359
                 pb=DummyProgress(), pp=None):
 
360
        """Initialize the merger object and perform the merge."""
494
361
        object.__init__(self)
495
 
        if interesting_files is not None and interesting_ids is not None:
496
 
            raise ValueError(
497
 
                'specify either interesting_ids or interesting_files')
498
 
        self.interesting_ids = interesting_ids
499
 
        self.interesting_files = interesting_files
500
362
        self.this_tree = working_tree
501
363
        self.base_tree = base_tree
502
364
        self.other_tree = other_tree
506
368
        self.show_base = show_base
507
369
        self.pb = pb
508
370
        self.pp = pp
509
 
        self.change_reporter = change_reporter
510
 
        self.cherrypick = cherrypick
511
371
        if self.pp is None:
512
372
            self.pp = ProgressPhase("Merge phase", 3, self.pb)
513
 
        if do_merge:
514
 
            self.do_merge()
515
373
 
516
 
    def do_merge(self):
517
 
        self.this_tree.lock_tree_write()
518
 
        self.base_tree.lock_read()
519
 
        self.other_tree.lock_read()
520
 
        self.tt = TreeTransform(self.this_tree, self.pb)
 
374
        if interesting_ids is not None:
 
375
            all_ids = interesting_ids
 
376
        else:
 
377
            all_ids = set(base_tree)
 
378
            all_ids.update(other_tree)
 
379
        working_tree.lock_tree_write()
 
380
        self.tt = TreeTransform(working_tree, self.pb)
521
381
        try:
522
382
            self.pp.next_phase()
523
 
            self._compute_transform()
524
 
            self.pp.next_phase()
525
 
            results = self.tt.apply(no_conflicts=True)
 
383
            child_pb = ui.ui_factory.nested_progress_bar()
 
384
            try:
 
385
                for num, file_id in enumerate(all_ids):
 
386
                    child_pb.update('Preparing file merge', num, len(all_ids))
 
387
                    self.merge_names(file_id)
 
388
                    file_status = self.merge_contents(file_id)
 
389
                    self.merge_executable(file_id, file_status)
 
390
            finally:
 
391
                child_pb.finished()
 
392
            self.fix_root()
 
393
            self.pp.next_phase()
 
394
            child_pb = ui.ui_factory.nested_progress_bar()
 
395
            try:
 
396
                fs_conflicts = resolve_conflicts(self.tt, child_pb)
 
397
            finally:
 
398
                child_pb.finished()
 
399
            self.cook_conflicts(fs_conflicts)
 
400
            for conflict in self.cooked_conflicts:
 
401
                warning(conflict)
 
402
            self.pp.next_phase()
 
403
            results = self.tt.apply()
526
404
            self.write_modified(results)
527
405
            try:
528
 
                self.this_tree.add_conflicts(self.cooked_conflicts)
 
406
                working_tree.add_conflicts(self.cooked_conflicts)
529
407
            except UnsupportedOperation:
530
408
                pass
531
409
        finally:
532
410
            self.tt.finalize()
533
 
            self.other_tree.unlock()
534
 
            self.base_tree.unlock()
535
 
            self.this_tree.unlock()
536
 
            self.pb.clear()
537
 
 
538
 
    def make_preview_transform(self):
539
 
        self.base_tree.lock_read()
540
 
        self.other_tree.lock_read()
541
 
        self.tt = TransformPreview(self.this_tree)
542
 
        try:
543
 
            self.pp.next_phase()
544
 
            self._compute_transform()
545
 
            self.pp.next_phase()
546
 
        finally:
547
 
            self.other_tree.unlock()
548
 
            self.base_tree.unlock()
549
 
            self.pb.clear()
550
 
        return self.tt
551
 
 
552
 
    def _compute_transform(self):
553
 
        entries = self._entries3()
554
 
        child_pb = ui.ui_factory.nested_progress_bar()
555
 
        try:
556
 
            for num, (file_id, changed, parents3, names3,
557
 
                      executable3) in enumerate(entries):
558
 
                child_pb.update('Preparing file merge', num, len(entries))
559
 
                self._merge_names(file_id, parents3, names3)
560
 
                if changed:
561
 
                    file_status = self.merge_contents(file_id)
562
 
                else:
563
 
                    file_status = 'unmodified'
564
 
                self._merge_executable(file_id,
565
 
                    executable3, file_status)
566
 
        finally:
567
 
            child_pb.finished()
568
 
        self.fix_root()
569
 
        self.pp.next_phase()
570
 
        child_pb = ui.ui_factory.nested_progress_bar()
571
 
        try:
572
 
            fs_conflicts = resolve_conflicts(self.tt, child_pb,
573
 
                lambda t, c: conflict_pass(t, c, self.other_tree))
574
 
        finally:
575
 
            child_pb.finished()
576
 
        if self.change_reporter is not None:
577
 
            from bzrlib import delta
578
 
            delta.report_changes(
579
 
                self.tt.iter_changes(), self.change_reporter)
580
 
        self.cook_conflicts(fs_conflicts)
581
 
        for conflict in self.cooked_conflicts:
582
 
            warning(conflict)
583
 
 
584
 
    def _entries3(self):
585
 
        """Gather data about files modified between three trees.
586
 
 
587
 
        Return a list of tuples of file_id, changed, parents3, names3,
588
 
        executable3.  changed is a boolean indicating whether the file contents
589
 
        or kind were changed.  parents3 is a tuple of parent ids for base,
590
 
        other and this.  names3 is a tuple of names for base, other and this.
591
 
        executable3 is a tuple of execute-bit values for base, other and this.
592
 
        """
593
 
        result = []
594
 
        iterator = self.other_tree.iter_changes(self.base_tree,
595
 
                include_unchanged=True, specific_files=self.interesting_files,
596
 
                extra_trees=[self.this_tree])
597
 
        for (file_id, paths, changed, versioned, parents, names, kind,
598
 
             executable) in iterator:
599
 
            if (self.interesting_ids is not None and
600
 
                file_id not in self.interesting_ids):
601
 
                continue
602
 
            if file_id in self.this_tree.inventory:
603
 
                entry = self.this_tree.inventory[file_id]
604
 
                this_name = entry.name
605
 
                this_parent = entry.parent_id
606
 
                this_executable = entry.executable
607
 
            else:
608
 
                this_name = None
609
 
                this_parent = None
610
 
                this_executable = None
611
 
            parents3 = parents + (this_parent,)
612
 
            names3 = names + (this_name,)
613
 
            executable3 = executable + (this_executable,)
614
 
            result.append((file_id, changed, parents3, names3, executable3))
615
 
        return result
 
411
            working_tree.unlock()
 
412
            self.pb.clear()
616
413
 
617
414
    def fix_root(self):
618
415
        try:
624
421
                                 self.tt.root)
625
422
        if self.other_tree.inventory.root is None:
626
423
            return
627
 
        other_root_file_id = self.other_tree.get_root_id()
 
424
        other_root_file_id = self.other_tree.inventory.root.file_id
628
425
        other_root = self.tt.trans_id_file_id(other_root_file_id)
629
426
        if other_root == self.tt.root:
630
427
            return
691
488
        return tree.kind(file_id)
692
489
 
693
490
    @staticmethod
694
 
    def _three_way(base, other, this):
695
 
        #if base == other, either they all agree, or only THIS has changed.
696
 
        if base == other:
697
 
            return 'this'
698
 
        elif this not in (base, other):
699
 
            return 'conflict'
700
 
        # "Ambiguous clean merge" -- both sides have made the same change.
701
 
        elif this == other:
702
 
            return "this"
703
 
        # this == base: only other has changed.
704
 
        else:
705
 
            return "other"
706
 
 
707
 
    @staticmethod
708
491
    def scalar_three_way(this_tree, base_tree, other_tree, file_id, key):
709
492
        """Do a three-way test on a scalar.
710
493
        Return "this", "other" or "conflict", depending whether a value wins.
715
498
        if key_base == key_other:
716
499
            return "this"
717
500
        key_this = key(this_tree, file_id)
 
501
        if key_this not in (key_base, key_other):
 
502
            return "conflict"
718
503
        # "Ambiguous clean merge"
719
 
        if key_this == key_other:
 
504
        elif key_this == key_other:
720
505
            return "this"
721
 
        elif key_this == key_base:
 
506
        else:
 
507
            assert key_this == key_base
722
508
            return "other"
723
 
        else:
724
 
            return "conflict"
725
509
 
726
510
    def merge_names(self, file_id):
 
511
        """Perform a merge on file_id names and parents"""
727
512
        def get_entry(tree):
728
513
            if file_id in tree.inventory:
729
514
                return tree.inventory[file_id]
732
517
        this_entry = get_entry(self.this_tree)
733
518
        other_entry = get_entry(self.other_tree)
734
519
        base_entry = get_entry(self.base_tree)
735
 
        entries = (base_entry, other_entry, this_entry)
736
 
        names = []
737
 
        parents = []
738
 
        for entry in entries:
739
 
            if entry is None:
740
 
                names.append(None)
741
 
                parents.append(None)
742
 
            else:
743
 
                names.append(entry.name)
744
 
                parents.append(entry.parent_id)
745
 
        return self._merge_names(file_id, parents, names)
746
 
 
747
 
    def _merge_names(self, file_id, parents, names):
748
 
        """Perform a merge on file_id names and parents"""
749
 
        base_name, other_name, this_name = names
750
 
        base_parent, other_parent, this_parent = parents
751
 
 
752
 
        name_winner = self._three_way(*names)
753
 
 
754
 
        parent_id_winner = self._three_way(*parents)
755
 
        if this_name is None:
 
520
        name_winner = self.scalar_three_way(this_entry, base_entry, 
 
521
                                            other_entry, file_id, self.name)
 
522
        parent_id_winner = self.scalar_three_way(this_entry, base_entry, 
 
523
                                                 other_entry, file_id, 
 
524
                                                 self.parent)
 
525
        if this_entry is None:
756
526
            if name_winner == "this":
757
527
                name_winner = "other"
758
528
            if parent_id_winner == "this":
762
532
        if name_winner == "conflict":
763
533
            trans_id = self.tt.trans_id_file_id(file_id)
764
534
            self._raw_conflicts.append(('name conflict', trans_id, 
765
 
                                        this_name, other_name))
 
535
                                        self.name(this_entry, file_id), 
 
536
                                        self.name(other_entry, file_id)))
766
537
        if parent_id_winner == "conflict":
767
538
            trans_id = self.tt.trans_id_file_id(file_id)
768
539
            self._raw_conflicts.append(('parent conflict', trans_id, 
769
 
                                        this_parent, other_parent))
770
 
        if other_name is None:
 
540
                                        self.parent(this_entry, file_id), 
 
541
                                        self.parent(other_entry, file_id)))
 
542
        if other_entry is None:
771
543
            # it doesn't matter whether the result was 'other' or 
772
544
            # 'conflict'-- if there's no 'other', we leave it alone.
773
545
            return
774
546
        # if we get here, name_winner and parent_winner are set to safe values.
 
547
        winner_entry = {"this": this_entry, "other": other_entry, 
 
548
                        "conflict": other_entry}
775
549
        trans_id = self.tt.trans_id_file_id(file_id)
776
 
        parent_id = parents[self.winner_idx[parent_id_winner]]
 
550
        parent_id = winner_entry[parent_id_winner].parent_id
777
551
        if parent_id is not None:
778
552
            parent_trans_id = self.tt.trans_id_file_id(parent_id)
779
 
            self.tt.adjust_path(names[self.winner_idx[name_winner]],
 
553
            self.tt.adjust_path(winner_entry[name_winner].name, 
780
554
                                parent_trans_id, trans_id)
781
555
 
782
556
    def merge_contents(self, file_id):
875
649
            base_lines = []
876
650
        other_lines = self.get_lines(self.other_tree, file_id)
877
651
        this_lines = self.get_lines(self.this_tree, file_id)
878
 
        m3 = Merge3(base_lines, this_lines, other_lines,
879
 
                    is_cherrypick=self.cherrypick)
 
652
        m3 = Merge3(base_lines, this_lines, other_lines)
880
653
        start_marker = "!START OF MERGE CONFLICT!" + "I HOPE THIS IS UNIQUE"
881
654
        if self.show_base is True:
882
655
            base_marker = '|' * 7
943
716
 
944
717
    def merge_executable(self, file_id, file_status):
945
718
        """Perform a merge on the execute bit."""
946
 
        executable = [self.executable(t, file_id) for t in (self.base_tree,
947
 
                      self.other_tree, self.this_tree)]
948
 
        self._merge_executable(file_id, executable, file_status)
949
 
 
950
 
    def _merge_executable(self, file_id, executable, file_status):
951
 
        """Perform a merge on the execute bit."""
952
 
        base_executable, other_executable, this_executable = executable
953
719
        if file_status == "deleted":
954
720
            return
955
 
        winner = self._three_way(*executable)
 
721
        trans_id = self.tt.trans_id_file_id(file_id)
 
722
        try:
 
723
            if self.tt.final_kind(trans_id) != "file":
 
724
                return
 
725
        except NoSuchFile:
 
726
            return
 
727
        winner = self.scalar_three_way(self.this_tree, self.base_tree, 
 
728
                                       self.other_tree, file_id, 
 
729
                                       self.executable)
956
730
        if winner == "conflict":
957
731
        # There must be a None in here, if we have a conflict, but we
958
732
        # need executability since file status was not deleted.
960
734
                winner = "this"
961
735
            else:
962
736
                winner = "other"
963
 
        if winner == 'this' and file_status != "modified":
964
 
            return
965
 
        trans_id = self.tt.trans_id_file_id(file_id)
966
 
        try:
967
 
            if self.tt.final_kind(trans_id) != "file":
968
 
                return
969
 
        except NoSuchFile:
970
 
            return
971
737
        if winner == "this":
972
 
            executability = this_executable
 
738
            if file_status == "modified":
 
739
                executability = self.this_tree.is_executable(file_id)
 
740
                if executability is not None:
 
741
                    trans_id = self.tt.trans_id_file_id(file_id)
 
742
                    self.tt.set_executability(executability, trans_id)
973
743
        else:
 
744
            assert winner == "other"
974
745
            if file_id in self.other_tree:
975
 
                executability = other_executable
 
746
                executability = self.other_tree.is_executable(file_id)
976
747
            elif file_id in self.this_tree:
977
 
                executability = this_executable
 
748
                executability = self.this_tree.is_executable(file_id)
978
749
            elif file_id in self.base_tree:
979
 
                executability = base_executable
980
 
        if executability is not None:
981
 
            trans_id = self.tt.trans_id_file_id(file_id)
982
 
            self.tt.set_executability(executability, trans_id)
 
750
                executability = self.base_tree.is_executable(file_id)
 
751
            if executability is not None:
 
752
                trans_id = self.tt.trans_id_file_id(file_id)
 
753
                self.tt.set_executability(executability, trans_id)
983
754
 
984
755
    def cook_conflicts(self, fs_conflicts):
985
756
        """Convert all conflicts into a form that doesn't depend on trans_id"""
1018
789
        for trans_id, conflicts in name_conflicts.iteritems():
1019
790
            try:
1020
791
                this_parent, other_parent = conflicts['parent conflict']
1021
 
                if this_parent == other_parent:
1022
 
                    raise AssertionError()
 
792
                assert this_parent != other_parent
1023
793
            except KeyError:
1024
794
                this_parent = other_parent = \
1025
795
                    self.tt.final_file_id(self.tt.final_parent(trans_id))
1026
796
            try:
1027
797
                this_name, other_name = conflicts['name conflict']
1028
 
                if this_name == other_name:
1029
 
                    raise AssertionError()
 
798
                assert this_name != other_name
1030
799
            except KeyError:
1031
800
                this_name = other_name = self.tt.final_name(trans_id)
1032
801
            other_path = fp.get_path(trans_id)
1033
 
            if this_parent is not None and this_name is not None:
 
802
            if this_parent is not None:
1034
803
                this_parent_path = \
1035
804
                    fp.get_path(self.tt.trans_id_file_id(this_parent))
1036
805
                this_path = pathjoin(this_parent_path, this_name)
1047
816
    """Three-way tree merger, text weave merger."""
1048
817
    supports_reprocess = True
1049
818
    supports_show_base = False
1050
 
    supports_reverse_cherrypick = False
1051
 
    history_based = True
 
819
 
 
820
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
 
821
                 interesting_ids=None, pb=DummyProgress(), pp=None,
 
822
                 reprocess=False):
 
823
        self.this_revision_tree = self._get_revision_tree(this_tree)
 
824
        self.other_revision_tree = self._get_revision_tree(other_tree)
 
825
        super(WeaveMerger, self).__init__(working_tree, this_tree, 
 
826
                                          base_tree, other_tree, 
 
827
                                          interesting_ids=interesting_ids, 
 
828
                                          pb=pb, pp=pp, reprocess=reprocess)
 
829
 
 
830
    def _get_revision_tree(self, tree):
 
831
        """Return a revision tree related to this tree.
 
832
        If the tree is a WorkingTree, the basis will be returned.
 
833
        """
 
834
        if getattr(tree, 'get_weave', False) is False:
 
835
            # If we have a WorkingTree, try using the basis
 
836
            return tree.branch.basis_tree()
 
837
        else:
 
838
            return tree
 
839
 
 
840
    def _check_file(self, file_id):
 
841
        """Check that the revision tree's version of the file matches."""
 
842
        for tree, rt in ((self.this_tree, self.this_revision_tree), 
 
843
                         (self.other_tree, self.other_revision_tree)):
 
844
            if rt is tree:
 
845
                continue
 
846
            if tree.get_file_sha1(file_id) != rt.get_file_sha1(file_id):
 
847
                raise WorkingTreeNotRevision(self.this_tree)
1052
848
 
1053
849
    def _merged_lines(self, file_id):
1054
850
        """Generate the merged lines.
1055
851
        There is no distinction between lines that are meant to contain <<<<<<<
1056
852
        and conflicts.
1057
853
        """
1058
 
        if self.cherrypick:
1059
 
            base = self.base_tree
1060
 
        else:
1061
 
            base = None
1062
 
        plan = self.this_tree.plan_file_merge(file_id, self.other_tree,
1063
 
                                              base=base)
1064
 
        if 'merge' in debug.debug_flags:
1065
 
            plan = list(plan)
1066
 
            trans_id = self.tt.trans_id_file_id(file_id)
1067
 
            name = self.tt.final_name(trans_id) + '.plan'
1068
 
            contents = ('%10s|%s' % l for l in plan)
1069
 
            self.tt.new_file(name, self.tt.final_parent(trans_id), contents)
1070
 
        textmerge = PlanWeaveMerge(plan, '<<<<<<< TREE\n',
1071
 
            '>>>>>>> MERGE-SOURCE\n')
1072
 
        return textmerge.merge_lines(self.reprocess)
 
854
        weave = self.this_revision_tree.get_weave(file_id)
 
855
        this_revision_id = self.this_revision_tree.inventory[file_id].revision
 
856
        other_revision_id = \
 
857
            self.other_revision_tree.inventory[file_id].revision
 
858
        wm = WeaveMerge(weave, this_revision_id, other_revision_id, 
 
859
                        '<<<<<<< TREE\n', '>>>>>>> MERGE-SOURCE\n')
 
860
        return wm.merge_lines(self.reprocess)
1073
861
 
1074
862
    def text_merge(self, file_id, trans_id):
1075
863
        """Perform a (weave) text merge for a given file and file-id.
1076
864
        If conflicts are encountered, .THIS and .OTHER files will be emitted,
1077
865
        and a conflict will be noted.
1078
866
        """
 
867
        self._check_file(file_id)
1079
868
        lines, conflicts = self._merged_lines(file_id)
1080
869
        lines = list(lines)
1081
870
        # Note we're checking whether the OUTPUT is binary in this case, 
1091
880
            file_group.append(trans_id)
1092
881
 
1093
882
 
1094
 
class LCAMerger(WeaveMerger):
1095
 
 
1096
 
    def _merged_lines(self, file_id):
1097
 
        """Generate the merged lines.
1098
 
        There is no distinction between lines that are meant to contain <<<<<<<
1099
 
        and conflicts.
1100
 
        """
1101
 
        if self.cherrypick:
1102
 
            base = self.base_tree
1103
 
        else:
1104
 
            base = None
1105
 
        plan = self.this_tree.plan_file_lca_merge(file_id, self.other_tree,
1106
 
                                                  base=base)
1107
 
        if 'merge' in debug.debug_flags:
1108
 
            plan = list(plan)
1109
 
            trans_id = self.tt.trans_id_file_id(file_id)
1110
 
            name = self.tt.final_name(trans_id) + '.plan'
1111
 
            contents = ('%10s|%s' % l for l in plan)
1112
 
            self.tt.new_file(name, self.tt.final_parent(trans_id), contents)
1113
 
        textmerge = PlanWeaveMerge(plan, '<<<<<<< TREE\n',
1114
 
            '>>>>>>> MERGE-SOURCE\n')
1115
 
        return textmerge.merge_lines(self.reprocess)
1116
 
 
1117
 
 
1118
883
class Diff3Merger(Merge3Merger):
1119
884
    """Three-way merger using external diff3 for text merging"""
1120
885
 
1159
924
 
1160
925
 
1161
926
def merge_inner(this_branch, other_tree, base_tree, ignore_zero=False,
1162
 
                backup_files=False,
1163
 
                merge_type=Merge3Merger,
1164
 
                interesting_ids=None,
1165
 
                show_base=False,
1166
 
                reprocess=False,
 
927
                backup_files=False, 
 
928
                merge_type=Merge3Merger, 
 
929
                interesting_ids=None, 
 
930
                show_base=False, 
 
931
                reprocess=False, 
1167
932
                other_rev_id=None,
1168
933
                interesting_files=None,
1169
934
                this_tree=None,
1170
 
                pb=DummyProgress(),
1171
 
                change_reporter=None):
 
935
                pb=DummyProgress()):
1172
936
    """Primary interface for merging. 
1173
937
 
1174
938
        typical use is probably 
1176
940
                     branch.get_revision_tree(base_revision))'
1177
941
        """
1178
942
    if this_tree is None:
1179
 
        raise BzrError("bzrlib.merge.merge_inner requires a this_tree "
1180
 
            "parameter as of bzrlib version 0.8.")
1181
 
    merger = Merger(this_branch, other_tree, base_tree, this_tree=this_tree,
1182
 
                    pb=pb, change_reporter=change_reporter)
 
943
        warnings.warn("bzrlib.merge.merge_inner requires a this_tree parameter as of "
 
944
             "bzrlib version 0.8.",
 
945
             DeprecationWarning,
 
946
             stacklevel=2)
 
947
        this_tree = this_branch.bzrdir.open_workingtree()
 
948
    merger = Merger(this_branch, other_tree, base_tree, this_tree=this_tree, 
 
949
                    pb=pb)
1183
950
    merger.backup_files = backup_files
1184
951
    merger.merge_type = merge_type
1185
952
    merger.interesting_ids = interesting_ids
1186
953
    merger.ignore_zero = ignore_zero
1187
954
    if interesting_files:
1188
 
        if interesting_ids:
1189
 
            raise ValueError('Only supply interesting_ids'
1190
 
                             ' or interesting_files')
1191
 
        merger.interesting_files = interesting_files
 
955
        assert not interesting_ids, ('Only supply interesting_ids'
 
956
                                     ' or interesting_files')
 
957
        merger._set_interesting_files(interesting_files)
1192
958
    merger.show_base = show_base
1193
959
    merger.reprocess = reprocess
1194
960
    merger.other_rev_id = other_rev_id
1195
961
    merger.other_basis = other_rev_id
1196
 
    get_revision_id = getattr(base_tree, 'get_revision_id', None)
1197
 
    if get_revision_id is None:
1198
 
        get_revision_id = base_tree.last_revision
1199
 
    merger.set_base_revision(get_revision_id(), this_branch)
1200
962
    return merger.do_merge()
1201
963
 
1202
 
def get_merge_type_registry():
1203
 
    """Merge type registry is in bzrlib.option to avoid circular imports.
1204
 
 
1205
 
    This method provides a sanctioned way to retrieve it.
1206
 
    """
1207
 
    from bzrlib import option
1208
 
    return option._merge_type_registry
1209
 
 
1210
 
 
1211
 
def _plan_annotate_merge(annotated_a, annotated_b, ancestors_a, ancestors_b):
1212
 
    def status_a(revision, text):
1213
 
        if revision in ancestors_b:
1214
 
            return 'killed-b', text
1215
 
        else:
1216
 
            return 'new-a', text
1217
 
 
1218
 
    def status_b(revision, text):
1219
 
        if revision in ancestors_a:
1220
 
            return 'killed-a', text
1221
 
        else:
1222
 
            return 'new-b', text
1223
 
 
1224
 
    plain_a = [t for (a, t) in annotated_a]
1225
 
    plain_b = [t for (a, t) in annotated_b]
1226
 
    matcher = patiencediff.PatienceSequenceMatcher(None, plain_a, plain_b)
1227
 
    blocks = matcher.get_matching_blocks()
1228
 
    a_cur = 0
1229
 
    b_cur = 0
1230
 
    for ai, bi, l in blocks:
1231
 
        # process all mismatched sections
1232
 
        # (last mismatched section is handled because blocks always
1233
 
        # includes a 0-length last block)
1234
 
        for revision, text in annotated_a[a_cur:ai]:
1235
 
            yield status_a(revision, text)
1236
 
        for revision, text in annotated_b[b_cur:bi]:
1237
 
            yield status_b(revision, text)
1238
 
        # and now the matched section
1239
 
        a_cur = ai + l
1240
 
        b_cur = bi + l
1241
 
        for text_a in plain_a[ai:a_cur]:
1242
 
            yield "unchanged", text_a
1243
 
 
1244
 
 
1245
 
class _PlanMergeBase(object):
1246
 
 
1247
 
    def __init__(self, a_rev, b_rev, vf, key_prefix):
1248
 
        """Contructor.
1249
 
 
1250
 
        :param a_rev: Revision-id of one revision to merge
1251
 
        :param b_rev: Revision-id of the other revision to merge
1252
 
        :param vf: A VersionedFiles containing both revisions
1253
 
        :param key_prefix: A prefix for accessing keys in vf, typically
1254
 
            (file_id,).
1255
 
        """
1256
 
        self.a_rev = a_rev
1257
 
        self.b_rev = b_rev
1258
 
        self.vf = vf
1259
 
        self._last_lines = None
1260
 
        self._last_lines_revision_id = None
1261
 
        self._cached_matching_blocks = {}
1262
 
        self._key_prefix = key_prefix
1263
 
        self._precache_tip_lines()
1264
 
 
1265
 
    def _precache_tip_lines(self):
1266
 
        lines = self.get_lines([self.a_rev, self.b_rev])
1267
 
        self.lines_a = lines[self.a_rev]
1268
 
        self.lines_b = lines[self.b_rev]
1269
 
 
1270
 
    def get_lines(self, revisions):
1271
 
        """Get lines for revisions from the backing VersionedFiles.
1272
 
        
1273
 
        :raises RevisionNotPresent: on absent texts.
1274
 
        """
1275
 
        keys = [(self._key_prefix + (rev,)) for rev in revisions]
1276
 
        result = {}
1277
 
        for record in self.vf.get_record_stream(keys, 'unordered', True):
1278
 
            if record.storage_kind == 'absent':
1279
 
                raise errors.RevisionNotPresent(record.key, self.vf)
1280
 
            result[record.key[-1]] = osutils.split_lines(
1281
 
                record.get_bytes_as('fulltext'))
1282
 
        return result
1283
 
 
1284
 
    def plan_merge(self):
1285
 
        """Generate a 'plan' for merging the two revisions.
1286
 
 
1287
 
        This involves comparing their texts and determining the cause of
1288
 
        differences.  If text A has a line and text B does not, then either the
1289
 
        line was added to text A, or it was deleted from B.  Once the causes
1290
 
        are combined, they are written out in the format described in
1291
 
        VersionedFile.plan_merge
1292
 
        """
1293
 
        blocks = self._get_matching_blocks(self.a_rev, self.b_rev)
1294
 
        unique_a, unique_b = self._unique_lines(blocks)
1295
 
        new_a, killed_b = self._determine_status(self.a_rev, unique_a)
1296
 
        new_b, killed_a = self._determine_status(self.b_rev, unique_b)
1297
 
        return self._iter_plan(blocks, new_a, killed_b, new_b, killed_a)
1298
 
 
1299
 
    def _iter_plan(self, blocks, new_a, killed_b, new_b, killed_a):
1300
 
        last_i = 0
1301
 
        last_j = 0
1302
 
        for i, j, n in blocks:
1303
 
            for a_index in range(last_i, i):
1304
 
                if a_index in new_a:
1305
 
                    if a_index in killed_b:
1306
 
                        yield 'conflicted-a', self.lines_a[a_index]
1307
 
                    else:
1308
 
                        yield 'new-a', self.lines_a[a_index]
1309
 
                else:
1310
 
                    yield 'killed-b', self.lines_a[a_index]
1311
 
            for b_index in range(last_j, j):
1312
 
                if b_index in new_b:
1313
 
                    if b_index in killed_a:
1314
 
                        yield 'conflicted-b', self.lines_b[b_index]
1315
 
                    else:
1316
 
                        yield 'new-b', self.lines_b[b_index]
1317
 
                else:
1318
 
                    yield 'killed-a', self.lines_b[b_index]
1319
 
            # handle common lines
1320
 
            for a_index in range(i, i+n):
1321
 
                yield 'unchanged', self.lines_a[a_index]
1322
 
            last_i = i+n
1323
 
            last_j = j+n
1324
 
 
1325
 
    def _get_matching_blocks(self, left_revision, right_revision):
1326
 
        """Return a description of which sections of two revisions match.
1327
 
 
1328
 
        See SequenceMatcher.get_matching_blocks
1329
 
        """
1330
 
        cached = self._cached_matching_blocks.get((left_revision,
1331
 
                                                   right_revision))
1332
 
        if cached is not None:
1333
 
            return cached
1334
 
        if self._last_lines_revision_id == left_revision:
1335
 
            left_lines = self._last_lines
1336
 
            right_lines = self.get_lines([right_revision])[right_revision]
1337
 
        else:
1338
 
            lines = self.get_lines([left_revision, right_revision])
1339
 
            left_lines = lines[left_revision]
1340
 
            right_lines = lines[right_revision]
1341
 
        self._last_lines = right_lines
1342
 
        self._last_lines_revision_id = right_revision
1343
 
        matcher = patiencediff.PatienceSequenceMatcher(None, left_lines,
1344
 
                                                       right_lines)
1345
 
        return matcher.get_matching_blocks()
1346
 
 
1347
 
    def _unique_lines(self, matching_blocks):
1348
 
        """Analyse matching_blocks to determine which lines are unique
1349
 
 
1350
 
        :return: a tuple of (unique_left, unique_right), where the values are
1351
 
            sets of line numbers of unique lines.
1352
 
        """
1353
 
        last_i = 0
1354
 
        last_j = 0
1355
 
        unique_left = []
1356
 
        unique_right = []
1357
 
        for i, j, n in matching_blocks:
1358
 
            unique_left.extend(range(last_i, i))
1359
 
            unique_right.extend(range(last_j, j))
1360
 
            last_i = i + n
1361
 
            last_j = j + n
1362
 
        return unique_left, unique_right
1363
 
 
1364
 
    @staticmethod
1365
 
    def _subtract_plans(old_plan, new_plan):
1366
 
        """Remove changes from new_plan that came from old_plan.
1367
 
 
1368
 
        It is assumed that the difference between the old_plan and new_plan
1369
 
        is their choice of 'b' text.
1370
 
 
1371
 
        All lines from new_plan that differ from old_plan are emitted
1372
 
        verbatim.  All lines from new_plan that match old_plan but are
1373
 
        not about the 'b' revision are emitted verbatim.
1374
 
 
1375
 
        Lines that match and are about the 'b' revision are the lines we
1376
 
        don't want, so we convert 'killed-b' -> 'unchanged', and 'new-b'
1377
 
        is skipped entirely.
1378
 
        """
1379
 
        matcher = patiencediff.PatienceSequenceMatcher(None, old_plan,
1380
 
                                                       new_plan)
1381
 
        last_j = 0
1382
 
        for i, j, n in matcher.get_matching_blocks():
1383
 
            for jj in range(last_j, j):
1384
 
                yield new_plan[jj]
1385
 
            for jj in range(j, j+n):
1386
 
                plan_line = new_plan[jj]
1387
 
                if plan_line[0] == 'new-b':
1388
 
                    pass
1389
 
                elif plan_line[0] == 'killed-b':
1390
 
                    yield 'unchanged', plan_line[1]
1391
 
                else:
1392
 
                    yield plan_line
1393
 
            last_j = j + n
1394
 
 
1395
 
 
1396
 
class _PlanMerge(_PlanMergeBase):
1397
 
    """Plan an annotate merge using on-the-fly annotation"""
1398
 
 
1399
 
    def __init__(self, a_rev, b_rev, vf, key_prefix):
1400
 
        super(_PlanMerge, self).__init__(a_rev, b_rev, vf, key_prefix)
1401
 
        self.a_key = self._key_prefix + (self.a_rev,)
1402
 
        self.b_key = self._key_prefix + (self.b_rev,)
1403
 
        self.graph = Graph(self.vf)
1404
 
        heads = self.graph.heads((self.a_key, self.b_key))
1405
 
        if len(heads) == 1:
1406
 
            # one side dominates, so we can just return its values, yay for
1407
 
            # per-file graphs
1408
 
            # Ideally we would know that before we get this far
1409
 
            self._head_key = heads.pop()
1410
 
            if self._head_key == self.a_key:
1411
 
                other = b_rev
1412
 
            else:
1413
 
                other = a_rev
1414
 
            mutter('found dominating revision for %s\n%s > %s', self.vf,
1415
 
                   self._head_key[-1], other)
1416
 
            self._weave = None
1417
 
        else:
1418
 
            self._head_key = None
1419
 
            self._build_weave()
1420
 
 
1421
 
    def _precache_tip_lines(self):
1422
 
        # Turn this into a no-op, because we will do this later
1423
 
        pass
1424
 
 
1425
 
    def _find_recursive_lcas(self):
1426
 
        """Find all the ancestors back to a unique lca"""
1427
 
        cur_ancestors = (self.a_key, self.b_key)
1428
 
        # graph.find_lca(uncommon, keys) now returns plain NULL_REVISION,
1429
 
        # rather than a key tuple. We will just map that directly to no common
1430
 
        # ancestors.
1431
 
        parent_map = {}
1432
 
        while True:
1433
 
            next_lcas = self.graph.find_lca(*cur_ancestors)
1434
 
            # Map a plain NULL_REVISION to a simple no-ancestors
1435
 
            if next_lcas == set([NULL_REVISION]):
1436
 
                next_lcas = ()
1437
 
            # Order the lca's based on when they were merged into the tip
1438
 
            # While the actual merge portion of weave merge uses a set() of
1439
 
            # active revisions, the order of insertion *does* effect the
1440
 
            # implicit ordering of the texts.
1441
 
            for rev_key in cur_ancestors:
1442
 
                ordered_parents = tuple(self.graph.find_merge_order(rev_key,
1443
 
                                                                    next_lcas))
1444
 
                parent_map[rev_key] = ordered_parents
1445
 
            if len(next_lcas) == 0:
1446
 
                break
1447
 
            elif len(next_lcas) == 1:
1448
 
                parent_map[list(next_lcas)[0]] = ()
1449
 
                break
1450
 
            elif len(next_lcas) > 2:
1451
 
                # More than 2 lca's, fall back to grabbing all nodes between
1452
 
                # this and the unique lca.
1453
 
                mutter('More than 2 LCAs, falling back to all nodes for:'
1454
 
                       ' %s, %s\n=> %s', self.a_key, self.b_key, cur_ancestors)
1455
 
                cur_lcas = next_lcas
1456
 
                while len(cur_lcas) > 1:
1457
 
                    cur_lcas = self.graph.find_lca(*cur_lcas)
1458
 
                if len(cur_lcas) == 0:
1459
 
                    # No common base to find, use the full ancestry
1460
 
                    unique_lca = None
1461
 
                else:
1462
 
                    unique_lca = list(cur_lcas)[0]
1463
 
                    if unique_lca == NULL_REVISION:
1464
 
                        # find_lca will return a plain 'NULL_REVISION' rather
1465
 
                        # than a key tuple when there is no common ancestor, we
1466
 
                        # prefer to just use None, because it doesn't confuse
1467
 
                        # _get_interesting_texts()
1468
 
                        unique_lca = None
1469
 
                parent_map.update(self._find_unique_parents(next_lcas,
1470
 
                                                            unique_lca))
1471
 
                break
1472
 
            cur_ancestors = next_lcas
1473
 
        return parent_map
1474
 
 
1475
 
    def _find_unique_parents(self, tip_keys, base_key):
1476
 
        """Find ancestors of tip that aren't ancestors of base.
1477
 
        
1478
 
        :param tip_keys: Nodes that are interesting
1479
 
        :param base_key: Cull all ancestors of this node
1480
 
        :return: The parent map for all revisions between tip_keys and
1481
 
            base_key. base_key will be included. References to nodes outside of
1482
 
            the ancestor set will also be removed.
1483
 
        """
1484
 
        # TODO: this would be simpler if find_unique_ancestors took a list
1485
 
        #       instead of a single tip, internally it supports it, but it
1486
 
        #       isn't a "backwards compatible" api change.
1487
 
        if base_key is None:
1488
 
            parent_map = dict(self.graph.iter_ancestry(tip_keys))
1489
 
            # We remove NULL_REVISION because it isn't a proper tuple key, and
1490
 
            # thus confuses things like _get_interesting_texts, and our logic
1491
 
            # to add the texts into the memory weave.
1492
 
            if NULL_REVISION in parent_map:
1493
 
                parent_map.pop(NULL_REVISION)
1494
 
        else:
1495
 
            interesting = set()
1496
 
            for tip in tip_keys:
1497
 
                interesting.update(
1498
 
                    self.graph.find_unique_ancestors(tip, [base_key]))
1499
 
            parent_map = self.graph.get_parent_map(interesting)
1500
 
            parent_map[base_key] = ()
1501
 
        culled_parent_map, child_map, tails = self._remove_external_references(
1502
 
            parent_map)
1503
 
        # Remove all the tails but base_key
1504
 
        if base_key is not None:
1505
 
            tails.remove(base_key)
1506
 
            self._prune_tails(culled_parent_map, child_map, tails)
1507
 
        # Now remove all the uninteresting 'linear' regions
1508
 
        simple_map = _mod_graph.collapse_linear_regions(culled_parent_map)
1509
 
        return simple_map
1510
 
 
1511
 
    @staticmethod
1512
 
    def _remove_external_references(parent_map):
1513
 
        """Remove references that go outside of the parent map.
1514
 
 
1515
 
        :param parent_map: Something returned from Graph.get_parent_map(keys)
1516
 
        :return: (filtered_parent_map, child_map, tails)
1517
 
            filtered_parent_map is parent_map without external references
1518
 
            child_map is the {parent_key: [child_keys]} mapping
1519
 
            tails is a list of nodes that do not have any parents in the map
1520
 
        """
1521
 
        # TODO: The basic effect of this function seems more generic than
1522
 
        #       _PlanMerge. But the specific details of building a child_map,
1523
 
        #       and computing tails seems very specific to _PlanMerge.
1524
 
        #       Still, should this be in Graph land?
1525
 
        filtered_parent_map = {}
1526
 
        child_map = {}
1527
 
        tails = []
1528
 
        for key, parent_keys in parent_map.iteritems():
1529
 
            culled_parent_keys = [p for p in parent_keys if p in parent_map]
1530
 
            if not culled_parent_keys:
1531
 
                tails.append(key)
1532
 
            for parent_key in culled_parent_keys:
1533
 
                child_map.setdefault(parent_key, []).append(key)
1534
 
            # TODO: Do we want to do this, it adds overhead for every node,
1535
 
            #       just to say that the node has no children
1536
 
            child_map.setdefault(key, [])
1537
 
            filtered_parent_map[key] = culled_parent_keys
1538
 
        return filtered_parent_map, child_map, tails
1539
 
 
1540
 
    @staticmethod
1541
 
    def _prune_tails(parent_map, child_map, tails_to_remove):
1542
 
        """Remove tails from the parent map.
1543
 
        
1544
 
        This will remove the supplied revisions until no more children have 0
1545
 
        parents.
1546
 
 
1547
 
        :param parent_map: A dict of {child: [parents]}, this dictionary will
1548
 
            be modified in place.
1549
 
        :param tails_to_remove: A list of tips that should be removed,
1550
 
            this list will be consumed
1551
 
        :param child_map: The reverse dict of parent_map ({parent: [children]})
1552
 
            this dict will be modified
1553
 
        :return: None, parent_map will be modified in place.
1554
 
        """
1555
 
        while tails_to_remove:
1556
 
            next = tails_to_remove.pop()
1557
 
            parent_map.pop(next)
1558
 
            children = child_map.pop(next)
1559
 
            for child in children:
1560
 
                child_parents = parent_map[child]
1561
 
                child_parents.remove(next)
1562
 
                if len(child_parents) == 0:
1563
 
                    tails_to_remove.append(child)
1564
 
 
1565
 
    def _get_interesting_texts(self, parent_map):
1566
 
        """Return a dict of texts we are interested in.
1567
 
 
1568
 
        Note that the input is in key tuples, but the output is in plain
1569
 
        revision ids.
1570
 
 
1571
 
        :param parent_map: The output from _find_recursive_lcas
1572
 
        :return: A dict of {'revision_id':lines} as returned by
1573
 
            _PlanMergeBase.get_lines()
1574
 
        """
1575
 
        all_revision_keys = set(parent_map)
1576
 
        all_revision_keys.add(self.a_key)
1577
 
        all_revision_keys.add(self.b_key)
1578
 
 
1579
 
        # Everything else is in 'keys' but get_lines is in 'revision_ids'
1580
 
        all_texts = self.get_lines([k[-1] for k in all_revision_keys])
1581
 
        return all_texts
1582
 
 
1583
 
    def _build_weave(self):
1584
 
        from bzrlib import weave
1585
 
        self._weave = weave.Weave(weave_name='in_memory_weave',
1586
 
                                  allow_reserved=True)
1587
 
        parent_map = self._find_recursive_lcas()
1588
 
 
1589
 
        all_texts = self._get_interesting_texts(parent_map)
1590
 
 
1591
 
        # Note: Unfortunately, the order given by topo_sort will effect the
1592
 
        # ordering resolution in the output. Specifically, if you add A then B,
1593
 
        # then in the output text A lines will show up before B lines. And, of
1594
 
        # course, topo_sort doesn't guarantee any real ordering.
1595
 
        # So we use merge_sort, and add a fake node on the tip.
1596
 
        # This ensures that left-hand parents will always be inserted into the
1597
 
        # weave before right-hand parents.
1598
 
        tip_key = self._key_prefix + (_mod_revision.CURRENT_REVISION,)
1599
 
        parent_map[tip_key] = (self.a_key, self.b_key)
1600
 
 
1601
 
        for seq_num, key, depth, eom in reversed(tsort.merge_sort(parent_map,
1602
 
                                                                  tip_key)):
1603
 
            if key == tip_key:
1604
 
                continue
1605
 
        # for key in tsort.topo_sort(parent_map):
1606
 
            parent_keys = parent_map[key]
1607
 
            revision_id = key[-1]
1608
 
            parent_ids = [k[-1] for k in parent_keys]
1609
 
            self._weave.add_lines(revision_id, parent_ids,
1610
 
                                  all_texts[revision_id])
1611
 
 
1612
 
    def plan_merge(self):
1613
 
        """Generate a 'plan' for merging the two revisions.
1614
 
 
1615
 
        This involves comparing their texts and determining the cause of
1616
 
        differences.  If text A has a line and text B does not, then either the
1617
 
        line was added to text A, or it was deleted from B.  Once the causes
1618
 
        are combined, they are written out in the format described in
1619
 
        VersionedFile.plan_merge
1620
 
        """
1621
 
        if self._head_key is not None: # There was a single head
1622
 
            if self._head_key == self.a_key:
1623
 
                plan = 'new-a'
1624
 
            else:
1625
 
                if self._head_key != self.b_key:
1626
 
                    raise AssertionError('There was an invalid head: %s != %s'
1627
 
                                         % (self.b_key, self._head_key))
1628
 
                plan = 'new-b'
1629
 
            head_rev = self._head_key[-1]
1630
 
            lines = self.get_lines([head_rev])[head_rev]
1631
 
            return ((plan, line) for line in lines)
1632
 
        return self._weave.plan_merge(self.a_rev, self.b_rev)
1633
 
 
1634
 
 
1635
 
class _PlanLCAMerge(_PlanMergeBase):
1636
 
    """
1637
 
    This merge algorithm differs from _PlanMerge in that:
1638
 
    1. comparisons are done against LCAs only
1639
 
    2. cases where a contested line is new versus one LCA but old versus
1640
 
       another are marked as conflicts, by emitting the line as conflicted-a
1641
 
       or conflicted-b.
1642
 
 
1643
 
    This is faster, and hopefully produces more useful output.
1644
 
    """
1645
 
 
1646
 
    def __init__(self, a_rev, b_rev, vf, key_prefix, graph):
1647
 
        _PlanMergeBase.__init__(self, a_rev, b_rev, vf, key_prefix)
1648
 
        lcas = graph.find_lca(key_prefix + (a_rev,), key_prefix + (b_rev,))
1649
 
        self.lcas = set()
1650
 
        for lca in lcas:
1651
 
            if lca == NULL_REVISION:
1652
 
                self.lcas.add(lca)
1653
 
            else:
1654
 
                self.lcas.add(lca[-1])
1655
 
        for lca in self.lcas:
1656
 
            if _mod_revision.is_null(lca):
1657
 
                lca_lines = []
1658
 
            else:
1659
 
                lca_lines = self.get_lines([lca])[lca]
1660
 
            matcher = patiencediff.PatienceSequenceMatcher(None, self.lines_a,
1661
 
                                                           lca_lines)
1662
 
            blocks = list(matcher.get_matching_blocks())
1663
 
            self._cached_matching_blocks[(a_rev, lca)] = blocks
1664
 
            matcher = patiencediff.PatienceSequenceMatcher(None, self.lines_b,
1665
 
                                                           lca_lines)
1666
 
            blocks = list(matcher.get_matching_blocks())
1667
 
            self._cached_matching_blocks[(b_rev, lca)] = blocks
1668
 
 
1669
 
    def _determine_status(self, revision_id, unique_line_numbers):
1670
 
        """Determines the status unique lines versus all lcas.
1671
 
 
1672
 
        Basically, determines why the line is unique to this revision.
1673
 
 
1674
 
        A line may be determined new, killed, or both.
1675
 
 
1676
 
        If a line is determined new, that means it was not present in at least
1677
 
        one LCA, and is not present in the other merge revision.
1678
 
 
1679
 
        If a line is determined killed, that means the line was present in
1680
 
        at least one LCA.
1681
 
 
1682
 
        If a line is killed and new, this indicates that the two merge
1683
 
        revisions contain differing conflict resolutions.
1684
 
        :param revision_id: The id of the revision in which the lines are
1685
 
            unique
1686
 
        :param unique_line_numbers: The line numbers of unique lines.
1687
 
        :return a tuple of (new_this, killed_other):
1688
 
        """
1689
 
        new = set()
1690
 
        killed = set()
1691
 
        unique_line_numbers = set(unique_line_numbers)
1692
 
        for lca in self.lcas:
1693
 
            blocks = self._get_matching_blocks(revision_id, lca)
1694
 
            unique_vs_lca, _ignored = self._unique_lines(blocks)
1695
 
            new.update(unique_line_numbers.intersection(unique_vs_lca))
1696
 
            killed.update(unique_line_numbers.difference(unique_vs_lca))
1697
 
        return new, killed
 
964
 
 
965
merge_types = {     "merge3": (Merge3Merger, "Native diff3-style merge"), 
 
966
                     "diff3": (Diff3Merger,  "Merge using external diff3"),
 
967
                     'weave': (WeaveMerger, "Weave-based merge")
 
968
              }
 
969
 
 
970
 
 
971
def merge_type_help():
 
972
    templ = '%s%%7s: %%s' % (' '*12)
 
973
    lines = [templ % (f[0], f[1][1]) for f in merge_types.iteritems()]
 
974
    return '\n'.join(lines)