/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1
# Copyright (C) 2005, 2006, 2008 Canonical Ltd
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
2
#
1110 by Martin Pool
- merge aaron's merge improvements:
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
7
#
1110 by Martin Pool
- merge aaron's merge improvements:
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
# GNU General Public License for more details.
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
12
#
1110 by Martin Pool
- merge aaron's merge improvements:
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
1545.2.3 by Aaron Bentley
Updated following j-a-meinel's comments
17
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
18
import errno
19
from itertools import chain
1185.1.2 by Martin Pool
- merge various windows and other fixes from Ollie Rutherfurd
20
import os
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
21
import warnings
1113 by Martin Pool
- fix is_ancestor import problem in merge
22
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
23
from bzrlib import (
1551.19.17 by Aaron Bentley
Add debugging flag for merges
24
    debug,
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
25
    errors,
3514.2.14 by John Arbash Meinel
Bring in the code to collapse linear portions of the graph.
26
    graph as _mod_graph,
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
27
    osutils,
1551.15.46 by Aaron Bentley
Move plan merge to tree
28
    patiencediff,
2221.4.15 by Aaron Bentley
Use RegistryOption for merge type
29
    registry,
2598.5.1 by Aaron Bentley
Start eliminating the use of None to indicate null revision
30
    revision as _mod_revision,
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
31
    tsort,
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
32
    )
1185.11.5 by John Arbash Meinel
Merged up-to-date against mainline, still broken.
33
from bzrlib.branch import Branch
1666.1.4 by Robert Collins
* 'Metadir' is now the default disk format. This improves behaviour in
34
from bzrlib.conflicts import ConflictList, Conflict
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
35
from bzrlib.errors import (BzrCommandError,
1534.4.28 by Robert Collins
first cut at merge from integration.
36
                           BzrError,
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
37
                           NoCommonAncestor,
38
                           NoCommits,
1534.4.28 by Robert Collins
first cut at merge from integration.
39
                           NoSuchRevision,
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
40
                           NoSuchFile,
1545.2.6 by Aaron Bentley
Removed _merge, renamed MergeConflictHandler to _MergeConflictHandler
41
                           NotBranchError,
1185.33.27 by Martin Pool
[merge] much integrated work from robert and john
42
                           NotVersionedError,
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
43
                           UnrelatedBranches,
1534.10.12 by Aaron Bentley
Merge produces new conflicts
44
                           UnsupportedOperation,
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
45
                           WorkingTreeNotRevision,
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
46
                           BinaryFile,
1534.4.28 by Robert Collins
first cut at merge from integration.
47
                           )
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
48
from bzrlib.graph import Graph
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
49
from bzrlib.merge3 import Merge3
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
50
from bzrlib.osutils import rename, pathjoin
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
51
from progress import DummyProgress, ProgressPhase
3052.1.3 by John Arbash Meinel
deprecate revision.is_ancestor, update the callers and the tests.
52
from bzrlib.revision import (NULL_REVISION, ensure_null)
1558.15.5 by Aaron Bentley
Fixed binary handling in weave merge
53
from bzrlib.textfile import check_text_lines
3200.1.1 by James Westby
Make pull --quiet more quiet. Fixes #185907.
54
from bzrlib.trace import mutter, warning, note, is_quiet
3008.1.9 by Michael Hudson
wanton hacking that lets me write an efficient version of get_diff_as_merged
55
from bzrlib.transform import (TransformPreview, TreeTransform,
56
                              resolve_conflicts, cook_conflicts,
2590.2.8 by Aaron Bentley
Restore conflict handling changes
57
                              conflict_pass, FinalPaths, create_by_entry,
58
                              unique_add, ROOT_PARENT)
1551.15.46 by Aaron Bentley
Move plan merge to tree
59
from bzrlib.versionedfile import PlanWeaveMerge
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
60
from bzrlib import ui
1545.2.6 by Aaron Bentley
Removed _merge, renamed MergeConflictHandler to _MergeConflictHandler
61
62
# TODO: Report back as changes are merged in
63
2325.3.1 by John Arbash Meinel
New helper function for merge, which allows us to re-use the existing workingtree, rather than opening it again.
64
1185.35.4 by Aaron Bentley
Implemented remerge
65
def transform_tree(from_tree, to_tree, interesting_ids=None):
66
    merge_inner(from_tree.branch, to_tree, from_tree, ignore_zero=True,
1558.1.3 by Aaron Bentley
Fixed deprecated op use in test suite
67
                interesting_ids=interesting_ids, this_tree=from_tree)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
68
1457.1.12 by Robert Collins
Update comment to reflect author.
69
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
70
class Merger(object):
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
71
    def __init__(self, this_branch, other_tree=None, base_tree=None,
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
72
                 this_tree=None, pb=DummyProgress(), change_reporter=None,
3146.5.3 by Aaron Bentley
Avoid retrieving revision graph twice
73
                 recurse='down', revision_graph=None):
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
74
        object.__init__(self)
75
        self.this_branch = this_branch
2598.5.4 by Aaron Bentley
Restore original Branch.last_revision behavior, fix bits that care
76
        self.this_basis = _mod_revision.ensure_null(
77
            this_branch.last_revision())
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
78
        self.this_rev_id = None
1534.4.26 by Robert Collins
Move working tree initialisation out from Branch.initialize, deprecated Branch.initialize to Branch.create.
79
        self.this_tree = this_tree
1185.12.83 by Aaron Bentley
Preliminary weave merge support
80
        self.this_revision_tree = None
1185.35.5 by Aaron Bentley
Made weave merge succeed if interesting files match history
81
        self.this_basis_tree = None
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
82
        self.other_tree = other_tree
2100.3.29 by Aaron Bentley
Get merge working initially
83
        self.other_branch = None
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
84
        self.base_tree = base_tree
85
        self.ignore_zero = False
86
        self.backup_files = False
87
        self.interesting_ids = None
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
88
        self.interesting_files = None
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
89
        self.show_base = False
1185.24.3 by Aaron Bentley
Integrated reprocessing into the rest of the merge stuff
90
        self.reprocess = False
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
91
        self._pb = pb
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
92
        self.pp = None
2100.3.29 by Aaron Bentley
Get merge working initially
93
        self.recurse = recurse
1551.11.9 by Aaron Bentley
Apply change reporting to merge
94
        self.change_reporter = change_reporter
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
95
        self._cached_trees = {}
3146.5.3 by Aaron Bentley
Avoid retrieving revision graph twice
96
        self._revision_graph = revision_graph
3146.5.1 by Aaron Bentley
Make merge --uncommitted work with merge-type weave
97
        self._base_is_ancestor = None
98
        self._base_is_other_ancestor = None
99
100
    @property
101
    def revision_graph(self):
102
        if self._revision_graph is None:
3146.5.3 by Aaron Bentley
Avoid retrieving revision graph twice
103
            self._revision_graph = self.this_branch.repository.get_graph()
3146.5.1 by Aaron Bentley
Make merge --uncommitted work with merge-type weave
104
        return self._revision_graph
105
106
    def _set_base_is_ancestor(self, value):
107
        self._base_is_ancestor = value
108
109
    def _get_base_is_ancestor(self):
110
        if self._base_is_ancestor is None:
111
            self._base_is_ancestor = self.revision_graph.is_ancestor(
112
                self.base_rev_id, self.this_basis)
113
        return self._base_is_ancestor
114
115
    base_is_ancestor = property(_get_base_is_ancestor, _set_base_is_ancestor)
116
117
    def _set_base_is_other_ancestor(self, value):
118
        self._base_is_other_ancestor = value
119
120
    def _get_base_is_other_ancestor(self):
121
        if self._base_is_other_ancestor is None:
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
122
            if self.other_basis is None:
123
                return True
124
            self._base_is_other_ancestor = self.revision_graph.is_ancestor(
3146.5.3 by Aaron Bentley
Avoid retrieving revision graph twice
125
                self.base_rev_id, self.other_basis)
3146.5.1 by Aaron Bentley
Make merge --uncommitted work with merge-type weave
126
        return self._base_is_other_ancestor
127
128
    base_is_other_ancestor = property(_get_base_is_other_ancestor,
129
                                      _set_base_is_other_ancestor)
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
130
1551.15.67 by Aaron Bentley
Stop using _merge_helper for merging
131
    @staticmethod
132
    def from_uncommitted(tree, other_tree, pb):
1551.15.74 by Aaron Bentley
Textual updates from review
133
        """Return a Merger for uncommitted changes in other_tree.
134
135
        :param tree: The tree to merge into
136
        :param other_tree: The tree to get uncommitted changes from
137
        :param pb: A progress indicator
138
        """
1551.15.67 by Aaron Bentley
Stop using _merge_helper for merging
139
        merger = Merger(tree.branch, other_tree, other_tree.basis_tree(), tree,
140
                        pb)
141
        merger.base_rev_id = merger.base_tree.get_revision_id()
142
        merger.other_rev_id = None
3146.5.1 by Aaron Bentley
Make merge --uncommitted work with merge-type weave
143
        merger.other_basis = merger.base_rev_id
1551.15.67 by Aaron Bentley
Stop using _merge_helper for merging
144
        return merger
145
146
    @classmethod
147
    def from_mergeable(klass, tree, mergeable, pb):
1551.15.74 by Aaron Bentley
Textual updates from review
148
        """Return a Merger for a bundle or merge directive.
149
150
        :param tree: The tree to merge changes into
151
        :param mergeable: A merge directive or bundle
152
        :param pb: A progress indicator
153
        """
1551.15.67 by Aaron Bentley
Stop using _merge_helper for merging
154
        mergeable.install_revisions(tree.branch.repository)
155
        base_revision_id, other_revision_id, verified =\
156
            mergeable.get_merge_request(tree.branch.repository)
3146.5.3 by Aaron Bentley
Avoid retrieving revision graph twice
157
        revision_graph = tree.branch.repository.get_graph()
1551.19.44 by Aaron Bentley
Fix handling of old merge directives with stricter get_parent_map
158
        if base_revision_id is not None:
159
            if (base_revision_id != _mod_revision.NULL_REVISION and
160
                revision_graph.is_ancestor(
161
                base_revision_id, tree.branch.last_revision())):
162
                base_revision_id = None
163
            else:
164
                warning('Performing cherrypick')
1551.15.67 by Aaron Bentley
Stop using _merge_helper for merging
165
        merger = klass.from_revision_ids(pb, tree, other_revision_id,
3146.5.3 by Aaron Bentley
Avoid retrieving revision graph twice
166
                                         base_revision_id, revision_graph=
167
                                         revision_graph)
1551.15.67 by Aaron Bentley
Stop using _merge_helper for merging
168
        return merger, verified
169
170
    @staticmethod
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
171
    def from_revision_ids(pb, tree, other, base=None, other_branch=None,
3146.5.3 by Aaron Bentley
Avoid retrieving revision graph twice
172
                          base_branch=None, revision_graph=None):
1551.15.74 by Aaron Bentley
Textual updates from review
173
        """Return a Merger for revision-ids.
174
175
        :param tree: The tree to merge changes into
176
        :param other: The revision-id to use as OTHER
177
        :param base: The revision-id to use as BASE.  If not specified, will
178
            be auto-selected.
179
        :param other_branch: A branch containing the other revision-id.  If
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
180
            not supplied, tree.branch is used.
1551.15.74 by Aaron Bentley
Textual updates from review
181
        :param base_branch: A branch containing the base revision-id.  If
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
182
            not supplied, other_branch or tree.branch will be used.
183
        :param revision_graph: If you have a revision_graph precomputed, pass
184
            it in, otherwise it will be created for you.
1551.15.74 by Aaron Bentley
Textual updates from review
185
        :param pb: A progress indicator
186
        """
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
187
        merger = Merger(tree.branch, this_tree=tree, pb=pb,
3146.5.3 by Aaron Bentley
Avoid retrieving revision graph twice
188
                        revision_graph=revision_graph)
1551.15.67 by Aaron Bentley
Stop using _merge_helper for merging
189
        if other_branch is None:
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
190
            other_branch = tree.branch
1551.15.67 by Aaron Bentley
Stop using _merge_helper for merging
191
        merger.set_other_revision(other, other_branch)
192
        if base is None:
193
            merger.find_base()
194
        else:
195
            if base_branch is None:
196
                base_branch = other_branch
197
            merger.set_base_revision(base, base_branch)
198
        return merger
199
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
200
    def revision_tree(self, revision_id, branch=None):
201
        if revision_id not in self._cached_trees:
202
            if branch is None:
203
                branch = self.this_branch
204
            try:
205
                tree = self.this_tree.revision_tree(revision_id)
206
            except errors.NoSuchRevisionInTree:
207
                tree = branch.repository.revision_tree(revision_id)
208
            self._cached_trees[revision_id] = tree
209
        return self._cached_trees[revision_id]
210
2485.8.58 by Vincent Ladeuil
merge bzr.dev@1617
211
    def _get_tree(self, treespec, possible_transports=None):
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
212
        from bzrlib import workingtree
213
        location, revno = treespec
214
        if revno is None:
215
            tree = workingtree.WorkingTree.open_containing(location)[0]
216
            return tree.branch, tree
2485.8.58 by Vincent Ladeuil
merge bzr.dev@1617
217
        branch = Branch.open_containing(location, possible_transports)[0]
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
218
        if revno == -1:
219
            revision_id = branch.last_revision()
220
        else:
221
            revision_id = branch.get_rev_id(revno)
222
        revision_id = ensure_null(revision_id)
223
        return branch, self.revision_tree(revision_id, branch)
1185.12.83 by Aaron Bentley
Preliminary weave merge support
224
225
    def ensure_revision_trees(self):
226
        if self.this_revision_tree is None:
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
227
            self.this_basis_tree = self.revision_tree(self.this_basis)
1185.35.5 by Aaron Bentley
Made weave merge succeed if interesting files match history
228
            if self.this_basis == self.this_rev_id:
229
                self.this_revision_tree = self.this_basis_tree
230
1185.12.83 by Aaron Bentley
Preliminary weave merge support
231
        if self.other_rev_id is None:
232
            other_basis_tree = self.revision_tree(self.other_basis)
1852.10.3 by Robert Collins
Remove all uses of compare_trees and replace with Tree.changes_from throughout bzrlib.
233
            changes = other_basis_tree.changes_from(self.other_tree)
1185.12.83 by Aaron Bentley
Preliminary weave merge support
234
            if changes.has_changed():
235
                raise WorkingTreeNotRevision(self.this_tree)
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
236
            other_rev_id = self.other_basis
1185.12.83 by Aaron Bentley
Preliminary weave merge support
237
            self.other_tree = other_basis_tree
238
239
    def file_revisions(self, file_id):
240
        self.ensure_revision_trees()
241
        def get_id(tree, file_id):
242
            revision_id = tree.inventory[file_id].revision
243
            return revision_id
1185.35.5 by Aaron Bentley
Made weave merge succeed if interesting files match history
244
        if self.this_rev_id is None:
245
            if self.this_basis_tree.get_file_sha1(file_id) != \
246
                self.this_tree.get_file_sha1(file_id):
247
                raise WorkingTreeNotRevision(self.this_tree)
248
249
        trees = (self.this_basis_tree, self.other_tree)
1185.12.83 by Aaron Bentley
Preliminary weave merge support
250
        return [get_id(tree, file_id) for tree in trees]
251
1185.82.44 by Aaron Bentley
Switch to merge_changeset in test suite
252
    def check_basis(self, check_clean, require_commits=True):
253
        if self.this_basis is None and require_commits is True:
2249.3.1 by John Arbash Meinel
Mention using 'bzr pull' if there are no commits in current branch
254
            raise BzrCommandError("This branch has no commits."
255
                                  " (perhaps you would prefer 'bzr pull')")
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
256
        if check_clean:
257
            self.compare_basis()
258
            if self.this_basis != self.this_rev_id:
2796.2.1 by Aaron Bentley
Begin work on reconfigure command
259
                raise errors.UncommittedChanges(self.this_tree)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
260
261
    def compare_basis(self):
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
262
        try:
263
            basis_tree = self.revision_tree(self.this_tree.last_revision())
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
264
        except errors.NoSuchRevision:
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
265
            basis_tree = self.this_tree.basis_tree()
266
        changes = self.this_tree.changes_from(basis_tree)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
267
        if not changes.has_changed():
268
            self.this_rev_id = self.this_basis
269
270
    def set_interesting_files(self, file_list):
2590.2.7 by Aaron Bentley
Misc cleanup
271
        self.interesting_files = file_list
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
272
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
273
    def set_pending(self):
2644.1.1 by Wouter van Heyst
Fix bug #127115 by checking for self.other_rev_id being None in Merger.set_pending()
274
        if not self.base_is_ancestor or not self.base_is_other_ancestor or self.other_rev_id is None:
1185.12.77 by Aaron Bentley
Prevented all ancestors from being marked as pending merges
275
            return
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
276
        self._add_parent()
277
278
    def _add_parent(self):
279
        new_parents = self.this_tree.get_parent_ids() + [self.other_rev_id]
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
280
        new_parent_trees = []
281
        for revision_id in new_parents:
282
            try:
283
                tree = self.revision_tree(revision_id)
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
284
            except errors.NoSuchRevision:
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
285
                tree = None
286
            else:
287
                tree.lock_read()
288
            new_parent_trees.append((revision_id, tree))
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
289
        try:
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
290
            self.this_tree.set_parent_trees(new_parent_trees,
291
                                            allow_leftmost_as_ghost=True)
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
292
        finally:
293
            for _revision_id, tree in new_parent_trees:
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
294
                if tree is not None:
295
                    tree.unlock()
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
296
2485.8.37 by Vincent Ladeuil
Fix merge multiple connections. Test suite *not* passing (sftp
297
    def set_other(self, other_revision, possible_transports=None):
1979.2.1 by Robert Collins
(robertc) adds a convenience method "merge_from_branch" to WorkingTree.
298
        """Set the revision and tree to merge from.
299
300
        This sets the other_tree, other_rev_id, other_basis attributes.
301
302
        :param other_revision: The [path, revision] list to merge from.
303
        """
2485.8.58 by Vincent Ladeuil
merge bzr.dev@1617
304
        self.other_branch, self.other_tree = self._get_tree(other_revision,
305
                                                            possible_transports)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
306
        if other_revision[1] == -1:
2598.5.4 by Aaron Bentley
Restore original Branch.last_revision behavior, fix bits that care
307
            self.other_rev_id = _mod_revision.ensure_null(
308
                self.other_branch.last_revision())
2598.5.1 by Aaron Bentley
Start eliminating the use of None to indicate null revision
309
            if _mod_revision.is_null(self.other_rev_id):
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
310
                raise NoCommits(self.other_branch)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
311
            self.other_basis = self.other_rev_id
312
        elif other_revision[1] is not None:
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
313
            self.other_rev_id = self.other_branch.get_rev_id(other_revision[1])
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
314
            self.other_basis = self.other_rev_id
315
        else:
316
            self.other_rev_id = None
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
317
            self.other_basis = self.other_branch.last_revision()
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
318
            if self.other_basis is None:
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
319
                raise NoCommits(self.other_branch)
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
320
        if self.other_rev_id is not None:
321
            self._cached_trees[self.other_rev_id] = self.other_tree
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
322
        self._maybe_fetch(self.other_branch,self.this_branch, self.other_basis)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
323
2100.3.29 by Aaron Bentley
Get merge working initially
324
    def set_other_revision(self, revision_id, other_branch):
325
        """Set 'other' based on a branch and revision id
326
327
        :param revision_id: The revision to use for a tree
328
        :param other_branch: The branch containing this tree
329
        """
330
        self.other_rev_id = revision_id
331
        self.other_branch = other_branch
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
332
        self._maybe_fetch(other_branch, self.this_branch, self.other_rev_id)
2100.3.29 by Aaron Bentley
Get merge working initially
333
        self.other_tree = self.revision_tree(revision_id)
334
        self.other_basis = revision_id
335
2520.4.110 by Aaron Bentley
Implement cherrypick support for merge directives
336
    def set_base_revision(self, revision_id, branch):
337
        """Set 'base' based on a branch and revision id
338
339
        :param revision_id: The revision to use for a tree
340
        :param branch: The branch containing this tree
341
        """
342
        self.base_rev_id = revision_id
343
        self.base_branch = branch
2520.4.132 by Aaron Bentley
Merge from bzr.dev
344
        self._maybe_fetch(branch, self.this_branch, revision_id)
2520.4.110 by Aaron Bentley
Implement cherrypick support for merge directives
345
        self.base_tree = self.revision_tree(revision_id)
2520.4.132 by Aaron Bentley
Merge from bzr.dev
346
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
347
    def _maybe_fetch(self, source, target, revision_id):
2665.5.2 by Aaron Bentley
Switch commit and merge to Repository.has_same_location
348
        if not source.repository.has_same_location(target.repository):
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
349
            target.fetch(source, revision_id)
2520.4.110 by Aaron Bentley
Implement cherrypick support for merge directives
350
1185.82.25 by Aaron Bentley
Added changeset-merging functionality
351
    def find_base(self):
2590.2.22 by Aaron Bentley
Remove cruft
352
        revisions = [ensure_null(self.this_basis),
353
                     ensure_null(self.other_basis)]
354
        if NULL_REVISION in revisions:
355
            self.base_rev_id = NULL_REVISION
356
        else:
3146.5.1 by Aaron Bentley
Make merge --uncommitted work with merge-type weave
357
            self.base_rev_id, steps = self.revision_graph.find_unique_lca(
358
                revisions[0], revisions[1], count_steps=True)
2590.2.22 by Aaron Bentley
Remove cruft
359
            if self.base_rev_id == NULL_REVISION:
360
                raise UnrelatedBranches()
1551.19.10 by Aaron Bentley
Merge now warns when it encounters a criss-cross
361
            if steps > 1:
1551.19.11 by Aaron Bentley
Add criss-cross help topic
362
                warning('Warning: criss-cross merge encountered.  See bzr'
363
                        ' help criss-cross.')
2590.2.13 by Aaron Bentley
Make find_base implement the base_finding code
364
        self.base_tree = self.revision_tree(self.base_rev_id)
365
        self.base_is_ancestor = True
2590.2.18 by Aaron Bentley
Merge is_ancestor fix
366
        self.base_is_other_ancestor = True
1185.82.25 by Aaron Bentley
Added changeset-merging functionality
367
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
368
    def set_base(self, base_revision):
1979.2.1 by Robert Collins
(robertc) adds a convenience method "merge_from_branch" to WorkingTree.
369
        """Set the base revision to use for the merge.
370
371
        :param base_revision: A 2-list containing a path and revision number.
372
        """
1185.12.96 by Aaron Bentley
Merge from mpool
373
        mutter("doing merge() with no base_revision specified")
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
374
        if base_revision == [None, None]:
2590.2.13 by Aaron Bentley
Make find_base implement the base_finding code
375
            self.find_base()
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
376
        else:
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
377
            base_branch, self.base_tree = self._get_tree(base_revision)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
378
            if base_revision[1] == -1:
379
                self.base_rev_id = base_branch.last_revision()
380
            elif base_revision[1] is None:
2598.5.3 by Aaron Bentley
Push NULL_REVISION deeper
381
                self.base_rev_id = _mod_revision.NULL_REVISION
493 by Martin Pool
- Merge aaron's merge command
382
            else:
2598.5.3 by Aaron Bentley
Push NULL_REVISION deeper
383
                self.base_rev_id = _mod_revision.ensure_null(
384
                    base_branch.get_rev_id(base_revision[1]))
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
385
            self._maybe_fetch(base_branch, self.this_branch, self.base_rev_id)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
386
3008.1.8 by Michael Hudson
extract merger creation into a method
387
    def make_merger(self):
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
388
        kwargs = {'working_tree':self.this_tree, 'this_tree': self.this_tree,
389
                  'other_tree': self.other_tree,
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
390
                  'interesting_ids': self.interesting_ids,
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
391
                  'interesting_files': self.interesting_files,
3008.1.11 by Michael Hudson
restore the default behaviour of Merge3Merger.__init__().
392
                  'pp': self.pp,
393
                  'do_merge': False}
1534.7.84 by Aaron Bentley
Added reprocess support, support for varying merge types
394
        if self.merge_type.requires_base:
395
            kwargs['base_tree'] = self.base_tree
1534.7.137 by Aaron Bentley
Avoided generating a new tree for every weave merge
396
        if self.merge_type.supports_reprocess:
397
            kwargs['reprocess'] = self.reprocess
398
        elif self.reprocess:
1551.6.14 by Aaron Bentley
Tweaks from merge review
399
            raise BzrError("Conflict reduction is not supported for merge"
400
                                  " type %s." % self.merge_type)
1534.7.137 by Aaron Bentley
Avoided generating a new tree for every weave merge
401
        if self.merge_type.supports_show_base:
402
            kwargs['show_base'] = self.show_base
403
        elif self.show_base:
1534.8.2 by Aaron Bentley
Implemented weave merge
404
            raise BzrError("Showing base is not supported for this"
3008.1.14 by Michael Hudson
trivial commit for testing
405
                           " merge type. %s" % self.merge_type)
3062.2.7 by Aaron Bentley
Prevent reverse cherry-picking with weave
406
        if (not getattr(self.merge_type, 'supports_reverse_cherrypick', True)
407
            and not self.base_is_other_ancestor):
408
            raise errors.CannotReverseCherrypick()
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
409
        if self.merge_type.supports_cherrypick:
3062.2.9 by Aaron Bentley
Don't use the base if not cherrypicking
410
            kwargs['cherrypick'] = (not self.base_is_ancestor or
411
                                    not self.base_is_other_ancestor)
3008.1.8 by Michael Hudson
extract merger creation into a method
412
        return self.merge_type(pb=self._pb,
413
                               change_reporter=self.change_reporter,
414
                               **kwargs)
415
3619.6.4 by Mark Hammond
do_merge gets one 'finally' per lock so locks always released on failure.
416
    def _do_merge_to(self, merge):
417
        merge.do_merge()
418
        if self.recurse == 'down':
419
            for relpath, file_id in self.this_tree.iter_references():
420
                sub_tree = self.this_tree.get_nested_tree(file_id, relpath)
421
                other_revision = self.other_tree.get_reference_revision(
422
                    file_id, relpath)
423
                if  other_revision == sub_tree.last_revision():
424
                    continue
425
                sub_merge = Merger(sub_tree.branch, this_tree=sub_tree)
426
                sub_merge.merge_type = self.merge_type
427
                other_branch = self.other_branch.reference_parent(file_id, relpath)
428
                sub_merge.set_other_revision(other_revision, other_branch)
429
                base_revision = self.base_tree.get_reference_revision(file_id)
430
                sub_merge.base_tree = \
431
                    sub_tree.branch.repository.revision_tree(base_revision)
432
                sub_merge.base_rev_id = base_revision
433
                sub_merge.do_merge()
434
        
3008.1.8 by Michael Hudson
extract merger creation into a method
435
    def do_merge(self):
2255.2.50 by John Arbash Meinel
merge only needs a lock_tree_write() on the working tree, not a full lock_write()
436
        self.this_tree.lock_tree_write()
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
437
        try:
438
            if self.base_tree is not None:
3619.6.4 by Mark Hammond
do_merge gets one 'finally' per lock so locks always released on failure.
439
                self.base_tree.lock_read()
440
            try:
441
                if self.other_tree is not None:
442
                    self.other_tree.lock_read()
443
                try:
444
                    merge = self.make_merger()
445
                    self._do_merge_to(merge)
446
                finally:
447
                    if self.other_tree is not None:
448
                        self.other_tree.unlock()
449
            finally:
450
                if self.base_tree is not None:
451
                    self.base_tree.unlock()
452
        finally:
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
453
            self.this_tree.unlock()
1534.7.151 by Aaron Bentley
Fixed all changes applied successfully
454
        if len(merge.cooked_conflicts) == 0:
3200.1.1 by James Westby
Make pull --quiet more quiet. Fixes #185907.
455
            if not self.ignore_zero and not is_quiet():
1534.7.141 by Aaron Bentley
Added conflict reporting
456
                note("All changes applied successfully.")
457
        else:
458
            note("%d conflicts encountered." % len(merge.cooked_conflicts))
459
1534.7.134 by Aaron Bentley
Hid raw conflicts
460
        return len(merge.cooked_conflicts)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
461
1545.2.4 by Aaron Bentley
PEP8 fixes
462
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
463
class Merge3Merger(object):
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
464
    """Three-way merger that uses the merge3 text merger"""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
465
    requires_base = True
466
    supports_reprocess = True
467
    supports_show_base = True
468
    history_based = False
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
469
    supports_cherrypick = True
3062.2.7 by Aaron Bentley
Prevent reverse cherry-picking with weave
470
    supports_reverse_cherrypick = True
2590.2.7 by Aaron Bentley
Misc cleanup
471
    winner_idx = {"this": 2, "other": 1, "conflict": 1}
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
472
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
473
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
1558.2.2 by Aaron Bentley
Make remerge honour interesting-ids
474
                 interesting_ids=None, reprocess=False, show_base=False,
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
475
                 pb=DummyProgress(), pp=None, change_reporter=None,
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
476
                 interesting_files=None, do_merge=True,
477
                 cherrypick=False):
2590.2.10 by Aaron Bentley
Updates from review
478
        """Initialize the merger object and perform the merge.
479
480
        :param working_tree: The working tree to apply the merge to
481
        :param this_tree: The local tree in the merge operation
482
        :param base_tree: The common tree in the merge operation
483
        :param other_tree: The other other tree to merge changes from
484
        :param interesting_ids: The file_ids of files that should be
485
            participate in the merge.  May not be combined with
486
            interesting_files.
487
        :param: reprocess If True, perform conflict-reduction processing.
488
        :param show_base: If True, show the base revision in text conflicts.
489
            (incompatible with reprocess)
490
        :param pb: A Progress bar
491
        :param pp: A ProgressPhase object
492
        :param change_reporter: An object that should report changes made
493
        :param interesting_files: The tree-relative paths of files that should
494
            participate in the merge.  If these paths refer to directories,
495
            the contents of those directories will also be included.  May not
496
            be combined with interesting_ids.  If neither interesting_files nor
497
            interesting_ids is specified, all files may participate in the
498
            merge.
499
        """
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
500
        object.__init__(self)
3376.2.4 by Martin Pool
Remove every assert statement from bzrlib!
501
        if interesting_files is not None and interesting_ids is not None:
502
            raise ValueError(
503
                'specify either interesting_ids or interesting_files')
2590.2.4 by Aaron Bentley
Move entry generation to a helper
504
        self.interesting_ids = interesting_ids
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
505
        self.interesting_files = interesting_files
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
506
        self.this_tree = working_tree
507
        self.base_tree = base_tree
508
        self.other_tree = other_tree
509
        self._raw_conflicts = []
510
        self.cooked_conflicts = []
511
        self.reprocess = reprocess
512
        self.show_base = show_base
1534.9.1 by Aaron Bentley
Added progress bars to merge
513
        self.pb = pb
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
514
        self.pp = pp
1551.11.9 by Aaron Bentley
Apply change reporting to merge
515
        self.change_reporter = change_reporter
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
516
        self.cherrypick = cherrypick
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
517
        if self.pp is None:
518
            self.pp = ProgressPhase("Merge phase", 3, self.pb)
3008.1.11 by Michael Hudson
restore the default behaviour of Merge3Merger.__init__().
519
        if do_merge:
520
            self.do_merge()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
521
3008.1.6 by Michael Hudson
chop up Merge3Merger.__init__ into pieces
522
    def do_merge(self):
523
        self.this_tree.lock_tree_write()
524
        self.base_tree.lock_read()
525
        self.other_tree.lock_read()
526
        self.tt = TreeTransform(self.this_tree, self.pb)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
527
        try:
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
528
            self.pp.next_phase()
3008.1.21 by Aaron Bentley
Make compute_transform private, test make_preview_transform
529
            self._compute_transform()
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
530
            self.pp.next_phase()
2590.2.17 by Aaron Bentley
Avoid redundant conflict check
531
            results = self.tt.apply(no_conflicts=True)
1558.4.3 by Aaron Bentley
Merge_modified performance/concurrency fix
532
            self.write_modified(results)
1534.10.12 by Aaron Bentley
Merge produces new conflicts
533
            try:
3008.1.6 by Michael Hudson
chop up Merge3Merger.__init__ into pieces
534
                self.this_tree.add_conflicts(self.cooked_conflicts)
1534.10.12 by Aaron Bentley
Merge produces new conflicts
535
            except UnsupportedOperation:
536
                pass
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
537
        finally:
1711.7.7 by John Arbash Meinel
Don't squelch errors in tt.finalize()
538
            self.tt.finalize()
2255.7.52 by Robert Collins
Lock trees in Merge3Merger correctly.
539
            self.other_tree.unlock()
540
            self.base_tree.unlock()
541
            self.this_tree.unlock()
1551.2.31 by Aaron Bentley
Got merge and revert using nested pbs
542
            self.pb.clear()
1534.7.192 by Aaron Bentley
Record hashes produced by merges
543
3008.1.9 by Michael Hudson
wanton hacking that lets me write an efficient version of get_diff_as_merged
544
    def make_preview_transform(self):
545
        self.base_tree.lock_read()
546
        self.other_tree.lock_read()
547
        self.tt = TransformPreview(self.this_tree)
548
        try:
549
            self.pp.next_phase()
3008.1.21 by Aaron Bentley
Make compute_transform private, test make_preview_transform
550
            self._compute_transform()
3008.1.9 by Michael Hudson
wanton hacking that lets me write an efficient version of get_diff_as_merged
551
            self.pp.next_phase()
552
        finally:
553
            self.other_tree.unlock()
554
            self.base_tree.unlock()
555
            self.pb.clear()
556
        return self.tt
557
3008.1.21 by Aaron Bentley
Make compute_transform private, test make_preview_transform
558
    def _compute_transform(self):
3008.1.6 by Michael Hudson
chop up Merge3Merger.__init__ into pieces
559
        entries = self._entries3()
560
        child_pb = ui.ui_factory.nested_progress_bar()
561
        try:
562
            for num, (file_id, changed, parents3, names3,
563
                      executable3) in enumerate(entries):
564
                child_pb.update('Preparing file merge', num, len(entries))
565
                self._merge_names(file_id, parents3, names3)
566
                if changed:
567
                    file_status = self.merge_contents(file_id)
568
                else:
569
                    file_status = 'unmodified'
570
                self._merge_executable(file_id,
571
                    executable3, file_status)
572
        finally:
573
            child_pb.finished()
574
        self.fix_root()
575
        self.pp.next_phase()
576
        child_pb = ui.ui_factory.nested_progress_bar()
577
        try:
578
            fs_conflicts = resolve_conflicts(self.tt, child_pb,
579
                lambda t, c: conflict_pass(t, c, self.other_tree))
580
        finally:
581
            child_pb.finished()
582
        if self.change_reporter is not None:
583
            from bzrlib import delta
584
            delta.report_changes(
3254.1.1 by Aaron Bentley
Make Tree.iter_changes a public method
585
                self.tt.iter_changes(), self.change_reporter)
3008.1.6 by Michael Hudson
chop up Merge3Merger.__init__ into pieces
586
        self.cook_conflicts(fs_conflicts)
587
        for conflict in self.cooked_conflicts:
588
            warning(conflict)
589
2590.2.4 by Aaron Bentley
Move entry generation to a helper
590
    def _entries3(self):
2590.2.7 by Aaron Bentley
Misc cleanup
591
        """Gather data about files modified between three trees.
592
593
        Return a list of tuples of file_id, changed, parents3, names3,
594
        executable3.  changed is a boolean indicating whether the file contents
595
        or kind were changed.  parents3 is a tuple of parent ids for base,
596
        other and this.  names3 is a tuple of names for base, other and this.
597
        executable3 is a tuple of execute-bit values for base, other and this.
598
        """
2590.2.4 by Aaron Bentley
Move entry generation to a helper
599
        result = []
3254.1.1 by Aaron Bentley
Make Tree.iter_changes a public method
600
        iterator = self.other_tree.iter_changes(self.base_tree,
3514.2.16 by John Arbash Meinel
Review feedback from Ian.
601
                include_unchanged=True, specific_files=self.interesting_files,
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
602
                extra_trees=[self.this_tree])
2590.2.4 by Aaron Bentley
Move entry generation to a helper
603
        for (file_id, paths, changed, versioned, parents, names, kind,
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
604
             executable) in iterator:
2590.2.4 by Aaron Bentley
Move entry generation to a helper
605
            if (self.interesting_ids is not None and
606
                file_id not in self.interesting_ids):
607
                continue
608
            if file_id in self.this_tree.inventory:
609
                entry = self.this_tree.inventory[file_id]
610
                this_name = entry.name
611
                this_parent = entry.parent_id
612
                this_executable = entry.executable
613
            else:
614
                this_name = None
615
                this_parent = None
616
                this_executable = None
617
            parents3 = parents + (this_parent,)
618
            names3 = names + (this_name,)
619
            executable3 = executable + (this_executable,)
620
            result.append((file_id, changed, parents3, names3, executable3))
621
        return result
622
1731.1.33 by Aaron Bentley
Revert no-special-root changes
623
    def fix_root(self):
624
        try:
625
            self.tt.final_kind(self.tt.root)
626
        except NoSuchFile:
627
            self.tt.cancel_deletion(self.tt.root)
628
        if self.tt.final_file_id(self.tt.root) is None:
629
            self.tt.version_file(self.tt.tree_file_id(self.tt.root), 
630
                                 self.tt.root)
631
        if self.other_tree.inventory.root is None:
632
            return
2946.3.3 by John Arbash Meinel
Prefer tree.get_root_id() as more explicit than tree.path2id('')
633
        other_root_file_id = self.other_tree.get_root_id()
1731.1.33 by Aaron Bentley
Revert no-special-root changes
634
        other_root = self.tt.trans_id_file_id(other_root_file_id)
635
        if other_root == self.tt.root:
636
            return
637
        try:
638
            self.tt.final_kind(other_root)
639
        except NoSuchFile:
640
            return
3649.3.1 by Jelmer Vernooij
Merging from a previously joined branch will no longer cause a traceback.
641
        if self.other_tree.inventory.root.file_id in self.this_tree.inventory:
642
            # the other tree's root is a non-root in the current tree
643
            return
1731.1.33 by Aaron Bentley
Revert no-special-root changes
644
        self.reparent_children(self.other_tree.inventory.root, self.tt.root)
645
        self.tt.cancel_creation(other_root)
646
        self.tt.cancel_versioning(other_root)
647
648
    def reparent_children(self, ie, target):
649
        for thing, child in ie.children.iteritems():
650
            trans_id = self.tt.trans_id_file_id(child.file_id)
651
            self.tt.adjust_path(self.tt.final_name(trans_id), target, trans_id)
652
1534.7.192 by Aaron Bentley
Record hashes produced by merges
653
    def write_modified(self, results):
654
        modified_hashes = {}
655
        for path in results.modified_paths:
656
            file_id = self.this_tree.path2id(self.this_tree.relpath(path))
657
            if file_id is None:
658
                continue
659
            hash = self.this_tree.get_file_sha1(file_id)
660
            if hash is None:
661
                continue
662
            modified_hashes[file_id] = hash
663
        self.this_tree.set_merge_modified(modified_hashes)
664
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
665
    @staticmethod
666
    def parent(entry, file_id):
1534.7.157 by Aaron Bentley
Added more docs
667
        """Determine the parent for a file_id (used as a key method)"""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
668
        if entry is None:
669
            return None
670
        return entry.parent_id
671
672
    @staticmethod
673
    def name(entry, file_id):
1534.7.157 by Aaron Bentley
Added more docs
674
        """Determine the name for a file_id (used as a key method)"""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
675
        if entry is None:
676
            return None
677
        return entry.name
678
    
679
    @staticmethod
680
    def contents_sha1(tree, file_id):
1534.7.157 by Aaron Bentley
Added more docs
681
        """Determine the sha1 of the file contents (used as a key method)."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
682
        if file_id not in tree:
683
            return None
684
        return tree.get_file_sha1(file_id)
685
686
    @staticmethod
687
    def executable(tree, file_id):
1534.7.157 by Aaron Bentley
Added more docs
688
        """Determine the executability of a file-id (used as a key method)."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
689
        if file_id not in tree:
690
            return None
691
        if tree.kind(file_id) != "file":
692
            return False
693
        return tree.is_executable(file_id)
694
695
    @staticmethod
696
    def kind(tree, file_id):
1534.7.157 by Aaron Bentley
Added more docs
697
        """Determine the kind of a file-id (used as a key method)."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
698
        if file_id not in tree:
699
            return None
700
        return tree.kind(file_id)
701
702
    @staticmethod
2590.2.8 by Aaron Bentley
Restore conflict handling changes
703
    def _three_way(base, other, this):
704
        #if base == other, either they all agree, or only THIS has changed.
705
        if base == other:
706
            return 'this'
2590.2.10 by Aaron Bentley
Updates from review
707
        elif this not in (base, other):
2590.2.8 by Aaron Bentley
Restore conflict handling changes
708
            return 'conflict'
2590.2.10 by Aaron Bentley
Updates from review
709
        # "Ambiguous clean merge" -- both sides have made the same change.
2590.2.8 by Aaron Bentley
Restore conflict handling changes
710
        elif this == other:
711
            return "this"
2590.2.10 by Aaron Bentley
Updates from review
712
        # this == base: only other has changed.
2590.2.8 by Aaron Bentley
Restore conflict handling changes
713
        else:
714
            return "other"
715
716
    @staticmethod
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
717
    def scalar_three_way(this_tree, base_tree, other_tree, file_id, key):
718
        """Do a three-way test on a scalar.
719
        Return "this", "other" or "conflict", depending whether a value wins.
720
        """
721
        key_base = key(base_tree, file_id)
722
        key_other = key(other_tree, file_id)
723
        #if base == other, either they all agree, or only THIS has changed.
724
        if key_base == key_other:
725
            return "this"
726
        key_this = key(this_tree, file_id)
3376.2.4 by Martin Pool
Remove every assert statement from bzrlib!
727
        # "Ambiguous clean merge"
728
        if key_this == key_other:
729
            return "this"
730
        elif key_this == key_base:
731
            return "other"
732
        else:
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
733
            return "conflict"
734
735
    def merge_names(self, file_id):
736
        def get_entry(tree):
737
            if file_id in tree.inventory:
738
                return tree.inventory[file_id]
739
            else:
740
                return None
741
        this_entry = get_entry(self.this_tree)
742
        other_entry = get_entry(self.other_tree)
743
        base_entry = get_entry(self.base_tree)
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
744
        entries = (base_entry, other_entry, this_entry)
745
        names = []
746
        parents = []
747
        for entry in entries:
748
            if entry is None:
749
                names.append(None)
750
                parents.append(None)
751
            else:
752
                names.append(entry.name)
753
                parents.append(entry.parent_id)
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
754
        return self._merge_names(file_id, parents, names)
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
755
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
756
    def _merge_names(self, file_id, parents, names):
2590.2.7 by Aaron Bentley
Misc cleanup
757
        """Perform a merge on file_id names and parents"""
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
758
        base_name, other_name, this_name = names
759
        base_parent, other_parent, this_parent = parents
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
760
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
761
        name_winner = self._three_way(*names)
762
763
        parent_id_winner = self._three_way(*parents)
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
764
        if this_name is None:
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
765
            if name_winner == "this":
766
                name_winner = "other"
767
            if parent_id_winner == "this":
768
                parent_id_winner = "other"
769
        if name_winner == "this" and parent_id_winner == "this":
770
            return
771
        if name_winner == "conflict":
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
772
            trans_id = self.tt.trans_id_file_id(file_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
773
            self._raw_conflicts.append(('name conflict', trans_id, 
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
774
                                        this_name, other_name))
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
775
        if parent_id_winner == "conflict":
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
776
            trans_id = self.tt.trans_id_file_id(file_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
777
            self._raw_conflicts.append(('parent conflict', trans_id, 
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
778
                                        this_parent, other_parent))
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
779
        if other_name is None:
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
780
            # it doesn't matter whether the result was 'other' or 
781
            # 'conflict'-- if there's no 'other', we leave it alone.
782
            return
783
        # if we get here, name_winner and parent_winner are set to safe values.
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
784
        trans_id = self.tt.trans_id_file_id(file_id)
2590.2.7 by Aaron Bentley
Misc cleanup
785
        parent_id = parents[self.winner_idx[parent_id_winner]]
1731.1.33 by Aaron Bentley
Revert no-special-root changes
786
        if parent_id is not None:
787
            parent_trans_id = self.tt.trans_id_file_id(parent_id)
2590.2.7 by Aaron Bentley
Misc cleanup
788
            self.tt.adjust_path(names[self.winner_idx[name_winner]],
1731.1.33 by Aaron Bentley
Revert no-special-root changes
789
                                parent_trans_id, trans_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
790
791
    def merge_contents(self, file_id):
1534.7.157 by Aaron Bentley
Added more docs
792
        """Performa a merge on file_id contents."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
793
        def contents_pair(tree):
794
            if file_id not in tree:
795
                return (None, None)
796
            kind = tree.kind(file_id)
797
            if kind == "file":
798
                contents = tree.get_file_sha1(file_id)
799
            elif kind == "symlink":
800
                contents = tree.get_symlink_target(file_id)
801
            else:
802
                contents = None
803
            return kind, contents
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
804
805
        def contents_conflict():
806
            trans_id = self.tt.trans_id_file_id(file_id)
807
            name = self.tt.final_name(trans_id)
808
            parent_id = self.tt.final_parent(trans_id)
809
            if file_id in self.this_tree.inventory:
810
                self.tt.unversion_file(trans_id)
1551.10.2 by Aaron Bentley
Handle merge with dangling inventory entries
811
                if file_id in self.this_tree:
812
                    self.tt.delete_contents(trans_id)
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
813
            file_group = self._dump_conflicts(name, parent_id, file_id, 
814
                                              set_version=True)
815
            self._raw_conflicts.append(('contents conflict', file_group))
816
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
817
        # See SPOT run.  run, SPOT, run.
818
        # So we're not QUITE repeating ourselves; we do tricky things with
819
        # file kind...
820
        base_pair = contents_pair(self.base_tree)
821
        other_pair = contents_pair(self.other_tree)
822
        if base_pair == other_pair:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
823
            # OTHER introduced no changes
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
824
            return "unmodified"
825
        this_pair = contents_pair(self.this_tree)
826
        if this_pair == other_pair:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
827
            # THIS and OTHER introduced the same changes
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
828
            return "unmodified"
829
        else:
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
830
            trans_id = self.tt.trans_id_file_id(file_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
831
            if this_pair == base_pair:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
832
                # only OTHER introduced changes
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
833
                if file_id in self.this_tree:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
834
                    # Remove any existing contents
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
835
                    self.tt.delete_contents(trans_id)
1534.7.147 by Aaron Bentley
Tweak to check inventory, not tree for file ids
836
                if file_id in self.other_tree:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
837
                    # OTHER changed the file
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
838
                    create_by_entry(self.tt, 
839
                                    self.other_tree.inventory[file_id], 
840
                                    self.other_tree, trans_id)
1534.7.147 by Aaron Bentley
Tweak to check inventory, not tree for file ids
841
                    if file_id not in self.this_tree.inventory:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
842
                        self.tt.version_file(file_id, trans_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
843
                    return "modified"
1534.7.147 by Aaron Bentley
Tweak to check inventory, not tree for file ids
844
                elif file_id in self.this_tree.inventory:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
845
                    # OTHER deleted the file
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
846
                    self.tt.unversion_file(trans_id)
847
                    return "deleted"
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
848
            #BOTH THIS and OTHER introduced changes; scalar conflict
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
849
            elif this_pair[0] == "file" and other_pair[0] == "file":
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
850
                # THIS and OTHER are both files, so text merge.  Either
851
                # BASE is a file, or both converted to files, so at least we
852
                # have agreement that output should be a file.
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
853
                try:
854
                    self.text_merge(file_id, trans_id)
855
                except BinaryFile:
856
                    return contents_conflict()
1534.7.147 by Aaron Bentley
Tweak to check inventory, not tree for file ids
857
                if file_id not in self.this_tree.inventory:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
858
                    self.tt.version_file(file_id, trans_id)
1534.7.152 by Aaron Bentley
Fixed overwrites
859
                try:
860
                    self.tt.tree_kind(trans_id)
861
                    self.tt.delete_contents(trans_id)
862
                except NoSuchFile:
863
                    pass
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
864
                return "modified"
865
            else:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
866
                # Scalar conflict, can't text merge.  Dump conflicts
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
867
                return contents_conflict()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
868
869
    def get_lines(self, tree, file_id):
1534.7.157 by Aaron Bentley
Added more docs
870
        """Return the lines in a file, or an empty list."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
871
        if file_id in tree:
872
            return tree.get_file(file_id).readlines()
873
        else:
874
            return []
875
876
    def text_merge(self, file_id, trans_id):
877
        """Perform a three-way text merge on a file_id"""
878
        # it's possible that we got here with base as a different type.
879
        # if so, we just want two-way text conflicts.
880
        if file_id in self.base_tree and \
881
            self.base_tree.kind(file_id) == "file":
882
            base_lines = self.get_lines(self.base_tree, file_id)
883
        else:
884
            base_lines = []
885
        other_lines = self.get_lines(self.other_tree, file_id)
886
        this_lines = self.get_lines(self.this_tree, file_id)
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
887
        m3 = Merge3(base_lines, this_lines, other_lines,
888
                    is_cherrypick=self.cherrypick)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
889
        start_marker = "!START OF MERGE CONFLICT!" + "I HOPE THIS IS UNIQUE"
890
        if self.show_base is True:
891
            base_marker = '|' * 7
892
        else:
893
            base_marker = None
894
895
        def iter_merge3(retval):
896
            retval["text_conflicts"] = False
897
            for line in m3.merge_lines(name_a = "TREE", 
898
                                       name_b = "MERGE-SOURCE", 
899
                                       name_base = "BASE-REVISION",
900
                                       start_marker=start_marker, 
901
                                       base_marker=base_marker,
902
                                       reprocess=self.reprocess):
903
                if line.startswith(start_marker):
904
                    retval["text_conflicts"] = True
905
                    yield line.replace(start_marker, '<' * 7)
906
                else:
907
                    yield line
908
        retval = {}
909
        merge3_iterator = iter_merge3(retval)
910
        self.tt.create_file(merge3_iterator, trans_id)
911
        if retval["text_conflicts"] is True:
912
            self._raw_conflicts.append(('text conflict', trans_id))
913
            name = self.tt.final_name(trans_id)
914
            parent_id = self.tt.final_parent(trans_id)
915
            file_group = self._dump_conflicts(name, parent_id, file_id, 
916
                                              this_lines, base_lines,
917
                                              other_lines)
918
            file_group.append(trans_id)
919
920
    def _dump_conflicts(self, name, parent_id, file_id, this_lines=None, 
921
                        base_lines=None, other_lines=None, set_version=False,
922
                        no_base=False):
1534.7.157 by Aaron Bentley
Added more docs
923
        """Emit conflict files.
924
        If this_lines, base_lines, or other_lines are omitted, they will be
925
        determined automatically.  If set_version is true, the .OTHER, .THIS
926
        or .BASE (in that order) will be created as versioned files.
927
        """
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
928
        data = [('OTHER', self.other_tree, other_lines), 
929
                ('THIS', self.this_tree, this_lines)]
930
        if not no_base:
931
            data.append(('BASE', self.base_tree, base_lines))
932
        versioned = False
933
        file_group = []
934
        for suffix, tree, lines in data:
935
            if file_id in tree:
936
                trans_id = self._conflict_file(name, parent_id, tree, file_id,
937
                                               suffix, lines)
938
                file_group.append(trans_id)
939
                if set_version and not versioned:
940
                    self.tt.version_file(file_id, trans_id)
941
                    versioned = True
942
        return file_group
943
           
944
    def _conflict_file(self, name, parent_id, tree, file_id, suffix, 
945
                       lines=None):
1534.7.157 by Aaron Bentley
Added more docs
946
        """Emit a single conflict file."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
947
        name = name + '.' + suffix
948
        trans_id = self.tt.create_path(name, parent_id)
949
        entry = tree.inventory[file_id]
950
        create_by_entry(self.tt, entry, tree, trans_id, lines)
951
        return trans_id
952
953
    def merge_executable(self, file_id, file_status):
1534.7.157 by Aaron Bentley
Added more docs
954
        """Perform a merge on the execute bit."""
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
955
        executable = [self.executable(t, file_id) for t in (self.base_tree,
956
                      self.other_tree, self.this_tree)]
957
        self._merge_executable(file_id, executable, file_status)
958
959
    def _merge_executable(self, file_id, executable, file_status):
960
        """Perform a merge on the execute bit."""
961
        base_executable, other_executable, this_executable = executable
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
962
        if file_status == "deleted":
963
            return
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
964
        winner = self._three_way(*executable)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
965
        if winner == "conflict":
966
        # There must be a None in here, if we have a conflict, but we
967
        # need executability since file status was not deleted.
1534.10.35 by Aaron Bentley
Merge handles contents + executable + deletion conflict
968
            if self.executable(self.other_tree, file_id) is None:
1534.7.142 by Aaron Bentley
Fixed executability conflicts
969
                winner = "this"
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
970
            else:
1534.7.142 by Aaron Bentley
Fixed executability conflicts
971
                winner = "other"
1551.19.30 by Aaron Bentley
Accelerate merge by skipping file existence check when merging execute bit
972
        if winner == 'this' and file_status != "modified":
973
            return
974
        trans_id = self.tt.trans_id_file_id(file_id)
975
        try:
976
            if self.tt.final_kind(trans_id) != "file":
977
                return
978
        except NoSuchFile:
979
            return
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
980
        if winner == "this":
1551.19.30 by Aaron Bentley
Accelerate merge by skipping file existence check when merging execute bit
981
            executability = this_executable
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
982
        else:
983
            if file_id in self.other_tree:
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
984
                executability = other_executable
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
985
            elif file_id in self.this_tree:
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
986
                executability = this_executable
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
987
            elif file_id in self.base_tree:
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
988
                executability = base_executable
1551.19.30 by Aaron Bentley
Accelerate merge by skipping file existence check when merging execute bit
989
        if executability is not None:
990
            trans_id = self.tt.trans_id_file_id(file_id)
991
            self.tt.set_executability(executability, trans_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
992
1534.7.172 by Aaron Bentley
Integrated fs conflicts with merge conflicts.
993
    def cook_conflicts(self, fs_conflicts):
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
994
        """Convert all conflicts into a form that doesn't depend on trans_id"""
1534.10.19 by Aaron Bentley
Stanza conversion, cooking
995
        from conflicts import Conflict
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
996
        name_conflicts = {}
1534.7.172 by Aaron Bentley
Integrated fs conflicts with merge conflicts.
997
        self.cooked_conflicts.extend(cook_conflicts(fs_conflicts, self.tt))
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
998
        fp = FinalPaths(self.tt)
999
        for conflict in self._raw_conflicts:
1000
            conflict_type = conflict[0]
1001
            if conflict_type in ('name conflict', 'parent conflict'):
1002
                trans_id = conflict[1]
1003
                conflict_args = conflict[2:]
1004
                if trans_id not in name_conflicts:
1005
                    name_conflicts[trans_id] = {}
1006
                unique_add(name_conflicts[trans_id], conflict_type, 
1007
                           conflict_args)
1008
            if conflict_type == 'contents conflict':
1009
                for trans_id in conflict[1]:
1010
                    file_id = self.tt.final_file_id(trans_id)
1011
                    if file_id is not None:
1012
                        break
1013
                path = fp.get_path(trans_id)
1014
                for suffix in ('.BASE', '.THIS', '.OTHER'):
1015
                    if path.endswith(suffix):
1016
                        path = path[:-len(suffix)]
1017
                        break
1534.10.19 by Aaron Bentley
Stanza conversion, cooking
1018
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
1019
                self.cooked_conflicts.append(c)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1020
            if conflict_type == 'text conflict':
1021
                trans_id = conflict[1]
1022
                path = fp.get_path(trans_id)
1023
                file_id = self.tt.final_file_id(trans_id)
1534.10.19 by Aaron Bentley
Stanza conversion, cooking
1024
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
1025
                self.cooked_conflicts.append(c)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1026
1027
        for trans_id, conflicts in name_conflicts.iteritems():
1028
            try:
1029
                this_parent, other_parent = conflicts['parent conflict']
3376.2.4 by Martin Pool
Remove every assert statement from bzrlib!
1030
                if this_parent == other_parent:
1031
                    raise AssertionError()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1032
            except KeyError:
1033
                this_parent = other_parent = \
1034
                    self.tt.final_file_id(self.tt.final_parent(trans_id))
1035
            try:
1036
                this_name, other_name = conflicts['name conflict']
3376.2.4 by Martin Pool
Remove every assert statement from bzrlib!
1037
                if this_name == other_name:
1038
                    raise AssertionError()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1039
            except KeyError:
1040
                this_name = other_name = self.tt.final_name(trans_id)
1041
            other_path = fp.get_path(trans_id)
1551.16.2 by Aaron Bentley
Don't crash on merging renamed deleted files (#110279)
1042
            if this_parent is not None and this_name is not None:
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1043
                this_parent_path = \
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
1044
                    fp.get_path(self.tt.trans_id_file_id(this_parent))
1534.7.166 by Aaron Bentley
Swapped os.path.join for pathjoin everywhere
1045
                this_path = pathjoin(this_parent_path, this_name)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1046
            else:
1047
                this_path = "<deleted>"
1048
            file_id = self.tt.final_file_id(trans_id)
1534.10.20 by Aaron Bentley
Got all tests passing
1049
            c = Conflict.factory('path conflict', path=this_path,
1534.10.19 by Aaron Bentley
Stanza conversion, cooking
1050
                                 conflict_path=other_path, file_id=file_id)
1051
            self.cooked_conflicts.append(c)
1666.1.4 by Robert Collins
* 'Metadir' is now the default disk format. This improves behaviour in
1052
        self.cooked_conflicts.sort(key=Conflict.sort_key)
1534.7.141 by Aaron Bentley
Added conflict reporting
1053
1054
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1055
class WeaveMerger(Merge3Merger):
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
1056
    """Three-way tree merger, text weave merger."""
1551.6.8 by Aaron Bentley
Implemented reprocess for weave
1057
    supports_reprocess = True
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1058
    supports_show_base = False
3062.2.7 by Aaron Bentley
Prevent reverse cherry-picking with weave
1059
    supports_reverse_cherrypick = False
3062.2.9 by Aaron Bentley
Don't use the base if not cherrypicking
1060
    history_based = True
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1061
1062
    def _merged_lines(self, file_id):
1063
        """Generate the merged lines.
1064
        There is no distinction between lines that are meant to contain <<<<<<<
1065
        and conflicts.
1066
        """
3062.2.9 by Aaron Bentley
Don't use the base if not cherrypicking
1067
        if self.cherrypick:
1068
            base = self.base_tree
1069
        else:
1070
            base = None
3062.2.4 by Aaron Bentley
Start supporting merge-with-base
1071
        plan = self.this_tree.plan_file_merge(file_id, self.other_tree,
3062.2.9 by Aaron Bentley
Don't use the base if not cherrypicking
1072
                                              base=base)
1551.19.17 by Aaron Bentley
Add debugging flag for merges
1073
        if 'merge' in debug.debug_flags:
1074
            plan = list(plan)
1075
            trans_id = self.tt.trans_id_file_id(file_id)
1076
            name = self.tt.final_name(trans_id) + '.plan'
1077
            contents = ('%10s|%s' % l for l in plan)
1078
            self.tt.new_file(name, self.tt.final_parent(trans_id), contents)
1551.15.52 by Aaron Bentley
Tweak from review comments
1079
        textmerge = PlanWeaveMerge(plan, '<<<<<<< TREE\n',
1080
            '>>>>>>> MERGE-SOURCE\n')
1081
        return textmerge.merge_lines(self.reprocess)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1082
1083
    def text_merge(self, file_id, trans_id):
1534.7.157 by Aaron Bentley
Added more docs
1084
        """Perform a (weave) text merge for a given file and file-id.
1085
        If conflicts are encountered, .THIS and .OTHER files will be emitted,
1086
        and a conflict will be noted.
1087
        """
1551.6.12 by Aaron Bentley
Indicate conflicts from merge_lines, insead of guessing
1088
        lines, conflicts = self._merged_lines(file_id)
1558.15.10 by Aaron Bentley
Merge bzr.dev
1089
        lines = list(lines)
1558.15.5 by Aaron Bentley
Fixed binary handling in weave merge
1090
        # Note we're checking whether the OUTPUT is binary in this case, 
1091
        # because we don't want to get into weave merge guts.
1092
        check_text_lines(lines)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1093
        self.tt.create_file(lines, trans_id)
1094
        if conflicts:
1095
            self._raw_conflicts.append(('text conflict', trans_id))
1096
            name = self.tt.final_name(trans_id)
1097
            parent_id = self.tt.final_parent(trans_id)
1098
            file_group = self._dump_conflicts(name, parent_id, file_id, 
1099
                                              no_base=True)
1100
            file_group.append(trans_id)
1101
1102
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1103
class LCAMerger(WeaveMerger):
1104
1105
    def _merged_lines(self, file_id):
1106
        """Generate the merged lines.
1107
        There is no distinction between lines that are meant to contain <<<<<<<
1108
        and conflicts.
1109
        """
1110
        if self.cherrypick:
1111
            base = self.base_tree
1112
        else:
1113
            base = None
1114
        plan = self.this_tree.plan_file_lca_merge(file_id, self.other_tree,
1115
                                                  base=base)
1116
        if 'merge' in debug.debug_flags:
1117
            plan = list(plan)
1118
            trans_id = self.tt.trans_id_file_id(file_id)
1119
            name = self.tt.final_name(trans_id) + '.plan'
1120
            contents = ('%10s|%s' % l for l in plan)
1121
            self.tt.new_file(name, self.tt.final_parent(trans_id), contents)
1122
        textmerge = PlanWeaveMerge(plan, '<<<<<<< TREE\n',
1123
            '>>>>>>> MERGE-SOURCE\n')
1124
        return textmerge.merge_lines(self.reprocess)
1125
1126
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1127
class Diff3Merger(Merge3Merger):
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
1128
    """Three-way merger using external diff3 for text merging"""
1711.7.20 by John Arbash Meinel
always close files, minor PEP8 cleanup
1129
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1130
    def dump_file(self, temp_dir, name, tree, file_id):
1131
        out_path = pathjoin(temp_dir, name)
1711.7.20 by John Arbash Meinel
always close files, minor PEP8 cleanup
1132
        out_file = open(out_path, "wb")
1133
        try:
1134
            in_file = tree.get_file(file_id)
1135
            for line in in_file:
1136
                out_file.write(line)
1137
        finally:
1138
            out_file.close()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1139
        return out_path
1140
1141
    def text_merge(self, file_id, trans_id):
1534.7.157 by Aaron Bentley
Added more docs
1142
        """Perform a diff3 merge using a specified file-id and trans-id.
1143
        If conflicts are encountered, .BASE, .THIS. and .OTHER conflict files
1144
        will be dumped, and a will be conflict noted.
1145
        """
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1146
        import bzrlib.patch
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
1147
        temp_dir = osutils.mkdtemp(prefix="bzr-")
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1148
        try:
1534.7.166 by Aaron Bentley
Swapped os.path.join for pathjoin everywhere
1149
            new_file = pathjoin(temp_dir, "new")
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1150
            this = self.dump_file(temp_dir, "this", self.this_tree, file_id)
1151
            base = self.dump_file(temp_dir, "base", self.base_tree, file_id)
1152
            other = self.dump_file(temp_dir, "other", self.other_tree, file_id)
1153
            status = bzrlib.patch.diff3(new_file, this, base, other)
1154
            if status not in (0, 1):
1155
                raise BzrError("Unhandled diff3 exit code")
1711.7.20 by John Arbash Meinel
always close files, minor PEP8 cleanup
1156
            f = open(new_file, 'rb')
1157
            try:
1158
                self.tt.create_file(f, trans_id)
1159
            finally:
1160
                f.close()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1161
            if status == 1:
1162
                name = self.tt.final_name(trans_id)
1163
                parent_id = self.tt.final_parent(trans_id)
1164
                self._dump_conflicts(name, parent_id, file_id)
1551.8.39 by Aaron Bentley
Fix diff3 conflict-reporting bug
1165
                self._raw_conflicts.append(('text conflict', trans_id))
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1166
        finally:
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
1167
            osutils.rmtree(temp_dir)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1168
1169
1170
def merge_inner(this_branch, other_tree, base_tree, ignore_zero=False,
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
1171
                backup_files=False,
1172
                merge_type=Merge3Merger,
1173
                interesting_ids=None,
1174
                show_base=False,
1175
                reprocess=False,
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1176
                other_rev_id=None,
1177
                interesting_files=None,
1534.9.9 by Aaron Bentley
Added progress bar to pull
1178
                this_tree=None,
1551.11.10 by Aaron Bentley
Add change reporting to pull
1179
                pb=DummyProgress(),
1180
                change_reporter=None):
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1181
    """Primary interface for merging. 
1182
1183
        typical use is probably 
1184
        'merge_inner(branch, branch.get_revision_tree(other_revision),
1185
                     branch.get_revision_tree(base_revision))'
1186
        """
1187
    if this_tree is None:
2367.2.1 by Robert Collins
Remove bzrlib 0.8 compatability where it was making the code unclear or messy. (Robert Collins)
1188
        raise BzrError("bzrlib.merge.merge_inner requires a this_tree "
1189
            "parameter as of bzrlib version 0.8.")
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
1190
    merger = Merger(this_branch, other_tree, base_tree, this_tree=this_tree,
1551.11.10 by Aaron Bentley
Add change reporting to pull
1191
                    pb=pb, change_reporter=change_reporter)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1192
    merger.backup_files = backup_files
1193
    merger.merge_type = merge_type
1194
    merger.interesting_ids = interesting_ids
1551.2.23 by Aaron Bentley
Got merge_inner's ignore_zero parameter working
1195
    merger.ignore_zero = ignore_zero
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1196
    if interesting_files:
3376.2.4 by Martin Pool
Remove every assert statement from bzrlib!
1197
        if interesting_ids:
1198
            raise ValueError('Only supply interesting_ids'
1199
                             ' or interesting_files')
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
1200
        merger.interesting_files = interesting_files
1979.2.1 by Robert Collins
(robertc) adds a convenience method "merge_from_branch" to WorkingTree.
1201
    merger.show_base = show_base
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1202
    merger.reprocess = reprocess
1203
    merger.other_rev_id = other_rev_id
1204
    merger.other_basis = other_rev_id
3249.3.1 by John Arbash Meinel
Implement cherrypick support for Merge3
1205
    get_revision_id = getattr(base_tree, 'get_revision_id', None)
1206
    if get_revision_id is None:
1207
        get_revision_id = base_tree.last_revision
1208
    merger.set_base_revision(get_revision_id(), this_branch)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1209
    return merger.do_merge()
1210
2221.4.15 by Aaron Bentley
Use RegistryOption for merge type
1211
def get_merge_type_registry():
2221.4.17 by Aaron Bentley
PEP8-ness
1212
    """Merge type registry is in bzrlib.option to avoid circular imports.
2221.4.15 by Aaron Bentley
Use RegistryOption for merge type
1213
1214
    This method provides a sanctioned way to retrieve it.
1215
    """
1216
    from bzrlib import option
2221.4.16 by Aaron Bentley
Add tests for get_merge_type_registry
1217
    return option._merge_type_registry
1551.15.46 by Aaron Bentley
Move plan merge to tree
1218
1219
1220
def _plan_annotate_merge(annotated_a, annotated_b, ancestors_a, ancestors_b):
1221
    def status_a(revision, text):
1222
        if revision in ancestors_b:
1223
            return 'killed-b', text
1224
        else:
1225
            return 'new-a', text
1226
1227
    def status_b(revision, text):
1228
        if revision in ancestors_a:
1229
            return 'killed-a', text
1230
        else:
1231
            return 'new-b', text
1232
1233
    plain_a = [t for (a, t) in annotated_a]
1234
    plain_b = [t for (a, t) in annotated_b]
1235
    matcher = patiencediff.PatienceSequenceMatcher(None, plain_a, plain_b)
1236
    blocks = matcher.get_matching_blocks()
1237
    a_cur = 0
1238
    b_cur = 0
1239
    for ai, bi, l in blocks:
1240
        # process all mismatched sections
1241
        # (last mismatched section is handled because blocks always
1242
        # includes a 0-length last block)
1243
        for revision, text in annotated_a[a_cur:ai]:
1244
            yield status_a(revision, text)
1245
        for revision, text in annotated_b[b_cur:bi]:
1246
            yield status_b(revision, text)
1247
        # and now the matched section
1248
        a_cur = ai + l
1249
        b_cur = bi + l
3376.2.8 by Martin Pool
Some review cleanups for assertion removal
1250
        for text_a in plain_a[ai:a_cur]:
1551.15.46 by Aaron Bentley
Move plan merge to tree
1251
            yield "unchanged", text_a
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1252
1253
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1254
class _PlanMergeBase(object):
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1255
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1256
    def __init__(self, a_rev, b_rev, vf, key_prefix):
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1257
        """Contructor.
1258
1259
        :param a_rev: Revision-id of one revision to merge
1260
        :param b_rev: Revision-id of the other revision to merge
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
1261
        :param vf: A VersionedFiles containing both revisions
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1262
        :param key_prefix: A prefix for accessing keys in vf, typically
1263
            (file_id,).
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1264
        """
1265
        self.a_rev = a_rev
1266
        self.b_rev = b_rev
1267
        self.vf = vf
3062.1.12 by Aaron Bentley
Implement simple text cache
1268
        self._last_lines = None
1269
        self._last_lines_revision_id = None
3144.3.7 by Aaron Bentley
Update from review
1270
        self._cached_matching_blocks = {}
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1271
        self._key_prefix = key_prefix
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1272
        self._precache_tip_lines()
1273
1274
    def _precache_tip_lines(self):
1275
        lines = self.get_lines([self.a_rev, self.b_rev])
1276
        self.lines_a = lines[self.a_rev]
1277
        self.lines_b = lines[self.b_rev]
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
1278
1279
    def get_lines(self, revisions):
1280
        """Get lines for revisions from the backing VersionedFiles.
1281
        
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1282
        :raises RevisionNotPresent: on absent texts.
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
1283
        """
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1284
        keys = [(self._key_prefix + (rev,)) for rev in revisions]
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
1285
        result = {}
1286
        for record in self.vf.get_record_stream(keys, 'unordered', True):
1287
            if record.storage_kind == 'absent':
1288
                raise errors.RevisionNotPresent(record.key, self.vf)
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1289
            result[record.key[-1]] = osutils.split_lines(
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
1290
                record.get_bytes_as('fulltext'))
1291
        return result
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1292
1293
    def plan_merge(self):
1294
        """Generate a 'plan' for merging the two revisions.
1295
1296
        This involves comparing their texts and determining the cause of
1297
        differences.  If text A has a line and text B does not, then either the
1298
        line was added to text A, or it was deleted from B.  Once the causes
1299
        are combined, they are written out in the format described in
1300
        VersionedFile.plan_merge
1301
        """
1302
        blocks = self._get_matching_blocks(self.a_rev, self.b_rev)
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1303
        unique_a, unique_b = self._unique_lines(blocks)
1304
        new_a, killed_b = self._determine_status(self.a_rev, unique_a)
1305
        new_b, killed_a = self._determine_status(self.b_rev, unique_b)
1306
        return self._iter_plan(blocks, new_a, killed_b, new_b, killed_a)
1307
1308
    def _iter_plan(self, blocks, new_a, killed_b, new_b, killed_a):
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1309
        last_i = 0
1310
        last_j = 0
1311
        for i, j, n in blocks:
1312
            for a_index in range(last_i, i):
1313
                if a_index in new_a:
3144.3.2 by Aaron Bentley
Get conflict handling working
1314
                    if a_index in killed_b:
1315
                        yield 'conflicted-a', self.lines_a[a_index]
1316
                    else:
1317
                        yield 'new-a', self.lines_a[a_index]
1318
                else:
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1319
                    yield 'killed-b', self.lines_a[a_index]
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1320
            for b_index in range(last_j, j):
1321
                if b_index in new_b:
3144.3.2 by Aaron Bentley
Get conflict handling working
1322
                    if b_index in killed_a:
3144.3.10 by Aaron Bentley
Use correct index when emitting conflicted-b
1323
                        yield 'conflicted-b', self.lines_b[b_index]
3144.3.2 by Aaron Bentley
Get conflict handling working
1324
                    else:
1325
                        yield 'new-b', self.lines_b[b_index]
1326
                else:
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1327
                    yield 'killed-a', self.lines_b[b_index]
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1328
            # handle common lines
1329
            for a_index in range(i, i+n):
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1330
                yield 'unchanged', self.lines_a[a_index]
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1331
            last_i = i+n
1332
            last_j = j+n
1333
1334
    def _get_matching_blocks(self, left_revision, right_revision):
1335
        """Return a description of which sections of two revisions match.
1336
1337
        See SequenceMatcher.get_matching_blocks
1338
        """
3144.3.7 by Aaron Bentley
Update from review
1339
        cached = self._cached_matching_blocks.get((left_revision,
1340
                                                   right_revision))
1341
        if cached is not None:
1342
            return cached
3062.1.12 by Aaron Bentley
Implement simple text cache
1343
        if self._last_lines_revision_id == left_revision:
1344
            left_lines = self._last_lines
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
1345
            right_lines = self.get_lines([right_revision])[right_revision]
3062.1.12 by Aaron Bentley
Implement simple text cache
1346
        else:
3350.6.4 by Robert Collins
First cut at pluralised VersionedFiles. Some rather massive API incompatabilities, primarily because of the difficulty of coherence among competing stores.
1347
            lines = self.get_lines([left_revision, right_revision])
1348
            left_lines = lines[left_revision]
1349
            right_lines = lines[right_revision]
3062.1.12 by Aaron Bentley
Implement simple text cache
1350
        self._last_lines = right_lines
1351
        self._last_lines_revision_id = right_revision
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1352
        matcher = patiencediff.PatienceSequenceMatcher(None, left_lines,
1353
                                                       right_lines)
1354
        return matcher.get_matching_blocks()
1355
1356
    def _unique_lines(self, matching_blocks):
1357
        """Analyse matching_blocks to determine which lines are unique
1358
1359
        :return: a tuple of (unique_left, unique_right), where the values are
1360
            sets of line numbers of unique lines.
1361
        """
1362
        last_i = 0
1363
        last_j = 0
1364
        unique_left = []
1365
        unique_right = []
1366
        for i, j, n in matching_blocks:
1367
            unique_left.extend(range(last_i, i))
1368
            unique_right.extend(range(last_j, j))
1369
            last_i = i + n
1370
            last_j = j + n
1371
        return unique_left, unique_right
1372
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1373
    @staticmethod
1374
    def _subtract_plans(old_plan, new_plan):
3144.3.7 by Aaron Bentley
Update from review
1375
        """Remove changes from new_plan that came from old_plan.
1376
1377
        It is assumed that the difference between the old_plan and new_plan
1378
        is their choice of 'b' text.
1379
1380
        All lines from new_plan that differ from old_plan are emitted
1381
        verbatim.  All lines from new_plan that match old_plan but are
1382
        not about the 'b' revision are emitted verbatim.
1383
1384
        Lines that match and are about the 'b' revision are the lines we
1385
        don't want, so we convert 'killed-b' -> 'unchanged', and 'new-b'
1386
        is skipped entirely.
1387
        """
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1388
        matcher = patiencediff.PatienceSequenceMatcher(None, old_plan,
1389
                                                       new_plan)
1390
        last_j = 0
1391
        for i, j, n in matcher.get_matching_blocks():
1392
            for jj in range(last_j, j):
1393
                yield new_plan[jj]
1394
            for jj in range(j, j+n):
1395
                plan_line = new_plan[jj]
1396
                if plan_line[0] == 'new-b':
1397
                    pass
1398
                elif plan_line[0] == 'killed-b':
1399
                    yield 'unchanged', plan_line[1]
1400
                else:
1401
                    yield plan_line
1402
            last_j = j + n
1403
1404
1405
class _PlanMerge(_PlanMergeBase):
1406
    """Plan an annotate merge using on-the-fly annotation"""
1407
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1408
    def __init__(self, a_rev, b_rev, vf, key_prefix):
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1409
        super(_PlanMerge, self).__init__(a_rev, b_rev, vf, key_prefix)
1410
        self.a_key = self._key_prefix + (self.a_rev,)
1411
        self.b_key = self._key_prefix + (self.b_rev,)
1412
        self.graph = Graph(self.vf)
3514.2.11 by John Arbash Meinel
Shortcut the case when one revision is in the ancestry of the other.
1413
        heads = self.graph.heads((self.a_key, self.b_key))
1414
        if len(heads) == 1:
1415
            # one side dominates, so we can just return its values, yay for
1416
            # per-file graphs
1417
            # Ideally we would know that before we get this far
1418
            self._head_key = heads.pop()
1419
            if self._head_key == self.a_key:
1420
                other = b_rev
1421
            else:
1422
                other = a_rev
1423
            mutter('found dominating revision for %s\n%s > %s', self.vf,
1424
                   self._head_key[-1], other)
1425
            self._weave = None
1426
        else:
1427
            self._head_key = None
1428
            self._build_weave()
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1429
1430
    def _precache_tip_lines(self):
1431
        # Turn this into a no-op, because we will do this later
1432
        pass
1433
1434
    def _find_recursive_lcas(self):
1435
        """Find all the ancestors back to a unique lca"""
1436
        cur_ancestors = (self.a_key, self.b_key)
1437
        # graph.find_lca(uncommon, keys) now returns plain NULL_REVISION,
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1438
        # rather than a key tuple. We will just map that directly to no common
1439
        # ancestors.
1440
        parent_map = {}
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1441
        while True:
1442
            next_lcas = self.graph.find_lca(*cur_ancestors)
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1443
            # Map a plain NULL_REVISION to a simple no-ancestors
1444
            if next_lcas == set([NULL_REVISION]):
1445
                next_lcas = ()
3514.2.9 by John Arbash Meinel
Add some debugging, and work on getting the graph right so we get the weave insertion order correct.
1446
            # Order the lca's based on when they were merged into the tip
1447
            # While the actual merge portion of weave merge uses a set() of
1448
            # active revisions, the order of insertion *does* effect the
1449
            # implicit ordering of the texts.
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1450
            for rev_key in cur_ancestors:
3514.2.9 by John Arbash Meinel
Add some debugging, and work on getting the graph right so we get the weave insertion order correct.
1451
                ordered_parents = tuple(self.graph.find_merge_order(rev_key,
1452
                                                                    next_lcas))
1453
                parent_map[rev_key] = ordered_parents
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1454
            if len(next_lcas) == 0:
1455
                break
1456
            elif len(next_lcas) == 1:
3514.2.9 by John Arbash Meinel
Add some debugging, and work on getting the graph right so we get the weave insertion order correct.
1457
                parent_map[list(next_lcas)[0]] = ()
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1458
                break
3514.2.10 by John Arbash Meinel
Handle more edge cases.
1459
            elif len(next_lcas) > 2:
3514.2.7 by John Arbash Meinel
Fix the failing test by implementing the fallback logic.
1460
                # More than 2 lca's, fall back to grabbing all nodes between
1461
                # this and the unique lca.
3514.2.16 by John Arbash Meinel
Review feedback from Ian.
1462
                mutter('More than 2 LCAs, falling back to all nodes for:'
1463
                       ' %s, %s\n=> %s', self.a_key, self.b_key, cur_ancestors)
3514.2.7 by John Arbash Meinel
Fix the failing test by implementing the fallback logic.
1464
                cur_lcas = next_lcas
1465
                while len(cur_lcas) > 1:
1466
                    cur_lcas = self.graph.find_lca(*cur_lcas)
1467
                if len(cur_lcas) == 0:
1468
                    # No common base to find, use the full ancestry
1469
                    unique_lca = None
1470
                else:
3514.2.8 by John Arbash Meinel
The insertion ordering into the weave has an impact on conflicts.
1471
                    unique_lca = list(cur_lcas)[0]
3514.2.14 by John Arbash Meinel
Bring in the code to collapse linear portions of the graph.
1472
                    if unique_lca == NULL_REVISION:
1473
                        # find_lca will return a plain 'NULL_REVISION' rather
1474
                        # than a key tuple when there is no common ancestor, we
1475
                        # prefer to just use None, because it doesn't confuse
1476
                        # _get_interesting_texts()
1477
                        unique_lca = None
3514.2.7 by John Arbash Meinel
Fix the failing test by implementing the fallback logic.
1478
                parent_map.update(self._find_unique_parents(next_lcas,
1479
                                                            unique_lca))
1480
                break
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1481
            cur_ancestors = next_lcas
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1482
        return parent_map
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1483
3514.2.7 by John Arbash Meinel
Fix the failing test by implementing the fallback logic.
1484
    def _find_unique_parents(self, tip_keys, base_key):
1485
        """Find ancestors of tip that aren't ancestors of base.
1486
        
1487
        :param tip_keys: Nodes that are interesting
1488
        :param base_key: Cull all ancestors of this node
1489
        :return: The parent map for all revisions between tip_keys and
1490
            base_key. base_key will be included. References to nodes outside of
1491
            the ancestor set will also be removed.
1492
        """
1493
        # TODO: this would be simpler if find_unique_ancestors took a list
1494
        #       instead of a single tip, internally it supports it, but it
1495
        #       isn't a "backwards compatible" api change.
1496
        if base_key is None:
1497
            parent_map = dict(self.graph.iter_ancestry(tip_keys))
3514.2.14 by John Arbash Meinel
Bring in the code to collapse linear portions of the graph.
1498
            # We remove NULL_REVISION because it isn't a proper tuple key, and
1499
            # thus confuses things like _get_interesting_texts, and our logic
1500
            # to add the texts into the memory weave.
1501
            if NULL_REVISION in parent_map:
1502
                parent_map.pop(NULL_REVISION)
3514.2.7 by John Arbash Meinel
Fix the failing test by implementing the fallback logic.
1503
        else:
1504
            interesting = set()
1505
            for tip in tip_keys:
1506
                interesting.update(
1507
                    self.graph.find_unique_ancestors(tip, [base_key]))
1508
            parent_map = self.graph.get_parent_map(interesting)
1509
            parent_map[base_key] = ()
3514.2.12 by John Arbash Meinel
Start refactoring into helper functions
1510
        culled_parent_map, child_map, tails = self._remove_external_references(
1511
            parent_map)
3514.2.13 by John Arbash Meinel
Add the ability to prune extra tails from the parent_map.
1512
        # Remove all the tails but base_key
3514.2.14 by John Arbash Meinel
Bring in the code to collapse linear portions of the graph.
1513
        if base_key is not None:
1514
            tails.remove(base_key)
1515
            self._prune_tails(culled_parent_map, child_map, tails)
1516
        # Now remove all the uninteresting 'linear' regions
3514.2.15 by John Arbash Meinel
Enable collapsing linear regions.
1517
        simple_map = _mod_graph.collapse_linear_regions(culled_parent_map)
1518
        return simple_map
3514.2.12 by John Arbash Meinel
Start refactoring into helper functions
1519
1520
    @staticmethod
1521
    def _remove_external_references(parent_map):
1522
        """Remove references that go outside of the parent map.
1523
1524
        :param parent_map: Something returned from Graph.get_parent_map(keys)
1525
        :return: (filtered_parent_map, child_map, tails)
1526
            filtered_parent_map is parent_map without external references
1527
            child_map is the {parent_key: [child_keys]} mapping
1528
            tails is a list of nodes that do not have any parents in the map
1529
        """
1530
        # TODO: The basic effect of this function seems more generic than
1531
        #       _PlanMerge. But the specific details of building a child_map,
1532
        #       and computing tails seems very specific to _PlanMerge.
1533
        #       Still, should this be in Graph land?
1534
        filtered_parent_map = {}
1535
        child_map = {}
1536
        tails = []
3514.2.7 by John Arbash Meinel
Fix the failing test by implementing the fallback logic.
1537
        for key, parent_keys in parent_map.iteritems():
3514.2.12 by John Arbash Meinel
Start refactoring into helper functions
1538
            culled_parent_keys = [p for p in parent_keys if p in parent_map]
1539
            if not culled_parent_keys:
1540
                tails.append(key)
1541
            for parent_key in culled_parent_keys:
1542
                child_map.setdefault(parent_key, []).append(key)
1543
            # TODO: Do we want to do this, it adds overhead for every node,
1544
            #       just to say that the node has no children
1545
            child_map.setdefault(key, [])
1546
            filtered_parent_map[key] = culled_parent_keys
1547
        return filtered_parent_map, child_map, tails
1548
3514.2.13 by John Arbash Meinel
Add the ability to prune extra tails from the parent_map.
1549
    @staticmethod
1550
    def _prune_tails(parent_map, child_map, tails_to_remove):
1551
        """Remove tails from the parent map.
1552
        
1553
        This will remove the supplied revisions until no more children have 0
1554
        parents.
1555
1556
        :param parent_map: A dict of {child: [parents]}, this dictionary will
1557
            be modified in place.
1558
        :param tails_to_remove: A list of tips that should be removed,
1559
            this list will be consumed
1560
        :param child_map: The reverse dict of parent_map ({parent: [children]})
1561
            this dict will be modified
1562
        :return: None, parent_map will be modified in place.
1563
        """
1564
        while tails_to_remove:
1565
            next = tails_to_remove.pop()
1566
            parent_map.pop(next)
1567
            children = child_map.pop(next)
1568
            for child in children:
1569
                child_parents = parent_map[child]
1570
                child_parents.remove(next)
1571
                if len(child_parents) == 0:
1572
                    tails_to_remove.append(child)
3514.2.7 by John Arbash Meinel
Fix the failing test by implementing the fallback logic.
1573
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1574
    def _get_interesting_texts(self, parent_map):
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1575
        """Return a dict of texts we are interested in.
1576
1577
        Note that the input is in key tuples, but the output is in plain
1578
        revision ids.
1579
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1580
        :param parent_map: The output from _find_recursive_lcas
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1581
        :return: A dict of {'revision_id':lines} as returned by
1582
            _PlanMergeBase.get_lines()
1583
        """
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1584
        all_revision_keys = set(parent_map)
1585
        all_revision_keys.add(self.a_key)
1586
        all_revision_keys.add(self.b_key)
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1587
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1588
        # Everything else is in 'keys' but get_lines is in 'revision_ids'
1589
        all_texts = self.get_lines([k[-1] for k in all_revision_keys])
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1590
        return all_texts
1591
1592
    def _build_weave(self):
1593
        from bzrlib import weave
1594
        self._weave = weave.Weave(weave_name='in_memory_weave',
1595
                                  allow_reserved=True)
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1596
        parent_map = self._find_recursive_lcas()
1597
1598
        all_texts = self._get_interesting_texts(parent_map)
1599
1600
        # Note: Unfortunately, the order given by topo_sort will effect the
1601
        # ordering resolution in the output. Specifically, if you add A then B,
1602
        # then in the output text A lines will show up before B lines. And, of
1603
        # course, topo_sort doesn't guarantee any real ordering.
3514.2.8 by John Arbash Meinel
The insertion ordering into the weave has an impact on conflicts.
1604
        # So we use merge_sort, and add a fake node on the tip.
1605
        # This ensures that left-hand parents will always be inserted into the
1606
        # weave before right-hand parents.
1607
        tip_key = self._key_prefix + (_mod_revision.CURRENT_REVISION,)
1608
        parent_map[tip_key] = (self.a_key, self.b_key)
1609
1610
        for seq_num, key, depth, eom in reversed(tsort.merge_sort(parent_map,
1611
                                                                  tip_key)):
1612
            if key == tip_key:
1613
                continue
3514.2.9 by John Arbash Meinel
Add some debugging, and work on getting the graph right so we get the weave insertion order correct.
1614
        # for key in tsort.topo_sort(parent_map):
3514.2.5 by John Arbash Meinel
Switch to the get_parent_map design I had settled on.
1615
            parent_keys = parent_map[key]
1616
            revision_id = key[-1]
1617
            parent_ids = [k[-1] for k in parent_keys]
1618
            self._weave.add_lines(revision_id, parent_ids,
1619
                                  all_texts[revision_id])
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1620
1621
    def plan_merge(self):
1622
        """Generate a 'plan' for merging the two revisions.
1623
1624
        This involves comparing their texts and determining the cause of
1625
        differences.  If text A has a line and text B does not, then either the
1626
        line was added to text A, or it was deleted from B.  Once the causes
1627
        are combined, they are written out in the format described in
1628
        VersionedFile.plan_merge
1629
        """
1630
        if self._head_key is not None: # There was a single head
1631
            if self._head_key == self.a_key:
1632
                plan = 'new-a'
3062.1.9 by Aaron Bentley
Move PlanMerge into merge and _PlanMergeVersionedFile into versionedfile
1633
            else:
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1634
                if self._head_key != self.b_key:
1635
                    raise AssertionError('There was an invalid head: %s != %s'
1636
                                         % (self.b_key, self._head_key))
1637
                plan = 'new-b'
3514.2.16 by John Arbash Meinel
Review feedback from Ian.
1638
            head_rev = self._head_key[-1]
1639
            lines = self.get_lines([head_rev])[head_rev]
3514.2.2 by John Arbash Meinel
Restore a real weave merge to 'bzr merge --weave'.
1640
            return ((plan, line) for line in lines)
1641
        return self._weave.plan_merge(self.a_rev, self.b_rev)
3062.2.1 by Aaron Bentley
Add support for plan-merge with a base
1642
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1643
1644
class _PlanLCAMerge(_PlanMergeBase):
1645
    """
3144.3.7 by Aaron Bentley
Update from review
1646
    This merge algorithm differs from _PlanMerge in that:
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1647
    1. comparisons are done against LCAs only
1648
    2. cases where a contested line is new versus one LCA but old versus
3144.3.7 by Aaron Bentley
Update from review
1649
       another are marked as conflicts, by emitting the line as conflicted-a
1650
       or conflicted-b.
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1651
1652
    This is faster, and hopefully produces more useful output.
1653
    """
1654
3350.6.10 by Martin Pool
VersionedFiles review cleanups
1655
    def __init__(self, a_rev, b_rev, vf, key_prefix, graph):
1656
        _PlanMergeBase.__init__(self, a_rev, b_rev, vf, key_prefix)
1657
        lcas = graph.find_lca(key_prefix + (a_rev,), key_prefix + (b_rev,))
3350.6.5 by Robert Collins
Update to bzr.dev.
1658
        self.lcas = set()
1659
        for lca in lcas:
1660
            if lca == NULL_REVISION:
1661
                self.lcas.add(lca)
1662
            else:
1663
                self.lcas.add(lca[-1])
3144.3.7 by Aaron Bentley
Update from review
1664
        for lca in self.lcas:
3287.17.1 by John Arbash Meinel
Fix bug #235715 by using the empty list as the text for a base of NULL_REVISION.
1665
            if _mod_revision.is_null(lca):
1666
                lca_lines = []
1667
            else:
3350.6.5 by Robert Collins
Update to bzr.dev.
1668
                lca_lines = self.get_lines([lca])[lca]
3144.3.7 by Aaron Bentley
Update from review
1669
            matcher = patiencediff.PatienceSequenceMatcher(None, self.lines_a,
1670
                                                           lca_lines)
1671
            blocks = list(matcher.get_matching_blocks())
1672
            self._cached_matching_blocks[(a_rev, lca)] = blocks
1673
            matcher = patiencediff.PatienceSequenceMatcher(None, self.lines_b,
1674
                                                           lca_lines)
1675
            blocks = list(matcher.get_matching_blocks())
1676
            self._cached_matching_blocks[(b_rev, lca)] = blocks
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1677
3144.3.7 by Aaron Bentley
Update from review
1678
    def _determine_status(self, revision_id, unique_line_numbers):
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1679
        """Determines the status unique lines versus all lcas.
1680
1681
        Basically, determines why the line is unique to this revision.
1682
1683
        A line may be determined new, killed, or both.
1684
3144.3.7 by Aaron Bentley
Update from review
1685
        If a line is determined new, that means it was not present in at least
1686
        one LCA, and is not present in the other merge revision.
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1687
1688
        If a line is determined killed, that means the line was present in
1689
        at least one LCA.
1690
1691
        If a line is killed and new, this indicates that the two merge
1692
        revisions contain differing conflict resolutions.
3144.3.7 by Aaron Bentley
Update from review
1693
        :param revision_id: The id of the revision in which the lines are
1694
            unique
1695
        :param unique_line_numbers: The line numbers of unique lines.
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1696
        :return a tuple of (new_this, killed_other):
1697
        """
1698
        new = set()
1699
        killed = set()
3144.3.7 by Aaron Bentley
Update from review
1700
        unique_line_numbers = set(unique_line_numbers)
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1701
        for lca in self.lcas:
1702
            blocks = self._get_matching_blocks(revision_id, lca)
1703
            unique_vs_lca, _ignored = self._unique_lines(blocks)
3144.3.7 by Aaron Bentley
Update from review
1704
            new.update(unique_line_numbers.intersection(unique_vs_lca))
1705
            killed.update(unique_line_numbers.difference(unique_vs_lca))
3144.3.1 by Aaron Bentley
Implement LCA merge, with problematic conflict markers
1706
        return new, killed