1
# Copyright (C) 2004, 2005, 2006 Canonical Ltd.
 
 
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.
 
 
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.
 
 
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
 
 
17
from bzrlib.delta import compare_trees
 
 
18
from bzrlib.errors import BzrError
 
 
19
import bzrlib.errors as errors
 
 
20
from bzrlib.symbol_versioning import *
 
 
21
from bzrlib.trace import mutter
 
 
23
# TODO: Rather than building a changeset object, we should probably
 
 
24
# invoke callbacks on an object.  That object can either accumulate a
 
 
25
# list, write them out directly, etc etc.
 
 
27
def internal_diff(old_filename, oldlines, new_filename, newlines, to_file):
 
 
30
    # FIXME: difflib is wrong if there is no trailing newline.
 
 
31
    # The syntax used by patch seems to be "\ No newline at
 
 
32
    # end of file" following the last diff line from that
 
 
33
    # file.  This is not trivial to insert into the
 
 
34
    # unified_diff output and it might be better to just fix
 
 
35
    # or replace that function.
 
 
37
    # In the meantime we at least make sure the patch isn't
 
 
41
    # Special workaround for Python2.3, where difflib fails if
 
 
42
    # both sequences are empty.
 
 
43
    if not oldlines and not newlines:
 
 
46
    ud = difflib.unified_diff(oldlines, newlines,
 
 
47
                              fromfile=old_filename+'\t', 
 
 
48
                              tofile=new_filename+'\t')
 
 
51
    # work-around for difflib being too smart for its own good
 
 
52
    # if /dev/null is "1,0", patch won't recognize it as /dev/null
 
 
54
        ud[2] = ud[2].replace('-1,0', '-0,0')
 
 
56
        ud[2] = ud[2].replace('+1,0', '+0,0')
 
 
57
    # work around for difflib emitting random spaces after the label
 
 
58
    ud[0] = ud[0][:-2] + '\n'
 
 
59
    ud[1] = ud[1][:-2] + '\n'
 
 
63
        if not line.endswith('\n'):
 
 
64
            to_file.write("\n\\ No newline at end of file\n")
 
 
68
def external_diff(old_filename, oldlines, new_filename, newlines, to_file,
 
 
70
    """Display a diff by calling out to the external diff program."""
 
 
73
    if to_file != sys.stdout:
 
 
74
        raise NotImplementedError("sorry, can't send external diff other than to stdout yet",
 
 
77
    # make sure our own output is properly ordered before the diff
 
 
80
    from tempfile import NamedTemporaryFile
 
 
83
    oldtmpf = NamedTemporaryFile()
 
 
84
    newtmpf = NamedTemporaryFile()
 
 
87
        # TODO: perhaps a special case for comparing to or from the empty
 
 
88
        # sequence; can just use /dev/null on Unix
 
 
90
        # TODO: if either of the files being compared already exists as a
 
 
91
        # regular named file (e.g. in the working directory) then we can
 
 
92
        # compare directly to that, rather than copying it.
 
 
94
        oldtmpf.writelines(oldlines)
 
 
95
        newtmpf.writelines(newlines)
 
 
103
                   '--label', old_filename+'\t',
 
 
105
                   '--label', new_filename+'\t',
 
 
108
        # diff only allows one style to be specified; they don't override.
 
 
109
        # note that some of these take optargs, and the optargs can be
 
 
110
        # directly appended to the options.
 
 
111
        # this is only an approximate parser; it doesn't properly understand
 
 
113
        for s in ['-c', '-u', '-C', '-U',
 
 
118
                  '-y', '--side-by-side',
 
 
130
            diffcmd.extend(diff_opts)
 
 
132
        rc = os.spawnvp(os.P_WAIT, 'diff', diffcmd)
 
 
134
        if rc != 0 and rc != 1:
 
 
135
            # returns 1 if files differ; that's OK
 
 
137
                msg = 'signal %d' % (-rc)
 
 
139
                msg = 'exit code %d' % rc
 
 
141
            raise BzrError('external diff failed with %s; command: %r' % (rc, diffcmd))
 
 
143
        oldtmpf.close()                 # and delete
 
 
147
@deprecated_function(zero_eight)
 
 
148
def show_diff(b, from_spec, specific_files, external_diff_options=None,
 
 
149
              revision2=None, output=None, b2=None):
 
 
150
    """Shortcut for showing the diff to the working tree.
 
 
152
    Please use show_diff_trees instead.
 
 
158
        None for 'basis tree', or otherwise the old revision to compare against.
 
 
160
    The more general form is show_diff_trees(), where the caller
 
 
161
    supplies any two trees.
 
 
167
    if from_spec is None:
 
 
168
        old_tree = b.bzrdir.open_workingtree()
 
 
170
            old_tree = old_tree = old_tree.basis_tree()
 
 
172
        old_tree = b.repository.revision_tree(from_spec.in_history(b).rev_id)
 
 
174
    if revision2 is None:
 
 
176
            new_tree = b.bzrdir.open_workingtree()
 
 
178
            new_tree = b2.bzrdir.open_workingtree()
 
 
180
        new_tree = b.repository.revision_tree(revision2.in_history(b).rev_id)
 
 
182
    return show_diff_trees(old_tree, new_tree, output, specific_files,
 
 
183
                           external_diff_options)
 
 
186
def diff_cmd_helper(tree, specific_files, external_diff_options, 
 
 
187
                    old_revision_spec=None, new_revision_spec=None):
 
 
188
    """Helper for cmd_diff.
 
 
194
        The specific files to compare, or None
 
 
196
    external_diff_options
 
 
197
        If non-None, run an external diff, and pass it these options
 
 
200
        If None, use basis tree as old revision, otherwise use the tree for
 
 
201
        the specified revision. 
 
 
204
        If None, use working tree as new revision, otherwise use the tree for
 
 
205
        the specified revision.
 
 
207
    The more general form is show_diff_trees(), where the caller
 
 
208
    supplies any two trees.
 
 
213
        revision_id = spec.in_store(tree.branch).rev_id
 
 
214
        return tree.branch.repository.revision_tree(revision_id)
 
 
215
    if old_revision_spec is None:
 
 
216
        old_tree = tree.basis_tree()
 
 
218
        old_tree = spec_tree(old_revision_spec)
 
 
220
    if new_revision_spec is None:
 
 
223
        new_tree = spec_tree(new_revision_spec)
 
 
225
    return show_diff_trees(old_tree, new_tree, sys.stdout, specific_files,
 
 
226
                           external_diff_options)
 
 
229
def show_diff_trees(old_tree, new_tree, to_file, specific_files=None,
 
 
230
                    external_diff_options=None):
 
 
231
    """Show in text form the changes from one tree to another.
 
 
234
        If set, include only changes to these files.
 
 
236
    external_diff_options
 
 
237
        If set, use an external GNU diff and pass these options.
 
 
243
            return _show_diff_trees(old_tree, new_tree, to_file,
 
 
244
                                    specific_files, external_diff_options)
 
 
251
def _show_diff_trees(old_tree, new_tree, to_file,
 
 
252
                     specific_files, external_diff_options):
 
 
254
    # TODO: Options to control putting on a prefix or suffix, perhaps
 
 
255
    # as a format string?
 
 
259
    DEVNULL = '/dev/null'
 
 
260
    # Windows users, don't panic about this filename -- it is a
 
 
261
    # special signal to GNU patch that the file should be created or
 
 
262
    # deleted respectively.
 
 
264
    # TODO: Generation of pseudo-diffs for added/deleted files could
 
 
265
    # be usefully made into a much faster special case.
 
 
267
    _raise_if_doubly_unversioned(specific_files, old_tree, new_tree)
 
 
269
    if external_diff_options:
 
 
270
        assert isinstance(external_diff_options, basestring)
 
 
271
        opts = external_diff_options.split()
 
 
272
        def diff_file(olab, olines, nlab, nlines, to_file):
 
 
273
            external_diff(olab, olines, nlab, nlines, to_file, opts)
 
 
275
        diff_file = internal_diff
 
 
277
    delta = compare_trees(old_tree, new_tree, want_unchanged=False,
 
 
278
                          specific_files=specific_files)
 
 
281
    for path, file_id, kind in delta.removed:
 
 
283
        print >>to_file, '=== removed %s %r' % (kind, old_label + path)
 
 
284
        old_tree.inventory[file_id].diff(diff_file, old_label + path, old_tree,
 
 
285
                                         DEVNULL, None, None, to_file)
 
 
286
    for path, file_id, kind in delta.added:
 
 
288
        print >>to_file, '=== added %s %r' % (kind, new_label + path)
 
 
289
        new_tree.inventory[file_id].diff(diff_file, new_label + path, new_tree,
 
 
290
                                         DEVNULL, None, None, to_file, 
 
 
292
    for (old_path, new_path, file_id, kind,
 
 
293
         text_modified, meta_modified) in delta.renamed:
 
 
295
        prop_str = get_prop_change(meta_modified)
 
 
296
        print >>to_file, '=== renamed %s %r => %r%s' % (
 
 
297
                    kind, old_label + old_path, new_label + new_path, prop_str)
 
 
298
        _maybe_diff_file_or_symlink(old_label, old_path, old_tree, file_id,
 
 
299
                                    new_label, new_path, new_tree,
 
 
300
                                    text_modified, kind, to_file, diff_file)
 
 
301
    for path, file_id, kind, text_modified, meta_modified in delta.modified:
 
 
303
        prop_str = get_prop_change(meta_modified)
 
 
304
        print >>to_file, '=== modified %s %r%s' % (kind, old_label + path,
 
 
307
            _maybe_diff_file_or_symlink(old_label, path, old_tree, file_id,
 
 
308
                                        new_label, path, new_tree,
 
 
309
                                        True, kind, to_file, diff_file)
 
 
314
def _raise_if_doubly_unversioned(specific_files, old_tree, new_tree):
 
 
315
    """Complain if paths are not versioned in either tree."""
 
 
316
    if not specific_files:
 
 
318
    old_unversioned = old_tree.filter_unversioned_files(specific_files)
 
 
319
    new_unversioned = new_tree.filter_unversioned_files(specific_files)
 
 
320
    unversioned = old_unversioned.intersection(new_unversioned)
 
 
322
        raise errors.PathsNotVersionedError(sorted(unversioned))
 
 
325
def get_prop_change(meta_modified):
 
 
327
        return " (properties changed)"
 
 
332
def _maybe_diff_file_or_symlink(old_label, old_path, old_tree, file_id,
 
 
333
                                new_label, new_path, new_tree, text_modified,
 
 
334
                                kind, to_file, diff_file):
 
 
336
        new_entry = new_tree.inventory[file_id]
 
 
337
        old_tree.inventory[file_id].diff(diff_file,
 
 
338
                                         old_label + old_path, old_tree,
 
 
339
                                         new_label + new_path, new_entry,