1
# -*- coding: UTF-8 -*-
 
 
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
from bzrlib.symbol_versioning import *
 
 
20
from bzrlib.trace import mutter
 
 
22
# TODO: Rather than building a changeset object, we should probably
 
 
23
# invoke callbacks on an object.  That object can either accumulate a
 
 
24
# list, write them out directly, etc etc.
 
 
26
def internal_diff(old_filename, oldlines, new_filename, newlines, to_file):
 
 
29
    # FIXME: difflib is wrong if there is no trailing newline.
 
 
30
    # The syntax used by patch seems to be "\ No newline at
 
 
31
    # end of file" following the last diff line from that
 
 
32
    # file.  This is not trivial to insert into the
 
 
33
    # unified_diff output and it might be better to just fix
 
 
34
    # or replace that function.
 
 
36
    # In the meantime we at least make sure the patch isn't
 
 
40
    # Special workaround for Python2.3, where difflib fails if
 
 
41
    # both sequences are empty.
 
 
42
    if not oldlines and not newlines:
 
 
45
    ud = difflib.unified_diff(oldlines, newlines,
 
 
46
                              fromfile=old_filename+'\t', 
 
 
47
                              tofile=new_filename+'\t')
 
 
50
    # work-around for difflib being too smart for its own good
 
 
51
    # if /dev/null is "1,0", patch won't recognize it as /dev/null
 
 
53
        ud[2] = ud[2].replace('-1,0', '-0,0')
 
 
55
        ud[2] = ud[2].replace('+1,0', '+0,0')
 
 
56
    # work around for difflib emitting random spaces after the label
 
 
57
    ud[0] = ud[0][:-2] + '\n'
 
 
58
    ud[1] = ud[1][:-2] + '\n'
 
 
62
        if not line.endswith('\n'):
 
 
63
            to_file.write("\n\\ No newline at end of file\n")
 
 
67
def external_diff(old_filename, oldlines, new_filename, newlines, to_file,
 
 
69
    """Display a diff by calling out to the external diff program."""
 
 
72
    if to_file != sys.stdout:
 
 
73
        raise NotImplementedError("sorry, can't send external diff other than to stdout yet",
 
 
76
    # make sure our own output is properly ordered before the diff
 
 
79
    from tempfile import NamedTemporaryFile
 
 
82
    oldtmpf = NamedTemporaryFile()
 
 
83
    newtmpf = NamedTemporaryFile()
 
 
86
        # TODO: perhaps a special case for comparing to or from the empty
 
 
87
        # sequence; can just use /dev/null on Unix
 
 
89
        # TODO: if either of the files being compared already exists as a
 
 
90
        # regular named file (e.g. in the working directory) then we can
 
 
91
        # compare directly to that, rather than copying it.
 
 
93
        oldtmpf.writelines(oldlines)
 
 
94
        newtmpf.writelines(newlines)
 
 
102
                   '--label', old_filename+'\t',
 
 
104
                   '--label', new_filename+'\t',
 
 
107
        # diff only allows one style to be specified; they don't override.
 
 
108
        # note that some of these take optargs, and the optargs can be
 
 
109
        # directly appended to the options.
 
 
110
        # this is only an approximate parser; it doesn't properly understand
 
 
112
        for s in ['-c', '-u', '-C', '-U',
 
 
117
                  '-y', '--side-by-side',
 
 
129
            diffcmd.extend(diff_opts)
 
 
131
        rc = os.spawnvp(os.P_WAIT, 'diff', diffcmd)
 
 
133
        if rc != 0 and rc != 1:
 
 
134
            # returns 1 if files differ; that's OK
 
 
136
                msg = 'signal %d' % (-rc)
 
 
138
                msg = 'exit code %d' % rc
 
 
140
            raise BzrError('external diff failed with %s; command: %r' % (rc, diffcmd))
 
 
142
        oldtmpf.close()                 # and delete
 
 
146
@deprecated_function(zero_eight)
 
 
147
def show_diff(b, from_spec, specific_files, external_diff_options=None,
 
 
148
              revision2=None, output=None, b2=None):
 
 
149
    """Shortcut for showing the diff to the working tree.
 
 
151
    Please use show_diff_trees instead.
 
 
157
        None for 'basis tree', or otherwise the old revision to compare against.
 
 
159
    The more general form is show_diff_trees(), where the caller
 
 
160
    supplies any two trees.
 
 
166
    if from_spec is None:
 
 
167
        old_tree = b.bzrdir.open_workingtree()
 
 
169
            old_tree = old_tree = old_tree.basis_tree()
 
 
171
        old_tree = b.repository.revision_tree(from_spec.in_history(b).rev_id)
 
 
173
    if revision2 is None:
 
 
175
            new_tree = b.bzrdir.open_workingtree()
 
 
177
            new_tree = b2.bzrdir.open_workingtree()
 
 
179
        new_tree = b.repository.revision_tree(revision2.in_history(b).rev_id)
 
 
181
    return show_diff_trees(old_tree, new_tree, output, specific_files,
 
 
182
                           external_diff_options)
 
 
185
def diff_cmd_helper(tree, specific_files, external_diff_options, 
 
 
186
                    old_revision_spec=None, new_revision_spec=None):
 
 
187
    """Helper for cmd_diff.
 
 
193
        The specific files to compare, or None
 
 
195
    external_diff_options
 
 
196
        If non-None, run an external diff, and pass it these options
 
 
199
        If None, use basis tree as old revision, otherwise use the tree for
 
 
200
        the specified revision. 
 
 
203
        If None, use working tree as new revision, otherwise use the tree for
 
 
204
        the specified revision.
 
 
206
    The more general form is show_diff_trees(), where the caller
 
 
207
    supplies any two trees.
 
 
212
        revision_id = spec.in_store(tree.branch).rev_id
 
 
213
        return tree.branch.repository.revision_tree(revision_id)
 
 
214
    if old_revision_spec is None:
 
 
215
        old_tree = tree.basis_tree()
 
 
217
        old_tree = spec_tree(old_revision_spec)
 
 
219
    if new_revision_spec is None:
 
 
222
        new_tree = spec_tree(new_revision_spec)
 
 
224
    return show_diff_trees(old_tree, new_tree, sys.stdout, specific_files,
 
 
225
                           external_diff_options)
 
 
228
def show_diff_trees(old_tree, new_tree, to_file, specific_files=None,
 
 
229
                    external_diff_options=None):
 
 
230
    """Show in text form the changes from one tree to another.
 
 
233
        If set, include only changes to these files.
 
 
235
    external_diff_options
 
 
236
        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
    if external_diff_options:
 
 
268
        assert isinstance(external_diff_options, basestring)
 
 
269
        opts = external_diff_options.split()
 
 
270
        def diff_file(olab, olines, nlab, nlines, to_file):
 
 
271
            external_diff(olab, olines, nlab, nlines, to_file, opts)
 
 
273
        diff_file = internal_diff
 
 
276
    delta = compare_trees(old_tree, new_tree, want_unchanged=False,
 
 
277
                          specific_files=specific_files)
 
 
280
    for path, file_id, kind in delta.removed:
 
 
282
        print >>to_file, '=== removed %s %r' % (kind, old_label + path)
 
 
283
        old_tree.inventory[file_id].diff(diff_file, old_label + path, old_tree,
 
 
284
                                         DEVNULL, None, None, to_file)
 
 
285
    for path, file_id, kind in delta.added:
 
 
287
        print >>to_file, '=== added %s %r' % (kind, new_label + path)
 
 
288
        new_tree.inventory[file_id].diff(diff_file, new_label + path, new_tree,
 
 
289
                                         DEVNULL, None, None, to_file, 
 
 
291
    for (old_path, new_path, file_id, kind,
 
 
292
         text_modified, meta_modified) in delta.renamed:
 
 
294
        prop_str = get_prop_change(meta_modified)
 
 
295
        print >>to_file, '=== renamed %s %r => %r%s' % (
 
 
296
                    kind, old_label + old_path, new_label + new_path, prop_str)
 
 
297
        _maybe_diff_file_or_symlink(old_label, old_path, old_tree, file_id,
 
 
298
                                    new_label, new_path, new_tree,
 
 
299
                                    text_modified, kind, to_file, diff_file)
 
 
300
    for path, file_id, kind, text_modified, meta_modified in delta.modified:
 
 
302
        prop_str = get_prop_change(meta_modified)
 
 
303
        print >>to_file, '=== modified %s %r%s' % (kind, old_label + path,
 
 
306
            _maybe_diff_file_or_symlink(old_label, path, old_tree, file_id,
 
 
307
                                        new_label, path, new_tree,
 
 
308
                                        True, kind, to_file, diff_file)
 
 
312
def get_prop_change(meta_modified):
 
 
314
        return " (properties changed)"
 
 
319
def _maybe_diff_file_or_symlink(old_label, old_path, old_tree, file_id,
 
 
320
                                new_label, new_path, new_tree, text_modified,
 
 
321
                                kind, to_file, diff_file):
 
 
323
        new_entry = new_tree.inventory[file_id]
 
 
324
        old_tree.inventory[file_id].diff(diff_file,
 
 
325
                                         old_label + old_path, old_tree,
 
 
326
                                         new_label + new_path, new_entry,