~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/merge.py

merge from aaron - fixes bare excepts, adds ancestor namespace

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
# Copyright (C) 2005 Canonical Ltd
 
2
 
 
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.
 
7
 
 
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.
 
12
 
 
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
 
 
17
 
 
18
import os
 
19
import tempfile
 
20
import shutil
 
21
import errno
 
22
from fetch import greedy_fetch
 
23
 
 
24
import bzrlib.osutils
 
25
import bzrlib.revision
 
26
from bzrlib.merge_core import merge_flex, ApplyMerge3, BackupBeforeChange
 
27
from bzrlib.changeset import generate_changeset, ExceptionConflictHandler
 
28
from bzrlib.changeset import Inventory, Diff3Merge
 
29
from bzrlib.branch import find_branch
 
30
from bzrlib.errors import BzrCommandError, UnrelatedBranches, NoCommonAncestor
 
31
from bzrlib.errors import NoCommits
 
32
from bzrlib.delta import compare_trees
 
33
from bzrlib.trace import mutter, warning
 
34
from bzrlib.fetch import greedy_fetch
 
35
from bzrlib.revision import is_ancestor
 
36
 
 
37
# comments from abentley on irc: merge happens in two stages, each
 
38
# of which generates a changeset object
 
39
 
 
40
# stage 1: generate OLD->OTHER,
 
41
# stage 2: use MINE and OLD->OTHER to generate MINE -> RESULT
 
42
 
 
43
class MergeConflictHandler(ExceptionConflictHandler):
 
44
    """Handle conflicts encountered while merging.
 
45
 
 
46
    This subclasses ExceptionConflictHandler, so that any types of
 
47
    conflict that are not explicitly handled cause an exception and
 
48
    terminate the merge.
 
49
    """
 
50
    def __init__(self, dir, ignore_zero=False):
 
51
        ExceptionConflictHandler.__init__(self, dir)
 
52
        self.conflicts = 0
 
53
        self.ignore_zero = ignore_zero
 
54
 
 
55
    def copy(self, source, dest):
 
56
        """Copy the text and mode of a file
 
57
        :param source: The path of the file to copy
 
58
        :param dest: The distination file to create
 
59
        """
 
60
        s_file = file(source, "rb")
 
61
        d_file = file(dest, "wb")
 
62
        for line in s_file:
 
63
            d_file.write(line)
 
64
        os.chmod(dest, 0777 & os.stat(source).st_mode)
 
65
 
 
66
    def dump(self, lines, dest):
 
67
        """Copy the text and mode of a file
 
68
        :param source: The path of the file to copy
 
69
        :param dest: The distination file to create
 
70
        """
 
71
        d_file = file(dest, "wb")
 
72
        for line in lines:
 
73
            d_file.write(line)
 
74
 
 
75
    def add_suffix(self, name, suffix, last_new_name=None):
 
76
        """Rename a file to append a suffix.  If the new name exists, the
 
77
        suffix is added repeatedly until a non-existant name is found
 
78
 
 
79
        :param name: The path of the file
 
80
        :param suffix: The suffix to append
 
81
        :param last_new_name: (used for recursive calls) the last name tried
 
82
        """
 
83
        if last_new_name is None:
 
84
            last_new_name = name
 
85
        new_name = last_new_name+suffix
 
86
        try:
 
87
            os.rename(name, new_name)
 
88
            return new_name
 
89
        except OSError, e:
 
90
            if e.errno != errno.EEXIST and e.errno != errno.ENOTEMPTY:
 
91
                raise
 
92
            return self.add_suffix(name, suffix, last_new_name=new_name)
 
93
 
 
94
    def conflict(self, text):
 
95
        warning(text)
 
96
        self.conflicts += 1
 
97
        
 
98
 
 
99
    def merge_conflict(self, new_file, this_path, base_lines, other_lines):
 
100
        """
 
101
        Handle diff3 conflicts by producing a .THIS, .BASE and .OTHER.  The
 
102
        main file will be a version with diff3 conflicts.
 
103
        :param new_file: Path to the output file with diff3 markers
 
104
        :param this_path: Path to the file text for the THIS tree
 
105
        :param base_path: Path to the file text for the BASE tree
 
106
        :param other_path: Path to the file text for the OTHER tree
 
107
        """
 
108
        self.add_suffix(this_path, ".THIS")
 
109
        self.dump(base_lines, this_path+".BASE")
 
110
        self.dump(other_lines, this_path+".OTHER")
 
111
        os.rename(new_file, this_path)
 
112
        self.conflict("Diff3 conflict encountered in %s" % this_path)
 
113
 
 
114
    def new_contents_conflict(self, filename, other_contents):
 
115
        """Conflicting contents for newly added file."""
 
116
        self.copy(other_contents, filename + ".OTHER")
 
117
        self.conflict("Conflict in newly added file %s" % filename)
 
118
    
 
119
 
 
120
    def target_exists(self, entry, target, old_path):
 
121
        """Handle the case when the target file or dir exists"""
 
122
        moved_path = self.add_suffix(target, ".moved")
 
123
        self.conflict("Moved existing %s to %s" % (target, moved_path))
 
124
 
 
125
    def rmdir_non_empty(self, filename):
 
126
        """Handle the case where the dir to be removed still has contents"""
 
127
        self.conflict("Directory %s not removed because it is not empty"\
 
128
            % filename)
 
129
        return "skip"
 
130
 
 
131
    def finalize(self):
 
132
        if not self.ignore_zero:
 
133
            print "%d conflicts encountered.\n" % self.conflicts
 
134
            
 
135
def get_tree(treespec, temp_root, label, local_branch=None):
 
136
    location, revno = treespec
 
137
    branch = find_branch(location)
 
138
    if revno is None:
 
139
        revision = None
 
140
    elif revno == -1:
 
141
        revision = branch.last_patch()
 
142
    else:
 
143
        revision = branch.lookup_revision(revno)
 
144
    return branch, get_revid_tree(branch, revision, temp_root, label,
 
145
                                  local_branch)
 
146
 
 
147
def get_revid_tree(branch, revision, temp_root, label, local_branch):
 
148
    if revision is None:
 
149
        base_tree = branch.working_tree()
 
150
    else:
 
151
        if local_branch is not None:
 
152
            greedy_fetch(local_branch, branch, revision)
 
153
            base_tree = local_branch.revision_tree(revision)
 
154
        else:
 
155
            base_tree = branch.revision_tree(revision)
 
156
    temp_path = os.path.join(temp_root, label)
 
157
    os.mkdir(temp_path)
 
158
    return MergeTree(base_tree, temp_path)
 
159
 
 
160
 
 
161
def file_exists(tree, file_id):
 
162
    return tree.has_filename(tree.id2path(file_id))
 
163
    
 
164
 
 
165
class MergeTree(object):
 
166
    def __init__(self, tree, tempdir):
 
167
        object.__init__(self)
 
168
        if hasattr(tree, "basedir"):
 
169
            self.root = tree.basedir
 
170
        else:
 
171
            self.root = None
 
172
        self.tree = tree
 
173
        self.tempdir = tempdir
 
174
        os.mkdir(os.path.join(self.tempdir, "texts"))
 
175
        self.cached = {}
 
176
 
 
177
    def __iter__(self):
 
178
        return self.tree.__iter__()
 
179
 
 
180
    def __contains__(self, file_id):
 
181
        return file_id in self.tree
 
182
 
 
183
    def get_file(self, file_id):
 
184
        return self.tree.get_file(file_id)
 
185
 
 
186
    def get_file_sha1(self, id):
 
187
        return self.tree.get_file_sha1(id)
 
188
 
 
189
    def id2path(self, file_id):
 
190
        return self.tree.id2path(file_id)
 
191
 
 
192
    def has_id(self, file_id):
 
193
        return self.tree.has_id(file_id)
 
194
 
 
195
    def has_or_had_id(self, file_id):
 
196
        if file_id == self.tree.inventory.root.file_id:
 
197
            return True
 
198
        return self.tree.inventory.has_id(file_id)
 
199
 
 
200
    def has_or_had_id(self, file_id):
 
201
        if file_id == self.tree.inventory.root.file_id:
 
202
            return True
 
203
        return self.tree.inventory.has_id(file_id)
 
204
 
 
205
    def readonly_path(self, id):
 
206
        if id not in self.tree:
 
207
            return None
 
208
        if self.root is not None:
 
209
            return self.tree.abspath(self.tree.id2path(id))
 
210
        else:
 
211
            if self.tree.inventory[id].kind in ("directory", "root_directory"):
 
212
                return self.tempdir
 
213
            if not self.cached.has_key(id):
 
214
                path = os.path.join(self.tempdir, "texts", id)
 
215
                outfile = file(path, "wb")
 
216
                outfile.write(self.tree.get_file(id).read())
 
217
                assert(os.path.exists(path))
 
218
                self.cached[id] = path
 
219
            return self.cached[id]
 
220
 
 
221
 
 
222
 
 
223
def merge(other_revision, base_revision,
 
224
          check_clean=True, ignore_zero=False,
 
225
          this_dir=None, backup_files=False, merge_type=ApplyMerge3,
 
226
          file_list=None):
 
227
    """Merge changes into a tree.
 
228
 
 
229
    base_revision
 
230
        tuple(path, revision) Base for three-way merge.
 
231
    other_revision
 
232
        tuple(path, revision) Other revision for three-way merge.
 
233
    this_dir
 
234
        Directory to merge changes into; '.' by default.
 
235
    check_clean
 
236
        If true, this_dir must have no uncommitted changes before the
 
237
        merge begins.
 
238
    all available ancestors of other_revision and base_revision are
 
239
    automatically pulled into the branch.
 
240
    """
 
241
    from bzrlib.revision import common_ancestor, MultipleRevisionSources
 
242
    from bzrlib.errors import NoSuchRevision
 
243
    tempdir = tempfile.mkdtemp(prefix="bzr-")
 
244
    try:
 
245
        if this_dir is None:
 
246
            this_dir = '.'
 
247
        this_branch = find_branch(this_dir)
 
248
        this_rev_id = this_branch.last_patch()
 
249
        if this_rev_id is None:
 
250
            raise BzrCommandError("This branch has no commits")
 
251
        if check_clean:
 
252
            changes = compare_trees(this_branch.working_tree(), 
 
253
                                    this_branch.basis_tree(), False)
 
254
            if changes.has_changed():
 
255
                raise BzrCommandError("Working tree has uncommitted changes.")
 
256
        other_branch, other_tree = get_tree(other_revision, tempdir, "other",
 
257
                                            this_branch)
 
258
        if other_revision[1] == -1:
 
259
            other_rev_id = other_branch.last_patch()
 
260
            if other_rev_id is None:
 
261
                raise NoCommits(other_branch)
 
262
            other_basis = other_rev_id
 
263
        elif other_revision[1] is not None:
 
264
            other_rev_id = other_branch.lookup_revision(other_revision[1])
 
265
            other_basis = other_rev_id
 
266
        else:
 
267
            other_rev_id = None
 
268
            other_basis = other_branch.last_patch()
 
269
            if other_basis is None:
 
270
                raise NoCommits(other_branch)
 
271
        if base_revision == [None, None]:
 
272
            try:
 
273
                base_rev_id = common_ancestor(this_rev_id, other_basis, 
 
274
                                              this_branch)
 
275
            except NoCommonAncestor:
 
276
                raise UnrelatedBranches()
 
277
            base_tree = get_revid_tree(this_branch, base_rev_id, tempdir, 
 
278
                                       "base", None)
 
279
            base_is_ancestor = True
 
280
        else:
 
281
            base_branch, base_tree = get_tree(base_revision, tempdir, "base")
 
282
            if base_revision[1] == -1:
 
283
                base_rev_id = base_branch.last_patch()
 
284
            elif base_revision[1] is None:
 
285
                base_rev_id = None
 
286
            else:
 
287
                base_rev_id = base_branch.lookup_revision(base_revision[1])
 
288
            if base_rev_id is not None:
 
289
                base_is_ancestor = is_ancestor(this_rev_id, base_rev_id, 
 
290
                                               MultipleRevisionSources(this_branch, 
 
291
                                                                       base_branch))
 
292
            else:
 
293
                base_is_ancestor = False
 
294
        if file_list is None:
 
295
            interesting_ids = None
 
296
        else:
 
297
            interesting_ids = set()
 
298
            this_tree = this_branch.working_tree()
 
299
            for fname in file_list:
 
300
                path = this_branch.relpath(fname)
 
301
                found_id = False
 
302
                for tree in (this_tree, base_tree.tree, other_tree.tree):
 
303
                    file_id = tree.inventory.path2id(path)
 
304
                    if file_id is not None:
 
305
                        interesting_ids.add(file_id)
 
306
                        found_id = True
 
307
                if not found_id:
 
308
                    raise BzrCommandError("%s is not a source file in any"
 
309
                                          " tree." % fname)
 
310
        merge_inner(this_branch, other_tree, base_tree, tempdir, 
 
311
                    ignore_zero=ignore_zero, backup_files=backup_files, 
 
312
                    merge_type=merge_type, interesting_ids=interesting_ids)
 
313
        if base_is_ancestor and other_rev_id is not None\
 
314
            and other_rev_id not in this_branch.revision_history():
 
315
            this_branch.add_pending_merge(other_rev_id)
 
316
    finally:
 
317
        shutil.rmtree(tempdir)
 
318
 
 
319
 
 
320
def set_interesting(inventory_a, inventory_b, interesting_ids):
 
321
    """Mark files whose ids are in interesting_ids as interesting
 
322
    """
 
323
    for inventory in (inventory_a, inventory_b):
 
324
        for path, source_file in inventory.iteritems():
 
325
             source_file.interesting = source_file.id in interesting_ids
 
326
 
 
327
 
 
328
def generate_cset_optimized(tree_a, tree_b, interesting_ids=None):
 
329
    """Generate a changeset.  If interesting_ids is supplied, only changes
 
330
    to those files will be shown.  Metadata changes are stripped.
 
331
    """ 
 
332
    cset =  generate_changeset(tree_a, tree_b, interesting_ids)
 
333
    for entry in cset.entries.itervalues():
 
334
        entry.metadata_change = None
 
335
    return cset
 
336
 
 
337
 
 
338
def merge_inner(this_branch, other_tree, base_tree, tempdir, 
 
339
                ignore_zero=False, merge_type=ApplyMerge3, backup_files=False,
 
340
                interesting_ids=None):
 
341
 
 
342
    def merge_factory(file_id, base, other):
 
343
        contents_change = merge_type(file_id, base, other)
 
344
        if backup_files:
 
345
            contents_change = BackupBeforeChange(contents_change)
 
346
        return contents_change
 
347
 
 
348
    this_tree = get_tree((this_branch.base, None), tempdir, "this")[1]
 
349
 
 
350
    def get_inventory(tree):
 
351
        return tree.tree.inventory
 
352
 
 
353
    inv_changes = merge_flex(this_tree, base_tree, other_tree,
 
354
                             generate_cset_optimized, get_inventory,
 
355
                             MergeConflictHandler(base_tree.root,
 
356
                                                  ignore_zero=ignore_zero),
 
357
                             merge_factory=merge_factory, 
 
358
                             interesting_ids=interesting_ids)
 
359
 
 
360
    adjust_ids = []
 
361
    for id, path in inv_changes.iteritems():
 
362
        if path is not None:
 
363
            if path == '.':
 
364
                path = ''
 
365
            else:
 
366
                assert path.startswith('.' + os.sep), "path is %s" % path
 
367
            path = path[2:]
 
368
        adjust_ids.append((path, id))
 
369
    if len(adjust_ids) > 0:
 
370
        this_branch.set_inventory(regen_inventory(this_branch, this_tree.root,
 
371
                                                  adjust_ids))
 
372
 
 
373
 
 
374
def regen_inventory(this_branch, root, new_entries):
 
375
    old_entries = this_branch.read_working_inventory()
 
376
    new_inventory = {}
 
377
    by_path = {}
 
378
    new_entries_map = {} 
 
379
    for path, file_id in new_entries:
 
380
        if path is None:
 
381
            continue
 
382
        new_entries_map[file_id] = path
 
383
 
 
384
    def id2path(file_id):
 
385
        path = new_entries_map.get(file_id)
 
386
        if path is not None:
 
387
            return path
 
388
        entry = old_entries[file_id]
 
389
        if entry.parent_id is None:
 
390
            return entry.name
 
391
        return os.path.join(id2path(entry.parent_id), entry.name)
 
392
        
 
393
    for file_id in old_entries:
 
394
        entry = old_entries[file_id]
 
395
        path = id2path(file_id)
 
396
        new_inventory[file_id] = (path, file_id, entry.parent_id, entry.kind)
 
397
        by_path[path] = file_id
 
398
    
 
399
    deletions = 0
 
400
    insertions = 0
 
401
    new_path_list = []
 
402
    for path, file_id in new_entries:
 
403
        if path is None:
 
404
            del new_inventory[file_id]
 
405
            deletions += 1
 
406
        else:
 
407
            new_path_list.append((path, file_id))
 
408
            if file_id not in old_entries:
 
409
                insertions += 1
 
410
    # Ensure no file is added before its parent
 
411
    new_path_list.sort()
 
412
    for path, file_id in new_path_list:
 
413
        if path == '':
 
414
            parent = None
 
415
        else:
 
416
            parent = by_path[os.path.dirname(path)]
 
417
        kind = bzrlib.osutils.file_kind(os.path.join(root, path))
 
418
        new_inventory[file_id] = (path, file_id, parent, kind)
 
419
        by_path[path] = file_id 
 
420
 
 
421
    # Get a list in insertion order
 
422
    new_inventory_list = new_inventory.values()
 
423
    mutter ("""Inventory regeneration:
 
424
old length: %i insertions: %i deletions: %i new_length: %i"""\
 
425
        % (len(old_entries), insertions, deletions, len(new_inventory_list)))
 
426
    assert len(new_inventory_list) == len(old_entries) + insertions - deletions
 
427
    new_inventory_list.sort()
 
428
    return new_inventory_list
 
429
 
 
430
merge_types = {     "merge3": (ApplyMerge3, "Native diff3-style merge"), 
 
431
                     "diff3": (Diff3Merge,  "Merge using external diff3")
 
432
              }
 
433