~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/merge.py

  • Committer: Andrew Bennetts
  • Date: 2010-06-25 06:47:40 UTC
  • mto: (5050.3.16 2.2)
  • mto: This revision was merged to the branch mainline in revision 5365.
  • Revision ID: andrew.bennetts@canonical.com-20100625064740-k93ngat248kdcqdm
Remove merge_into_helper for now, as it currently has no callers.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006, 2008 Canonical Ltd
 
1
# Copyright (C) 2005-2010 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
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
 
 
17
 
 
18
 
import errno
19
 
from itertools import chain
20
 
import os
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
16
 
21
17
import warnings
22
18
 
 
19
from bzrlib.lazy_import import lazy_import
 
20
lazy_import(globals(), """
23
21
from bzrlib import (
 
22
    branch as _mod_branch,
 
23
    conflicts as _mod_conflicts,
24
24
    debug,
25
 
    errors,
 
25
    generate_ids,
26
26
    graph as _mod_graph,
 
27
    merge3,
27
28
    osutils,
28
29
    patiencediff,
29
 
    registry,
30
30
    revision as _mod_revision,
 
31
    textfile,
 
32
    trace,
 
33
    transform,
31
34
    tree as _mod_tree,
32
35
    tsort,
33
 
    )
34
 
from bzrlib.branch import Branch
35
 
from bzrlib.conflicts import ConflictList, Conflict
36
 
from bzrlib.errors import (BzrCommandError,
37
 
                           BzrError,
38
 
                           NoCommonAncestor,
39
 
                           NoCommits,
40
 
                           NoSuchRevision,
41
 
                           NoSuchFile,
42
 
                           NotBranchError,
43
 
                           NotVersionedError,
44
 
                           UnrelatedBranches,
45
 
                           UnsupportedOperation,
46
 
                           WorkingTreeNotRevision,
47
 
                           BinaryFile,
48
 
                           )
49
 
from bzrlib.graph import Graph
50
 
from bzrlib.merge3 import Merge3
51
 
from bzrlib.osutils import rename, pathjoin
52
 
from progress import DummyProgress, ProgressPhase
53
 
from bzrlib.revision import (NULL_REVISION, ensure_null)
54
 
from bzrlib.textfile import check_text_lines
55
 
from bzrlib.trace import mutter, warning, note, is_quiet
56
 
from bzrlib.transform import (TransformPreview, TreeTransform,
57
 
                              resolve_conflicts, cook_conflicts,
58
 
                              conflict_pass, FinalPaths, create_from_tree,
59
 
                              unique_add, ROOT_PARENT)
60
 
from bzrlib.versionedfile import PlanWeaveMerge
61
 
from bzrlib import ui
62
 
 
 
36
    ui,
 
37
    versionedfile,
 
38
    workingtree,
 
39
    )
 
40
from bzrlib.cleanup import OperationWithCleanups
 
41
""")
 
42
from bzrlib import (
 
43
    decorators,
 
44
    errors,
 
45
    hooks,
 
46
    )
 
47
from bzrlib.symbol_versioning import (
 
48
    deprecated_in,
 
49
    deprecated_method,
 
50
    )
63
51
# TODO: Report back as changes are merged in
64
52
 
65
53
 
66
54
def transform_tree(from_tree, to_tree, interesting_ids=None):
67
 
    merge_inner(from_tree.branch, to_tree, from_tree, ignore_zero=True,
68
 
                interesting_ids=interesting_ids, this_tree=from_tree)
 
55
    from_tree.lock_tree_write()
 
56
    operation = OperationWithCleanups(merge_inner)
 
57
    operation.add_cleanup(from_tree.unlock)
 
58
    operation.run_simple(from_tree.branch, to_tree, from_tree,
 
59
        ignore_zero=True, interesting_ids=interesting_ids, this_tree=from_tree)
 
60
 
 
61
 
 
62
class MergeHooks(hooks.Hooks):
 
63
 
 
64
    def __init__(self):
 
65
        hooks.Hooks.__init__(self)
 
66
        self.create_hook(hooks.HookPoint('merge_file_content',
 
67
            "Called with a bzrlib.merge.Merger object to create a per file "
 
68
            "merge object when starting a merge. "
 
69
            "Should return either None or a subclass of "
 
70
            "``bzrlib.merge.AbstractPerFileMerger``. "
 
71
            "Such objects will then be called per file "
 
72
            "that needs to be merged (including when one "
 
73
            "side has deleted the file and the other has changed it). "
 
74
            "See the AbstractPerFileMerger API docs for details on how it is "
 
75
            "used by merge.",
 
76
            (2, 1), None))
 
77
 
 
78
 
 
79
class AbstractPerFileMerger(object):
 
80
    """PerFileMerger objects are used by plugins extending merge for bzrlib.
 
81
 
 
82
    See ``bzrlib.plugins.news_merge.news_merge`` for an example concrete class.
 
83
    
 
84
    :ivar merger: The Merge3Merger performing the merge.
 
85
    """
 
86
 
 
87
    def __init__(self, merger):
 
88
        """Create a PerFileMerger for use with merger."""
 
89
        self.merger = merger
 
90
 
 
91
    def merge_contents(self, merge_params):
 
92
        """Attempt to merge the contents of a single file.
 
93
        
 
94
        :param merge_params: A bzrlib.merge.MergeHookParams
 
95
        :return : A tuple of (status, chunks), where status is one of
 
96
            'not_applicable', 'success', 'conflicted', or 'delete'.  If status
 
97
            is 'success' or 'conflicted', then chunks should be an iterable of
 
98
            strings for the new file contents.
 
99
        """
 
100
        return ('not applicable', None)
 
101
 
 
102
 
 
103
class PerFileMerger(AbstractPerFileMerger):
 
104
    """Merge individual files when self.file_matches returns True.
 
105
 
 
106
    This class is intended to be subclassed.  The file_matches and
 
107
    merge_matching methods should be overridden with concrete implementations.
 
108
    """
 
109
 
 
110
    def file_matches(self, params):
 
111
        """Return True if merge_matching should be called on this file.
 
112
 
 
113
        Only called with merges of plain files with no clear winner.
 
114
 
 
115
        Subclasses must override this.
 
116
        """
 
117
        raise NotImplementedError(self.file_matches)
 
118
 
 
119
    def get_filename(self, params, tree):
 
120
        """Lookup the filename (i.e. basename, not path), given a Tree (e.g.
 
121
        self.merger.this_tree) and a MergeHookParams.
 
122
        """
 
123
        return osutils.basename(tree.id2path(params.file_id))
 
124
 
 
125
    def get_filepath(self, params, tree):
 
126
        """Calculate the path to the file in a tree.
 
127
 
 
128
        :param params: A MergeHookParams describing the file to merge
 
129
        :param tree: a Tree, e.g. self.merger.this_tree.
 
130
        """
 
131
        return tree.id2path(params.file_id)
 
132
 
 
133
    def merge_contents(self, params):
 
134
        """Merge the contents of a single file."""
 
135
        # Check whether this custom merge logic should be used.
 
136
        if (
 
137
            # OTHER is a straight winner, rely on default merge.
 
138
            params.winner == 'other' or
 
139
            # THIS and OTHER aren't both files.
 
140
            not params.is_file_merge() or
 
141
            # The filename doesn't match *.xml
 
142
            not self.file_matches(params)):
 
143
            return 'not_applicable', None
 
144
        return self.merge_matching(params)
 
145
 
 
146
    def merge_matching(self, params):
 
147
        """Merge the contents of a single file that has matched the criteria
 
148
        in PerFileMerger.merge_contents (is a conflict, is a file,
 
149
        self.file_matches is True).
 
150
 
 
151
        Subclasses must override this.
 
152
        """
 
153
        raise NotImplementedError(self.merge_matching)
 
154
 
 
155
 
 
156
class ConfigurableFileMerger(PerFileMerger):
 
157
    """Merge individual files when configured via a .conf file.
 
158
 
 
159
    This is a base class for concrete custom file merging logic. Concrete
 
160
    classes should implement ``merge_text``.
 
161
 
 
162
    See ``bzrlib.plugins.news_merge.news_merge`` for an example concrete class.
 
163
    
 
164
    :ivar affected_files: The configured file paths to merge.
 
165
 
 
166
    :cvar name_prefix: The prefix to use when looking up configuration
 
167
        details. <name_prefix>_merge_files describes the files targeted by the
 
168
        hook for example.
 
169
        
 
170
    :cvar default_files: The default file paths to merge when no configuration
 
171
        is present.
 
172
    """
 
173
 
 
174
    name_prefix = None
 
175
    default_files = None
 
176
 
 
177
    def __init__(self, merger):
 
178
        super(ConfigurableFileMerger, self).__init__(merger)
 
179
        self.affected_files = None
 
180
        self.default_files = self.__class__.default_files or []
 
181
        self.name_prefix = self.__class__.name_prefix
 
182
        if self.name_prefix is None:
 
183
            raise ValueError("name_prefix must be set.")
 
184
 
 
185
    def file_matches(self, params):
 
186
        """Check whether the file should call the merge hook.
 
187
 
 
188
        <name_prefix>_merge_files configuration variable is a list of files
 
189
        that should use the hook.
 
190
        """
 
191
        affected_files = self.affected_files
 
192
        if affected_files is None:
 
193
            config = self.merger.this_branch.get_config()
 
194
            # Until bzr provides a better policy for caching the config, we
 
195
            # just add the part we're interested in to the params to avoid
 
196
            # reading the config files repeatedly (bazaar.conf, location.conf,
 
197
            # branch.conf).
 
198
            config_key = self.name_prefix + '_merge_files'
 
199
            affected_files = config.get_user_option_as_list(config_key)
 
200
            if affected_files is None:
 
201
                # If nothing was specified in the config, use the default.
 
202
                affected_files = self.default_files
 
203
            self.affected_files = affected_files
 
204
        if affected_files:
 
205
            filepath = self.get_filepath(params, self.merger.this_tree)
 
206
            if filepath in affected_files:
 
207
                return True
 
208
        return False
 
209
 
 
210
    def merge_matching(self, params):
 
211
        return self.merge_text(params)
 
212
 
 
213
    def merge_text(self, params):
 
214
        """Merge the byte contents of a single file.
 
215
 
 
216
        This is called after checking that the merge should be performed in
 
217
        merge_contents, and it should behave as per
 
218
        ``bzrlib.merge.AbstractPerFileMerger.merge_contents``.
 
219
        """
 
220
        raise NotImplementedError(self.merge_text)
 
221
 
 
222
 
 
223
class MergeHookParams(object):
 
224
    """Object holding parameters passed to merge_file_content hooks.
 
225
 
 
226
    There are some fields hooks can access:
 
227
 
 
228
    :ivar file_id: the file ID of the file being merged
 
229
    :ivar trans_id: the transform ID for the merge of this file
 
230
    :ivar this_kind: kind of file_id in 'this' tree
 
231
    :ivar other_kind: kind of file_id in 'other' tree
 
232
    :ivar winner: one of 'this', 'other', 'conflict'
 
233
    """
 
234
 
 
235
    def __init__(self, merger, file_id, trans_id, this_kind, other_kind,
 
236
            winner):
 
237
        self._merger = merger
 
238
        self.file_id = file_id
 
239
        self.trans_id = trans_id
 
240
        self.this_kind = this_kind
 
241
        self.other_kind = other_kind
 
242
        self.winner = winner
 
243
 
 
244
    def is_file_merge(self):
 
245
        """True if this_kind and other_kind are both 'file'."""
 
246
        return self.this_kind == 'file' and self.other_kind == 'file'
 
247
 
 
248
    @decorators.cachedproperty
 
249
    def base_lines(self):
 
250
        """The lines of the 'base' version of the file."""
 
251
        return self._merger.get_lines(self._merger.base_tree, self.file_id)
 
252
 
 
253
    @decorators.cachedproperty
 
254
    def this_lines(self):
 
255
        """The lines of the 'this' version of the file."""
 
256
        return self._merger.get_lines(self._merger.this_tree, self.file_id)
 
257
 
 
258
    @decorators.cachedproperty
 
259
    def other_lines(self):
 
260
        """The lines of the 'other' version of the file."""
 
261
        return self._merger.get_lines(self._merger.other_tree, self.file_id)
69
262
 
70
263
 
71
264
class Merger(object):
 
265
 
 
266
    hooks = MergeHooks()
 
267
 
72
268
    def __init__(self, this_branch, other_tree=None, base_tree=None,
73
 
                 this_tree=None, pb=DummyProgress(), change_reporter=None,
 
269
                 this_tree=None, pb=None, change_reporter=None,
74
270
                 recurse='down', revision_graph=None):
75
271
        object.__init__(self)
76
272
        self.this_branch = this_branch
89
285
        self.interesting_files = None
90
286
        self.show_base = False
91
287
        self.reprocess = False
92
 
        self._pb = pb
 
288
        if pb is not None:
 
289
            warnings.warn("pb parameter to Merger() is deprecated and ignored")
93
290
        self.pp = None
94
291
        self.recurse = recurse
95
292
        self.change_reporter = change_reporter
100
297
        self._is_criss_cross = None
101
298
        self._lca_trees = None
102
299
 
 
300
    def cache_trees_with_revision_ids(self, trees):
 
301
        """Cache any tree in trees if it has a revision_id."""
 
302
        for maybe_tree in trees:
 
303
            if maybe_tree is None:
 
304
                continue
 
305
            try:
 
306
                rev_id = maybe_tree.get_revision_id()
 
307
            except AttributeError:
 
308
                continue
 
309
            self._cached_trees[rev_id] = maybe_tree
 
310
 
103
311
    @property
104
312
    def revision_graph(self):
105
313
        if self._revision_graph is None:
132
340
                                      _set_base_is_other_ancestor)
133
341
 
134
342
    @staticmethod
135
 
    def from_uncommitted(tree, other_tree, pb, base_tree=None):
 
343
    def from_uncommitted(tree, other_tree, pb=None, base_tree=None):
136
344
        """Return a Merger for uncommitted changes in other_tree.
137
345
 
138
346
        :param tree: The tree to merge into
167
375
                base_revision_id, tree.branch.last_revision())):
168
376
                base_revision_id = None
169
377
            else:
170
 
                warning('Performing cherrypick')
 
378
                trace.warning('Performing cherrypick')
171
379
        merger = klass.from_revision_ids(pb, tree, other_revision_id,
172
380
                                         base_revision_id, revision_graph=
173
381
                                         revision_graph)
220
428
        return self._cached_trees[revision_id]
221
429
 
222
430
    def _get_tree(self, treespec, possible_transports=None):
223
 
        from bzrlib import workingtree
224
431
        location, revno = treespec
225
432
        if revno is None:
226
433
            tree = workingtree.WorkingTree.open_containing(location)[0]
227
434
            return tree.branch, tree
228
 
        branch = Branch.open_containing(location, possible_transports)[0]
 
435
        branch = _mod_branch.Branch.open_containing(
 
436
            location, possible_transports)[0]
229
437
        if revno == -1:
230
438
            revision_id = branch.last_revision()
231
439
        else:
232
440
            revision_id = branch.get_rev_id(revno)
233
 
        revision_id = ensure_null(revision_id)
 
441
        revision_id = _mod_revision.ensure_null(revision_id)
234
442
        return branch, self.revision_tree(revision_id, branch)
235
443
 
 
444
    @deprecated_method(deprecated_in((2, 1, 0)))
236
445
    def ensure_revision_trees(self):
237
446
        if self.this_revision_tree is None:
238
447
            self.this_basis_tree = self.revision_tree(self.this_basis)
241
450
 
242
451
        if self.other_rev_id is None:
243
452
            other_basis_tree = self.revision_tree(self.other_basis)
244
 
            changes = other_basis_tree.changes_from(self.other_tree)
245
 
            if changes.has_changed():
246
 
                raise WorkingTreeNotRevision(self.this_tree)
 
453
            if other_basis_tree.has_changes(self.other_tree):
 
454
                raise errors.WorkingTreeNotRevision(self.this_tree)
247
455
            other_rev_id = self.other_basis
248
456
            self.other_tree = other_basis_tree
249
457
 
 
458
    @deprecated_method(deprecated_in((2, 1, 0)))
250
459
    def file_revisions(self, file_id):
251
460
        self.ensure_revision_trees()
252
461
        def get_id(tree, file_id):
255
464
        if self.this_rev_id is None:
256
465
            if self.this_basis_tree.get_file_sha1(file_id) != \
257
466
                self.this_tree.get_file_sha1(file_id):
258
 
                raise WorkingTreeNotRevision(self.this_tree)
 
467
                raise errors.WorkingTreeNotRevision(self.this_tree)
259
468
 
260
469
        trees = (self.this_basis_tree, self.other_tree)
261
470
        return [get_id(tree, file_id) for tree in trees]
262
471
 
 
472
    @deprecated_method(deprecated_in((2, 1, 0)))
263
473
    def check_basis(self, check_clean, require_commits=True):
264
474
        if self.this_basis is None and require_commits is True:
265
 
            raise BzrCommandError("This branch has no commits."
266
 
                                  " (perhaps you would prefer 'bzr pull')")
 
475
            raise errors.BzrCommandError(
 
476
                "This branch has no commits."
 
477
                " (perhaps you would prefer 'bzr pull')")
267
478
        if check_clean:
268
479
            self.compare_basis()
269
480
            if self.this_basis != self.this_rev_id:
270
481
                raise errors.UncommittedChanges(self.this_tree)
271
482
 
 
483
    @deprecated_method(deprecated_in((2, 1, 0)))
272
484
    def compare_basis(self):
273
485
        try:
274
486
            basis_tree = self.revision_tree(self.this_tree.last_revision())
275
487
        except errors.NoSuchRevision:
276
488
            basis_tree = self.this_tree.basis_tree()
277
 
        changes = self.this_tree.changes_from(basis_tree)
278
 
        if not changes.has_changed():
 
489
        if not self.this_tree.has_changes(basis_tree):
279
490
            self.this_rev_id = self.this_basis
280
491
 
281
492
    def set_interesting_files(self, file_list):
282
493
        self.interesting_files = file_list
283
494
 
284
495
    def set_pending(self):
285
 
        if not self.base_is_ancestor or not self.base_is_other_ancestor or self.other_rev_id is None:
 
496
        if (not self.base_is_ancestor or not self.base_is_other_ancestor
 
497
            or self.other_rev_id is None):
286
498
            return
287
499
        self._add_parent()
288
500
 
289
501
    def _add_parent(self):
290
502
        new_parents = self.this_tree.get_parent_ids() + [self.other_rev_id]
291
503
        new_parent_trees = []
 
504
        operation = OperationWithCleanups(self.this_tree.set_parent_trees)
292
505
        for revision_id in new_parents:
293
506
            try:
294
507
                tree = self.revision_tree(revision_id)
296
509
                tree = None
297
510
            else:
298
511
                tree.lock_read()
 
512
                operation.add_cleanup(tree.unlock)
299
513
            new_parent_trees.append((revision_id, tree))
300
 
        try:
301
 
            self.this_tree.set_parent_trees(new_parent_trees,
302
 
                                            allow_leftmost_as_ghost=True)
303
 
        finally:
304
 
            for _revision_id, tree in new_parent_trees:
305
 
                if tree is not None:
306
 
                    tree.unlock()
 
514
        operation.run_simple(new_parent_trees, allow_leftmost_as_ghost=True)
307
515
 
308
516
    def set_other(self, other_revision, possible_transports=None):
309
517
        """Set the revision and tree to merge from.
318
526
            self.other_rev_id = _mod_revision.ensure_null(
319
527
                self.other_branch.last_revision())
320
528
            if _mod_revision.is_null(self.other_rev_id):
321
 
                raise NoCommits(self.other_branch)
 
529
                raise errors.NoCommits(self.other_branch)
322
530
            self.other_basis = self.other_rev_id
323
531
        elif other_revision[1] is not None:
324
532
            self.other_rev_id = self.other_branch.get_rev_id(other_revision[1])
327
535
            self.other_rev_id = None
328
536
            self.other_basis = self.other_branch.last_revision()
329
537
            if self.other_basis is None:
330
 
                raise NoCommits(self.other_branch)
 
538
                raise errors.NoCommits(self.other_branch)
331
539
        if self.other_rev_id is not None:
332
540
            self._cached_trees[self.other_rev_id] = self.other_tree
333
541
        self._maybe_fetch(self.other_branch,self.this_branch, self.other_basis)
360
568
            target.fetch(source, revision_id)
361
569
 
362
570
    def find_base(self):
363
 
        revisions = [ensure_null(self.this_basis),
364
 
                     ensure_null(self.other_basis)]
365
 
        if NULL_REVISION in revisions:
366
 
            self.base_rev_id = NULL_REVISION
 
571
        revisions = [_mod_revision.ensure_null(self.this_basis),
 
572
                     _mod_revision.ensure_null(self.other_basis)]
 
573
        if _mod_revision.NULL_REVISION in revisions:
 
574
            self.base_rev_id = _mod_revision.NULL_REVISION
367
575
            self.base_tree = self.revision_tree(self.base_rev_id)
368
576
            self._is_criss_cross = False
369
577
        else:
370
578
            lcas = self.revision_graph.find_lca(revisions[0], revisions[1])
371
579
            self._is_criss_cross = False
372
580
            if len(lcas) == 0:
373
 
                self.base_rev_id = NULL_REVISION
 
581
                self.base_rev_id = _mod_revision.NULL_REVISION
374
582
            elif len(lcas) == 1:
375
583
                self.base_rev_id = list(lcas)[0]
376
584
            else: # len(lcas) > 1
385
593
                    self.base_rev_id = self.revision_graph.find_unique_lca(
386
594
                                            *lcas)
387
595
                self._is_criss_cross = True
388
 
            if self.base_rev_id == NULL_REVISION:
389
 
                raise UnrelatedBranches()
 
596
            if self.base_rev_id == _mod_revision.NULL_REVISION:
 
597
                raise errors.UnrelatedBranches()
390
598
            if self._is_criss_cross:
391
 
                warning('Warning: criss-cross merge encountered.  See bzr'
392
 
                        ' help criss-cross.')
393
 
                mutter('Criss-cross lcas: %r' % lcas)
 
599
                trace.warning('Warning: criss-cross merge encountered.  See bzr'
 
600
                              ' help criss-cross.')
 
601
                trace.mutter('Criss-cross lcas: %r' % lcas)
394
602
                interesting_revision_ids = [self.base_rev_id]
395
603
                interesting_revision_ids.extend(lcas)
396
604
                interesting_trees = dict((t.get_revision_id(), t)
406
614
                self.base_tree = self.revision_tree(self.base_rev_id)
407
615
        self.base_is_ancestor = True
408
616
        self.base_is_other_ancestor = True
409
 
        mutter('Base revid: %r' % self.base_rev_id)
 
617
        trace.mutter('Base revid: %r' % self.base_rev_id)
410
618
 
411
619
    def set_base(self, base_revision):
412
620
        """Set the base revision to use for the merge.
413
621
 
414
622
        :param base_revision: A 2-list containing a path and revision number.
415
623
        """
416
 
        mutter("doing merge() with no base_revision specified")
 
624
        trace.mutter("doing merge() with no base_revision specified")
417
625
        if base_revision == [None, None]:
418
626
            self.find_base()
419
627
        else:
432
640
                  'other_tree': self.other_tree,
433
641
                  'interesting_ids': self.interesting_ids,
434
642
                  'interesting_files': self.interesting_files,
435
 
                  'pp': self.pp,
 
643
                  'this_branch': self.this_branch,
436
644
                  'do_merge': False}
437
645
        if self.merge_type.requires_base:
438
646
            kwargs['base_tree'] = self.base_tree
439
647
        if self.merge_type.supports_reprocess:
440
648
            kwargs['reprocess'] = self.reprocess
441
649
        elif self.reprocess:
442
 
            raise BzrError("Conflict reduction is not supported for merge"
443
 
                                  " type %s." % self.merge_type)
 
650
            raise errors.BzrError(
 
651
                "Conflict reduction is not supported for merge"
 
652
                " type %s." % self.merge_type)
444
653
        if self.merge_type.supports_show_base:
445
654
            kwargs['show_base'] = self.show_base
446
655
        elif self.show_base:
447
 
            raise BzrError("Showing base is not supported for this"
448
 
                           " merge type. %s" % self.merge_type)
 
656
            raise errors.BzrError("Showing base is not supported for this"
 
657
                                  " merge type. %s" % self.merge_type)
449
658
        if (not getattr(self.merge_type, 'supports_reverse_cherrypick', True)
450
659
            and not self.base_is_other_ancestor):
451
660
            raise errors.CannotReverseCherrypick()
455
664
        if self._is_criss_cross and getattr(self.merge_type,
456
665
                                            'supports_lca_trees', False):
457
666
            kwargs['lca_trees'] = self._lca_trees
458
 
        return self.merge_type(pb=self._pb,
 
667
        return self.merge_type(pb=None,
459
668
                               change_reporter=self.change_reporter,
460
669
                               **kwargs)
461
670
 
462
 
    def _do_merge_to(self, merge):
 
671
    def _do_merge_to(self):
 
672
        merge = self.make_merger()
 
673
        if self.other_branch is not None:
 
674
            self.other_branch.update_references(self.this_branch)
463
675
        merge.do_merge()
464
676
        if self.recurse == 'down':
465
677
            for relpath, file_id in self.this_tree.iter_references():
477
689
                    sub_tree.branch.repository.revision_tree(base_revision)
478
690
                sub_merge.base_rev_id = base_revision
479
691
                sub_merge.do_merge()
480
 
        
 
692
        return merge
 
693
 
481
694
    def do_merge(self):
 
695
        operation = OperationWithCleanups(self._do_merge_to)
482
696
        self.this_tree.lock_tree_write()
483
 
        try:
484
 
            if self.base_tree is not None:
485
 
                self.base_tree.lock_read()
486
 
            try:
487
 
                if self.other_tree is not None:
488
 
                    self.other_tree.lock_read()
489
 
                try:
490
 
                    merge = self.make_merger()
491
 
                    self._do_merge_to(merge)
492
 
                finally:
493
 
                    if self.other_tree is not None:
494
 
                        self.other_tree.unlock()
495
 
            finally:
496
 
                if self.base_tree is not None:
497
 
                    self.base_tree.unlock()
498
 
        finally:
499
 
            self.this_tree.unlock()
 
697
        operation.add_cleanup(self.this_tree.unlock)
 
698
        if self.base_tree is not None:
 
699
            self.base_tree.lock_read()
 
700
            operation.add_cleanup(self.base_tree.unlock)
 
701
        if self.other_tree is not None:
 
702
            self.other_tree.lock_read()
 
703
            operation.add_cleanup(self.other_tree.unlock)
 
704
        merge = operation.run_simple()
500
705
        if len(merge.cooked_conflicts) == 0:
501
 
            if not self.ignore_zero and not is_quiet():
502
 
                note("All changes applied successfully.")
 
706
            if not self.ignore_zero and not trace.is_quiet():
 
707
                trace.note("All changes applied successfully.")
503
708
        else:
504
 
            note("%d conflicts encountered." % len(merge.cooked_conflicts))
 
709
            trace.note("%d conflicts encountered."
 
710
                       % len(merge.cooked_conflicts))
505
711
 
506
712
        return len(merge.cooked_conflicts)
507
713
 
534
740
    winner_idx = {"this": 2, "other": 1, "conflict": 1}
535
741
    supports_lca_trees = True
536
742
 
537
 
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
 
743
    def __init__(self, working_tree, this_tree, base_tree, other_tree,
538
744
                 interesting_ids=None, reprocess=False, show_base=False,
539
 
                 pb=DummyProgress(), pp=None, change_reporter=None,
 
745
                 pb=None, pp=None, change_reporter=None,
540
746
                 interesting_files=None, do_merge=True,
541
 
                 cherrypick=False, lca_trees=None):
 
747
                 cherrypick=False, lca_trees=None, this_branch=None):
542
748
        """Initialize the merger object and perform the merge.
543
749
 
544
750
        :param working_tree: The working tree to apply the merge to
545
751
        :param this_tree: The local tree in the merge operation
546
752
        :param base_tree: The common tree in the merge operation
547
 
        :param other_tree: The other other tree to merge changes from
 
753
        :param other_tree: The other tree to merge changes from
 
754
        :param this_branch: The branch associated with this_tree.  Defaults to
 
755
            this_tree.branch if not supplied.
548
756
        :param interesting_ids: The file_ids of files that should be
549
757
            participate in the merge.  May not be combined with
550
758
            interesting_files.
551
759
        :param: reprocess If True, perform conflict-reduction processing.
552
760
        :param show_base: If True, show the base revision in text conflicts.
553
761
            (incompatible with reprocess)
554
 
        :param pb: A Progress bar
 
762
        :param pb: ignored
555
763
        :param pp: A ProgressPhase object
556
764
        :param change_reporter: An object that should report changes made
557
765
        :param interesting_files: The tree-relative paths of files that should
568
776
        if interesting_files is not None and interesting_ids is not None:
569
777
            raise ValueError(
570
778
                'specify either interesting_ids or interesting_files')
 
779
        if this_branch is None:
 
780
            this_branch = this_tree.branch
571
781
        self.interesting_ids = interesting_ids
572
782
        self.interesting_files = interesting_files
573
783
        self.this_tree = working_tree
574
784
        self.base_tree = base_tree
575
785
        self.other_tree = other_tree
 
786
        self.this_branch = this_branch
576
787
        self._raw_conflicts = []
577
788
        self.cooked_conflicts = []
578
789
        self.reprocess = reprocess
583
794
        # making sure we haven't missed any corner cases.
584
795
        # if lca_trees is None:
585
796
        #     self._lca_trees = [self.base_tree]
586
 
        self.pb = pb
587
 
        self.pp = pp
588
797
        self.change_reporter = change_reporter
589
798
        self.cherrypick = cherrypick
590
 
        if self.pp is None:
591
 
            self.pp = ProgressPhase("Merge phase", 3, self.pb)
592
799
        if do_merge:
593
800
            self.do_merge()
 
801
        if pp is not None:
 
802
            warnings.warn("pp argument to Merge3Merger is deprecated")
 
803
        if pb is not None:
 
804
            warnings.warn("pb argument to Merge3Merger is deprecated")
594
805
 
595
806
    def do_merge(self):
 
807
        operation = OperationWithCleanups(self._do_merge)
596
808
        self.this_tree.lock_tree_write()
 
809
        operation.add_cleanup(self.this_tree.unlock)
597
810
        self.base_tree.lock_read()
 
811
        operation.add_cleanup(self.base_tree.unlock)
598
812
        self.other_tree.lock_read()
599
 
        self.tt = TreeTransform(self.this_tree, self.pb)
 
813
        operation.add_cleanup(self.other_tree.unlock)
 
814
        operation.run()
 
815
 
 
816
    def _do_merge(self, operation):
 
817
        self.tt = transform.TreeTransform(self.this_tree, None)
 
818
        operation.add_cleanup(self.tt.finalize)
 
819
        self._compute_transform()
 
820
        results = self.tt.apply(no_conflicts=True)
 
821
        self.write_modified(results)
600
822
        try:
601
 
            self.pp.next_phase()
602
 
            self._compute_transform()
603
 
            self.pp.next_phase()
604
 
            results = self.tt.apply(no_conflicts=True)
605
 
            self.write_modified(results)
606
 
            try:
607
 
                self.this_tree.add_conflicts(self.cooked_conflicts)
608
 
            except UnsupportedOperation:
609
 
                pass
610
 
        finally:
611
 
            self.tt.finalize()
612
 
            self.other_tree.unlock()
613
 
            self.base_tree.unlock()
614
 
            self.this_tree.unlock()
615
 
            self.pb.clear()
 
823
            self.this_tree.add_conflicts(self.cooked_conflicts)
 
824
        except errors.UnsupportedOperation:
 
825
            pass
616
826
 
617
827
    def make_preview_transform(self):
 
828
        operation = OperationWithCleanups(self._make_preview_transform)
618
829
        self.base_tree.lock_read()
 
830
        operation.add_cleanup(self.base_tree.unlock)
619
831
        self.other_tree.lock_read()
620
 
        self.tt = TransformPreview(self.this_tree)
621
 
        try:
622
 
            self.pp.next_phase()
623
 
            self._compute_transform()
624
 
            self.pp.next_phase()
625
 
        finally:
626
 
            self.other_tree.unlock()
627
 
            self.base_tree.unlock()
628
 
            self.pb.clear()
 
832
        operation.add_cleanup(self.other_tree.unlock)
 
833
        return operation.run_simple()
 
834
 
 
835
    def _make_preview_transform(self):
 
836
        self.tt = transform.TransformPreview(self.this_tree)
 
837
        self._compute_transform()
629
838
        return self.tt
630
839
 
631
840
    def _compute_transform(self):
637
846
            resolver = self._lca_multi_way
638
847
        child_pb = ui.ui_factory.nested_progress_bar()
639
848
        try:
 
849
            factories = Merger.hooks['merge_file_content']
 
850
            hooks = [factory(self) for factory in factories] + [self]
 
851
            self.active_hooks = [hook for hook in hooks if hook is not None]
640
852
            for num, (file_id, changed, parents3, names3,
641
853
                      executable3) in enumerate(entries):
642
854
                child_pb.update('Preparing file merge', num, len(entries))
643
855
                self._merge_names(file_id, parents3, names3, resolver=resolver)
644
856
                if changed:
645
 
                    file_status = self.merge_contents(file_id)
 
857
                    file_status = self._do_merge_contents(file_id)
646
858
                else:
647
859
                    file_status = 'unmodified'
648
860
                self._merge_executable(file_id,
650
862
        finally:
651
863
            child_pb.finished()
652
864
        self.fix_root()
653
 
        self.pp.next_phase()
 
865
        self._finish_transform()
 
866
 
 
867
    def _finish_transform(self):
 
868
        """Finalize the transform and report the changes.
 
869
 
 
870
        This is the second half of _compute_transform.
 
871
        """
654
872
        child_pb = ui.ui_factory.nested_progress_bar()
655
873
        try:
656
 
            fs_conflicts = resolve_conflicts(self.tt, child_pb,
657
 
                lambda t, c: conflict_pass(t, c, self.other_tree))
 
874
            fs_conflicts = transform.resolve_conflicts(self.tt, child_pb,
 
875
                lambda t, c: transform.conflict_pass(t, c, self.other_tree))
658
876
        finally:
659
877
            child_pb.finished()
660
878
        if self.change_reporter is not None:
663
881
                self.tt.iter_changes(), self.change_reporter)
664
882
        self.cook_conflicts(fs_conflicts)
665
883
        for conflict in self.cooked_conflicts:
666
 
            warning(conflict)
 
884
            trace.warning(conflict)
667
885
 
668
886
    def _entries3(self):
669
887
        """Gather data about files modified between three trees.
854
1072
                        continue
855
1073
                else:
856
1074
                    raise AssertionError('unhandled kind: %s' % other_ie.kind)
857
 
                # XXX: We need to handle kind == 'symlink'
858
1075
 
859
1076
            # If we have gotten this far, that means something has changed
860
1077
            result.append((file_id, content_changed,
867
1084
                          ))
868
1085
        return result
869
1086
 
870
 
 
871
1087
    def fix_root(self):
872
1088
        try:
873
1089
            self.tt.final_kind(self.tt.root)
874
 
        except NoSuchFile:
 
1090
        except errors.NoSuchFile:
875
1091
            self.tt.cancel_deletion(self.tt.root)
876
1092
        if self.tt.final_file_id(self.tt.root) is None:
877
 
            self.tt.version_file(self.tt.tree_file_id(self.tt.root), 
 
1093
            self.tt.version_file(self.tt.tree_file_id(self.tt.root),
878
1094
                                 self.tt.root)
879
1095
        other_root_file_id = self.other_tree.get_root_id()
880
1096
        if other_root_file_id is None:
882
1098
        other_root = self.tt.trans_id_file_id(other_root_file_id)
883
1099
        if other_root == self.tt.root:
884
1100
            return
 
1101
        if self.other_tree.inventory.root.file_id in self.this_tree.inventory:
 
1102
            # the other tree's root is a non-root in the current tree (as when
 
1103
            # a previously unrelated branch is merged into another)
 
1104
            return
885
1105
        try:
886
1106
            self.tt.final_kind(other_root)
887
 
        except NoSuchFile:
888
 
            return
889
 
        if self.other_tree.inventory.root.file_id in self.this_tree.inventory:
890
 
            # the other tree's root is a non-root in the current tree
891
 
            return
892
 
        self.reparent_children(self.other_tree.inventory.root, self.tt.root)
893
 
        self.tt.cancel_creation(other_root)
894
 
        self.tt.cancel_versioning(other_root)
895
 
 
896
 
    def reparent_children(self, ie, target):
897
 
        for thing, child in ie.children.iteritems():
 
1107
            other_root_is_present = True
 
1108
        except errors.NoSuchFile:
 
1109
            # other_root doesn't have a physical representation. We still need
 
1110
            # to move any references to the actual root of the tree.
 
1111
            other_root_is_present = False
 
1112
        # 'other_tree.inventory.root' is not present in this tree. We are
 
1113
        # calling adjust_path for children which *want* to be present with a
 
1114
        # correct place to go.
 
1115
        for thing, child in self.other_tree.inventory.root.children.iteritems():
898
1116
            trans_id = self.tt.trans_id_file_id(child.file_id)
899
 
            self.tt.adjust_path(self.tt.final_name(trans_id), target, trans_id)
 
1117
            if not other_root_is_present:
 
1118
                # FIXME: Make final_kind returns None instead of raising
 
1119
                # NoSuchFile to avoid the ugly construct below -- vila 20100402
 
1120
                try:
 
1121
                    self.tt.final_kind(trans_id)
 
1122
                    # The item exist in the final tree and has a defined place
 
1123
                    # to go already.
 
1124
                    continue
 
1125
                except errors.NoSuchFile, e:
 
1126
                    pass
 
1127
            # Move the item into the root
 
1128
            self.tt.adjust_path(self.tt.final_name(trans_id),
 
1129
                                self.tt.root, trans_id)
 
1130
        if other_root_is_present:
 
1131
            self.tt.cancel_creation(other_root)
 
1132
            self.tt.cancel_versioning(other_root)
900
1133
 
901
1134
    def write_modified(self, results):
902
1135
        modified_hashes = {}
923
1156
        if entry is None:
924
1157
            return None
925
1158
        return entry.name
926
 
    
 
1159
 
927
1160
    @staticmethod
928
1161
    def contents_sha1(tree, file_id):
929
1162
        """Determine the sha1 of the file contents (used as a key method)."""
934
1167
    @staticmethod
935
1168
    def executable(tree, file_id):
936
1169
        """Determine the executability of a file-id (used as a key method)."""
937
 
        if file_id not in tree:
 
1170
        if not tree.has_id(file_id):
938
1171
            return None
939
1172
        if tree.kind(file_id) != "file":
940
1173
            return False
943
1176
    @staticmethod
944
1177
    def kind(tree, file_id):
945
1178
        """Determine the kind of a file-id (used as a key method)."""
946
 
        if file_id not in tree:
 
1179
        if not tree.has_id(file_id):
947
1180
            return None
948
1181
        return tree.kind(file_id)
949
1182
 
950
1183
    @staticmethod
951
1184
    def _three_way(base, other, this):
952
 
        #if base == other, either they all agree, or only THIS has changed.
953
1185
        if base == other:
 
1186
            # if 'base == other', either they all agree, or only 'this' has
 
1187
            # changed.
954
1188
            return 'this'
955
1189
        elif this not in (base, other):
 
1190
            # 'this' is neither 'base' nor 'other', so both sides changed
956
1191
            return 'conflict'
957
 
        # "Ambiguous clean merge" -- both sides have made the same change.
958
1192
        elif this == other:
 
1193
            # "Ambiguous clean merge" -- both sides have made the same change.
959
1194
            return "this"
960
 
        # this == base: only other has changed.
961
1195
        else:
 
1196
            # this == base: only other has changed.
962
1197
            return "other"
963
1198
 
964
1199
    @staticmethod
1008
1243
                # only has an lca value
1009
1244
                return 'other'
1010
1245
 
1011
 
        # At this point, the lcas disagree, and the tips disagree
 
1246
        # At this point, the lcas disagree, and the tip disagree
1012
1247
        return 'conflict'
1013
1248
 
1014
1249
    @staticmethod
 
1250
    @deprecated_method(deprecated_in((2, 2, 0)))
1015
1251
    def scalar_three_way(this_tree, base_tree, other_tree, file_id, key):
1016
1252
        """Do a three-way test on a scalar.
1017
1253
        Return "this", "other" or "conflict", depending whether a value wins.
1032
1268
 
1033
1269
    def merge_names(self, file_id):
1034
1270
        def get_entry(tree):
1035
 
            if file_id in tree.inventory:
 
1271
            if tree.has_id(file_id):
1036
1272
                return tree.inventory[file_id]
1037
1273
            else:
1038
1274
                return None
1067
1303
                parent_id_winner = "other"
1068
1304
        if name_winner == "this" and parent_id_winner == "this":
1069
1305
            return
1070
 
        if name_winner == "conflict":
1071
 
            trans_id = self.tt.trans_id_file_id(file_id)
1072
 
            self._raw_conflicts.append(('name conflict', trans_id, 
1073
 
                                        this_name, other_name))
1074
 
        if parent_id_winner == "conflict":
1075
 
            trans_id = self.tt.trans_id_file_id(file_id)
1076
 
            self._raw_conflicts.append(('parent conflict', trans_id, 
1077
 
                                        this_parent, other_parent))
 
1306
        if name_winner == 'conflict' or parent_id_winner == 'conflict':
 
1307
            # Creating helpers (.OTHER or .THIS) here cause problems down the
 
1308
            # road if a ContentConflict needs to be created so we should not do
 
1309
            # that
 
1310
            trans_id = self.tt.trans_id_file_id(file_id)
 
1311
            self._raw_conflicts.append(('path conflict', trans_id, file_id,
 
1312
                                        this_parent, this_name,
 
1313
                                        other_parent, other_name))
1078
1314
        if other_name is None:
1079
 
            # it doesn't matter whether the result was 'other' or 
 
1315
            # it doesn't matter whether the result was 'other' or
1080
1316
            # 'conflict'-- if there's no 'other', we leave it alone.
1081
1317
            return
1082
 
        # if we get here, name_winner and parent_winner are set to safe values.
1083
 
        trans_id = self.tt.trans_id_file_id(file_id)
1084
1318
        parent_id = parents[self.winner_idx[parent_id_winner]]
1085
1319
        if parent_id is not None:
1086
 
            parent_trans_id = self.tt.trans_id_file_id(parent_id)
 
1320
            # if we get here, name_winner and parent_winner are set to safe
 
1321
            # values.
1087
1322
            self.tt.adjust_path(names[self.winner_idx[name_winner]],
1088
 
                                parent_trans_id, trans_id)
 
1323
                                self.tt.trans_id_file_id(parent_id),
 
1324
                                self.tt.trans_id_file_id(file_id))
1089
1325
 
1090
 
    def merge_contents(self, file_id):
 
1326
    def _do_merge_contents(self, file_id):
1091
1327
        """Performs a merge on file_id contents."""
1092
1328
        def contents_pair(tree):
1093
1329
            if file_id not in tree:
1101
1337
                contents = None
1102
1338
            return kind, contents
1103
1339
 
1104
 
        def contents_conflict():
1105
 
            trans_id = self.tt.trans_id_file_id(file_id)
1106
 
            name = self.tt.final_name(trans_id)
1107
 
            parent_id = self.tt.final_parent(trans_id)
1108
 
            if file_id in self.this_tree.inventory:
1109
 
                self.tt.unversion_file(trans_id)
1110
 
                if file_id in self.this_tree:
1111
 
                    self.tt.delete_contents(trans_id)
1112
 
            file_group = self._dump_conflicts(name, parent_id, file_id, 
1113
 
                                              set_version=True)
1114
 
            self._raw_conflicts.append(('contents conflict', file_group))
1115
 
 
1116
1340
        # See SPOT run.  run, SPOT, run.
1117
1341
        # So we're not QUITE repeating ourselves; we do tricky things with
1118
1342
        # file kind...
1134
1358
        if winner == 'this':
1135
1359
            # No interesting changes introduced by OTHER
1136
1360
            return "unmodified"
 
1361
        # We have a hypothetical conflict, but if we have files, then we
 
1362
        # can try to merge the content
1137
1363
        trans_id = self.tt.trans_id_file_id(file_id)
1138
 
        if winner == 'other':
 
1364
        params = MergeHookParams(self, file_id, trans_id, this_pair[0],
 
1365
            other_pair[0], winner)
 
1366
        hooks = self.active_hooks
 
1367
        hook_status = 'not_applicable'
 
1368
        for hook in hooks:
 
1369
            hook_status, lines = hook.merge_contents(params)
 
1370
            if hook_status != 'not_applicable':
 
1371
                # Don't try any more hooks, this one applies.
 
1372
                break
 
1373
        result = "modified"
 
1374
        if hook_status == 'not_applicable':
 
1375
            # This is a contents conflict, because none of the available
 
1376
            # functions could merge it.
 
1377
            result = None
 
1378
            name = self.tt.final_name(trans_id)
 
1379
            parent_id = self.tt.final_parent(trans_id)
 
1380
            if self.this_tree.has_id(file_id):
 
1381
                self.tt.unversion_file(trans_id)
 
1382
            file_group = self._dump_conflicts(name, parent_id, file_id,
 
1383
                                              set_version=True)
 
1384
            self._raw_conflicts.append(('contents conflict', file_group))
 
1385
        elif hook_status == 'success':
 
1386
            self.tt.create_file(lines, trans_id)
 
1387
        elif hook_status == 'conflicted':
 
1388
            # XXX: perhaps the hook should be able to provide
 
1389
            # the BASE/THIS/OTHER files?
 
1390
            self.tt.create_file(lines, trans_id)
 
1391
            self._raw_conflicts.append(('text conflict', trans_id))
 
1392
            name = self.tt.final_name(trans_id)
 
1393
            parent_id = self.tt.final_parent(trans_id)
 
1394
            self._dump_conflicts(name, parent_id, file_id)
 
1395
        elif hook_status == 'delete':
 
1396
            self.tt.unversion_file(trans_id)
 
1397
            result = "deleted"
 
1398
        elif hook_status == 'done':
 
1399
            # The hook function did whatever it needs to do directly, no
 
1400
            # further action needed here.
 
1401
            pass
 
1402
        else:
 
1403
            raise AssertionError('unknown hook_status: %r' % (hook_status,))
 
1404
        if not self.this_tree.has_id(file_id) and result == "modified":
 
1405
            self.tt.version_file(file_id, trans_id)
 
1406
        # The merge has been performed, so the old contents should not be
 
1407
        # retained.
 
1408
        try:
 
1409
            self.tt.delete_contents(trans_id)
 
1410
        except errors.NoSuchFile:
 
1411
            pass
 
1412
        return result
 
1413
 
 
1414
    def _default_other_winner_merge(self, merge_hook_params):
 
1415
        """Replace this contents with other."""
 
1416
        file_id = merge_hook_params.file_id
 
1417
        trans_id = merge_hook_params.trans_id
 
1418
        file_in_this = self.this_tree.has_id(file_id)
 
1419
        if self.other_tree.has_id(file_id):
 
1420
            # OTHER changed the file
 
1421
            wt = self.this_tree
 
1422
            if wt.supports_content_filtering():
 
1423
                # We get the path from the working tree if it exists.
 
1424
                # That fails though when OTHER is adding a file, so
 
1425
                # we fall back to the other tree to find the path if
 
1426
                # it doesn't exist locally.
 
1427
                try:
 
1428
                    filter_tree_path = wt.id2path(file_id)
 
1429
                except errors.NoSuchId:
 
1430
                    filter_tree_path = self.other_tree.id2path(file_id)
 
1431
            else:
 
1432
                # Skip the id2path lookup for older formats
 
1433
                filter_tree_path = None
 
1434
            transform.create_from_tree(self.tt, trans_id,
 
1435
                             self.other_tree, file_id,
 
1436
                             filter_tree_path=filter_tree_path)
 
1437
            return 'done', None
 
1438
        elif file_in_this:
 
1439
            # OTHER deleted the file
 
1440
            return 'delete', None
 
1441
        else:
 
1442
            raise AssertionError(
 
1443
                'winner is OTHER, but file_id %r not in THIS or OTHER tree'
 
1444
                % (file_id,))
 
1445
 
 
1446
    def merge_contents(self, merge_hook_params):
 
1447
        """Fallback merge logic after user installed hooks."""
 
1448
        # This function is used in merge hooks as the fallback instance.
 
1449
        # Perhaps making this function and the functions it calls be a 
 
1450
        # a separate class would be better.
 
1451
        if merge_hook_params.winner == 'other':
1139
1452
            # OTHER is a straight winner, so replace this contents with other
1140
 
            file_in_this = file_id in self.this_tree
1141
 
            if file_in_this:
1142
 
                # Remove any existing contents
1143
 
                self.tt.delete_contents(trans_id)
1144
 
            if file_id in self.other_tree:
1145
 
                # OTHER changed the file
1146
 
                create_from_tree(self.tt, trans_id,
1147
 
                                 self.other_tree, file_id)
1148
 
                if not file_in_this:
1149
 
                    self.tt.version_file(file_id, trans_id)
1150
 
                return "modified"
1151
 
            elif file_in_this:
1152
 
                # OTHER deleted the file
1153
 
                self.tt.unversion_file(trans_id)
1154
 
                return "deleted"
 
1453
            return self._default_other_winner_merge(merge_hook_params)
 
1454
        elif merge_hook_params.is_file_merge():
 
1455
            # THIS and OTHER are both files, so text merge.  Either
 
1456
            # BASE is a file, or both converted to files, so at least we
 
1457
            # have agreement that output should be a file.
 
1458
            try:
 
1459
                self.text_merge(merge_hook_params.file_id,
 
1460
                    merge_hook_params.trans_id)
 
1461
            except errors.BinaryFile:
 
1462
                return 'not_applicable', None
 
1463
            return 'done', None
1155
1464
        else:
1156
 
            # We have a hypothetical conflict, but if we have files, then we
1157
 
            # can try to merge the content
1158
 
            if this_pair[0] == 'file' and other_pair[0] == 'file':
1159
 
                # THIS and OTHER are both files, so text merge.  Either
1160
 
                # BASE is a file, or both converted to files, so at least we
1161
 
                # have agreement that output should be a file.
1162
 
                try:
1163
 
                    self.text_merge(file_id, trans_id)
1164
 
                except BinaryFile:
1165
 
                    return contents_conflict()
1166
 
                if file_id not in self.this_tree:
1167
 
                    self.tt.version_file(file_id, trans_id)
1168
 
                try:
1169
 
                    self.tt.tree_kind(trans_id)
1170
 
                    self.tt.delete_contents(trans_id)
1171
 
                except NoSuchFile:
1172
 
                    pass
1173
 
                return "modified"
1174
 
            else:
1175
 
                return contents_conflict()
 
1465
            return 'not_applicable', None
1176
1466
 
1177
1467
    def get_lines(self, tree, file_id):
1178
1468
        """Return the lines in a file, or an empty list."""
1179
 
        if file_id in tree:
1180
 
            return tree.get_file(file_id).readlines()
 
1469
        if tree.has_id(file_id):
 
1470
            return tree.get_file_lines(file_id)
1181
1471
        else:
1182
1472
            return []
1183
1473
 
1185
1475
        """Perform a three-way text merge on a file_id"""
1186
1476
        # it's possible that we got here with base as a different type.
1187
1477
        # if so, we just want two-way text conflicts.
1188
 
        if file_id in self.base_tree and \
 
1478
        if self.base_tree.has_id(file_id) and \
1189
1479
            self.base_tree.kind(file_id) == "file":
1190
1480
            base_lines = self.get_lines(self.base_tree, file_id)
1191
1481
        else:
1192
1482
            base_lines = []
1193
1483
        other_lines = self.get_lines(self.other_tree, file_id)
1194
1484
        this_lines = self.get_lines(self.this_tree, file_id)
1195
 
        m3 = Merge3(base_lines, this_lines, other_lines,
1196
 
                    is_cherrypick=self.cherrypick)
 
1485
        m3 = merge3.Merge3(base_lines, this_lines, other_lines,
 
1486
                           is_cherrypick=self.cherrypick)
1197
1487
        start_marker = "!START OF MERGE CONFLICT!" + "I HOPE THIS IS UNIQUE"
1198
1488
        if self.show_base is True:
1199
1489
            base_marker = '|' * 7
1202
1492
 
1203
1493
        def iter_merge3(retval):
1204
1494
            retval["text_conflicts"] = False
1205
 
            for line in m3.merge_lines(name_a = "TREE", 
1206
 
                                       name_b = "MERGE-SOURCE", 
 
1495
            for line in m3.merge_lines(name_a = "TREE",
 
1496
                                       name_b = "MERGE-SOURCE",
1207
1497
                                       name_base = "BASE-REVISION",
1208
 
                                       start_marker=start_marker, 
 
1498
                                       start_marker=start_marker,
1209
1499
                                       base_marker=base_marker,
1210
1500
                                       reprocess=self.reprocess):
1211
1501
                if line.startswith(start_marker):
1220
1510
            self._raw_conflicts.append(('text conflict', trans_id))
1221
1511
            name = self.tt.final_name(trans_id)
1222
1512
            parent_id = self.tt.final_parent(trans_id)
1223
 
            file_group = self._dump_conflicts(name, parent_id, file_id, 
 
1513
            file_group = self._dump_conflicts(name, parent_id, file_id,
1224
1514
                                              this_lines, base_lines,
1225
1515
                                              other_lines)
1226
1516
            file_group.append(trans_id)
1227
1517
 
1228
 
    def _dump_conflicts(self, name, parent_id, file_id, this_lines=None, 
 
1518
    def _dump_conflicts(self, name, parent_id, file_id, this_lines=None,
1229
1519
                        base_lines=None, other_lines=None, set_version=False,
1230
1520
                        no_base=False):
1231
1521
        """Emit conflict files.
1233
1523
        determined automatically.  If set_version is true, the .OTHER, .THIS
1234
1524
        or .BASE (in that order) will be created as versioned files.
1235
1525
        """
1236
 
        data = [('OTHER', self.other_tree, other_lines), 
 
1526
        data = [('OTHER', self.other_tree, other_lines),
1237
1527
                ('THIS', self.this_tree, this_lines)]
1238
1528
        if not no_base:
1239
1529
            data.append(('BASE', self.base_tree, base_lines))
 
1530
 
 
1531
        # We need to use the actual path in the working tree of the file here,
 
1532
        # ignoring the conflict suffixes
 
1533
        wt = self.this_tree
 
1534
        if wt.supports_content_filtering():
 
1535
            try:
 
1536
                filter_tree_path = wt.id2path(file_id)
 
1537
            except errors.NoSuchId:
 
1538
                # file has been deleted
 
1539
                filter_tree_path = None
 
1540
        else:
 
1541
            # Skip the id2path lookup for older formats
 
1542
            filter_tree_path = None
 
1543
 
1240
1544
        versioned = False
1241
1545
        file_group = []
1242
1546
        for suffix, tree, lines in data:
1243
 
            if file_id in tree:
 
1547
            if tree.has_id(file_id):
1244
1548
                trans_id = self._conflict_file(name, parent_id, tree, file_id,
1245
 
                                               suffix, lines)
 
1549
                                               suffix, lines, filter_tree_path)
1246
1550
                file_group.append(trans_id)
1247
1551
                if set_version and not versioned:
1248
1552
                    self.tt.version_file(file_id, trans_id)
1249
1553
                    versioned = True
1250
1554
        return file_group
1251
 
           
 
1555
 
1252
1556
    def _conflict_file(self, name, parent_id, tree, file_id, suffix,
1253
 
                       lines=None):
 
1557
                       lines=None, filter_tree_path=None):
1254
1558
        """Emit a single conflict file."""
1255
1559
        name = name + '.' + suffix
1256
1560
        trans_id = self.tt.create_path(name, parent_id)
1257
 
        create_from_tree(self.tt, trans_id, tree, file_id, lines)
 
1561
        transform.create_from_tree(self.tt, trans_id, tree, file_id, lines,
 
1562
            filter_tree_path)
1258
1563
        return trans_id
1259
1564
 
1260
1565
    def merge_executable(self, file_id, file_status):
1284
1589
        try:
1285
1590
            if self.tt.final_kind(trans_id) != "file":
1286
1591
                return
1287
 
        except NoSuchFile:
 
1592
        except errors.NoSuchFile:
1288
1593
            return
1289
1594
        if winner == "this":
1290
1595
            executability = this_executable
1291
1596
        else:
1292
 
            if file_id in self.other_tree:
 
1597
            if self.other_tree.has_id(file_id):
1293
1598
                executability = other_executable
1294
 
            elif file_id in self.this_tree:
 
1599
            elif self.this_tree.has_id(file_id):
1295
1600
                executability = this_executable
1296
 
            elif file_id in self.base_tree:
 
1601
            elif self.base_tree_has_id(file_id):
1297
1602
                executability = base_executable
1298
1603
        if executability is not None:
1299
1604
            trans_id = self.tt.trans_id_file_id(file_id)
1301
1606
 
1302
1607
    def cook_conflicts(self, fs_conflicts):
1303
1608
        """Convert all conflicts into a form that doesn't depend on trans_id"""
1304
 
        from conflicts import Conflict
1305
 
        name_conflicts = {}
1306
 
        self.cooked_conflicts.extend(cook_conflicts(fs_conflicts, self.tt))
1307
 
        fp = FinalPaths(self.tt)
 
1609
        self.cooked_conflicts.extend(transform.cook_conflicts(
 
1610
                fs_conflicts, self.tt))
 
1611
        fp = transform.FinalPaths(self.tt)
1308
1612
        for conflict in self._raw_conflicts:
1309
1613
            conflict_type = conflict[0]
1310
 
            if conflict_type in ('name conflict', 'parent conflict'):
1311
 
                trans_id = conflict[1]
1312
 
                conflict_args = conflict[2:]
1313
 
                if trans_id not in name_conflicts:
1314
 
                    name_conflicts[trans_id] = {}
1315
 
                unique_add(name_conflicts[trans_id], conflict_type, 
1316
 
                           conflict_args)
1317
 
            if conflict_type == 'contents conflict':
 
1614
            if conflict_type == 'path conflict':
 
1615
                (trans_id, file_id,
 
1616
                this_parent, this_name,
 
1617
                other_parent, other_name) = conflict[1:]
 
1618
                if this_parent is None or this_name is None:
 
1619
                    this_path = '<deleted>'
 
1620
                else:
 
1621
                    parent_path =  fp.get_path(
 
1622
                        self.tt.trans_id_file_id(this_parent))
 
1623
                    this_path = osutils.pathjoin(parent_path, this_name)
 
1624
                if other_parent is None or other_name is None:
 
1625
                    other_path = '<deleted>'
 
1626
                else:
 
1627
                    parent_path =  fp.get_path(
 
1628
                        self.tt.trans_id_file_id(other_parent))
 
1629
                    other_path = osutils.pathjoin(parent_path, other_name)
 
1630
                c = _mod_conflicts.Conflict.factory(
 
1631
                    'path conflict', path=this_path,
 
1632
                    conflict_path=other_path,
 
1633
                    file_id=file_id)
 
1634
            elif conflict_type == 'contents conflict':
1318
1635
                for trans_id in conflict[1]:
1319
1636
                    file_id = self.tt.final_file_id(trans_id)
1320
1637
                    if file_id is not None:
1324
1641
                    if path.endswith(suffix):
1325
1642
                        path = path[:-len(suffix)]
1326
1643
                        break
1327
 
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
1328
 
                self.cooked_conflicts.append(c)
1329
 
            if conflict_type == 'text conflict':
 
1644
                c = _mod_conflicts.Conflict.factory(conflict_type,
 
1645
                                                    path=path, file_id=file_id)
 
1646
            elif conflict_type == 'text conflict':
1330
1647
                trans_id = conflict[1]
1331
1648
                path = fp.get_path(trans_id)
1332
1649
                file_id = self.tt.final_file_id(trans_id)
1333
 
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
1334
 
                self.cooked_conflicts.append(c)
1335
 
 
1336
 
        for trans_id, conflicts in name_conflicts.iteritems():
1337
 
            try:
1338
 
                this_parent, other_parent = conflicts['parent conflict']
1339
 
                if this_parent == other_parent:
1340
 
                    raise AssertionError()
1341
 
            except KeyError:
1342
 
                this_parent = other_parent = \
1343
 
                    self.tt.final_file_id(self.tt.final_parent(trans_id))
1344
 
            try:
1345
 
                this_name, other_name = conflicts['name conflict']
1346
 
                if this_name == other_name:
1347
 
                    raise AssertionError()
1348
 
            except KeyError:
1349
 
                this_name = other_name = self.tt.final_name(trans_id)
1350
 
            other_path = fp.get_path(trans_id)
1351
 
            if this_parent is not None and this_name is not None:
1352
 
                this_parent_path = \
1353
 
                    fp.get_path(self.tt.trans_id_file_id(this_parent))
1354
 
                this_path = pathjoin(this_parent_path, this_name)
 
1650
                c = _mod_conflicts.Conflict.factory(conflict_type,
 
1651
                                                    path=path, file_id=file_id)
1355
1652
            else:
1356
 
                this_path = "<deleted>"
1357
 
            file_id = self.tt.final_file_id(trans_id)
1358
 
            c = Conflict.factory('path conflict', path=this_path,
1359
 
                                 conflict_path=other_path, file_id=file_id)
 
1653
                raise AssertionError('bad conflict type: %r' % (conflict,))
1360
1654
            self.cooked_conflicts.append(c)
1361
 
        self.cooked_conflicts.sort(key=Conflict.sort_key)
 
1655
        self.cooked_conflicts.sort(key=_mod_conflicts.Conflict.sort_key)
1362
1656
 
1363
1657
 
1364
1658
class WeaveMerger(Merge3Merger):
1368
1662
    supports_reverse_cherrypick = False
1369
1663
    history_based = True
1370
1664
 
1371
 
    def _merged_lines(self, file_id):
1372
 
        """Generate the merged lines.
1373
 
        There is no distinction between lines that are meant to contain <<<<<<<
1374
 
        and conflicts.
1375
 
        """
1376
 
        if self.cherrypick:
1377
 
            base = self.base_tree
1378
 
        else:
1379
 
            base = None
1380
 
        plan = self.this_tree.plan_file_merge(file_id, self.other_tree,
 
1665
    def _generate_merge_plan(self, file_id, base):
 
1666
        return self.this_tree.plan_file_merge(file_id, self.other_tree,
1381
1667
                                              base=base)
 
1668
 
 
1669
    def _merged_lines(self, file_id):
 
1670
        """Generate the merged lines.
 
1671
        There is no distinction between lines that are meant to contain <<<<<<<
 
1672
        and conflicts.
 
1673
        """
 
1674
        if self.cherrypick:
 
1675
            base = self.base_tree
 
1676
        else:
 
1677
            base = None
 
1678
        plan = self._generate_merge_plan(file_id, base)
1382
1679
        if 'merge' in debug.debug_flags:
1383
1680
            plan = list(plan)
1384
1681
            trans_id = self.tt.trans_id_file_id(file_id)
1385
1682
            name = self.tt.final_name(trans_id) + '.plan'
1386
 
            contents = ('%10s|%s' % l for l in plan)
 
1683
            contents = ('%11s|%s' % l for l in plan)
1387
1684
            self.tt.new_file(name, self.tt.final_parent(trans_id), contents)
1388
 
        textmerge = PlanWeaveMerge(plan, '<<<<<<< TREE\n',
1389
 
            '>>>>>>> MERGE-SOURCE\n')
1390
 
        return textmerge.merge_lines(self.reprocess)
 
1685
        textmerge = versionedfile.PlanWeaveMerge(plan, '<<<<<<< TREE\n',
 
1686
                                                 '>>>>>>> MERGE-SOURCE\n')
 
1687
        lines, conflicts = textmerge.merge_lines(self.reprocess)
 
1688
        if conflicts:
 
1689
            base_lines = textmerge.base_from_plan()
 
1690
        else:
 
1691
            base_lines = None
 
1692
        return lines, base_lines
1391
1693
 
1392
1694
    def text_merge(self, file_id, trans_id):
1393
1695
        """Perform a (weave) text merge for a given file and file-id.
1394
1696
        If conflicts are encountered, .THIS and .OTHER files will be emitted,
1395
1697
        and a conflict will be noted.
1396
1698
        """
1397
 
        lines, conflicts = self._merged_lines(file_id)
 
1699
        lines, base_lines = self._merged_lines(file_id)
1398
1700
        lines = list(lines)
1399
 
        # Note we're checking whether the OUTPUT is binary in this case, 
 
1701
        # Note we're checking whether the OUTPUT is binary in this case,
1400
1702
        # because we don't want to get into weave merge guts.
1401
 
        check_text_lines(lines)
 
1703
        textfile.check_text_lines(lines)
1402
1704
        self.tt.create_file(lines, trans_id)
1403
 
        if conflicts:
 
1705
        if base_lines is not None:
 
1706
            # Conflict
1404
1707
            self._raw_conflicts.append(('text conflict', trans_id))
1405
1708
            name = self.tt.final_name(trans_id)
1406
1709
            parent_id = self.tt.final_parent(trans_id)
1407
 
            file_group = self._dump_conflicts(name, parent_id, file_id, 
1408
 
                                              no_base=True)
 
1710
            file_group = self._dump_conflicts(name, parent_id, file_id,
 
1711
                                              no_base=False,
 
1712
                                              base_lines=base_lines)
1409
1713
            file_group.append(trans_id)
1410
1714
 
1411
1715
 
1412
1716
class LCAMerger(WeaveMerger):
1413
1717
 
1414
 
    def _merged_lines(self, file_id):
1415
 
        """Generate the merged lines.
1416
 
        There is no distinction between lines that are meant to contain <<<<<<<
1417
 
        and conflicts.
1418
 
        """
1419
 
        if self.cherrypick:
1420
 
            base = self.base_tree
1421
 
        else:
1422
 
            base = None
1423
 
        plan = self.this_tree.plan_file_lca_merge(file_id, self.other_tree,
 
1718
    def _generate_merge_plan(self, file_id, base):
 
1719
        return self.this_tree.plan_file_lca_merge(file_id, self.other_tree,
1424
1720
                                                  base=base)
1425
 
        if 'merge' in debug.debug_flags:
1426
 
            plan = list(plan)
1427
 
            trans_id = self.tt.trans_id_file_id(file_id)
1428
 
            name = self.tt.final_name(trans_id) + '.plan'
1429
 
            contents = ('%10s|%s' % l for l in plan)
1430
 
            self.tt.new_file(name, self.tt.final_parent(trans_id), contents)
1431
 
        textmerge = PlanWeaveMerge(plan, '<<<<<<< TREE\n',
1432
 
            '>>>>>>> MERGE-SOURCE\n')
1433
 
        return textmerge.merge_lines(self.reprocess)
1434
 
 
1435
1721
 
1436
1722
class Diff3Merger(Merge3Merger):
1437
1723
    """Three-way merger using external diff3 for text merging"""
1438
1724
 
1439
1725
    def dump_file(self, temp_dir, name, tree, file_id):
1440
 
        out_path = pathjoin(temp_dir, name)
 
1726
        out_path = osutils.pathjoin(temp_dir, name)
1441
1727
        out_file = open(out_path, "wb")
1442
1728
        try:
1443
1729
            in_file = tree.get_file(file_id)
1455
1741
        import bzrlib.patch
1456
1742
        temp_dir = osutils.mkdtemp(prefix="bzr-")
1457
1743
        try:
1458
 
            new_file = pathjoin(temp_dir, "new")
 
1744
            new_file = osutils.pathjoin(temp_dir, "new")
1459
1745
            this = self.dump_file(temp_dir, "this", self.this_tree, file_id)
1460
1746
            base = self.dump_file(temp_dir, "base", self.base_tree, file_id)
1461
1747
            other = self.dump_file(temp_dir, "other", self.other_tree, file_id)
1462
1748
            status = bzrlib.patch.diff3(new_file, this, base, other)
1463
1749
            if status not in (0, 1):
1464
 
                raise BzrError("Unhandled diff3 exit code")
 
1750
                raise errors.BzrError("Unhandled diff3 exit code")
1465
1751
            f = open(new_file, 'rb')
1466
1752
            try:
1467
1753
                self.tt.create_file(f, trans_id)
1476
1762
            osutils.rmtree(temp_dir)
1477
1763
 
1478
1764
 
 
1765
class PathNotInTree(errors.BzrError):
 
1766
 
 
1767
    _fmt = """%(tree)s does not contain %(path)s."""
 
1768
 
 
1769
    def __init__(self, path, tree):
 
1770
        errors.BzrError.__init__(self, path=path, tree=tree)
 
1771
 
 
1772
 
 
1773
class MergeIntoMerger(Merger):
 
1774
    """Merger that understands other_tree will be merged into a subdir.
 
1775
 
 
1776
    This also changes the Merger api so that it uses real Branch, revision_id,
 
1777
    and RevisonTree objects, rather than using revision specs.
 
1778
    """
 
1779
 
 
1780
    def __init__(self, this_tree, other_branch, other_tree, target_subdir,
 
1781
            source_subpath, other_rev_id=None):
 
1782
        """Create a new MergeIntoMerger object.
 
1783
 
 
1784
        source_subpath in other_tree will be effectively copied to
 
1785
        target_subdir in this_tree.
 
1786
 
 
1787
        :param this_tree: The tree that we will be merging into.
 
1788
        :param other_branch: The Branch we will be merging from.
 
1789
        :param other_tree: The RevisionTree object we want to merge.
 
1790
        :param target_subdir: The relative path where we want to merge
 
1791
            other_tree into this_tree
 
1792
        :param source_subpath: The relative path specifying the subtree of
 
1793
            other_tree to merge into this_tree.
 
1794
        """
 
1795
        # It is assumed that we are merging a tree that is not in our current
 
1796
        # ancestry, which means we are using the "EmptyTree" as our basis.
 
1797
        null_ancestor_tree = this_tree.branch.repository.revision_tree(
 
1798
                                _mod_revision.NULL_REVISION)
 
1799
        super(MergeIntoMerger, self).__init__(
 
1800
            this_branch=this_tree.branch,
 
1801
            this_tree=this_tree,
 
1802
            other_tree=other_tree,
 
1803
            base_tree=null_ancestor_tree,
 
1804
            )
 
1805
        self._target_subdir = target_subdir
 
1806
        self._source_subpath = source_subpath
 
1807
        self.other_branch = other_branch
 
1808
        if other_rev_id is None:
 
1809
            other_rev_id = other_tree.get_revision_id()
 
1810
        self.other_rev_id = self.other_basis = other_rev_id
 
1811
        self.base_is_ancestor = True
 
1812
        self.backup_files = True
 
1813
        self.merge_type = Merge3Merger
 
1814
        self.show_base = False
 
1815
        self.reprocess = False
 
1816
        self.interesting_ids = None
 
1817
        self.merge_type = _Wrapper(Merge3MergeIntoMerger,
 
1818
                                  target_subdir=self._target_subdir,
 
1819
                                  source_subpath=self._source_subpath)
 
1820
        if self._source_subpath != '':
 
1821
            # If this isn't a partial merge make sure the revisions will be
 
1822
            # present.
 
1823
            self._maybe_fetch(self.other_branch, self.this_branch,
 
1824
                self.other_basis)
 
1825
 
 
1826
    def set_pending(self):
 
1827
        if self._source_subpath != '':
 
1828
            return
 
1829
        Merger.set_pending(self)
 
1830
 
 
1831
 
 
1832
class _Wrapper(object):
 
1833
    """Wrap a class to provide extra parameters."""
 
1834
 
 
1835
    # Merger.do_merge() sets up its own set of parameters to pass to the
 
1836
    # 'merge_type' member. And it is difficult override do_merge without
 
1837
    # re-writing the whole thing, so instead we create a wrapper which will
 
1838
    # pass the extra parameters.
 
1839
 
 
1840
    def __init__(self, merge_type, **kwargs):
 
1841
        self._extra_kwargs = kwargs
 
1842
        self._merge_type = merge_type
 
1843
 
 
1844
    def __call__(self, *args, **kwargs):
 
1845
        kwargs.update(self._extra_kwargs)
 
1846
        return self._merge_type(*args, **kwargs)
 
1847
 
 
1848
    def __getattr__(self, name):
 
1849
        return getattr(self._merge_type, name)
 
1850
 
 
1851
 
 
1852
class Merge3MergeIntoMerger(Merge3Merger):
 
1853
    """Merger that incorporates a tree (or part of a tree) into another."""
 
1854
 
 
1855
    def __init__(self, *args, **kwargs):
 
1856
        # All of the interesting work happens during Merge3Merger.__init__(),
 
1857
        # so we have have to hack in to get our extra parameters set.
 
1858
        self._source_subpath = kwargs.pop('source_subpath')
 
1859
        self._target_subdir = kwargs.pop('target_subdir')
 
1860
        super(Merge3MergeIntoMerger, self).__init__(*args, **kwargs)
 
1861
 
 
1862
    def _compute_transform(self):
 
1863
        child_pb = ui.ui_factory.nested_progress_bar()
 
1864
        try:
 
1865
            entries = self._entries_to_incorporate()
 
1866
            entries = list(entries)
 
1867
            for num, (entry, parent_id) in enumerate(entries):
 
1868
                child_pb.update('Preparing file merge', num, len(entries))
 
1869
                parent_trans_id = self.tt.trans_id_file_id(parent_id)
 
1870
                trans_id = transform.new_by_entry(self.tt, entry,
 
1871
                    parent_trans_id, self.other_tree)
 
1872
        finally:
 
1873
            child_pb.finished()
 
1874
        self._finish_transform()
 
1875
 
 
1876
    def _entries_to_incorporate(self):
 
1877
        """Yields pairs of (inventory_entry, new_parent)."""
 
1878
        other_inv = self.other_tree.inventory
 
1879
        subdir_id = other_inv.path2id(self._source_subpath)
 
1880
        if subdir_id is None:
 
1881
            # XXX: The error would be clearer if it gave the URL of the source
 
1882
            # branch, but we don't have a reference to that here.
 
1883
            raise PathNotInTree(self._source_subpath, "Source tree")
 
1884
        subdir = other_inv[subdir_id]
 
1885
        parent_in_target = osutils.dirname(self._target_subdir)
 
1886
        target_id = self.this_tree.inventory.path2id(parent_in_target)
 
1887
        if target_id is None:
 
1888
            raise PathNotInTree(self._target_subdir, "Target tree")
 
1889
        name_in_target = osutils.basename(self._target_subdir)
 
1890
        merge_into_root = subdir.copy()
 
1891
        merge_into_root.name = name_in_target
 
1892
        if merge_into_root.file_id in self.this_tree.inventory:
 
1893
            # Give the root a new file-id.
 
1894
            # This can happen fairly easily if the directory we are
 
1895
            # incorporating is the root, and both trees have 'TREE_ROOT' as
 
1896
            # their root_id.  Users will expect this to Just Work, so we
 
1897
            # change the file-id here.
 
1898
            # Non-root file-ids could potentially conflict too.  That's really
 
1899
            # an edge case, so we don't do anything special for those.  We let
 
1900
            # them cause conflicts.
 
1901
            merge_into_root.file_id = generate_ids.gen_file_id(name_in_target)
 
1902
        yield (merge_into_root, target_id)
 
1903
        if subdir.kind != 'directory':
 
1904
            # No children, so we are done.
 
1905
            return
 
1906
        for ignored_path, entry in other_inv.iter_entries_by_dir(subdir_id):
 
1907
            parent_id = entry.parent_id
 
1908
            if parent_id == subdir.file_id:
 
1909
                # The root's parent ID has changed, so make sure children of
 
1910
                # the root refer to the new ID.
 
1911
                parent_id = merge_into_root.file_id
 
1912
            yield (entry, parent_id)
 
1913
 
 
1914
 
1479
1915
def merge_inner(this_branch, other_tree, base_tree, ignore_zero=False,
1480
1916
                backup_files=False,
1481
1917
                merge_type=Merge3Merger,
1485
1921
                other_rev_id=None,
1486
1922
                interesting_files=None,
1487
1923
                this_tree=None,
1488
 
                pb=DummyProgress(),
 
1924
                pb=None,
1489
1925
                change_reporter=None):
1490
 
    """Primary interface for merging. 
1491
 
 
1492
 
        typical use is probably 
1493
 
        'merge_inner(branch, branch.get_revision_tree(other_revision),
1494
 
                     branch.get_revision_tree(base_revision))'
1495
 
        """
 
1926
    """Primary interface for merging.
 
1927
 
 
1928
    Typical use is probably::
 
1929
 
 
1930
        merge_inner(branch, branch.get_revision_tree(other_revision),
 
1931
                    branch.get_revision_tree(base_revision))
 
1932
    """
1496
1933
    if this_tree is None:
1497
 
        raise BzrError("bzrlib.merge.merge_inner requires a this_tree "
1498
 
            "parameter as of bzrlib version 0.8.")
 
1934
        raise errors.BzrError("bzrlib.merge.merge_inner requires a this_tree "
 
1935
                              "parameter as of bzrlib version 0.8.")
1499
1936
    merger = Merger(this_branch, other_tree, base_tree, this_tree=this_tree,
1500
1937
                    pb=pb, change_reporter=change_reporter)
1501
1938
    merger.backup_files = backup_files
1514
1951
    get_revision_id = getattr(base_tree, 'get_revision_id', None)
1515
1952
    if get_revision_id is None:
1516
1953
        get_revision_id = base_tree.last_revision
 
1954
    merger.cache_trees_with_revision_ids([other_tree, base_tree, this_tree])
1517
1955
    merger.set_base_revision(get_revision_id(), this_branch)
1518
1956
    return merger.do_merge()
1519
1957
 
1718
2156
        super(_PlanMerge, self).__init__(a_rev, b_rev, vf, key_prefix)
1719
2157
        self.a_key = self._key_prefix + (self.a_rev,)
1720
2158
        self.b_key = self._key_prefix + (self.b_rev,)
1721
 
        self.graph = Graph(self.vf)
 
2159
        self.graph = _mod_graph.Graph(self.vf)
1722
2160
        heads = self.graph.heads((self.a_key, self.b_key))
1723
2161
        if len(heads) == 1:
1724
2162
            # one side dominates, so we can just return its values, yay for
1729
2167
                other = b_rev
1730
2168
            else:
1731
2169
                other = a_rev
1732
 
            mutter('found dominating revision for %s\n%s > %s', self.vf,
1733
 
                   self._head_key[-1], other)
 
2170
            trace.mutter('found dominating revision for %s\n%s > %s', self.vf,
 
2171
                         self._head_key[-1], other)
1734
2172
            self._weave = None
1735
2173
        else:
1736
2174
            self._head_key = None
1750
2188
        while True:
1751
2189
            next_lcas = self.graph.find_lca(*cur_ancestors)
1752
2190
            # Map a plain NULL_REVISION to a simple no-ancestors
1753
 
            if next_lcas == set([NULL_REVISION]):
 
2191
            if next_lcas == set([_mod_revision.NULL_REVISION]):
1754
2192
                next_lcas = ()
1755
2193
            # Order the lca's based on when they were merged into the tip
1756
2194
            # While the actual merge portion of weave merge uses a set() of
1768
2206
            elif len(next_lcas) > 2:
1769
2207
                # More than 2 lca's, fall back to grabbing all nodes between
1770
2208
                # this and the unique lca.
1771
 
                mutter('More than 2 LCAs, falling back to all nodes for:'
1772
 
                       ' %s, %s\n=> %s', self.a_key, self.b_key, cur_ancestors)
 
2209
                trace.mutter('More than 2 LCAs, falling back to all nodes for:'
 
2210
                             ' %s, %s\n=> %s',
 
2211
                             self.a_key, self.b_key, cur_ancestors)
1773
2212
                cur_lcas = next_lcas
1774
2213
                while len(cur_lcas) > 1:
1775
2214
                    cur_lcas = self.graph.find_lca(*cur_lcas)
1778
2217
                    unique_lca = None
1779
2218
                else:
1780
2219
                    unique_lca = list(cur_lcas)[0]
1781
 
                    if unique_lca == NULL_REVISION:
 
2220
                    if unique_lca == _mod_revision.NULL_REVISION:
1782
2221
                        # find_lca will return a plain 'NULL_REVISION' rather
1783
2222
                        # than a key tuple when there is no common ancestor, we
1784
2223
                        # prefer to just use None, because it doesn't confuse
1792
2231
 
1793
2232
    def _find_unique_parents(self, tip_keys, base_key):
1794
2233
        """Find ancestors of tip that aren't ancestors of base.
1795
 
        
 
2234
 
1796
2235
        :param tip_keys: Nodes that are interesting
1797
2236
        :param base_key: Cull all ancestors of this node
1798
2237
        :return: The parent map for all revisions between tip_keys and
1807
2246
            # We remove NULL_REVISION because it isn't a proper tuple key, and
1808
2247
            # thus confuses things like _get_interesting_texts, and our logic
1809
2248
            # to add the texts into the memory weave.
1810
 
            if NULL_REVISION in parent_map:
1811
 
                parent_map.pop(NULL_REVISION)
 
2249
            if _mod_revision.NULL_REVISION in parent_map:
 
2250
                parent_map.pop(_mod_revision.NULL_REVISION)
1812
2251
        else:
1813
2252
            interesting = set()
1814
2253
            for tip in tip_keys:
1858
2297
    @staticmethod
1859
2298
    def _prune_tails(parent_map, child_map, tails_to_remove):
1860
2299
        """Remove tails from the parent map.
1861
 
        
 
2300
 
1862
2301
        This will remove the supplied revisions until no more children have 0
1863
2302
        parents.
1864
2303
 
1966
2405
        lcas = graph.find_lca(key_prefix + (a_rev,), key_prefix + (b_rev,))
1967
2406
        self.lcas = set()
1968
2407
        for lca in lcas:
1969
 
            if lca == NULL_REVISION:
 
2408
            if lca == _mod_revision.NULL_REVISION:
1970
2409
                self.lcas.add(lca)
1971
2410
            else:
1972
2411
                self.lcas.add(lca[-1])