~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/diff.py

  • Committer: Ian Clatworthy
  • Date: 2009-09-09 11:43:10 UTC
  • mto: (4634.37.2 prepare-2.0)
  • mto: This revision was merged to the branch mainline in revision 4689.
  • Revision ID: ian.clatworthy@canonical.com-20090909114310-glw7tv76i5gnx9pt
put rules back in Makefile supporting plain-style docs

Show diffs side-by-side

added added

removed removed

Lines of Context:
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
import difflib
18
18
import os
19
19
import re
 
20
import shutil
20
21
import sys
21
22
 
22
23
from bzrlib.lazy_import import lazy_import
27
28
import time
28
29
 
29
30
from bzrlib import (
 
31
    branch as _mod_branch,
 
32
    bzrdir,
 
33
    commands,
30
34
    errors,
31
35
    osutils,
32
36
    patiencediff,
33
37
    textfile,
34
38
    timestamp,
 
39
    views,
35
40
    )
36
41
""")
37
42
 
38
43
from bzrlib.symbol_versioning import (
39
 
        deprecated_function,
40
 
        )
41
 
from bzrlib.trace import mutter, warning
 
44
    deprecated_function,
 
45
    )
 
46
from bzrlib.trace import mutter, note, warning
42
47
 
43
48
 
44
49
# TODO: Rather than building a changeset object, we should probably
73
78
    # both sequences are empty.
74
79
    if not oldlines and not newlines:
75
80
        return
76
 
    
 
81
 
77
82
    if allow_binary is False:
78
83
        textfile.check_text_lines(oldlines)
79
84
        textfile.check_text_lines(newlines)
86
91
                      sequencematcher=sequence_matcher)
87
92
 
88
93
    ud = list(ud)
 
94
    if len(ud) == 0: # Identical contents, nothing to do
 
95
        return
89
96
    # work-around for difflib being too smart for its own good
90
97
    # if /dev/null is "1,0", patch won't recognize it as /dev/null
91
98
    if not oldlines:
92
99
        ud[2] = ud[2].replace('-1,0', '-0,0')
93
100
    elif not newlines:
94
101
        ud[2] = ud[2].replace('+1,0', '+0,0')
95
 
    # work around for difflib emitting random spaces after the label
96
 
    ud[0] = ud[0][:-2] + '\n'
97
 
    ud[1] = ud[1][:-2] + '\n'
98
102
 
99
103
    for line in ud:
100
104
        to_file.write(line)
101
105
        if not line.endswith('\n'):
102
106
            to_file.write("\n\\ No newline at end of file\n")
103
 
    print >>to_file
 
107
    to_file.write('\n')
104
108
 
105
109
 
106
110
def _spawn_external_diff(diffcmd, capture_errors=True):
167
171
 
168
172
        if not diff_opts:
169
173
            diff_opts = []
 
174
        if sys.platform == 'win32':
 
175
            # Popen doesn't do the proper encoding for external commands
 
176
            # Since we are dealing with an ANSI api, use mbcs encoding
 
177
            old_filename = old_filename.encode('mbcs')
 
178
            new_filename = new_filename.encode('mbcs')
170
179
        diffcmd = ['diff',
171
180
                   '--label', old_filename,
172
181
                   old_abspath,
195
204
            break
196
205
        else:
197
206
            diffcmd.append('-u')
198
 
                  
 
207
 
199
208
        if diff_opts:
200
209
            diffcmd.extend(diff_opts)
201
210
 
202
211
        pipe = _spawn_external_diff(diffcmd, capture_errors=True)
203
212
        out,err = pipe.communicate()
204
213
        rc = pipe.returncode
205
 
        
 
214
 
206
215
        # internal_diff() adds a trailing newline, add one here for consistency
207
216
        out += '\n'
208
217
        if rc == 2:
243
252
                msg = 'signal %d' % (-rc)
244
253
            else:
245
254
                msg = 'exit code %d' % rc
246
 
                
247
 
            raise errors.BzrError('external diff failed with %s; command: %r' 
 
255
 
 
256
            raise errors.BzrError('external diff failed with %s; command: %r'
248
257
                                  % (rc, diffcmd))
249
258
 
250
259
 
268
277
                        new_abspath, e)
269
278
 
270
279
 
271
 
def diff_cmd_helper(tree, specific_files, external_diff_options, 
272
 
                    old_revision_spec=None, new_revision_spec=None,
273
 
                    revision_specs=None,
274
 
                    old_label='a/', new_label='b/'):
275
 
    """Helper for cmd_diff.
276
 
 
277
 
    :param tree:
278
 
        A WorkingTree
279
 
 
280
 
    :param specific_files:
281
 
        The specific files to compare, or None
282
 
 
283
 
    :param external_diff_options:
284
 
        If non-None, run an external diff, and pass it these options
285
 
 
286
 
    :param old_revision_spec:
287
 
        If None, use basis tree as old revision, otherwise use the tree for
288
 
        the specified revision. 
289
 
 
290
 
    :param new_revision_spec:
291
 
        If None, use working tree as new revision, otherwise use the tree for
292
 
        the specified revision.
293
 
    
294
 
    :param revision_specs: 
295
 
        Zero, one or two RevisionSpecs from the command line, saying what revisions 
296
 
        to compare.  This can be passed as an alternative to the old_revision_spec 
297
 
        and new_revision_spec parameters.
298
 
 
299
 
    The more general form is show_diff_trees(), where the caller
300
 
    supplies any two trees.
 
280
def _get_trees_to_diff(path_list, revision_specs, old_url, new_url,
 
281
    apply_view=True):
 
282
    """Get the trees and specific files to diff given a list of paths.
 
283
 
 
284
    This method works out the trees to be diff'ed and the files of
 
285
    interest within those trees.
 
286
 
 
287
    :param path_list:
 
288
        the list of arguments passed to the diff command
 
289
    :param revision_specs:
 
290
        Zero, one or two RevisionSpecs from the diff command line,
 
291
        saying what revisions to compare.
 
292
    :param old_url:
 
293
        The url of the old branch or tree. If None, the tree to use is
 
294
        taken from the first path, if any, or the current working tree.
 
295
    :param new_url:
 
296
        The url of the new branch or tree. If None, the tree to use is
 
297
        taken from the first path, if any, or the current working tree.
 
298
    :param apply_view:
 
299
        if True and a view is set, apply the view or check that the paths
 
300
        are within it
 
301
    :returns:
 
302
        a tuple of (old_tree, new_tree, specific_files, extra_trees) where
 
303
        extra_trees is a sequence of additional trees to search in for
 
304
        file-ids.
301
305
    """
302
 
 
303
 
    # TODO: perhaps remove the old parameters old_revision_spec and
304
 
    # new_revision_spec, since this is only really for use from cmd_diff and
305
 
    # it now always passes through a sequence of revision_specs -- mbp
306
 
    # 20061221
307
 
 
308
 
    def spec_tree(spec):
309
 
        if tree:
310
 
            revision = spec.in_store(tree.branch)
311
 
        else:
312
 
            revision = spec.in_store(None)
313
 
        revision_id = revision.rev_id
314
 
        branch = revision.branch
315
 
        return branch.repository.revision_tree(revision_id)
316
 
 
 
306
    # Get the old and new revision specs
 
307
    old_revision_spec = None
 
308
    new_revision_spec = None
317
309
    if revision_specs is not None:
318
 
        assert (old_revision_spec is None
319
 
                and new_revision_spec is None)
320
310
        if len(revision_specs) > 0:
321
311
            old_revision_spec = revision_specs[0]
 
312
            if old_url is None:
 
313
                old_url = old_revision_spec.get_branch()
322
314
        if len(revision_specs) > 1:
323
315
            new_revision_spec = revision_specs[1]
324
 
 
325
 
    if old_revision_spec is None:
326
 
        old_tree = tree.basis_tree()
327
 
    else:
328
 
        old_tree = spec_tree(old_revision_spec)
329
 
 
330
 
    if (new_revision_spec is None
331
 
        or new_revision_spec.spec is None):
332
 
        new_tree = tree
333
 
    else:
334
 
        new_tree = spec_tree(new_revision_spec)
335
 
 
336
 
    if new_tree is not tree:
337
 
        extra_trees = (tree,)
338
 
    else:
339
 
        extra_trees = None
340
 
 
341
 
    return show_diff_trees(old_tree, new_tree, sys.stdout, specific_files,
342
 
                           external_diff_options,
343
 
                           old_label=old_label, new_label=new_label,
344
 
                           extra_trees=extra_trees)
 
316
            if new_url is None:
 
317
                new_url = new_revision_spec.get_branch()
 
318
 
 
319
    other_paths = []
 
320
    make_paths_wt_relative = True
 
321
    consider_relpath = True
 
322
    if path_list is None or len(path_list) == 0:
 
323
        # If no path is given, the current working tree is used
 
324
        default_location = u'.'
 
325
        consider_relpath = False
 
326
    elif old_url is not None and new_url is not None:
 
327
        other_paths = path_list
 
328
        make_paths_wt_relative = False
 
329
    else:
 
330
        default_location = path_list[0]
 
331
        other_paths = path_list[1:]
 
332
 
 
333
    # Get the old location
 
334
    specific_files = []
 
335
    if old_url is None:
 
336
        old_url = default_location
 
337
    working_tree, branch, relpath = \
 
338
        bzrdir.BzrDir.open_containing_tree_or_branch(old_url)
 
339
    if consider_relpath and relpath != '':
 
340
        if working_tree is not None and apply_view:
 
341
            views.check_path_in_view(working_tree, relpath)
 
342
        specific_files.append(relpath)
 
343
    old_tree = _get_tree_to_diff(old_revision_spec, working_tree, branch)
 
344
 
 
345
    # Get the new location
 
346
    if new_url is None:
 
347
        new_url = default_location
 
348
    if new_url != old_url:
 
349
        working_tree, branch, relpath = \
 
350
            bzrdir.BzrDir.open_containing_tree_or_branch(new_url)
 
351
        if consider_relpath and relpath != '':
 
352
            if working_tree is not None and apply_view:
 
353
                views.check_path_in_view(working_tree, relpath)
 
354
            specific_files.append(relpath)
 
355
    new_tree = _get_tree_to_diff(new_revision_spec, working_tree, branch,
 
356
        basis_is_default=working_tree is None)
 
357
 
 
358
    # Get the specific files (all files is None, no files is [])
 
359
    if make_paths_wt_relative and working_tree is not None:
 
360
        try:
 
361
            from bzrlib.builtins import safe_relpath_files
 
362
            other_paths = safe_relpath_files(working_tree, other_paths,
 
363
            apply_view=apply_view)
 
364
        except errors.FileInWrongBranch:
 
365
            raise errors.BzrCommandError("Files are in different branches")
 
366
    specific_files.extend(other_paths)
 
367
    if len(specific_files) == 0:
 
368
        specific_files = None
 
369
        if (working_tree is not None and working_tree.supports_views()
 
370
            and apply_view):
 
371
            view_files = working_tree.views.lookup_view()
 
372
            if view_files:
 
373
                specific_files = view_files
 
374
                view_str = views.view_display_str(view_files)
 
375
                note("*** Ignoring files outside view. View is %s" % view_str)
 
376
 
 
377
    # Get extra trees that ought to be searched for file-ids
 
378
    extra_trees = None
 
379
    if working_tree is not None and working_tree not in (old_tree, new_tree):
 
380
        extra_trees = (working_tree,)
 
381
    return old_tree, new_tree, specific_files, extra_trees
 
382
 
 
383
def _get_tree_to_diff(spec, tree=None, branch=None, basis_is_default=True):
 
384
    if branch is None and tree is not None:
 
385
        branch = tree.branch
 
386
    if spec is None or spec.spec is None:
 
387
        if basis_is_default:
 
388
            if tree is not None:
 
389
                return tree.basis_tree()
 
390
            else:
 
391
                return branch.basis_tree()
 
392
        else:
 
393
            return tree
 
394
    return spec.as_tree(branch)
345
395
 
346
396
 
347
397
def show_diff_trees(old_tree, new_tree, to_file, specific_files=None,
348
398
                    external_diff_options=None,
349
399
                    old_label='a/', new_label='b/',
350
400
                    extra_trees=None,
351
 
                    path_encoding='utf8'):
 
401
                    path_encoding='utf8',
 
402
                    using=None):
352
403
    """Show in text form the changes from one tree to another.
353
404
 
354
 
    to_files
355
 
        If set, include only changes to these files.
 
405
    to_file
 
406
        The output stream.
 
407
 
 
408
    specific_files
 
409
        Include only changes to these files - None for all changes.
356
410
 
357
411
    external_diff_options
358
412
        If set, use an external GNU diff and pass these options.
371
425
                tree.lock_read()
372
426
        new_tree.lock_read()
373
427
        try:
374
 
            return _show_diff_trees(old_tree, new_tree, to_file,
375
 
                                    specific_files, external_diff_options,
376
 
                                    old_label=old_label, new_label=new_label,
377
 
                                    extra_trees=extra_trees,
378
 
                                    path_encoding=path_encoding)
 
428
            differ = DiffTree.from_trees_options(old_tree, new_tree, to_file,
 
429
                                                 path_encoding,
 
430
                                                 external_diff_options,
 
431
                                                 old_label, new_label, using)
 
432
            return differ.show_diff(specific_files, extra_trees)
379
433
        finally:
380
434
            new_tree.unlock()
381
435
            if extra_trees is not None:
385
439
        old_tree.unlock()
386
440
 
387
441
 
388
 
def _show_diff_trees(old_tree, new_tree, to_file,
389
 
                     specific_files, external_diff_options, path_encoding,
390
 
                     old_label='a/', new_label='b/', extra_trees=None):
391
 
 
392
 
    # GNU Patch uses the epoch date to detect files that are being added
393
 
    # or removed in a diff.
394
 
    EPOCH_DATE = '1970-01-01 00:00:00 +0000'
395
 
 
396
 
    # TODO: Generation of pseudo-diffs for added/deleted files could
397
 
    # be usefully made into a much faster special case.
398
 
 
399
 
    if external_diff_options:
400
 
        assert isinstance(external_diff_options, basestring)
401
 
        opts = external_diff_options.split()
402
 
        def diff_file(olab, olines, nlab, nlines, to_file):
403
 
            external_diff(olab, olines, nlab, nlines, to_file, opts)
404
 
    else:
405
 
        diff_file = internal_diff
406
 
    
407
 
    delta = new_tree.changes_from(old_tree,
408
 
        specific_files=specific_files,
409
 
        extra_trees=extra_trees, require_versioned=True)
410
 
 
411
 
    has_changes = 0
412
 
    for path, file_id, kind in delta.removed:
413
 
        has_changes = 1
414
 
        path_encoded = path.encode(path_encoding, "replace")
415
 
        print >>to_file, "=== removed %s '%s'" % (kind, path_encoded)
416
 
        old_name = '%s%s\t%s' % (old_label, path,
417
 
                                 _patch_header_date(old_tree, file_id, path))
418
 
        new_name = '%s%s\t%s' % (new_label, path, EPOCH_DATE)
419
 
        old_tree.inventory[file_id].diff(diff_file, old_name, old_tree,
420
 
                                         new_name, None, None, to_file)
421
 
    for path, file_id, kind in delta.added:
422
 
        has_changes = 1
423
 
        path_encoded = path.encode(path_encoding, "replace")
424
 
        print >>to_file, "=== added %s '%s'" % (kind, path_encoded)
425
 
        old_name = '%s%s\t%s' % (old_label, path, EPOCH_DATE)
426
 
        new_name = '%s%s\t%s' % (new_label, path,
427
 
                                 _patch_header_date(new_tree, file_id, path))
428
 
        new_tree.inventory[file_id].diff(diff_file, new_name, new_tree,
429
 
                                         old_name, None, None, to_file, 
430
 
                                         reverse=True)
431
 
    for (old_path, new_path, file_id, kind,
432
 
         text_modified, meta_modified) in delta.renamed:
433
 
        has_changes = 1
434
 
        prop_str = get_prop_change(meta_modified)
435
 
        oldpath_encoded = old_path.encode(path_encoding, "replace")
436
 
        newpath_encoded = new_path.encode(path_encoding, "replace")
437
 
        print >>to_file, "=== renamed %s '%s' => '%s'%s" % (kind,
438
 
                            oldpath_encoded, newpath_encoded, prop_str)
439
 
        old_name = '%s%s\t%s' % (old_label, old_path,
440
 
                                 _patch_header_date(old_tree, file_id,
441
 
                                                    old_path))
442
 
        new_name = '%s%s\t%s' % (new_label, new_path,
443
 
                                 _patch_header_date(new_tree, file_id,
444
 
                                                    new_path))
445
 
        _maybe_diff_file_or_symlink(old_name, old_tree, file_id,
446
 
                                    new_name, new_tree,
447
 
                                    text_modified, kind, to_file, diff_file)
448
 
    for path, file_id, kind, text_modified, meta_modified in delta.modified:
449
 
        has_changes = 1
450
 
        prop_str = get_prop_change(meta_modified)
451
 
        path_encoded = path.encode(path_encoding, "replace")
452
 
        print >>to_file, "=== modified %s '%s'%s" % (kind,
453
 
                            path_encoded, prop_str)
454
 
        # The file may be in a different location in the old tree (because
455
 
        # the containing dir was renamed, but the file itself was not)
456
 
        old_path = old_tree.id2path(file_id)
457
 
        old_name = '%s%s\t%s' % (old_label, old_path,
458
 
                                 _patch_header_date(old_tree, file_id, old_path))
459
 
        new_name = '%s%s\t%s' % (new_label, path,
460
 
                                 _patch_header_date(new_tree, file_id, path))
461
 
        if text_modified:
462
 
            _maybe_diff_file_or_symlink(old_name, old_tree, file_id,
463
 
                                        new_name, new_tree,
464
 
                                        True, kind, to_file, diff_file)
465
 
 
466
 
    return has_changes
467
 
 
468
 
 
469
442
def _patch_header_date(tree, file_id, path):
470
443
    """Returns a timestamp suitable for use in a patch header."""
471
444
    mtime = tree.get_file_mtime(file_id, path)
472
 
    assert mtime is not None, \
473
 
        "got an mtime of None for file-id %s, path %s in tree %s" % (
474
 
                file_id, path, tree)
475
445
    return timestamp.format_patch_date(mtime)
476
446
 
477
447
 
478
 
def _raise_if_nonexistent(paths, old_tree, new_tree):
479
 
    """Complain if paths are not in either inventory or tree.
480
 
 
481
 
    It's OK with the files exist in either tree's inventory, or 
482
 
    if they exist in the tree but are not versioned.
483
 
    
484
 
    This can be used by operations such as bzr status that can accept
485
 
    unknown or ignored files.
486
 
    """
487
 
    mutter("check paths: %r", paths)
488
 
    if not paths:
489
 
        return
490
 
    s = old_tree.filter_unversioned_files(paths)
491
 
    s = new_tree.filter_unversioned_files(s)
492
 
    s = [path for path in s if not new_tree.has_filename(path)]
493
 
    if s:
494
 
        raise errors.PathsDoNotExist(sorted(s))
495
 
 
496
 
 
497
 
def get_prop_change(meta_modified):
498
 
    if meta_modified:
499
 
        return " (properties changed)"
 
448
def get_executable_change(old_is_x, new_is_x):
 
449
    descr = { True:"+x", False:"-x", None:"??" }
 
450
    if old_is_x != new_is_x:
 
451
        return ["%s to %s" % (descr[old_is_x], descr[new_is_x],)]
500
452
    else:
501
 
        return  ""
502
 
 
503
 
 
504
 
def _maybe_diff_file_or_symlink(old_path, old_tree, file_id,
505
 
                                new_path, new_tree, text_modified,
506
 
                                kind, to_file, diff_file):
507
 
    if text_modified:
508
 
        new_entry = new_tree.inventory[file_id]
509
 
        old_tree.inventory[file_id].diff(diff_file,
510
 
                                         old_path, old_tree,
511
 
                                         new_path, new_entry, 
512
 
                                         new_tree, to_file)
 
453
        return []
 
454
 
 
455
 
 
456
class DiffPath(object):
 
457
    """Base type for command object that compare files"""
 
458
 
 
459
    # The type or contents of the file were unsuitable for diffing
 
460
    CANNOT_DIFF = 'CANNOT_DIFF'
 
461
    # The file has changed in a semantic way
 
462
    CHANGED = 'CHANGED'
 
463
    # The file content may have changed, but there is no semantic change
 
464
    UNCHANGED = 'UNCHANGED'
 
465
 
 
466
    def __init__(self, old_tree, new_tree, to_file, path_encoding='utf-8'):
 
467
        """Constructor.
 
468
 
 
469
        :param old_tree: The tree to show as the old tree in the comparison
 
470
        :param new_tree: The tree to show as new in the comparison
 
471
        :param to_file: The file to write comparison data to
 
472
        :param path_encoding: The character encoding to write paths in
 
473
        """
 
474
        self.old_tree = old_tree
 
475
        self.new_tree = new_tree
 
476
        self.to_file = to_file
 
477
        self.path_encoding = path_encoding
 
478
 
 
479
    def finish(self):
 
480
        pass
 
481
 
 
482
    @classmethod
 
483
    def from_diff_tree(klass, diff_tree):
 
484
        return klass(diff_tree.old_tree, diff_tree.new_tree,
 
485
                     diff_tree.to_file, diff_tree.path_encoding)
 
486
 
 
487
    @staticmethod
 
488
    def _diff_many(differs, file_id, old_path, new_path, old_kind, new_kind):
 
489
        for file_differ in differs:
 
490
            result = file_differ.diff(file_id, old_path, new_path, old_kind,
 
491
                                      new_kind)
 
492
            if result is not DiffPath.CANNOT_DIFF:
 
493
                return result
 
494
        else:
 
495
            return DiffPath.CANNOT_DIFF
 
496
 
 
497
 
 
498
class DiffKindChange(object):
 
499
    """Special differ for file kind changes.
 
500
 
 
501
    Represents kind change as deletion + creation.  Uses the other differs
 
502
    to do this.
 
503
    """
 
504
    def __init__(self, differs):
 
505
        self.differs = differs
 
506
 
 
507
    def finish(self):
 
508
        pass
 
509
 
 
510
    @classmethod
 
511
    def from_diff_tree(klass, diff_tree):
 
512
        return klass(diff_tree.differs)
 
513
 
 
514
    def diff(self, file_id, old_path, new_path, old_kind, new_kind):
 
515
        """Perform comparison
 
516
 
 
517
        :param file_id: The file_id of the file to compare
 
518
        :param old_path: Path of the file in the old tree
 
519
        :param new_path: Path of the file in the new tree
 
520
        :param old_kind: Old file-kind of the file
 
521
        :param new_kind: New file-kind of the file
 
522
        """
 
523
        if None in (old_kind, new_kind):
 
524
            return DiffPath.CANNOT_DIFF
 
525
        result = DiffPath._diff_many(self.differs, file_id, old_path,
 
526
                                       new_path, old_kind, None)
 
527
        if result is DiffPath.CANNOT_DIFF:
 
528
            return result
 
529
        return DiffPath._diff_many(self.differs, file_id, old_path, new_path,
 
530
                                     None, new_kind)
 
531
 
 
532
 
 
533
class DiffDirectory(DiffPath):
 
534
 
 
535
    def diff(self, file_id, old_path, new_path, old_kind, new_kind):
 
536
        """Perform comparison between two directories.  (dummy)
 
537
 
 
538
        """
 
539
        if 'directory' not in (old_kind, new_kind):
 
540
            return self.CANNOT_DIFF
 
541
        if old_kind not in ('directory', None):
 
542
            return self.CANNOT_DIFF
 
543
        if new_kind not in ('directory', None):
 
544
            return self.CANNOT_DIFF
 
545
        return self.CHANGED
 
546
 
 
547
 
 
548
class DiffSymlink(DiffPath):
 
549
 
 
550
    def diff(self, file_id, old_path, new_path, old_kind, new_kind):
 
551
        """Perform comparison between two symlinks
 
552
 
 
553
        :param file_id: The file_id of the file to compare
 
554
        :param old_path: Path of the file in the old tree
 
555
        :param new_path: Path of the file in the new tree
 
556
        :param old_kind: Old file-kind of the file
 
557
        :param new_kind: New file-kind of the file
 
558
        """
 
559
        if 'symlink' not in (old_kind, new_kind):
 
560
            return self.CANNOT_DIFF
 
561
        if old_kind == 'symlink':
 
562
            old_target = self.old_tree.get_symlink_target(file_id)
 
563
        elif old_kind is None:
 
564
            old_target = None
 
565
        else:
 
566
            return self.CANNOT_DIFF
 
567
        if new_kind == 'symlink':
 
568
            new_target = self.new_tree.get_symlink_target(file_id)
 
569
        elif new_kind is None:
 
570
            new_target = None
 
571
        else:
 
572
            return self.CANNOT_DIFF
 
573
        return self.diff_symlink(old_target, new_target)
 
574
 
 
575
    def diff_symlink(self, old_target, new_target):
 
576
        if old_target is None:
 
577
            self.to_file.write('=== target is %r\n' % new_target)
 
578
        elif new_target is None:
 
579
            self.to_file.write('=== target was %r\n' % old_target)
 
580
        else:
 
581
            self.to_file.write('=== target changed %r => %r\n' %
 
582
                              (old_target, new_target))
 
583
        return self.CHANGED
 
584
 
 
585
 
 
586
class DiffText(DiffPath):
 
587
 
 
588
    # GNU Patch uses the epoch date to detect files that are being added
 
589
    # or removed in a diff.
 
590
    EPOCH_DATE = '1970-01-01 00:00:00 +0000'
 
591
 
 
592
    def __init__(self, old_tree, new_tree, to_file, path_encoding='utf-8',
 
593
                 old_label='', new_label='', text_differ=internal_diff):
 
594
        DiffPath.__init__(self, old_tree, new_tree, to_file, path_encoding)
 
595
        self.text_differ = text_differ
 
596
        self.old_label = old_label
 
597
        self.new_label = new_label
 
598
        self.path_encoding = path_encoding
 
599
 
 
600
    def diff(self, file_id, old_path, new_path, old_kind, new_kind):
 
601
        """Compare two files in unified diff format
 
602
 
 
603
        :param file_id: The file_id of the file to compare
 
604
        :param old_path: Path of the file in the old tree
 
605
        :param new_path: Path of the file in the new tree
 
606
        :param old_kind: Old file-kind of the file
 
607
        :param new_kind: New file-kind of the file
 
608
        """
 
609
        if 'file' not in (old_kind, new_kind):
 
610
            return self.CANNOT_DIFF
 
611
        from_file_id = to_file_id = file_id
 
612
        if old_kind == 'file':
 
613
            old_date = _patch_header_date(self.old_tree, file_id, old_path)
 
614
        elif old_kind is None:
 
615
            old_date = self.EPOCH_DATE
 
616
            from_file_id = None
 
617
        else:
 
618
            return self.CANNOT_DIFF
 
619
        if new_kind == 'file':
 
620
            new_date = _patch_header_date(self.new_tree, file_id, new_path)
 
621
        elif new_kind is None:
 
622
            new_date = self.EPOCH_DATE
 
623
            to_file_id = None
 
624
        else:
 
625
            return self.CANNOT_DIFF
 
626
        from_label = '%s%s\t%s' % (self.old_label, old_path, old_date)
 
627
        to_label = '%s%s\t%s' % (self.new_label, new_path, new_date)
 
628
        return self.diff_text(from_file_id, to_file_id, from_label, to_label,
 
629
            old_path, new_path)
 
630
 
 
631
    def diff_text(self, from_file_id, to_file_id, from_label, to_label,
 
632
        from_path=None, to_path=None):
 
633
        """Diff the content of given files in two trees
 
634
 
 
635
        :param from_file_id: The id of the file in the from tree.  If None,
 
636
            the file is not present in the from tree.
 
637
        :param to_file_id: The id of the file in the to tree.  This may refer
 
638
            to a different file from from_file_id.  If None,
 
639
            the file is not present in the to tree.
 
640
        :param from_path: The path in the from tree or None if unknown.
 
641
        :param to_path: The path in the to tree or None if unknown.
 
642
        """
 
643
        def _get_text(tree, file_id, path):
 
644
            if file_id is not None:
 
645
                return tree.get_file(file_id, path).readlines()
 
646
            else:
 
647
                return []
 
648
        try:
 
649
            from_text = _get_text(self.old_tree, from_file_id, from_path)
 
650
            to_text = _get_text(self.new_tree, to_file_id, to_path)
 
651
            self.text_differ(from_label, from_text, to_label, to_text,
 
652
                             self.to_file)
 
653
        except errors.BinaryFile:
 
654
            self.to_file.write(
 
655
                  ("Binary files %s and %s differ\n" %
 
656
                  (from_label, to_label)).encode(self.path_encoding))
 
657
        return self.CHANGED
 
658
 
 
659
 
 
660
class DiffFromTool(DiffPath):
 
661
 
 
662
    def __init__(self, command_template, old_tree, new_tree, to_file,
 
663
                 path_encoding='utf-8'):
 
664
        DiffPath.__init__(self, old_tree, new_tree, to_file, path_encoding)
 
665
        self.command_template = command_template
 
666
        self._root = osutils.mkdtemp(prefix='bzr-diff-')
 
667
 
 
668
    @classmethod
 
669
    def from_string(klass, command_string, old_tree, new_tree, to_file,
 
670
                    path_encoding='utf-8'):
 
671
        command_template = commands.shlex_split_unicode(command_string)
 
672
        command_template.extend(['%(old_path)s', '%(new_path)s'])
 
673
        return klass(command_template, old_tree, new_tree, to_file,
 
674
                     path_encoding)
 
675
 
 
676
    @classmethod
 
677
    def make_from_diff_tree(klass, command_string):
 
678
        def from_diff_tree(diff_tree):
 
679
            return klass.from_string(command_string, diff_tree.old_tree,
 
680
                                     diff_tree.new_tree, diff_tree.to_file)
 
681
        return from_diff_tree
 
682
 
 
683
    def _get_command(self, old_path, new_path):
 
684
        my_map = {'old_path': old_path, 'new_path': new_path}
 
685
        return [t % my_map for t in self.command_template]
 
686
 
 
687
    def _execute(self, old_path, new_path):
 
688
        command = self._get_command(old_path, new_path)
 
689
        try:
 
690
            proc = subprocess.Popen(command, stdout=subprocess.PIPE,
 
691
                                    cwd=self._root)
 
692
        except OSError, e:
 
693
            if e.errno == errno.ENOENT:
 
694
                raise errors.ExecutableMissing(command[0])
 
695
            else:
 
696
                raise
 
697
        self.to_file.write(proc.stdout.read())
 
698
        return proc.wait()
 
699
 
 
700
    def _try_symlink_root(self, tree, prefix):
 
701
        if (getattr(tree, 'abspath', None) is None
 
702
            or not osutils.host_os_dereferences_symlinks()):
 
703
            return False
 
704
        try:
 
705
            os.symlink(tree.abspath(''), osutils.pathjoin(self._root, prefix))
 
706
        except OSError, e:
 
707
            if e.errno != errno.EEXIST:
 
708
                raise
 
709
        return True
 
710
 
 
711
    def _write_file(self, file_id, tree, prefix, relpath):
 
712
        full_path = osutils.pathjoin(self._root, prefix, relpath)
 
713
        if self._try_symlink_root(tree, prefix):
 
714
            return full_path
 
715
        parent_dir = osutils.dirname(full_path)
 
716
        try:
 
717
            os.makedirs(parent_dir)
 
718
        except OSError, e:
 
719
            if e.errno != errno.EEXIST:
 
720
                raise
 
721
        source = tree.get_file(file_id, relpath)
 
722
        try:
 
723
            target = open(full_path, 'wb')
 
724
            try:
 
725
                osutils.pumpfile(source, target)
 
726
            finally:
 
727
                target.close()
 
728
        finally:
 
729
            source.close()
 
730
        osutils.make_readonly(full_path)
 
731
        mtime = tree.get_file_mtime(file_id)
 
732
        os.utime(full_path, (mtime, mtime))
 
733
        return full_path
 
734
 
 
735
    def _prepare_files(self, file_id, old_path, new_path):
 
736
        old_disk_path = self._write_file(file_id, self.old_tree, 'old',
 
737
                                         old_path)
 
738
        new_disk_path = self._write_file(file_id, self.new_tree, 'new',
 
739
                                         new_path)
 
740
        return old_disk_path, new_disk_path
 
741
 
 
742
    def finish(self):
 
743
        try:
 
744
            osutils.rmtree(self._root)
 
745
        except OSError, e:
 
746
            if e.errno != errno.ENOENT:
 
747
                mutter("The temporary directory \"%s\" was not "
 
748
                        "cleanly removed: %s." % (self._root, e))
 
749
 
 
750
    def diff(self, file_id, old_path, new_path, old_kind, new_kind):
 
751
        if (old_kind, new_kind) != ('file', 'file'):
 
752
            return DiffPath.CANNOT_DIFF
 
753
        self._prepare_files(file_id, old_path, new_path)
 
754
        self._execute(osutils.pathjoin('old', old_path),
 
755
                      osutils.pathjoin('new', new_path))
 
756
 
 
757
 
 
758
class DiffTree(object):
 
759
    """Provides textual representations of the difference between two trees.
 
760
 
 
761
    A DiffTree examines two trees and where a file-id has altered
 
762
    between them, generates a textual representation of the difference.
 
763
    DiffTree uses a sequence of DiffPath objects which are each
 
764
    given the opportunity to handle a given altered fileid. The list
 
765
    of DiffPath objects can be extended globally by appending to
 
766
    DiffTree.diff_factories, or for a specific diff operation by
 
767
    supplying the extra_factories option to the appropriate method.
 
768
    """
 
769
 
 
770
    # list of factories that can provide instances of DiffPath objects
 
771
    # may be extended by plugins.
 
772
    diff_factories = [DiffSymlink.from_diff_tree,
 
773
                      DiffDirectory.from_diff_tree]
 
774
 
 
775
    def __init__(self, old_tree, new_tree, to_file, path_encoding='utf-8',
 
776
                 diff_text=None, extra_factories=None):
 
777
        """Constructor
 
778
 
 
779
        :param old_tree: Tree to show as old in the comparison
 
780
        :param new_tree: Tree to show as new in the comparison
 
781
        :param to_file: File to write comparision to
 
782
        :param path_encoding: Character encoding to write paths in
 
783
        :param diff_text: DiffPath-type object to use as a last resort for
 
784
            diffing text files.
 
785
        :param extra_factories: Factories of DiffPaths to try before any other
 
786
            DiffPaths"""
 
787
        if diff_text is None:
 
788
            diff_text = DiffText(old_tree, new_tree, to_file, path_encoding,
 
789
                                 '', '',  internal_diff)
 
790
        self.old_tree = old_tree
 
791
        self.new_tree = new_tree
 
792
        self.to_file = to_file
 
793
        self.path_encoding = path_encoding
 
794
        self.differs = []
 
795
        if extra_factories is not None:
 
796
            self.differs.extend(f(self) for f in extra_factories)
 
797
        self.differs.extend(f(self) for f in self.diff_factories)
 
798
        self.differs.extend([diff_text, DiffKindChange.from_diff_tree(self)])
 
799
 
 
800
    @classmethod
 
801
    def from_trees_options(klass, old_tree, new_tree, to_file,
 
802
                           path_encoding, external_diff_options, old_label,
 
803
                           new_label, using):
 
804
        """Factory for producing a DiffTree.
 
805
 
 
806
        Designed to accept options used by show_diff_trees.
 
807
        :param old_tree: The tree to show as old in the comparison
 
808
        :param new_tree: The tree to show as new in the comparison
 
809
        :param to_file: File to write comparisons to
 
810
        :param path_encoding: Character encoding to use for writing paths
 
811
        :param external_diff_options: If supplied, use the installed diff
 
812
            binary to perform file comparison, using supplied options.
 
813
        :param old_label: Prefix to use for old file labels
 
814
        :param new_label: Prefix to use for new file labels
 
815
        :param using: Commandline to use to invoke an external diff tool
 
816
        """
 
817
        if using is not None:
 
818
            extra_factories = [DiffFromTool.make_from_diff_tree(using)]
 
819
        else:
 
820
            extra_factories = []
 
821
        if external_diff_options:
 
822
            opts = external_diff_options.split()
 
823
            def diff_file(olab, olines, nlab, nlines, to_file):
 
824
                external_diff(olab, olines, nlab, nlines, to_file, opts)
 
825
        else:
 
826
            diff_file = internal_diff
 
827
        diff_text = DiffText(old_tree, new_tree, to_file, path_encoding,
 
828
                             old_label, new_label, diff_file)
 
829
        return klass(old_tree, new_tree, to_file, path_encoding, diff_text,
 
830
                     extra_factories)
 
831
 
 
832
    def show_diff(self, specific_files, extra_trees=None):
 
833
        """Write tree diff to self.to_file
 
834
 
 
835
        :param sepecific_files: the specific files to compare (recursive)
 
836
        :param extra_trees: extra trees to use for mapping paths to file_ids
 
837
        """
 
838
        try:
 
839
            return self._show_diff(specific_files, extra_trees)
 
840
        finally:
 
841
            for differ in self.differs:
 
842
                differ.finish()
 
843
 
 
844
    def _show_diff(self, specific_files, extra_trees):
 
845
        # TODO: Generation of pseudo-diffs for added/deleted files could
 
846
        # be usefully made into a much faster special case.
 
847
        iterator = self.new_tree.iter_changes(self.old_tree,
 
848
                                               specific_files=specific_files,
 
849
                                               extra_trees=extra_trees,
 
850
                                               require_versioned=True)
 
851
        has_changes = 0
 
852
        def changes_key(change):
 
853
            old_path, new_path = change[1]
 
854
            path = new_path
 
855
            if path is None:
 
856
                path = old_path
 
857
            return path
 
858
        def get_encoded_path(path):
 
859
            if path is not None:
 
860
                return path.encode(self.path_encoding, "replace")
 
861
        for (file_id, paths, changed_content, versioned, parent, name, kind,
 
862
             executable) in sorted(iterator, key=changes_key):
 
863
            # The root does not get diffed, and items with no known kind (that
 
864
            # is, missing) in both trees are skipped as well.
 
865
            if parent == (None, None) or kind == (None, None):
 
866
                continue
 
867
            oldpath, newpath = paths
 
868
            oldpath_encoded = get_encoded_path(paths[0])
 
869
            newpath_encoded = get_encoded_path(paths[1])
 
870
            old_present = (kind[0] is not None and versioned[0])
 
871
            new_present = (kind[1] is not None and versioned[1])
 
872
            renamed = (parent[0], name[0]) != (parent[1], name[1])
 
873
 
 
874
            properties_changed = []
 
875
            properties_changed.extend(get_executable_change(executable[0], executable[1]))
 
876
 
 
877
            if properties_changed:
 
878
                prop_str = " (properties changed: %s)" % (", ".join(properties_changed),)
 
879
            else:
 
880
                prop_str = ""
 
881
 
 
882
            if (old_present, new_present) == (True, False):
 
883
                self.to_file.write("=== removed %s '%s'\n" %
 
884
                                   (kind[0], oldpath_encoded))
 
885
                newpath = oldpath
 
886
            elif (old_present, new_present) == (False, True):
 
887
                self.to_file.write("=== added %s '%s'\n" %
 
888
                                   (kind[1], newpath_encoded))
 
889
                oldpath = newpath
 
890
            elif renamed:
 
891
                self.to_file.write("=== renamed %s '%s' => '%s'%s\n" %
 
892
                    (kind[0], oldpath_encoded, newpath_encoded, prop_str))
 
893
            else:
 
894
                # if it was produced by iter_changes, it must be
 
895
                # modified *somehow*, either content or execute bit.
 
896
                self.to_file.write("=== modified %s '%s'%s\n" % (kind[0],
 
897
                                   newpath_encoded, prop_str))
 
898
            if changed_content:
 
899
                self._diff(file_id, oldpath, newpath, kind[0], kind[1])
 
900
                has_changes = 1
 
901
            if renamed:
 
902
                has_changes = 1
 
903
        return has_changes
 
904
 
 
905
    def diff(self, file_id, old_path, new_path):
 
906
        """Perform a diff of a single file
 
907
 
 
908
        :param file_id: file-id of the file
 
909
        :param old_path: The path of the file in the old tree
 
910
        :param new_path: The path of the file in the new tree
 
911
        """
 
912
        try:
 
913
            old_kind = self.old_tree.kind(file_id)
 
914
        except (errors.NoSuchId, errors.NoSuchFile):
 
915
            old_kind = None
 
916
        try:
 
917
            new_kind = self.new_tree.kind(file_id)
 
918
        except (errors.NoSuchId, errors.NoSuchFile):
 
919
            new_kind = None
 
920
        self._diff(file_id, old_path, new_path, old_kind, new_kind)
 
921
 
 
922
 
 
923
    def _diff(self, file_id, old_path, new_path, old_kind, new_kind):
 
924
        result = DiffPath._diff_many(self.differs, file_id, old_path,
 
925
                                       new_path, old_kind, new_kind)
 
926
        if result is DiffPath.CANNOT_DIFF:
 
927
            error_path = new_path
 
928
            if error_path is None:
 
929
                error_path = old_path
 
930
            raise errors.NoDiffFound(error_path)