~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/merge.py

(jameinel) Allow 'bzr serve' to interpret SIGHUP as a graceful shutdown.
 (bug #795025) (John A Meinel)

Show diffs side-by-side

added added

removed removed

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