~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/delta.py

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006 Canonical
 
1
# Copyright (C) 2005, 2006 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
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
from bzrlib import (
 
18
    errors,
 
19
    osutils,
 
20
    )
17
21
from bzrlib.inventory import InventoryEntry
18
 
from bzrlib.trace import mutter
19
 
from bzrlib.symbol_versioning import deprecated_function, zero_nine
 
22
from bzrlib.trace import mutter, is_quiet
 
23
from bzrlib.symbol_versioning import deprecated_function
20
24
 
21
25
 
22
26
class TreeDelta(object):
23
27
    """Describes changes from one tree to another.
24
28
 
25
 
    Contains four lists:
 
29
    Contains seven lists:
26
30
 
27
31
    added
28
32
        (path, id, kind)
30
34
        (path, id, kind)
31
35
    renamed
32
36
        (oldpath, newpath, id, kind, text_modified, meta_modified)
 
37
    kind_changed
 
38
        (path, id, old_kind, new_kind)
33
39
    modified
34
40
        (path, id, kind, text_modified, meta_modified)
35
41
    unchanged
36
42
        (path, id, kind)
 
43
    unversioned
 
44
        (path, None, kind)
37
45
 
38
46
    Each id is listed only once.
39
47
 
52
60
        self.added = []
53
61
        self.removed = []
54
62
        self.renamed = []
 
63
        self.kind_changed = []
55
64
        self.modified = []
56
65
        self.unchanged = []
 
66
        self.unversioned = []
57
67
 
58
68
    def __eq__(self, other):
59
69
        if not isinstance(other, TreeDelta):
62
72
               and self.removed == other.removed \
63
73
               and self.renamed == other.renamed \
64
74
               and self.modified == other.modified \
65
 
               and self.unchanged == other.unchanged
 
75
               and self.unchanged == other.unchanged \
 
76
               and self.kind_changed == other.kind_changed \
 
77
               and self.unversioned == other.unversioned
66
78
 
67
79
    def __ne__(self, other):
68
80
        return not (self == other)
69
81
 
70
82
    def __repr__(self):
71
 
        return "TreeDelta(added=%r, removed=%r, renamed=%r, modified=%r," \
72
 
            " unchanged=%r)" % (self.added, self.removed, self.renamed,
73
 
            self.modified, self.unchanged)
 
83
        return "TreeDelta(added=%r, removed=%r, renamed=%r," \
 
84
            " kind_changed=%r, modified=%r, unchanged=%r," \
 
85
            " unversioned=%r)" % (self.added,
 
86
            self.removed, self.renamed, self.kind_changed, self.modified,
 
87
            self.unchanged, self.unversioned)
74
88
 
75
89
    def has_changed(self):
76
90
        return bool(self.modified
77
91
                    or self.added
78
92
                    or self.removed
79
 
                    or self.renamed)
 
93
                    or self.renamed
 
94
                    or self.kind_changed)
80
95
 
81
96
    def touches_file_id(self, file_id):
82
97
        """Return True if file_id is modified by this delta."""
87
102
        for v in self.renamed:
88
103
            if v[2] == file_id:
89
104
                return True
 
105
        for v in self.kind_changed:
 
106
            if v[1] == file_id:
 
107
                return True
90
108
        return False
91
 
            
92
 
 
93
 
    def show(self, to_file, show_ids=False, show_unchanged=False):
94
 
        """output this delta in status-like form to to_file."""
95
 
        def show_list(files):
96
 
            for item in files:
97
 
                path, fid, kind = item[:3]
98
 
 
99
 
                if kind == 'directory':
100
 
                    path += '/'
101
 
                elif kind == 'symlink':
102
 
                    path += '@'
103
 
 
104
 
                if len(item) == 5 and item[4]:
105
 
                    path += '*'
106
 
 
107
 
                if show_ids:
108
 
                    print >>to_file, '  %-30s %s' % (path, fid)
 
109
 
 
110
 
 
111
    def show(self, to_file, show_ids=False, show_unchanged=False,
 
112
             short_status=False, indent='',
 
113
             filter=None):
 
114
        """Output this delta in status-like form to to_file.
 
115
 
 
116
        :param to_file: A file-like object where the output is displayed.
 
117
 
 
118
        :param show_ids: Output the file ids if True.
 
119
 
 
120
        :param show_unchanged: Output the unchanged files if True.
 
121
 
 
122
        :param short_status: Single-line status if True.
 
123
 
 
124
        :param indent: Added at the beginning of all output lines (for merged
 
125
            revisions).
 
126
 
 
127
        :param filter: A callable receiving a path and a file id and
 
128
            returning True if the path should be displayed.
 
129
        """
 
130
 
 
131
        def decorate_path(path, kind, meta_modified=None):
 
132
            if kind == 'directory':
 
133
                path += '/'
 
134
            elif kind == 'symlink':
 
135
                path += '@'
 
136
            if meta_modified:
 
137
                path += '*'
 
138
            return path
 
139
 
 
140
        def show_more_renamed(item):
 
141
            (oldpath, file_id, kind,
 
142
             text_modified, meta_modified, newpath) = item
 
143
            dec_new_path = decorate_path(newpath, kind, meta_modified)
 
144
            to_file.write(' => %s' % dec_new_path)
 
145
            if text_modified or meta_modified:
 
146
                extra_modified.append((newpath, file_id, kind,
 
147
                                       text_modified, meta_modified))
 
148
 
 
149
        def show_more_kind_changed(item):
 
150
            (path, file_id, old_kind, new_kind) = item
 
151
            to_file.write(' (%s => %s)' % (old_kind, new_kind))
 
152
 
 
153
        def show_path(path, file_id, kind, meta_modified,
 
154
                      default_format, with_file_id_format):
 
155
            dec_path = decorate_path(path, kind, meta_modified)
 
156
            if show_ids:
 
157
                to_file.write(with_file_id_format % dec_path)
 
158
            else:
 
159
                to_file.write(default_format % dec_path)
 
160
 
 
161
        def show_list(files, long_status_name, short_status_letter,
 
162
                      default_format='%s', with_file_id_format='%-30s',
 
163
                      show_more=None):
 
164
            if files:
 
165
                header_shown = False
 
166
                if short_status:
 
167
                    prefix = short_status_letter
109
168
                else:
110
 
                    print >>to_file, ' ', path
111
 
            
112
 
        if self.removed:
113
 
            print >>to_file, 'removed:'
114
 
            show_list(self.removed)
115
 
                
116
 
        if self.added:
117
 
            print >>to_file, 'added:'
118
 
            show_list(self.added)
119
 
 
 
169
                    prefix = ''
 
170
                prefix = indent + prefix + '  '
 
171
 
 
172
                for item in files:
 
173
                    path, file_id, kind = item[:3]
 
174
                    if (filter is not None and not filter(path, file_id)):
 
175
                        continue
 
176
                    if not header_shown and not short_status:
 
177
                        to_file.write(indent + long_status_name + ':\n')
 
178
                        header_shown = True
 
179
                    meta_modified = None
 
180
                    if len(item) == 5:
 
181
                        meta_modified = item[4]
 
182
 
 
183
                    to_file.write(prefix)
 
184
                    show_path(path, file_id, kind, meta_modified,
 
185
                              default_format, with_file_id_format)
 
186
                    if show_more is not None:
 
187
                        show_more(item)
 
188
                    if show_ids:
 
189
                        to_file.write(' %s' % file_id)
 
190
                    to_file.write('\n')
 
191
 
 
192
        show_list(self.removed, 'removed', 'D')#
 
193
        show_list(self.added, 'added', 'A')
120
194
        extra_modified = []
121
 
 
122
 
        if self.renamed:
123
 
            print >>to_file, 'renamed:'
124
 
            for (oldpath, newpath, fid, kind,
125
 
                 text_modified, meta_modified) in self.renamed:
126
 
                if text_modified or meta_modified:
127
 
                    extra_modified.append((newpath, fid, kind,
128
 
                                           text_modified, meta_modified))
129
 
                if meta_modified:
130
 
                    newpath += '*'
131
 
                if show_ids:
132
 
                    print >>to_file, '  %s => %s %s' % (oldpath, newpath, fid)
133
 
                else:
134
 
                    print >>to_file, '  %s => %s' % (oldpath, newpath)
135
 
                    
136
 
        if self.modified or extra_modified:
137
 
            print >>to_file, 'modified:'
138
 
            show_list(self.modified)
139
 
            show_list(extra_modified)
140
 
            
141
 
        if show_unchanged and self.unchanged:
142
 
            print >>to_file, 'unchanged:'
143
 
            show_list(self.unchanged)
144
 
 
145
 
 
146
 
@deprecated_function(zero_nine)
147
 
def compare_trees(old_tree, new_tree, want_unchanged=False,
148
 
                  specific_files=None, extra_trees=None,
149
 
                  require_versioned=False):
150
 
    """compare_trees was deprecated in 0.10. Please see Tree.changes_from."""
151
 
    return new_tree.changes_from(old_tree,
152
 
        want_unchanged=want_unchanged,
153
 
        specific_files=specific_files,
154
 
        extra_trees=extra_trees,
155
 
        require_versioned=require_versioned)
156
 
 
157
 
 
158
 
def _compare_trees(old_tree, new_tree, want_unchanged, specific_file_ids):
159
 
 
160
 
    from osutils import is_inside_any
161
 
    
162
 
    old_inv = old_tree.inventory
163
 
    new_inv = new_tree.inventory
 
195
        # Reorder self.renamed tuples so that all lists share the same
 
196
        # order for their 3 first fields and that they also begin like
 
197
        # the self.modified tuples
 
198
        renamed = [(p, i, k, tm, mm, np)
 
199
                   for  p, np, i, k, tm, mm  in self.renamed]
 
200
        show_list(renamed, 'renamed', 'R', with_file_id_format='%s',
 
201
                  show_more=show_more_renamed)
 
202
        show_list(self.kind_changed, 'kind changed', 'K',
 
203
                  with_file_id_format='%s',
 
204
                  show_more=show_more_kind_changed)
 
205
        show_list(self.modified + extra_modified, 'modified', 'M')
 
206
        if show_unchanged:
 
207
            show_list(self.unchanged, 'unchanged', 'S')
 
208
 
 
209
        show_list(self.unversioned, 'unknown', ' ')
 
210
 
 
211
    def get_changes_as_text(self, show_ids=False, show_unchanged=False,
 
212
             short_status=False):
 
213
        import StringIO
 
214
        output = StringIO.StringIO()
 
215
        self.show(output, show_ids, show_unchanged, short_status)
 
216
        return output.getvalue()
 
217
 
 
218
 
 
219
def _compare_trees(old_tree, new_tree, want_unchanged, specific_files,
 
220
                   include_root, extra_trees=None,
 
221
                   require_versioned=False, want_unversioned=False):
 
222
    """Worker function that implements Tree.changes_from."""
164
223
    delta = TreeDelta()
165
 
    mutter('start compare_trees')
166
 
 
167
 
    # TODO: Rather than iterating over the whole tree and then filtering, we
168
 
    # could diff just the specified files (if any) and their subtrees.  
169
 
 
170
 
    old_files = old_tree.list_files()
171
 
    new_files = new_tree.list_files()
172
 
 
173
 
    more_old = True
174
 
    more_new = True
175
 
 
176
 
    added = {}
177
 
    removed = {}
178
 
 
179
 
    def get_next(iter):
180
 
        try:
181
 
            return iter.next()
182
 
        except StopIteration:
183
 
            return None, None, None, None, None
184
 
    old_path, old_class, old_kind, old_file_id, old_entry = get_next(old_files)
185
 
    new_path, new_class, new_kind, new_file_id, new_entry = get_next(new_files)
186
 
 
187
 
 
188
 
    def check_matching(old_path, old_entry, new_path, new_entry):
189
 
        """We have matched up 2 file_ids, check for changes."""
190
 
        assert old_entry.kind == new_entry.kind
191
 
 
192
 
        if specific_file_ids:
193
 
            if (old_entry.file_id not in specific_file_ids and 
194
 
                new_entry.file_id not in specific_file_ids):
195
 
                return
196
 
 
197
 
        # temporary hack until all entries are populated before clients 
198
 
        # get them
199
 
        old_entry._read_tree_state(old_path, old_tree)
200
 
        new_entry._read_tree_state(new_path, new_tree)
201
 
        text_modified, meta_modified = new_entry.detect_changes(old_entry)
202
 
        
203
 
        # If the name changes, or the parent_id changes, we have a rename
204
 
        # (if we move a parent, that doesn't count as a rename for the file)
205
 
        if (old_entry.name != new_entry.name 
206
 
            or old_entry.parent_id != new_entry.parent_id):
207
 
            delta.renamed.append((old_path,
208
 
                                  new_path,
209
 
                                  old_entry.file_id, old_entry.kind,
210
 
                                  text_modified, meta_modified))
211
 
        elif text_modified or meta_modified:
212
 
            delta.modified.append((new_path, new_entry.file_id, new_entry.kind,
213
 
                                   text_modified, meta_modified))
214
 
        elif want_unchanged:
215
 
            delta.unchanged.append((new_path, new_entry.file_id, new_entry.kind))
216
 
 
217
 
 
218
 
    def handle_old(path, entry):
219
 
        """old entry without a new entry match
220
 
 
221
 
        Check to see if a matching new entry was already seen as an
222
 
        added file, and switch the pair into being a rename.
223
 
        Otherwise just mark the old entry being removed.
224
 
        """
225
 
        if entry.file_id in added:
226
 
            # Actually this is a rename, we found a new file_id earlier
227
 
            # at a different location, so it is no-longer added
228
 
            x_new_path, x_new_entry = added.pop(entry.file_id)
229
 
            check_matching(path, entry, x_new_path, x_new_entry)
230
 
        else:
231
 
            # We have an old_file_id which doesn't line up with a new_file_id
232
 
            # So this file looks to be removed
233
 
            assert entry.file_id not in removed
234
 
            removed[entry.file_id] = path, entry
235
 
 
236
 
    def handle_new(path, entry):
237
 
        """new entry without an old entry match
238
 
        
239
 
        Check to see if a matching old entry was already seen as a
240
 
        removal, and change the pair into a rename.
241
 
        Otherwise just mark the new entry as an added file.
242
 
        """
243
 
        if entry.file_id in removed:
244
 
            # We saw this file_id earlier at an old different location
245
 
            # it is no longer removed, just renamed
246
 
            x_old_path, x_old_entry = removed.pop(entry.file_id)
247
 
            check_matching(x_old_path, x_old_entry, path, entry)
248
 
        else:
249
 
            # We have a new file which does not match an old file
250
 
            # mark it as added
251
 
            assert entry.file_id not in added
252
 
            added[entry.file_id] = path, entry
253
 
 
254
 
    while old_path or new_path:
255
 
        # list_files() returns files in alphabetical path sorted order
256
 
        if old_path == new_path:
257
 
            if old_file_id == new_file_id:
258
 
                # This is the common case, the files are in the same place
259
 
                # check if there were any content changes
260
 
 
261
 
                if old_file_id is None:
262
 
                    # We have 2 unversioned files, no deltas possible???
263
 
                    pass
264
 
                else:
265
 
                    check_matching(old_path, old_entry, new_path, new_entry)
 
224
    # mutter('start compare_trees')
 
225
 
 
226
    for (file_id, path, content_change, versioned, parent_id, name, kind,
 
227
         executable) in new_tree.iter_changes(old_tree, want_unchanged,
 
228
            specific_files, extra_trees=extra_trees,
 
229
            require_versioned=require_versioned,
 
230
            want_unversioned=want_unversioned):
 
231
        if versioned == (False, False):
 
232
            delta.unversioned.append((path[1], None, kind[1]))
 
233
            continue
 
234
        if not include_root and (None, None) == parent_id:
 
235
            continue
 
236
        fully_present = tuple((versioned[x] and kind[x] is not None) for
 
237
                              x in range(2))
 
238
        if fully_present[0] != fully_present[1]:
 
239
            if fully_present[1] is True:
 
240
                delta.added.append((path[1], file_id, kind[1]))
266
241
            else:
267
 
                # The ids don't match, so we have to handle them both
268
 
                # separately.
269
 
                if old_file_id is not None:
270
 
                    handle_old(old_path, old_entry)
271
 
 
272
 
                if new_file_id is not None:
273
 
                    handle_new(new_path, new_entry)
274
 
 
275
 
            # The two entries were at the same path, so increment both sides
276
 
            old_path, old_class, old_kind, old_file_id, old_entry = get_next(old_files)
277
 
            new_path, new_class, new_kind, new_file_id, new_entry = get_next(new_files)
278
 
        elif new_path is None or (old_path is not None and old_path < new_path):
279
 
            # Assume we don't match, only process old_path
280
 
            if old_file_id is not None:
281
 
                handle_old(old_path, old_entry)
282
 
            # old_path came first, so increment it, trying to match up
283
 
            old_path, old_class, old_kind, old_file_id, old_entry = get_next(old_files)
284
 
        elif new_path is not None:
285
 
            # new_path came first, so increment it, trying to match up
286
 
            if new_file_id is not None:
287
 
                handle_new(new_path, new_entry)
288
 
            new_path, new_class, new_kind, new_file_id, new_entry = get_next(new_files)
289
 
 
290
 
    # Now we have a set of added and removed files, mark them all
291
 
    for old_path, old_entry in removed.itervalues():
292
 
        if specific_file_ids:
293
 
            if not old_entry.file_id in specific_file_ids:
294
 
                continue
295
 
        delta.removed.append((old_path, old_entry.file_id, old_entry.kind))
296
 
    for new_path, new_entry in added.itervalues():
297
 
        if specific_file_ids:
298
 
            if not new_entry.file_id in specific_file_ids:
299
 
                continue
300
 
        delta.added.append((new_path, new_entry.file_id, new_entry.kind))
 
242
                delta.removed.append((path[0], file_id, kind[0]))
 
243
        elif fully_present[0] is False:
 
244
            continue
 
245
        elif name[0] != name[1] or parent_id[0] != parent_id[1]:
 
246
            # If the name changes, or the parent_id changes, we have a rename
 
247
            # (if we move a parent, that doesn't count as a rename for the
 
248
            # file)
 
249
            delta.renamed.append((path[0],
 
250
                                  path[1],
 
251
                                  file_id,
 
252
                                  kind[1],
 
253
                                  content_change,
 
254
                                  (executable[0] != executable[1])))
 
255
        elif kind[0] != kind[1]:
 
256
            delta.kind_changed.append((path[1], file_id, kind[0], kind[1]))
 
257
        elif content_change or executable[0] != executable[1]:
 
258
            delta.modified.append((path[1], file_id, kind[1],
 
259
                                   content_change,
 
260
                                   (executable[0] != executable[1])))
 
261
        else:
 
262
            delta.unchanged.append((path[1], file_id, kind[1]))
301
263
 
302
264
    delta.removed.sort()
303
265
    delta.added.sort()
308
270
    delta.unchanged.sort()
309
271
 
310
272
    return delta
 
273
 
 
274
 
 
275
class _ChangeReporter(object):
 
276
    """Report changes between two trees"""
 
277
 
 
278
    def __init__(self, output=None, suppress_root_add=True,
 
279
                 output_file=None, unversioned_filter=None, view_info=None):
 
280
        """Constructor
 
281
 
 
282
        :param output: a function with the signature of trace.note, i.e.
 
283
            accepts a format and parameters.
 
284
        :param supress_root_add: If true, adding the root will be ignored
 
285
            (i.e. when a tree has just been initted)
 
286
        :param output_file: If supplied, a file-like object to write to.
 
287
            Only one of output and output_file may be supplied.
 
288
        :param unversioned_filter: A filter function to be called on
 
289
            unversioned files. This should return True to ignore a path.
 
290
            By default, no filtering takes place.
 
291
        :param view_info: A tuple of view_name,view_files if only
 
292
            items inside a view are to be reported on, or None for
 
293
            no view filtering.
 
294
        """
 
295
        if output_file is not None:
 
296
            if output is not None:
 
297
                raise BzrError('Cannot specify both output and output_file')
 
298
            def output(fmt, *args):
 
299
                output_file.write((fmt % args) + '\n')
 
300
        self.output = output
 
301
        if self.output is None:
 
302
            from bzrlib import trace
 
303
            self.output = trace.note
 
304
        self.suppress_root_add = suppress_root_add
 
305
        self.modified_map = {'kind changed': 'K',
 
306
                             'unchanged': ' ',
 
307
                             'created': 'N',
 
308
                             'modified': 'M',
 
309
                             'deleted': 'D'}
 
310
        self.versioned_map = {'added': '+', # versioned target
 
311
                              'unchanged': ' ', # versioned in both
 
312
                              'removed': '-', # versioned in source
 
313
                              'unversioned': '?', # versioned in neither
 
314
                              }
 
315
        self.unversioned_filter = unversioned_filter
 
316
        if view_info is None:
 
317
            self.view_name = None
 
318
            self.view_files = []
 
319
        else:
 
320
            self.view_name = view_info[0]
 
321
            self.view_files = view_info[1]
 
322
            self.output("Operating on whole tree but only reporting on "
 
323
                        "'%s' view." % (self.view_name,))
 
324
 
 
325
    def report(self, file_id, paths, versioned, renamed, modified, exe_change,
 
326
               kind):
 
327
        """Report one change to a file
 
328
 
 
329
        :param file_id: The file_id of the file
 
330
        :param path: The old and new paths as generated by Tree.iter_changes.
 
331
        :param versioned: may be 'added', 'removed', 'unchanged', or
 
332
            'unversioned.
 
333
        :param renamed: may be True or False
 
334
        :param modified: may be 'created', 'deleted', 'kind changed',
 
335
            'modified' or 'unchanged'.
 
336
        :param exe_change: True if the execute bit has changed
 
337
        :param kind: A pair of file kinds, as generated by Tree.iter_changes.
 
338
            None indicates no file present.
 
339
        """
 
340
        if is_quiet():
 
341
            return
 
342
        if paths[1] == '' and versioned == 'added' and self.suppress_root_add:
 
343
            return
 
344
        if self.view_files and not osutils.is_inside_any(self.view_files,
 
345
            paths[1]):
 
346
            return
 
347
        if versioned == 'unversioned':
 
348
            # skip ignored unversioned files if needed.
 
349
            if self.unversioned_filter is not None:
 
350
                if self.unversioned_filter(paths[1]):
 
351
                    return
 
352
            # dont show a content change in the output.
 
353
            modified = 'unchanged'
 
354
        # we show both paths in the following situations:
 
355
        # the file versioning is unchanged AND
 
356
        # ( the path is different OR
 
357
        #   the kind is different)
 
358
        if (versioned == 'unchanged' and
 
359
            (renamed or modified == 'kind changed')):
 
360
            if renamed:
 
361
                # on a rename, we show old and new
 
362
                old_path, path = paths
 
363
            else:
 
364
                # if it's not renamed, we're showing both for kind changes
 
365
                # so only show the new path
 
366
                old_path, path = paths[1], paths[1]
 
367
            # if the file is not missing in the source, we show its kind
 
368
            # when we show two paths.
 
369
            if kind[0] is not None:
 
370
                old_path += osutils.kind_marker(kind[0])
 
371
            old_path += " => "
 
372
        elif versioned == 'removed':
 
373
            # not present in target
 
374
            old_path = ""
 
375
            path = paths[0]
 
376
        else:
 
377
            old_path = ""
 
378
            path = paths[1]
 
379
        if renamed:
 
380
            rename = "R"
 
381
        else:
 
382
            rename = self.versioned_map[versioned]
 
383
        # we show the old kind on the new path when the content is deleted.
 
384
        if modified == 'deleted':
 
385
            path += osutils.kind_marker(kind[0])
 
386
        # otherwise we always show the current kind when there is one
 
387
        elif kind[1] is not None:
 
388
            path += osutils.kind_marker(kind[1])
 
389
        if exe_change:
 
390
            exe = '*'
 
391
        else:
 
392
            exe = ' '
 
393
        self.output("%s%s%s %s%s", rename, self.modified_map[modified], exe,
 
394
                    old_path, path)
 
395
 
 
396
 
 
397
def report_changes(change_iterator, reporter):
 
398
    """Report the changes from a change iterator.
 
399
 
 
400
    This is essentially a translation from low-level to medium-level changes.
 
401
    Further processing may be required to produce a human-readable output.
 
402
    Unfortunately, some tree-changing operations are very complex
 
403
    :change_iterator: an iterator or sequence of changes in the format
 
404
        generated by Tree.iter_changes
 
405
    :param reporter: The _ChangeReporter that will report the changes.
 
406
    """
 
407
    versioned_change_map = {
 
408
        (True, True)  : 'unchanged',
 
409
        (True, False) : 'removed',
 
410
        (False, True) : 'added',
 
411
        (False, False): 'unversioned',
 
412
        }
 
413
    for (file_id, path, content_change, versioned, parent_id, name, kind,
 
414
         executable) in change_iterator:
 
415
        exe_change = False
 
416
        # files are "renamed" if they are moved or if name changes, as long
 
417
        # as it had a value
 
418
        if None not in name and None not in parent_id and\
 
419
            (name[0] != name[1] or parent_id[0] != parent_id[1]):
 
420
            renamed = True
 
421
        else:
 
422
            renamed = False
 
423
        if kind[0] != kind[1]:
 
424
            if kind[0] is None:
 
425
                modified = "created"
 
426
            elif kind[1] is None:
 
427
                modified = "deleted"
 
428
            else:
 
429
                modified = "kind changed"
 
430
        else:
 
431
            if content_change:
 
432
                modified = "modified"
 
433
            else:
 
434
                modified = "unchanged"
 
435
            if kind[1] == "file":
 
436
                exe_change = (executable[0] != executable[1])
 
437
        versioned_change = versioned_change_map[versioned]
 
438
        reporter.report(file_id, path, versioned_change, renamed, modified,
 
439
                        exe_change, kind)