/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
1692.7.6 by Martin Pool
[patch] force deletion of trees containing readonly files (alexander)
1
# Copyright (C) 2005, 2006 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
1185.1.2 by Martin Pool
- merge various windows and other fixes from Ollie Rutherfurd
18
import os
1545.2.6 by Aaron Bentley
Removed _merge, renamed MergeConflictHandler to _MergeConflictHandler
19
import errno
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
20
import warnings
1113 by Martin Pool
- fix is_ancestor import problem in merge
21
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
22
from bzrlib import (
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
23
    errors,
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
24
    osutils,
2221.4.15 by Aaron Bentley
Use RegistryOption for merge type
25
    registry,
2598.5.1 by Aaron Bentley
Start eliminating the use of None to indicate null revision
26
    revision as _mod_revision,
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
27
    )
1185.11.5 by John Arbash Meinel
Merged up-to-date against mainline, still broken.
28
from bzrlib.branch import Branch
1666.1.4 by Robert Collins
* 'Metadir' is now the default disk format. This improves behaviour in
29
from bzrlib.conflicts import ConflictList, Conflict
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
30
from bzrlib.errors import (BzrCommandError,
1534.4.28 by Robert Collins
first cut at merge from integration.
31
                           BzrError,
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
32
                           NoCommonAncestor,
33
                           NoCommits,
1534.4.28 by Robert Collins
first cut at merge from integration.
34
                           NoSuchRevision,
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
35
                           NoSuchFile,
1545.2.6 by Aaron Bentley
Removed _merge, renamed MergeConflictHandler to _MergeConflictHandler
36
                           NotBranchError,
1185.33.27 by Martin Pool
[merge] much integrated work from robert and john
37
                           NotVersionedError,
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
38
                           UnrelatedBranches,
1534.10.12 by Aaron Bentley
Merge produces new conflicts
39
                           UnsupportedOperation,
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
40
                           WorkingTreeNotRevision,
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
41
                           BinaryFile,
1534.4.28 by Robert Collins
first cut at merge from integration.
42
                           )
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
43
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.
44
from bzrlib.osutils import rename, pathjoin
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
45
from progress import DummyProgress, ProgressPhase
2490.2.6 by Aaron Bentley
Use new common-ancestor code everywhere
46
from bzrlib.revision import (is_ancestor, NULL_REVISION, ensure_null)
1558.15.5 by Aaron Bentley
Fixed binary handling in weave merge
47
from bzrlib.textfile import check_text_lines
1545.2.6 by Aaron Bentley
Removed _merge, renamed MergeConflictHandler to _MergeConflictHandler
48
from bzrlib.trace import mutter, warning, note
1534.7.172 by Aaron Bentley
Integrated fs conflicts with merge conflicts.
49
from bzrlib.transform import (TreeTransform, resolve_conflicts, cook_conflicts,
2590.2.8 by Aaron Bentley
Restore conflict handling changes
50
                              conflict_pass, FinalPaths, create_by_entry,
51
                              unique_add, ROOT_PARENT)
1551.6.8 by Aaron Bentley
Implemented reprocess for weave
52
from bzrlib.versionedfile import WeaveMerge
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
53
from bzrlib import ui
1545.2.6 by Aaron Bentley
Removed _merge, renamed MergeConflictHandler to _MergeConflictHandler
54
55
# TODO: Report back as changes are merged in
56
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.
57
1185.35.4 by Aaron Bentley
Implemented remerge
58
def transform_tree(from_tree, to_tree, interesting_ids=None):
59
    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
60
                interesting_ids=interesting_ids, this_tree=from_tree)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
61
1457.1.12 by Robert Collins
Update comment to reflect author.
62
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
63
class Merger(object):
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
64
    def __init__(self, this_branch, other_tree=None, base_tree=None,
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
65
                 this_tree=None, pb=DummyProgress(), change_reporter=None,
66
                 recurse='down'):
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
67
        object.__init__(self)
1534.4.26 by Robert Collins
Move working tree initialisation out from Branch.initialize, deprecated Branch.initialize to Branch.create.
68
        assert this_tree is not None, "this_tree is required"
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
69
        self.this_branch = this_branch
2598.5.4 by Aaron Bentley
Restore original Branch.last_revision behavior, fix bits that care
70
        self.this_basis = _mod_revision.ensure_null(
71
            this_branch.last_revision())
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
72
        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.
73
        self.this_tree = this_tree
1185.12.83 by Aaron Bentley
Preliminary weave merge support
74
        self.this_revision_tree = None
1185.35.5 by Aaron Bentley
Made weave merge succeed if interesting files match history
75
        self.this_basis_tree = None
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
76
        self.other_tree = other_tree
2100.3.29 by Aaron Bentley
Get merge working initially
77
        self.other_branch = None
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
78
        self.base_tree = base_tree
79
        self.ignore_zero = False
80
        self.backup_files = False
81
        self.interesting_ids = None
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
82
        self.interesting_files = None
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
83
        self.show_base = False
1185.24.3 by Aaron Bentley
Integrated reprocessing into the rest of the merge stuff
84
        self.reprocess = False
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
85
        self._pb = pb
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
86
        self.pp = None
2100.3.29 by Aaron Bentley
Get merge working initially
87
        self.recurse = recurse
1551.11.9 by Aaron Bentley
Apply change reporting to merge
88
        self.change_reporter = change_reporter
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
89
        self._cached_trees = {}
90
91
    def revision_tree(self, revision_id, branch=None):
92
        if revision_id not in self._cached_trees:
93
            if branch is None:
94
                branch = self.this_branch
95
            try:
96
                tree = self.this_tree.revision_tree(revision_id)
97
            except errors.NoSuchRevisionInTree:
98
                tree = branch.repository.revision_tree(revision_id)
99
            self._cached_trees[revision_id] = tree
100
        return self._cached_trees[revision_id]
101
102
    def _get_tree(self, treespec):
103
        from bzrlib import workingtree
104
        location, revno = treespec
105
        if revno is None:
106
            tree = workingtree.WorkingTree.open_containing(location)[0]
107
            return tree.branch, tree
108
        branch = Branch.open_containing(location)[0]
109
        if revno == -1:
110
            revision_id = branch.last_revision()
111
        else:
112
            revision_id = branch.get_rev_id(revno)
113
        revision_id = ensure_null(revision_id)
114
        return branch, self.revision_tree(revision_id, branch)
1185.12.83 by Aaron Bentley
Preliminary weave merge support
115
116
    def ensure_revision_trees(self):
117
        if self.this_revision_tree is None:
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
118
            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
119
            if self.this_basis == self.this_rev_id:
120
                self.this_revision_tree = self.this_basis_tree
121
1185.12.83 by Aaron Bentley
Preliminary weave merge support
122
        if self.other_rev_id is None:
123
            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.
124
            changes = other_basis_tree.changes_from(self.other_tree)
1185.12.83 by Aaron Bentley
Preliminary weave merge support
125
            if changes.has_changed():
126
                raise WorkingTreeNotRevision(self.this_tree)
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
127
            other_rev_id = self.other_basis
1185.12.83 by Aaron Bentley
Preliminary weave merge support
128
            self.other_tree = other_basis_tree
129
130
    def file_revisions(self, file_id):
131
        self.ensure_revision_trees()
132
        def get_id(tree, file_id):
133
            revision_id = tree.inventory[file_id].revision
134
            assert revision_id is not None
135
            return revision_id
1185.35.5 by Aaron Bentley
Made weave merge succeed if interesting files match history
136
        if self.this_rev_id is None:
137
            if self.this_basis_tree.get_file_sha1(file_id) != \
138
                self.this_tree.get_file_sha1(file_id):
139
                raise WorkingTreeNotRevision(self.this_tree)
140
141
        trees = (self.this_basis_tree, self.other_tree)
1185.12.83 by Aaron Bentley
Preliminary weave merge support
142
        return [get_id(tree, file_id) for tree in trees]
143
1185.82.44 by Aaron Bentley
Switch to merge_changeset in test suite
144
    def check_basis(self, check_clean, require_commits=True):
145
        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
146
            raise BzrCommandError("This branch has no commits."
147
                                  " (perhaps you would prefer 'bzr pull')")
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
148
        if check_clean:
149
            self.compare_basis()
150
            if self.this_basis != self.this_rev_id:
151
                raise BzrCommandError("Working tree has uncommitted changes.")
152
153
    def compare_basis(self):
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
154
        try:
155
            basis_tree = self.revision_tree(self.this_tree.last_revision())
156
        except errors.RevisionNotPresent:
157
            basis_tree = self.this_tree.basis_tree()
158
        changes = self.this_tree.changes_from(basis_tree)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
159
        if not changes.has_changed():
160
            self.this_rev_id = self.this_basis
161
162
    def set_interesting_files(self, file_list):
2590.2.7 by Aaron Bentley
Misc cleanup
163
        self.interesting_files = file_list
1457.1.8 by Robert Collins
Replace the WorkingTree.revert method algorithm with a call to merge_inner.
164
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
165
    def set_pending(self):
2590.3.2 by Aaron Bentley
Avoid redundant is_ancestor checks
166
        if not self.base_is_ancestor or not self.base_is_other_ancestor:
1185.12.77 by Aaron Bentley
Prevented all ancestors from being marked as pending merges
167
            return
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
168
        self._add_parent()
169
170
    def _add_parent(self):
171
        new_parents = self.this_tree.get_parent_ids() + [self.other_rev_id]
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
172
        new_parent_trees = []
173
        for revision_id in new_parents:
174
            try:
175
                tree = self.revision_tree(revision_id)
176
            except errors.RevisionNotPresent:
177
                tree = None
178
            else:
179
                tree.lock_read()
180
            new_parent_trees.append((revision_id, tree))
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
181
        try:
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
182
            self.this_tree.set_parent_trees(new_parent_trees,
183
                                            allow_leftmost_as_ghost=True)
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
184
        finally:
185
            for _revision_id, tree in new_parent_trees:
2590.2.20 by Aaron Bentley
Fix handling of ghost base trees
186
                if tree is not None:
187
                    tree.unlock()
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
188
189
    def set_other(self, other_revision):
1979.2.1 by Robert Collins
(robertc) adds a convenience method "merge_from_branch" to WorkingTree.
190
        """Set the revision and tree to merge from.
191
192
        This sets the other_tree, other_rev_id, other_basis attributes.
193
194
        :param other_revision: The [path, revision] list to merge from.
195
        """
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
196
        self.other_branch, self.other_tree = self._get_tree(other_revision)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
197
        if other_revision[1] == -1:
2598.5.4 by Aaron Bentley
Restore original Branch.last_revision behavior, fix bits that care
198
            self.other_rev_id = _mod_revision.ensure_null(
199
                self.other_branch.last_revision())
2598.5.1 by Aaron Bentley
Start eliminating the use of None to indicate null revision
200
            if _mod_revision.is_null(self.other_rev_id):
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
201
                raise NoCommits(self.other_branch)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
202
            self.other_basis = self.other_rev_id
203
        elif other_revision[1] is not None:
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
204
            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
205
            self.other_basis = self.other_rev_id
206
        else:
207
            self.other_rev_id = None
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
208
            self.other_basis = self.other_branch.last_revision()
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
209
            if self.other_basis is None:
2100.3.31 by Aaron Bentley
Merged bzr.dev (17 tests failing)
210
                raise NoCommits(self.other_branch)
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
211
        if self.other_rev_id is not None:
212
            self._cached_trees[self.other_rev_id] = self.other_tree
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
213
        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
214
2100.3.29 by Aaron Bentley
Get merge working initially
215
    def set_other_revision(self, revision_id, other_branch):
216
        """Set 'other' based on a branch and revision id
217
218
        :param revision_id: The revision to use for a tree
219
        :param other_branch: The branch containing this tree
220
        """
221
        self.other_rev_id = revision_id
222
        self.other_branch = other_branch
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
223
        self._maybe_fetch(other_branch, self.this_branch, self.other_rev_id)
2100.3.29 by Aaron Bentley
Get merge working initially
224
        self.other_tree = self.revision_tree(revision_id)
225
        self.other_basis = revision_id
226
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
227
    def _maybe_fetch(self, source, target, revision_id):
228
        if (source.repository.bzrdir.root_transport.base !=
229
            target.repository.bzrdir.root_transport.base):
230
            target.fetch(source, revision_id)
231
1185.82.25 by Aaron Bentley
Added changeset-merging functionality
232
    def find_base(self):
2590.2.22 by Aaron Bentley
Remove cruft
233
        this_repo = self.this_branch.repository
234
        graph = this_repo.get_graph()
235
        revisions = [ensure_null(self.this_basis),
236
                     ensure_null(self.other_basis)]
237
        if NULL_REVISION in revisions:
238
            self.base_rev_id = NULL_REVISION
239
        else:
240
            self.base_rev_id = graph.find_unique_lca(*revisions)
241
            if self.base_rev_id == NULL_REVISION:
242
                raise UnrelatedBranches()
2590.2.13 by Aaron Bentley
Make find_base implement the base_finding code
243
        self.base_tree = self.revision_tree(self.base_rev_id)
244
        self.base_is_ancestor = True
2590.2.18 by Aaron Bentley
Merge is_ancestor fix
245
        self.base_is_other_ancestor = True
1185.82.25 by Aaron Bentley
Added changeset-merging functionality
246
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
247
    def set_base(self, base_revision):
1979.2.1 by Robert Collins
(robertc) adds a convenience method "merge_from_branch" to WorkingTree.
248
        """Set the base revision to use for the merge.
249
250
        :param base_revision: A 2-list containing a path and revision number.
251
        """
1185.12.96 by Aaron Bentley
Merge from mpool
252
        mutter("doing merge() with no base_revision specified")
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
253
        if base_revision == [None, None]:
2590.2.13 by Aaron Bentley
Make find_base implement the base_finding code
254
            self.find_base()
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
255
        else:
2590.2.11 by Aaron Bentley
Aggressively cache trees, use dirstate. re-mplement _add_parent.
256
            base_branch, self.base_tree = self._get_tree(base_revision)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
257
            if base_revision[1] == -1:
258
                self.base_rev_id = base_branch.last_revision()
259
            elif base_revision[1] is None:
2598.5.3 by Aaron Bentley
Push NULL_REVISION deeper
260
                self.base_rev_id = _mod_revision.NULL_REVISION
493 by Martin Pool
- Merge aaron's merge command
261
            else:
2598.5.3 by Aaron Bentley
Push NULL_REVISION deeper
262
                self.base_rev_id = _mod_revision.ensure_null(
263
                    base_branch.get_rev_id(base_revision[1]))
2590.2.19 by Aaron Bentley
Avoid fetch within a repository
264
            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
265
            self.base_is_ancestor = is_ancestor(self.this_basis, 
266
                                                self.base_rev_id,
267
                                                self.this_branch)
2590.3.2 by Aaron Bentley
Avoid redundant is_ancestor checks
268
            self.base_is_other_ancestor = is_ancestor(self.other_basis,
269
                                                      self.base_rev_id,
270
                                                      self.this_branch)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
271
272
    def do_merge(self):
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
273
        kwargs = {'working_tree':self.this_tree, 'this_tree': self.this_tree,
274
                  'other_tree': self.other_tree,
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
275
                  'interesting_ids': self.interesting_ids,
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
276
                  'interesting_files': self.interesting_files,
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
277
                  'pp': self.pp}
1534.7.84 by Aaron Bentley
Added reprocess support, support for varying merge types
278
        if self.merge_type.requires_base:
279
            kwargs['base_tree'] = self.base_tree
1534.7.137 by Aaron Bentley
Avoided generating a new tree for every weave merge
280
        if self.merge_type.supports_reprocess:
281
            kwargs['reprocess'] = self.reprocess
282
        elif self.reprocess:
1551.6.14 by Aaron Bentley
Tweaks from merge review
283
            raise BzrError("Conflict reduction is not supported for merge"
284
                                  " type %s." % self.merge_type)
1534.7.137 by Aaron Bentley
Avoided generating a new tree for every weave merge
285
        if self.merge_type.supports_show_base:
286
            kwargs['show_base'] = self.show_base
287
        elif self.show_base:
1534.8.2 by Aaron Bentley
Implemented weave merge
288
            raise BzrError("Showing base is not supported for this"
289
                                  " merge type. %s" % self.merge_type)
2255.2.50 by John Arbash Meinel
merge only needs a lock_tree_write() on the working tree, not a full lock_write()
290
        self.this_tree.lock_tree_write()
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
291
        if self.base_tree is not None:
292
            self.base_tree.lock_read()
293
        if self.other_tree is not None:
294
            self.other_tree.lock_read()
295
        try:
2255.2.83 by John Arbash Meinel
[merge] bzr.dev 2294
296
            merge = self.merge_type(pb=self._pb,
297
                                    change_reporter=self.change_reporter,
298
                                    **kwargs)
2255.2.226 by Robert Collins
Get merge_nested finally working: change nested tree iterators to take file_ids, and ensure the right branch is connected to in the merge logic. May not be suitable for shared repositories yet.
299
            if self.recurse == 'down':
300
                for path, file_id in self.this_tree.iter_references():
301
                    sub_tree = self.this_tree.get_nested_tree(file_id, path)
302
                    other_revision = self.other_tree.get_reference_revision(
303
                        file_id, path)
304
                    if  other_revision == sub_tree.last_revision():
305
                        continue
306
                    sub_merge = Merger(sub_tree.branch, this_tree=sub_tree)
307
                    sub_merge.merge_type = self.merge_type
308
                    relpath = self.this_tree.relpath(path)
309
                    other_branch = self.other_branch.reference_parent(file_id, relpath)
310
                    sub_merge.set_other_revision(other_revision, other_branch)
311
                    base_revision = self.base_tree.get_reference_revision(file_id)
312
                    sub_merge.base_tree = \
313
                        sub_tree.branch.repository.revision_tree(base_revision)
314
                    sub_merge.do_merge()
315
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
316
        finally:
317
            if self.other_tree is not None:
318
                self.other_tree.unlock()
319
            if self.base_tree is not None:
320
                self.base_tree.unlock()
321
            self.this_tree.unlock()
1534.7.151 by Aaron Bentley
Fixed all changes applied successfully
322
        if len(merge.cooked_conflicts) == 0:
1534.7.141 by Aaron Bentley
Added conflict reporting
323
            if not self.ignore_zero:
324
                note("All changes applied successfully.")
325
        else:
326
            note("%d conflicts encountered." % len(merge.cooked_conflicts))
327
1534.7.134 by Aaron Bentley
Hid raw conflicts
328
        return len(merge.cooked_conflicts)
1185.12.76 by Aaron Bentley
Refactored merge and merge_inner to use Merger
329
1545.2.4 by Aaron Bentley
PEP8 fixes
330
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
331
class Merge3Merger(object):
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
332
    """Three-way merger that uses the merge3 text merger"""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
333
    requires_base = True
334
    supports_reprocess = True
335
    supports_show_base = True
336
    history_based = False
2590.2.7 by Aaron Bentley
Misc cleanup
337
    winner_idx = {"this": 2, "other": 1, "conflict": 1}
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
338
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
339
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
1558.2.2 by Aaron Bentley
Make remerge honour interesting-ids
340
                 interesting_ids=None, reprocess=False, show_base=False,
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
341
                 pb=DummyProgress(), pp=None, change_reporter=None,
342
                 interesting_files=None):
2590.2.10 by Aaron Bentley
Updates from review
343
        """Initialize the merger object and perform the merge.
344
345
        :param working_tree: The working tree to apply the merge to
346
        :param this_tree: The local tree in the merge operation
347
        :param base_tree: The common tree in the merge operation
348
        :param other_tree: The other other tree to merge changes from
349
        :param interesting_ids: The file_ids of files that should be
350
            participate in the merge.  May not be combined with
351
            interesting_files.
352
        :param: reprocess If True, perform conflict-reduction processing.
353
        :param show_base: If True, show the base revision in text conflicts.
354
            (incompatible with reprocess)
355
        :param pb: A Progress bar
356
        :param pp: A ProgressPhase object
357
        :param change_reporter: An object that should report changes made
358
        :param interesting_files: The tree-relative paths of files that should
359
            participate in the merge.  If these paths refer to directories,
360
            the contents of those directories will also be included.  May not
361
            be combined with interesting_ids.  If neither interesting_files nor
362
            interesting_ids is specified, all files may participate in the
363
            merge.
364
        """
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
365
        object.__init__(self)
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
366
        if interesting_files is not None:
367
            assert interesting_ids is None
2590.2.4 by Aaron Bentley
Move entry generation to a helper
368
        self.interesting_ids = interesting_ids
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
369
        self.interesting_files = interesting_files
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
370
        self.this_tree = working_tree
2255.7.52 by Robert Collins
Lock trees in Merge3Merger correctly.
371
        self.this_tree.lock_tree_write()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
372
        self.base_tree = base_tree
2255.7.52 by Robert Collins
Lock trees in Merge3Merger correctly.
373
        self.base_tree.lock_read()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
374
        self.other_tree = other_tree
2255.7.52 by Robert Collins
Lock trees in Merge3Merger correctly.
375
        self.other_tree.lock_read()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
376
        self._raw_conflicts = []
377
        self.cooked_conflicts = []
378
        self.reprocess = reprocess
379
        self.show_base = show_base
1534.9.1 by Aaron Bentley
Added progress bars to merge
380
        self.pb = pb
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
381
        self.pp = pp
1551.11.9 by Aaron Bentley
Apply change reporting to merge
382
        self.change_reporter = change_reporter
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
383
        if self.pp is None:
384
            self.pp = ProgressPhase("Merge phase", 3, self.pb)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
385
1534.9.1 by Aaron Bentley
Added progress bars to merge
386
        self.tt = TreeTransform(working_tree, self.pb)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
387
        try:
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
388
            self.pp.next_phase()
2590.2.4 by Aaron Bentley
Move entry generation to a helper
389
            entries = self._entries3()
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
390
            child_pb = ui.ui_factory.nested_progress_bar()
1551.2.31 by Aaron Bentley
Got merge and revert using nested pbs
391
            try:
2590.2.4 by Aaron Bentley
Move entry generation to a helper
392
                for num, (file_id, changed, parents3, names3,
393
                          executable3) in enumerate(entries):
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
394
                    child_pb.update('Preparing file merge', num, len(entries))
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
395
                    self._merge_names(file_id, parents3, names3)
396
                    if changed:
397
                        file_status = self.merge_contents(file_id)
398
                    else:
399
                        file_status = 'unmodified'
400
                    self._merge_executable(file_id,
401
                        executable3, file_status)
1551.2.31 by Aaron Bentley
Got merge and revert using nested pbs
402
            finally:
403
                child_pb.finished()
1731.1.33 by Aaron Bentley
Revert no-special-root changes
404
            self.fix_root()
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
405
            self.pp.next_phase()
1773.4.1 by Martin Pool
Add pyflakes makefile target; fix many warnings
406
            child_pb = ui.ui_factory.nested_progress_bar()
1551.2.31 by Aaron Bentley
Got merge and revert using nested pbs
407
            try:
2590.2.8 by Aaron Bentley
Restore conflict handling changes
408
                fs_conflicts = resolve_conflicts(self.tt, child_pb,
409
                    lambda t, c: conflict_pass(t, c, self.other_tree))
1551.2.31 by Aaron Bentley
Got merge and revert using nested pbs
410
            finally:
411
                child_pb.finished()
1551.11.9 by Aaron Bentley
Apply change reporting to merge
412
            if change_reporter is not None:
1551.11.12 by Aaron Bentley
Changes from review
413
                from bzrlib import delta
1551.11.9 by Aaron Bentley
Apply change reporting to merge
414
                delta.report_changes(self.tt._iter_changes(), change_reporter)
1534.7.172 by Aaron Bentley
Integrated fs conflicts with merge conflicts.
415
            self.cook_conflicts(fs_conflicts)
1534.10.24 by Aaron Bentley
Eliminated conflicts_to_strings, made remove_files a ConflictList member
416
            for conflict in self.cooked_conflicts:
417
                warning(conflict)
1551.2.32 by Aaron Bentley
Handle progress phases more nicely in merge
418
            self.pp.next_phase()
2590.2.17 by Aaron Bentley
Avoid redundant conflict check
419
            results = self.tt.apply(no_conflicts=True)
1558.4.3 by Aaron Bentley
Merge_modified performance/concurrency fix
420
            self.write_modified(results)
1534.10.12 by Aaron Bentley
Merge produces new conflicts
421
            try:
1551.7.11 by Aaron Bentley
Add WorkingTree.add_conflicts
422
                working_tree.add_conflicts(self.cooked_conflicts)
1534.10.12 by Aaron Bentley
Merge produces new conflicts
423
            except UnsupportedOperation:
424
                pass
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
425
        finally:
1711.7.7 by John Arbash Meinel
Don't squelch errors in tt.finalize()
426
            self.tt.finalize()
2255.7.52 by Robert Collins
Lock trees in Merge3Merger correctly.
427
            self.other_tree.unlock()
428
            self.base_tree.unlock()
429
            self.this_tree.unlock()
1551.2.31 by Aaron Bentley
Got merge and revert using nested pbs
430
            self.pb.clear()
1534.7.192 by Aaron Bentley
Record hashes produced by merges
431
2590.2.4 by Aaron Bentley
Move entry generation to a helper
432
    def _entries3(self):
2590.2.7 by Aaron Bentley
Misc cleanup
433
        """Gather data about files modified between three trees.
434
435
        Return a list of tuples of file_id, changed, parents3, names3,
436
        executable3.  changed is a boolean indicating whether the file contents
437
        or kind were changed.  parents3 is a tuple of parent ids for base,
438
        other and this.  names3 is a tuple of names for base, other and this.
439
        executable3 is a tuple of execute-bit values for base, other and this.
440
        """
2590.2.4 by Aaron Bentley
Move entry generation to a helper
441
        result = []
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
442
        iterator = self.other_tree._iter_changes(self.base_tree,
443
                include_unchanged=True, specific_files=self.interesting_files,
444
                extra_trees=[self.this_tree])
2590.2.4 by Aaron Bentley
Move entry generation to a helper
445
        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
446
             executable) in iterator:
2590.2.4 by Aaron Bentley
Move entry generation to a helper
447
            if (self.interesting_ids is not None and
448
                file_id not in self.interesting_ids):
449
                continue
450
            if file_id in self.this_tree.inventory:
451
                entry = self.this_tree.inventory[file_id]
452
                this_name = entry.name
453
                this_parent = entry.parent_id
454
                this_executable = entry.executable
455
            else:
456
                this_name = None
457
                this_parent = None
458
                this_executable = None
459
            parents3 = parents + (this_parent,)
460
            names3 = names + (this_name,)
461
            executable3 = executable + (this_executable,)
462
            result.append((file_id, changed, parents3, names3, executable3))
463
        return result
464
1731.1.33 by Aaron Bentley
Revert no-special-root changes
465
    def fix_root(self):
466
        try:
467
            self.tt.final_kind(self.tt.root)
468
        except NoSuchFile:
469
            self.tt.cancel_deletion(self.tt.root)
470
        if self.tt.final_file_id(self.tt.root) is None:
471
            self.tt.version_file(self.tt.tree_file_id(self.tt.root), 
472
                                 self.tt.root)
473
        if self.other_tree.inventory.root is None:
474
            return
475
        other_root_file_id = self.other_tree.inventory.root.file_id
476
        other_root = self.tt.trans_id_file_id(other_root_file_id)
477
        if other_root == self.tt.root:
478
            return
479
        try:
480
            self.tt.final_kind(other_root)
481
        except NoSuchFile:
482
            return
483
        self.reparent_children(self.other_tree.inventory.root, self.tt.root)
484
        self.tt.cancel_creation(other_root)
485
        self.tt.cancel_versioning(other_root)
486
487
    def reparent_children(self, ie, target):
488
        for thing, child in ie.children.iteritems():
489
            trans_id = self.tt.trans_id_file_id(child.file_id)
490
            self.tt.adjust_path(self.tt.final_name(trans_id), target, trans_id)
491
1534.7.192 by Aaron Bentley
Record hashes produced by merges
492
    def write_modified(self, results):
493
        modified_hashes = {}
494
        for path in results.modified_paths:
495
            file_id = self.this_tree.path2id(self.this_tree.relpath(path))
496
            if file_id is None:
497
                continue
498
            hash = self.this_tree.get_file_sha1(file_id)
499
            if hash is None:
500
                continue
501
            modified_hashes[file_id] = hash
502
        self.this_tree.set_merge_modified(modified_hashes)
503
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
504
    @staticmethod
505
    def parent(entry, file_id):
1534.7.157 by Aaron Bentley
Added more docs
506
        """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
507
        if entry is None:
508
            return None
509
        return entry.parent_id
510
511
    @staticmethod
512
    def name(entry, file_id):
1534.7.157 by Aaron Bentley
Added more docs
513
        """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
514
        if entry is None:
515
            return None
516
        return entry.name
517
    
518
    @staticmethod
519
    def contents_sha1(tree, file_id):
1534.7.157 by Aaron Bentley
Added more docs
520
        """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
521
        if file_id not in tree:
522
            return None
523
        return tree.get_file_sha1(file_id)
524
525
    @staticmethod
526
    def executable(tree, file_id):
1534.7.157 by Aaron Bentley
Added more docs
527
        """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
528
        if file_id not in tree:
529
            return None
530
        if tree.kind(file_id) != "file":
531
            return False
532
        return tree.is_executable(file_id)
533
534
    @staticmethod
535
    def kind(tree, file_id):
1534.7.157 by Aaron Bentley
Added more docs
536
        """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
537
        if file_id not in tree:
538
            return None
539
        return tree.kind(file_id)
540
541
    @staticmethod
2590.2.8 by Aaron Bentley
Restore conflict handling changes
542
    def _three_way(base, other, this):
543
        #if base == other, either they all agree, or only THIS has changed.
544
        if base == other:
545
            return 'this'
2590.2.10 by Aaron Bentley
Updates from review
546
        elif this not in (base, other):
2590.2.8 by Aaron Bentley
Restore conflict handling changes
547
            return 'conflict'
2590.2.10 by Aaron Bentley
Updates from review
548
        # "Ambiguous clean merge" -- both sides have made the same change.
2590.2.8 by Aaron Bentley
Restore conflict handling changes
549
        elif this == other:
550
            return "this"
2590.2.10 by Aaron Bentley
Updates from review
551
        # this == base: only other has changed.
2590.2.8 by Aaron Bentley
Restore conflict handling changes
552
        else:
553
            return "other"
554
555
    @staticmethod
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
556
    def scalar_three_way(this_tree, base_tree, other_tree, file_id, key):
557
        """Do a three-way test on a scalar.
558
        Return "this", "other" or "conflict", depending whether a value wins.
559
        """
560
        key_base = key(base_tree, file_id)
561
        key_other = key(other_tree, file_id)
562
        #if base == other, either they all agree, or only THIS has changed.
563
        if key_base == key_other:
564
            return "this"
565
        key_this = key(this_tree, file_id)
566
        if key_this not in (key_base, key_other):
567
            return "conflict"
568
        # "Ambiguous clean merge"
569
        elif key_this == key_other:
570
            return "this"
571
        else:
572
            assert key_this == key_base
573
            return "other"
574
575
    def merge_names(self, file_id):
576
        def get_entry(tree):
577
            if file_id in tree.inventory:
578
                return tree.inventory[file_id]
579
            else:
580
                return None
581
        this_entry = get_entry(self.this_tree)
582
        other_entry = get_entry(self.other_tree)
583
        base_entry = get_entry(self.base_tree)
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
584
        entries = (base_entry, other_entry, this_entry)
585
        names = []
586
        parents = []
587
        for entry in entries:
588
            if entry is None:
589
                names.append(None)
590
                parents.append(None)
591
            else:
592
                names.append(entry.name)
593
                parents.append(entry.parent_id)
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
594
        return self._merge_names(file_id, parents, names)
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
595
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
596
    def _merge_names(self, file_id, parents, names):
2590.2.7 by Aaron Bentley
Misc cleanup
597
        """Perform a merge on file_id names and parents"""
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
598
        base_name, other_name, this_name = names
599
        base_parent, other_parent, this_parent = parents
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
600
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
601
        name_winner = self._three_way(*names)
602
603
        parent_id_winner = self._three_way(*parents)
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
604
        if this_name is None:
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
605
            if name_winner == "this":
606
                name_winner = "other"
607
            if parent_id_winner == "this":
608
                parent_id_winner = "other"
609
        if name_winner == "this" and parent_id_winner == "this":
610
            return
611
        if name_winner == "conflict":
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
612
            trans_id = self.tt.trans_id_file_id(file_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
613
            self._raw_conflicts.append(('name conflict', trans_id, 
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
614
                                        this_name, other_name))
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
615
        if parent_id_winner == "conflict":
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
616
            trans_id = self.tt.trans_id_file_id(file_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
617
            self._raw_conflicts.append(('parent conflict', trans_id, 
2590.2.1 by Aaron Bentley
Start work on merging names based on iter_changes
618
                                        this_parent, other_parent))
2590.2.2 by Aaron Bentley
Do most name merging from iter_changes output
619
        if other_name is None:
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
620
            # it doesn't matter whether the result was 'other' or 
621
            # 'conflict'-- if there's no 'other', we leave it alone.
622
            return
623
        # 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
624
        trans_id = self.tt.trans_id_file_id(file_id)
2590.2.7 by Aaron Bentley
Misc cleanup
625
        parent_id = parents[self.winner_idx[parent_id_winner]]
1731.1.33 by Aaron Bentley
Revert no-special-root changes
626
        if parent_id is not None:
627
            parent_trans_id = self.tt.trans_id_file_id(parent_id)
2590.2.7 by Aaron Bentley
Misc cleanup
628
            self.tt.adjust_path(names[self.winner_idx[name_winner]],
1731.1.33 by Aaron Bentley
Revert no-special-root changes
629
                                parent_trans_id, trans_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
630
631
    def merge_contents(self, file_id):
1534.7.157 by Aaron Bentley
Added more docs
632
        """Performa a merge on file_id contents."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
633
        def contents_pair(tree):
634
            if file_id not in tree:
635
                return (None, None)
636
            kind = tree.kind(file_id)
637
            if kind == "file":
638
                contents = tree.get_file_sha1(file_id)
639
            elif kind == "symlink":
640
                contents = tree.get_symlink_target(file_id)
641
            else:
642
                contents = None
643
            return kind, contents
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
644
645
        def contents_conflict():
646
            trans_id = self.tt.trans_id_file_id(file_id)
647
            name = self.tt.final_name(trans_id)
648
            parent_id = self.tt.final_parent(trans_id)
649
            if file_id in self.this_tree.inventory:
650
                self.tt.unversion_file(trans_id)
1551.10.2 by Aaron Bentley
Handle merge with dangling inventory entries
651
                if file_id in self.this_tree:
652
                    self.tt.delete_contents(trans_id)
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
653
            file_group = self._dump_conflicts(name, parent_id, file_id, 
654
                                              set_version=True)
655
            self._raw_conflicts.append(('contents conflict', file_group))
656
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
657
        # See SPOT run.  run, SPOT, run.
658
        # So we're not QUITE repeating ourselves; we do tricky things with
659
        # file kind...
660
        base_pair = contents_pair(self.base_tree)
661
        other_pair = contents_pair(self.other_tree)
662
        if base_pair == other_pair:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
663
            # OTHER introduced no changes
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
664
            return "unmodified"
665
        this_pair = contents_pair(self.this_tree)
666
        if this_pair == other_pair:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
667
            # THIS and OTHER introduced the same changes
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
668
            return "unmodified"
669
        else:
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
670
            trans_id = self.tt.trans_id_file_id(file_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
671
            if this_pair == base_pair:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
672
                # only OTHER introduced changes
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
673
                if file_id in self.this_tree:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
674
                    # Remove any existing contents
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
675
                    self.tt.delete_contents(trans_id)
1534.7.147 by Aaron Bentley
Tweak to check inventory, not tree for file ids
676
                if file_id in self.other_tree:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
677
                    # OTHER changed the file
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
678
                    create_by_entry(self.tt, 
679
                                    self.other_tree.inventory[file_id], 
680
                                    self.other_tree, trans_id)
1534.7.147 by Aaron Bentley
Tweak to check inventory, not tree for file ids
681
                    if file_id not in self.this_tree.inventory:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
682
                        self.tt.version_file(file_id, trans_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
683
                    return "modified"
1534.7.147 by Aaron Bentley
Tweak to check inventory, not tree for file ids
684
                elif file_id in self.this_tree.inventory:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
685
                    # OTHER deleted the file
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
686
                    self.tt.unversion_file(trans_id)
687
                    return "deleted"
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
688
            #BOTH THIS and OTHER introduced changes; scalar conflict
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
689
            elif this_pair[0] == "file" and other_pair[0] == "file":
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
690
                # THIS and OTHER are both files, so text merge.  Either
691
                # BASE is a file, or both converted to files, so at least we
692
                # have agreement that output should be a file.
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
693
                try:
694
                    self.text_merge(file_id, trans_id)
695
                except BinaryFile:
696
                    return contents_conflict()
1534.7.147 by Aaron Bentley
Tweak to check inventory, not tree for file ids
697
                if file_id not in self.this_tree.inventory:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
698
                    self.tt.version_file(file_id, trans_id)
1534.7.152 by Aaron Bentley
Fixed overwrites
699
                try:
700
                    self.tt.tree_kind(trans_id)
701
                    self.tt.delete_contents(trans_id)
702
                except NoSuchFile:
703
                    pass
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
704
                return "modified"
705
            else:
1534.7.145 by Aaron Bentley
More fixups after get_trans_id
706
                # Scalar conflict, can't text merge.  Dump conflicts
1558.15.3 by Aaron Bentley
Handle binary files for diff3 merges
707
                return contents_conflict()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
708
709
    def get_lines(self, tree, file_id):
1534.7.157 by Aaron Bentley
Added more docs
710
        """Return the lines in a file, or an empty list."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
711
        if file_id in tree:
712
            return tree.get_file(file_id).readlines()
713
        else:
714
            return []
715
716
    def text_merge(self, file_id, trans_id):
717
        """Perform a three-way text merge on a file_id"""
718
        # it's possible that we got here with base as a different type.
719
        # if so, we just want two-way text conflicts.
720
        if file_id in self.base_tree and \
721
            self.base_tree.kind(file_id) == "file":
722
            base_lines = self.get_lines(self.base_tree, file_id)
723
        else:
724
            base_lines = []
725
        other_lines = self.get_lines(self.other_tree, file_id)
726
        this_lines = self.get_lines(self.this_tree, file_id)
727
        m3 = Merge3(base_lines, this_lines, other_lines)
728
        start_marker = "!START OF MERGE CONFLICT!" + "I HOPE THIS IS UNIQUE"
729
        if self.show_base is True:
730
            base_marker = '|' * 7
731
        else:
732
            base_marker = None
733
734
        def iter_merge3(retval):
735
            retval["text_conflicts"] = False
736
            for line in m3.merge_lines(name_a = "TREE", 
737
                                       name_b = "MERGE-SOURCE", 
738
                                       name_base = "BASE-REVISION",
739
                                       start_marker=start_marker, 
740
                                       base_marker=base_marker,
741
                                       reprocess=self.reprocess):
742
                if line.startswith(start_marker):
743
                    retval["text_conflicts"] = True
744
                    yield line.replace(start_marker, '<' * 7)
745
                else:
746
                    yield line
747
        retval = {}
748
        merge3_iterator = iter_merge3(retval)
749
        self.tt.create_file(merge3_iterator, trans_id)
750
        if retval["text_conflicts"] is True:
751
            self._raw_conflicts.append(('text conflict', trans_id))
752
            name = self.tt.final_name(trans_id)
753
            parent_id = self.tt.final_parent(trans_id)
754
            file_group = self._dump_conflicts(name, parent_id, file_id, 
755
                                              this_lines, base_lines,
756
                                              other_lines)
757
            file_group.append(trans_id)
758
759
    def _dump_conflicts(self, name, parent_id, file_id, this_lines=None, 
760
                        base_lines=None, other_lines=None, set_version=False,
761
                        no_base=False):
1534.7.157 by Aaron Bentley
Added more docs
762
        """Emit conflict files.
763
        If this_lines, base_lines, or other_lines are omitted, they will be
764
        determined automatically.  If set_version is true, the .OTHER, .THIS
765
        or .BASE (in that order) will be created as versioned files.
766
        """
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
767
        data = [('OTHER', self.other_tree, other_lines), 
768
                ('THIS', self.this_tree, this_lines)]
769
        if not no_base:
770
            data.append(('BASE', self.base_tree, base_lines))
771
        versioned = False
772
        file_group = []
773
        for suffix, tree, lines in data:
774
            if file_id in tree:
775
                trans_id = self._conflict_file(name, parent_id, tree, file_id,
776
                                               suffix, lines)
777
                file_group.append(trans_id)
778
                if set_version and not versioned:
779
                    self.tt.version_file(file_id, trans_id)
780
                    versioned = True
781
        return file_group
782
           
783
    def _conflict_file(self, name, parent_id, tree, file_id, suffix, 
784
                       lines=None):
1534.7.157 by Aaron Bentley
Added more docs
785
        """Emit a single conflict file."""
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
786
        name = name + '.' + suffix
787
        trans_id = self.tt.create_path(name, parent_id)
788
        entry = tree.inventory[file_id]
789
        create_by_entry(self.tt, entry, tree, trans_id, lines)
790
        return trans_id
791
792
    def merge_executable(self, file_id, file_status):
1534.7.157 by Aaron Bentley
Added more docs
793
        """Perform a merge on the execute bit."""
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
794
        executable = [self.executable(t, file_id) for t in (self.base_tree,
795
                      self.other_tree, self.this_tree)]
796
        self._merge_executable(file_id, executable, file_status)
797
798
    def _merge_executable(self, file_id, executable, file_status):
799
        """Perform a merge on the execute bit."""
800
        base_executable, other_executable, this_executable = executable
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
801
        if file_status == "deleted":
802
            return
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
803
        trans_id = self.tt.trans_id_file_id(file_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
804
        try:
805
            if self.tt.final_kind(trans_id) != "file":
806
                return
807
        except NoSuchFile:
808
            return
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
809
        winner = self._three_way(*executable)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
810
        if winner == "conflict":
811
        # There must be a None in here, if we have a conflict, but we
812
        # need executability since file status was not deleted.
1534.10.35 by Aaron Bentley
Merge handles contents + executable + deletion conflict
813
            if self.executable(self.other_tree, file_id) is None:
1534.7.142 by Aaron Bentley
Fixed executability conflicts
814
                winner = "this"
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
815
            else:
1534.7.142 by Aaron Bentley
Fixed executability conflicts
816
                winner = "other"
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
817
        if winner == "this":
2325.3.4 by John Arbash Meinel
Rather than setting the executable bit for every file, properly create the working inventory to include it.
818
            if file_status == "modified":
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
819
                executability = this_executable
2325.3.4 by John Arbash Meinel
Rather than setting the executable bit for every file, properly create the working inventory to include it.
820
                if executability is not None:
821
                    trans_id = self.tt.trans_id_file_id(file_id)
822
                    self.tt.set_executability(executability, trans_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
823
        else:
824
            assert winner == "other"
825
            if file_id in self.other_tree:
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
826
                executability = other_executable
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
827
            elif file_id in self.this_tree:
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
828
                executability = this_executable
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
829
            elif file_id in self.base_tree:
2590.2.3 by Aaron Bentley
Merge the execute bit based on iter_changes
830
                executability = base_executable
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
831
            if executability is not None:
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
832
                trans_id = self.tt.trans_id_file_id(file_id)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
833
                self.tt.set_executability(executability, trans_id)
834
1534.7.172 by Aaron Bentley
Integrated fs conflicts with merge conflicts.
835
    def cook_conflicts(self, fs_conflicts):
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
836
        """Convert all conflicts into a form that doesn't depend on trans_id"""
1534.10.19 by Aaron Bentley
Stanza conversion, cooking
837
        from conflicts import Conflict
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
838
        name_conflicts = {}
1534.7.172 by Aaron Bentley
Integrated fs conflicts with merge conflicts.
839
        self.cooked_conflicts.extend(cook_conflicts(fs_conflicts, self.tt))
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
840
        fp = FinalPaths(self.tt)
841
        for conflict in self._raw_conflicts:
842
            conflict_type = conflict[0]
843
            if conflict_type in ('name conflict', 'parent conflict'):
844
                trans_id = conflict[1]
845
                conflict_args = conflict[2:]
846
                if trans_id not in name_conflicts:
847
                    name_conflicts[trans_id] = {}
848
                unique_add(name_conflicts[trans_id], conflict_type, 
849
                           conflict_args)
850
            if conflict_type == 'contents conflict':
851
                for trans_id in conflict[1]:
852
                    file_id = self.tt.final_file_id(trans_id)
853
                    if file_id is not None:
854
                        break
855
                path = fp.get_path(trans_id)
856
                for suffix in ('.BASE', '.THIS', '.OTHER'):
857
                    if path.endswith(suffix):
858
                        path = path[:-len(suffix)]
859
                        break
1534.10.19 by Aaron Bentley
Stanza conversion, cooking
860
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
861
                self.cooked_conflicts.append(c)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
862
            if conflict_type == 'text conflict':
863
                trans_id = conflict[1]
864
                path = fp.get_path(trans_id)
865
                file_id = self.tt.final_file_id(trans_id)
1534.10.19 by Aaron Bentley
Stanza conversion, cooking
866
                c = Conflict.factory(conflict_type, path=path, file_id=file_id)
867
                self.cooked_conflicts.append(c)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
868
869
        for trans_id, conflicts in name_conflicts.iteritems():
870
            try:
871
                this_parent, other_parent = conflicts['parent conflict']
872
                assert this_parent != other_parent
873
            except KeyError:
874
                this_parent = other_parent = \
875
                    self.tt.final_file_id(self.tt.final_parent(trans_id))
876
            try:
877
                this_name, other_name = conflicts['name conflict']
878
                assert this_name != other_name
879
            except KeyError:
880
                this_name = other_name = self.tt.final_name(trans_id)
881
            other_path = fp.get_path(trans_id)
1551.16.2 by Aaron Bentley
Don't crash on merging renamed deleted files (#110279)
882
            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
883
                this_parent_path = \
1534.7.181 by Aaron Bentley
Renamed a bunch of functions
884
                    fp.get_path(self.tt.trans_id_file_id(this_parent))
1534.7.166 by Aaron Bentley
Swapped os.path.join for pathjoin everywhere
885
                this_path = pathjoin(this_parent_path, this_name)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
886
            else:
887
                this_path = "<deleted>"
888
            file_id = self.tt.final_file_id(trans_id)
1534.10.20 by Aaron Bentley
Got all tests passing
889
            c = Conflict.factory('path conflict', path=this_path,
1534.10.19 by Aaron Bentley
Stanza conversion, cooking
890
                                 conflict_path=other_path, file_id=file_id)
891
            self.cooked_conflicts.append(c)
1666.1.4 by Robert Collins
* 'Metadir' is now the default disk format. This improves behaviour in
892
        self.cooked_conflicts.sort(key=Conflict.sort_key)
1534.7.141 by Aaron Bentley
Added conflict reporting
893
894
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
895
class WeaveMerger(Merge3Merger):
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
896
    """Three-way tree merger, text weave merger."""
1551.6.8 by Aaron Bentley
Implemented reprocess for weave
897
    supports_reprocess = True
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
898
    supports_show_base = False
899
1534.9.1 by Aaron Bentley
Added progress bars to merge
900
    def __init__(self, working_tree, this_tree, base_tree, other_tree, 
1551.6.8 by Aaron Bentley
Implemented reprocess for weave
901
                 interesting_ids=None, pb=DummyProgress(), pp=None,
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
902
                 reprocess=False, change_reporter=None,
903
                 interesting_files=None):
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
904
        self.this_revision_tree = self._get_revision_tree(this_tree)
905
        self.other_revision_tree = self._get_revision_tree(other_tree)
906
        super(WeaveMerger, self).__init__(working_tree, this_tree, 
1558.2.2 by Aaron Bentley
Make remerge honour interesting-ids
907
                                          base_tree, other_tree, 
908
                                          interesting_ids=interesting_ids, 
1551.11.11 by Aaron Bentley
Get tests passing
909
                                          pb=pb, pp=pp, reprocess=reprocess,
910
                                          change_reporter=change_reporter)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
911
912
    def _get_revision_tree(self, tree):
1759.2.1 by Jelmer Vernooij
Fix some types (found using aspell).
913
        """Return a revision tree related to this tree.
1534.7.157 by Aaron Bentley
Added more docs
914
        If the tree is a WorkingTree, the basis will be returned.
915
        """
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
916
        if getattr(tree, 'get_weave', False) is False:
917
            # If we have a WorkingTree, try using the basis
918
            return tree.branch.basis_tree()
919
        else:
920
            return tree
921
922
    def _check_file(self, file_id):
923
        """Check that the revision tree's version of the file matches."""
924
        for tree, rt in ((self.this_tree, self.this_revision_tree), 
925
                         (self.other_tree, self.other_revision_tree)):
926
            if rt is tree:
927
                continue
928
            if tree.get_file_sha1(file_id) != rt.get_file_sha1(file_id):
929
                raise WorkingTreeNotRevision(self.this_tree)
930
931
    def _merged_lines(self, file_id):
932
        """Generate the merged lines.
933
        There is no distinction between lines that are meant to contain <<<<<<<
934
        and conflicts.
935
        """
936
        weave = self.this_revision_tree.get_weave(file_id)
937
        this_revision_id = self.this_revision_tree.inventory[file_id].revision
938
        other_revision_id = \
939
            self.other_revision_tree.inventory[file_id].revision
1551.6.10 by Aaron Bentley
Renamed WeaveMerge to PlanMerge, added plan method, created planless WeaveMerge
940
        wm = WeaveMerge(weave, this_revision_id, other_revision_id, 
941
                        '<<<<<<< TREE\n', '>>>>>>> MERGE-SOURCE\n')
1551.6.8 by Aaron Bentley
Implemented reprocess for weave
942
        return wm.merge_lines(self.reprocess)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
943
944
    def text_merge(self, file_id, trans_id):
1534.7.157 by Aaron Bentley
Added more docs
945
        """Perform a (weave) text merge for a given file and file-id.
946
        If conflicts are encountered, .THIS and .OTHER files will be emitted,
947
        and a conflict will be noted.
948
        """
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
949
        self._check_file(file_id)
1551.6.12 by Aaron Bentley
Indicate conflicts from merge_lines, insead of guessing
950
        lines, conflicts = self._merged_lines(file_id)
1558.15.10 by Aaron Bentley
Merge bzr.dev
951
        lines = list(lines)
1558.15.5 by Aaron Bentley
Fixed binary handling in weave merge
952
        # Note we're checking whether the OUTPUT is binary in this case, 
953
        # because we don't want to get into weave merge guts.
954
        check_text_lines(lines)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
955
        self.tt.create_file(lines, trans_id)
956
        if conflicts:
957
            self._raw_conflicts.append(('text conflict', trans_id))
958
            name = self.tt.final_name(trans_id)
959
            parent_id = self.tt.final_parent(trans_id)
960
            file_group = self._dump_conflicts(name, parent_id, file_id, 
961
                                              no_base=True)
962
            file_group.append(trans_id)
963
964
965
class Diff3Merger(Merge3Merger):
1534.7.167 by Aaron Bentley
PEP8 and comment cleanups
966
    """Three-way merger using external diff3 for text merging"""
1711.7.20 by John Arbash Meinel
always close files, minor PEP8 cleanup
967
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
968
    def dump_file(self, temp_dir, name, tree, file_id):
969
        out_path = pathjoin(temp_dir, name)
1711.7.20 by John Arbash Meinel
always close files, minor PEP8 cleanup
970
        out_file = open(out_path, "wb")
971
        try:
972
            in_file = tree.get_file(file_id)
973
            for line in in_file:
974
                out_file.write(line)
975
        finally:
976
            out_file.close()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
977
        return out_path
978
979
    def text_merge(self, file_id, trans_id):
1534.7.157 by Aaron Bentley
Added more docs
980
        """Perform a diff3 merge using a specified file-id and trans-id.
981
        If conflicts are encountered, .BASE, .THIS. and .OTHER conflict files
982
        will be dumped, and a will be conflict noted.
983
        """
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
984
        import bzrlib.patch
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
985
        temp_dir = osutils.mkdtemp(prefix="bzr-")
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
986
        try:
1534.7.166 by Aaron Bentley
Swapped os.path.join for pathjoin everywhere
987
            new_file = pathjoin(temp_dir, "new")
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
988
            this = self.dump_file(temp_dir, "this", self.this_tree, file_id)
989
            base = self.dump_file(temp_dir, "base", self.base_tree, file_id)
990
            other = self.dump_file(temp_dir, "other", self.other_tree, file_id)
991
            status = bzrlib.patch.diff3(new_file, this, base, other)
992
            if status not in (0, 1):
993
                raise BzrError("Unhandled diff3 exit code")
1711.7.20 by John Arbash Meinel
always close files, minor PEP8 cleanup
994
            f = open(new_file, 'rb')
995
            try:
996
                self.tt.create_file(f, trans_id)
997
            finally:
998
                f.close()
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
999
            if status == 1:
1000
                name = self.tt.final_name(trans_id)
1001
                parent_id = self.tt.final_parent(trans_id)
1002
                self._dump_conflicts(name, parent_id, file_id)
1551.8.39 by Aaron Bentley
Fix diff3 conflict-reporting bug
1003
                self._raw_conflicts.append(('text conflict', trans_id))
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1004
        finally:
1996.3.18 by John Arbash Meinel
Now that mkdtemp and rmtree are lazy, they should not be directly improted.
1005
            osutils.rmtree(temp_dir)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1006
1007
1008
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.
1009
                backup_files=False,
1010
                merge_type=Merge3Merger,
1011
                interesting_ids=None,
1012
                show_base=False,
1013
                reprocess=False,
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1014
                other_rev_id=None,
1015
                interesting_files=None,
1534.9.9 by Aaron Bentley
Added progress bar to pull
1016
                this_tree=None,
1551.11.10 by Aaron Bentley
Add change reporting to pull
1017
                pb=DummyProgress(),
1018
                change_reporter=None):
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1019
    """Primary interface for merging. 
1020
1021
        typical use is probably 
1022
        'merge_inner(branch, branch.get_revision_tree(other_revision),
1023
                     branch.get_revision_tree(base_revision))'
1024
        """
1025
    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)
1026
        raise BzrError("bzrlib.merge.merge_inner requires a this_tree "
1027
            "parameter as of bzrlib version 0.8.")
2255.2.31 by Robert Collins
Work in progress to make merge_inner work with dirstate trees.
1028
    merger = Merger(this_branch, other_tree, base_tree, this_tree=this_tree,
1551.11.10 by Aaron Bentley
Add change reporting to pull
1029
                    pb=pb, change_reporter=change_reporter)
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1030
    merger.backup_files = backup_files
1031
    merger.merge_type = merge_type
1032
    merger.interesting_ids = interesting_ids
1551.2.23 by Aaron Bentley
Got merge_inner's ignore_zero parameter working
1033
    merger.ignore_zero = ignore_zero
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1034
    if interesting_files:
1035
        assert not interesting_ids, ('Only supply interesting_ids'
1036
                                     ' or interesting_files')
2590.2.5 by Aaron Bentley
Allow selected files to be specified instead of selected ids
1037
        merger.interesting_files = interesting_files
1979.2.1 by Robert Collins
(robertc) adds a convenience method "merge_from_branch" to WorkingTree.
1038
    merger.show_base = show_base
1534.7.140 by Aaron Bentley
Moved the merge stuff into merge.py
1039
    merger.reprocess = reprocess
1040
    merger.other_rev_id = other_rev_id
1041
    merger.other_basis = other_rev_id
1042
    return merger.do_merge()
1043
2221.4.15 by Aaron Bentley
Use RegistryOption for merge type
1044
def get_merge_type_registry():
2221.4.17 by Aaron Bentley
PEP8-ness
1045
    """Merge type registry is in bzrlib.option to avoid circular imports.
2221.4.15 by Aaron Bentley
Use RegistryOption for merge type
1046
1047
    This method provides a sanctioned way to retrieve it.
1048
    """
1049
    from bzrlib import option
2221.4.16 by Aaron Bentley
Add tests for get_merge_type_registry
1050
    return option._merge_type_registry