~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/status.py

  • Committer: John Arbash Meinel
  • Author(s): Mark Hammond
  • Date: 2008-09-09 17:02:21 UTC
  • mto: This revision was merged to the branch mainline in revision 3697.
  • Revision ID: john@arbash-meinel.com-20080909170221-svim3jw2mrz0amp3
An updated transparent icon for bzr.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2005, 2006, 2007 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
 
 
17
 
from __future__ import absolute_import
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18
16
 
19
17
import sys
20
18
 
21
19
from bzrlib import (
22
20
    delta as _mod_delta,
23
 
    hooks as _mod_hooks,
24
21
    log,
25
22
    osutils,
 
23
    tree,
26
24
    tsort,
27
25
    revision as _mod_revision,
28
26
    )
 
27
from bzrlib.diff import _raise_if_nonexistent
29
28
import bzrlib.errors as errors
30
 
from bzrlib.trace import mutter, warning
 
29
from bzrlib.osutils import is_inside_any
 
30
from bzrlib.symbol_versioning import (deprecated_function,
 
31
        )
 
32
from bzrlib.trace import warning
31
33
 
32
34
# TODO: when showing single-line logs, truncate to the width of the terminal
33
35
# if known, but only if really going to the terminal (not into a file)
34
36
 
35
37
 
36
 
def report_changes(to_file, old, new, specific_files, 
37
 
                   show_short_reporter, show_long_callback, 
38
 
                   short=False, want_unchanged=False, 
39
 
                   want_unversioned=False, show_ids=False, classify=True):
40
 
    """Display summary of changes.
41
 
 
42
 
    This compares two trees with regards to a list of files, and delegates 
43
 
    the display to underlying elements.
44
 
 
45
 
    For short output, it creates an iterator on all changes, and lets a given
46
 
    reporter display these changes.
47
 
 
48
 
    For stantard output, it creates a delta of the changes, and forwards it
49
 
    to a callback
50
 
 
51
 
    :param to_file: If set, write to this file (default stdout.)
52
 
    :param old: Start tree for the comparison
53
 
    :param end: End tree for the comparison
54
 
    :param specific_files: If set, a list of filenames whose status should be
55
 
        shown.  It is an error to give a filename that is not in the working
56
 
        tree, or in the working inventory or in the basis inventory.
57
 
    :param show_short_reporter: Reporter in charge of display for short output
58
 
    :param show_long_callback: Callback in charge of display for normal output
59
 
    :param short: If True, gives short SVN-style status lines.
60
 
    :param want_unchanged: Deprecated parameter. If set, includes unchanged
61
 
        files.
62
 
    :param show_ids: If set, includes each file's id.
63
 
    :param want_unversioned: If False, only shows versioned files.
64
 
    :param classify: Add special symbols to indicate file kind.
65
 
    """
66
 
 
67
 
    if short:
68
 
        changes = new.iter_changes(old, want_unchanged, specific_files,
69
 
            require_versioned=False, want_unversioned=want_unversioned)
70
 
        _mod_delta.report_changes(changes, show_short_reporter)
71
 
        
72
 
    else:
73
 
        delta = new.changes_from(old, want_unchanged=want_unchanged,
74
 
                              specific_files=specific_files,
75
 
                              want_unversioned=want_unversioned)
76
 
        # filter out unknown files. We may want a tree method for
77
 
        # this
78
 
        delta.unversioned = [unversioned for unversioned in
79
 
            delta.unversioned if not new.is_ignored(unversioned[0])]
80
 
        show_long_callback(to_file, delta, 
81
 
                           show_ids=show_ids,
82
 
                           show_unchanged=want_unchanged,
83
 
                           classify=classify)
84
 
 
85
 
 
86
38
def show_tree_status(wt, show_unchanged=None,
87
39
                     specific_files=None,
88
40
                     show_ids=False,
90
42
                     show_pending=True,
91
43
                     revision=None,
92
44
                     short=False,
93
 
                     verbose=False,
94
 
                     versioned=False,
95
 
                     classify=True,
96
 
                     show_long_callback=_mod_delta.report_delta):
 
45
                     versioned=False):
97
46
    """Display summary of changes.
98
47
 
99
 
    By default this compares the working tree to a previous revision.
100
 
    If the revision argument is given, summarizes changes between the
 
48
    By default this compares the working tree to a previous revision. 
 
49
    If the revision argument is given, summarizes changes between the 
101
50
    working tree and another, or between two revisions.
102
51
 
103
 
    The result is written out as Unicode and to_file should be able
 
52
    The result is written out as Unicode and to_file should be able 
104
53
    to encode that.
105
54
 
106
55
    If showing the status of a working tree, extra information is included
107
56
    about unknown files, conflicts, and pending merges.
108
57
 
109
 
    :param show_unchanged: Deprecated parameter. If set, includes unchanged
 
58
    :param show_unchanged: Deprecated parameter. If set, includes unchanged 
110
59
        files.
111
60
    :param specific_files: If set, a list of filenames whose status should be
112
 
        shown.  It is an error to give a filename that is not in the working
 
61
        shown.  It is an error to give a filename that is not in the working 
113
62
        tree, or in the working inventory or in the basis inventory.
114
63
    :param show_ids: If set, includes each file's id.
115
64
    :param to_file: If set, write to this file (default stdout.)
119
68
        If one revision, compare with working tree.
120
69
        If two revisions, show status between first and second.
121
70
    :param short: If True, gives short SVN-style status lines.
122
 
    :param verbose: If True, show all merged revisions, not just
123
 
        the merge tips
124
71
    :param versioned: If True, only shows versioned files.
125
 
    :param classify: Add special symbols to indicate file kind.
126
 
    :param show_long_callback: A callback: message = show_long_callback(to_file, delta, 
127
 
        show_ids, show_unchanged, indent, filter), only used with the long output
128
72
    """
129
73
    if show_unchanged is not None:
130
74
        warn("show_tree_status with show_unchanged has been deprecated "
132
76
 
133
77
    if to_file is None:
134
78
        to_file = sys.stdout
135
 
 
 
79
    
136
80
    wt.lock_read()
137
81
    try:
138
82
        new_is_working_tree = True
143
87
            old = new.basis_tree()
144
88
        elif len(revision) > 0:
145
89
            try:
146
 
                old = revision[0].as_tree(wt.branch)
 
90
                rev_id = revision[0].as_revision_id(wt.branch)
 
91
                old = wt.branch.repository.revision_tree(rev_id)
147
92
            except errors.NoSuchRevision, e:
148
93
                raise errors.BzrCommandError(str(e))
149
94
            if (len(revision) > 1) and (revision[1].spec is not None):
150
95
                try:
151
 
                    new = revision[1].as_tree(wt.branch)
 
96
                    rev_id = revision[1].as_revision_id(wt.branch)
 
97
                    new = wt.branch.repository.revision_tree(rev_id)
152
98
                    new_is_working_tree = False
153
99
                except errors.NoSuchRevision, e:
154
100
                    raise errors.BzrCommandError(str(e))
157
103
        old.lock_read()
158
104
        new.lock_read()
159
105
        try:
160
 
            for hook in hooks['pre_status']:
161
 
                hook(StatusHookParams(old, new, to_file, versioned,
162
 
                    show_ids, short, verbose, specific_files=specific_files))
163
 
 
164
 
            specific_files, nonexistents \
165
 
                = _filter_nonexistent(specific_files, old, new)
 
106
            _raise_if_nonexistent(specific_files, old, new)
166
107
            want_unversioned = not versioned
167
 
 
168
 
            # Reporter used for short outputs
169
 
            reporter = _mod_delta._ChangeReporter(output_file=to_file,
170
 
                unversioned_filter=new.is_ignored, classify=classify)
171
 
            report_changes(to_file, old, new, specific_files, 
172
 
                           reporter, show_long_callback, 
173
 
                           short=short, want_unchanged=show_unchanged, 
174
 
                           want_unversioned=want_unversioned, show_ids=show_ids,
175
 
                           classify=classify)
176
 
 
177
 
            # show the ignored files among specific files (i.e. show the files
178
 
            # identified from input that we choose to ignore). 
179
 
            if specific_files is not None:
180
 
                # Ignored files is sorted because specific_files is already sorted
181
 
                ignored_files = [specific for specific in
182
 
                    specific_files if new.is_ignored(specific)]
183
 
                if len(ignored_files) > 0 and not short:
184
 
                    to_file.write("ignored:\n")
185
 
                    prefix = ' '
186
 
                else:
187
 
                    prefix = 'I  '
188
 
                for ignored_file in ignored_files:
189
 
                    to_file.write("%s %s\n" % (prefix, ignored_file))
190
 
 
 
108
            if short:
 
109
                changes = new.iter_changes(old, show_unchanged, specific_files,
 
110
                    require_versioned=False, want_unversioned=want_unversioned)
 
111
                reporter = _mod_delta._ChangeReporter(output_file=to_file,
 
112
                    unversioned_filter=new.is_ignored)
 
113
                _mod_delta.report_changes(changes, reporter)
 
114
            else:
 
115
                delta = new.changes_from(old, want_unchanged=show_unchanged,
 
116
                                      specific_files=specific_files,
 
117
                                      want_unversioned=want_unversioned)
 
118
                # filter out unknown files. We may want a tree method for
 
119
                # this
 
120
                delta.unversioned = [unversioned for unversioned in
 
121
                    delta.unversioned if not new.is_ignored(unversioned[0])]
 
122
                delta.show(to_file,
 
123
                           show_ids=show_ids,
 
124
                           show_unchanged=show_unchanged,
 
125
                           short_status=False)
191
126
            # show the new conflicts only for now. XXX: get them from the
192
127
            # delta.
193
128
            conflicts = new.conflicts()
201
136
                    prefix = 'C  '
202
137
                else:
203
138
                    prefix = ' '
204
 
                to_file.write("%s %s\n" % (prefix, unicode(conflict)))
205
 
            # Show files that were requested but don't exist (and are
206
 
            # not versioned).  We don't involve delta in this; these
207
 
            # paths are really the province of just the status
208
 
            # command, since they have more to do with how it was
209
 
            # invoked than with the tree it's operating on.
210
 
            if nonexistents and not short:
211
 
                to_file.write("nonexistent:\n")
212
 
            for nonexistent in nonexistents:
213
 
                # We could calculate prefix outside the loop but, given
214
 
                # how rarely this ought to happen, it's OK and arguably
215
 
                # slightly faster to do it here (ala conflicts above)
216
 
                if short:
217
 
                    prefix = 'X  '
218
 
                else:
219
 
                    prefix = ' '
220
 
                to_file.write("%s %s\n" % (prefix, nonexistent))
 
139
                to_file.write("%s %s\n" % (prefix, conflict))
221
140
            if (new_is_working_tree and show_pending):
222
 
                show_pending_merges(new, to_file, short, verbose=verbose)
223
 
            if nonexistents:
224
 
                raise errors.PathsDoNotExist(nonexistents)
225
 
            for hook in hooks['post_status']:
226
 
                hook(StatusHookParams(old, new, to_file, versioned,
227
 
                    show_ids, short, verbose, specific_files=specific_files))
 
141
                show_pending_merges(new, to_file, short)
228
142
        finally:
229
143
            old.unlock()
230
144
            new.unlock()
258
172
    return sorter.iter_topo_order()
259
173
 
260
174
 
261
 
def show_pending_merges(new, to_file, short=False, verbose=False):
 
175
def show_pending_merges(new, to_file, short=False):
262
176
    """Write out a display of pending merges in a working tree."""
263
177
    parents = new.get_parent_ids()
264
178
    if len(parents) < 2:
265
179
        return
266
180
 
267
 
    term_width = osutils.terminal_width()
268
 
    if term_width is not None:
269
 
        # we need one extra space for terminals that wrap on last char
270
 
        term_width = term_width - 1
 
181
    # we need one extra space for terminals that wrap on last char
 
182
    term_width = osutils.terminal_width() - 1
271
183
    if short:
272
184
        first_prefix = 'P   '
273
185
        sub_prefix = 'P.   '
275
187
        first_prefix = '  '
276
188
        sub_prefix = '    '
277
189
 
278
 
    def show_log_message(rev, prefix):
279
 
        if term_width is None:
280
 
            width = term_width
281
 
        else:
282
 
            width = term_width - len(prefix)
283
 
        log_message = log_formatter.log_string(None, rev, width, prefix=prefix)
284
 
        to_file.write(log_message + '\n')
285
 
 
286
190
    pending = parents[1:]
287
191
    branch = new.branch
288
192
    last_revision = parents[0]
289
193
    if not short:
290
 
        if verbose:
291
 
            to_file.write('pending merges:\n')
292
 
        else:
293
 
            to_file.write('pending merge tips:'
294
 
                          ' (use -v to see all merge revisions)\n')
 
194
        to_file.write('pending merges:\n')
295
195
    graph = branch.repository.get_graph()
296
196
    other_revisions = [last_revision]
297
197
    log_formatter = log.LineLogFormatter(to_file)
305
205
            continue
306
206
 
307
207
        # Log the merge, as it gets a slightly different formatting
308
 
        show_log_message(rev, first_prefix)
309
 
        if not verbose:
310
 
            continue
311
 
 
 
208
        log_message = log_formatter.log_string(None, rev,
 
209
                        term_width - len(first_prefix))
 
210
        to_file.write(first_prefix + log_message + '\n')
312
211
        # Find all of the revisions in the merge source, which are not in the
313
212
        # last committed revision.
314
213
        merge_extra = graph.find_unique_ancestors(merge, other_revisions)
343
242
            if rev is None:
344
243
                to_file.write(sub_prefix + '(ghost) ' + sub_merge + '\n')
345
244
                continue
346
 
            show_log_message(revisions[sub_merge], sub_prefix)
347
 
 
348
 
 
349
 
def _filter_nonexistent(orig_paths, old_tree, new_tree):
350
 
    """Convert orig_paths to two sorted lists and return them.
351
 
 
352
 
    The first is orig_paths paths minus the items in the second list,
353
 
    and the second list is paths that are not in either inventory or
354
 
    tree (they don't qualify if they exist in the tree's inventory, or
355
 
    if they exist in the tree but are not versioned.)
356
 
 
357
 
    If either of the two lists is empty, return it as an empty list.
358
 
 
359
 
    This can be used by operations such as bzr status that can accept
360
 
    unknown or ignored files.
361
 
    """
362
 
    mutter("check paths: %r", orig_paths)
363
 
    if not orig_paths:
364
 
        return orig_paths, []
365
 
    s = old_tree.filter_unversioned_files(orig_paths)
366
 
    s = new_tree.filter_unversioned_files(s)
367
 
    nonexistent = [path for path in s if not new_tree.has_filename(path)]
368
 
    remaining   = [path for path in orig_paths if not path in nonexistent]
369
 
    # Sorting the 'remaining' list doesn't have much effect in
370
 
    # practice, since the various status output sections will sort
371
 
    # their groups individually.  But for consistency of this
372
 
    # function's API, it's better to sort both than just 'nonexistent'.
373
 
    return sorted(remaining), sorted(nonexistent)
374
 
 
375
 
 
376
 
class StatusHooks(_mod_hooks.Hooks):
377
 
    """A dictionary mapping hook name to a list of callables for status hooks.
378
 
 
379
 
    e.g. ['post_status'] Is the list of items to be called when the
380
 
    status command has finished printing the status.
381
 
    """
382
 
 
383
 
    def __init__(self):
384
 
        """Create the default hooks.
385
 
 
386
 
        These are all empty initially, because by default nothing should get
387
 
        notified.
388
 
        """
389
 
        _mod_hooks.Hooks.__init__(self, "bzrlib.status", "hooks")
390
 
        self.add_hook('post_status',
391
 
            "Called with argument StatusHookParams after Bazaar has "
392
 
            "displayed the status. StatusHookParams has the attributes "
393
 
            "(old_tree, new_tree, to_file, versioned, show_ids, short, "
394
 
            "verbose). The last four arguments correspond to the command "
395
 
            "line options specified by the user for the status command. "
396
 
            "to_file is the output stream for writing.",
397
 
            (2, 3))
398
 
        self.add_hook('pre_status',
399
 
            "Called with argument StatusHookParams before Bazaar "
400
 
            "displays the status. StatusHookParams has the attributes "
401
 
            "(old_tree, new_tree, to_file, versioned, show_ids, short, "
402
 
            "verbose). The last four arguments correspond to the command "
403
 
            "line options specified by the user for the status command. "
404
 
            "to_file is the output stream for writing.",
405
 
            (2, 3))
406
 
 
407
 
 
408
 
class StatusHookParams(object):
409
 
    """Object holding parameters passed to post_status hooks.
410
 
 
411
 
    :ivar old_tree: Start tree (basis tree) for comparison.
412
 
    :ivar new_tree: Working tree.
413
 
    :ivar to_file: If set, write to this file.
414
 
    :ivar versioned: Show only versioned files.
415
 
    :ivar show_ids: Show internal object ids.
416
 
    :ivar short: Use short status indicators.
417
 
    :ivar verbose: Verbose flag.
418
 
    """
419
 
 
420
 
    def __init__(self, old_tree, new_tree, to_file, versioned, show_ids,
421
 
            short, verbose, specific_files=None):
422
 
        """Create a group of post_status hook parameters.
423
 
 
424
 
        :param old_tree: Start tree (basis tree) for comparison.
425
 
        :param new_tree: Working tree.
426
 
        :param to_file: If set, write to this file.
427
 
        :param versioned: Show only versioned files.
428
 
        :param show_ids: Show internal object ids.
429
 
        :param short: Use short status indicators.
430
 
        :param verbose: Verbose flag.
431
 
        :param specific_files: If set, a list of filenames whose status should be
432
 
            shown.  It is an error to give a filename that is not in the working
433
 
            tree, or in the working inventory or in the basis inventory.
434
 
        """
435
 
        self.old_tree = old_tree
436
 
        self.new_tree = new_tree
437
 
        self.to_file = to_file
438
 
        self.versioned = versioned
439
 
        self.show_ids = show_ids
440
 
        self.short = short
441
 
        self.verbose = verbose
442
 
        self.specific_files = specific_files
443
 
 
444
 
    def __eq__(self, other):
445
 
        return self.__dict__ == other.__dict__
446
 
 
447
 
    def __repr__(self):
448
 
        return "<%s(%s, %s, %s, %s, %s, %s, %s, %s)>" % (self.__class__.__name__,
449
 
            self.old_tree, self.new_tree, self.to_file, self.versioned,
450
 
            self.show_ids, self.short, self.verbose, self.specific_files)
451
 
 
452
 
 
453
 
def _show_shelve_summary(params):
454
 
    """post_status hook to display a summary of shelves.
455
 
 
456
 
    :param params: StatusHookParams.
457
 
    """
458
 
    # Don't show shelves if status of specific files is being shown, only if
459
 
    # no file arguments have been passed
460
 
    if params.specific_files:
461
 
        return
462
 
    get_shelf_manager = getattr(params.new_tree, 'get_shelf_manager', None)
463
 
    if get_shelf_manager is None:
464
 
        return
465
 
    manager = get_shelf_manager()
466
 
    shelves = manager.active_shelves()
467
 
    if shelves:
468
 
        singular = '%d shelf exists. '
469
 
        plural = '%d shelves exist. '
470
 
        if len(shelves) == 1:
471
 
            fmt = singular
472
 
        else:
473
 
            fmt = plural
474
 
        params.to_file.write(fmt % len(shelves))
475
 
        params.to_file.write('See "bzr shelve --list" for details.\n')
476
 
 
477
 
 
478
 
hooks = StatusHooks()
479
 
 
480
 
 
481
 
hooks.install_named_hook('post_status', _show_shelve_summary,
482
 
    'bzr status')
483
 
 
 
245
            log_message = log_formatter.log_string(None,
 
246
                            revisions[sub_merge],
 
247
                            term_width - len(sub_prefix))
 
248
            to_file.write(sub_prefix + log_message + '\n')