~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/status.py

  • Committer: Ian Clatworthy
  • Date: 2009-09-09 15:30:59 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-20090909153059-sb038agvd38ci2q8
more link fixes in the User Guide

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
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
 
from __future__ import absolute_import
18
 
 
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
    )
29
27
import bzrlib.errors as errors
 
28
from bzrlib.osutils import is_inside_any
 
29
from bzrlib.symbol_versioning import (deprecated_function,
 
30
        )
30
31
from bzrlib.trace import mutter, warning
31
32
 
32
33
# TODO: when showing single-line logs, truncate to the width of the terminal
33
34
# if known, but only if really going to the terminal (not into a file)
34
35
 
35
36
 
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
37
def show_tree_status(wt, show_unchanged=None,
87
38
                     specific_files=None,
88
39
                     show_ids=False,
91
42
                     revision=None,
92
43
                     short=False,
93
44
                     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
48
    By default this compares the working tree to a previous revision.
122
71
    :param verbose: If True, show all merged revisions, not just
123
72
        the merge tips
124
73
    :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
74
    """
129
75
    if show_unchanged is not None:
130
76
        warn("show_tree_status with show_unchanged has been deprecated "
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
106
            specific_files, nonexistents \
165
107
                = _filter_nonexistent(specific_files, old, new)
166
108
            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
 
 
 
109
            if short:
 
110
                changes = new.iter_changes(old, show_unchanged, specific_files,
 
111
                    require_versioned=False, want_unversioned=want_unversioned)
 
112
                reporter = _mod_delta._ChangeReporter(output_file=to_file,
 
113
                    unversioned_filter=new.is_ignored)
 
114
                _mod_delta.report_changes(changes, reporter)
 
115
            else:
 
116
                delta = new.changes_from(old, want_unchanged=show_unchanged,
 
117
                                      specific_files=specific_files,
 
118
                                      want_unversioned=want_unversioned)
 
119
                # filter out unknown files. We may want a tree method for
 
120
                # this
 
121
                delta.unversioned = [unversioned for unversioned in
 
122
                    delta.unversioned if not new.is_ignored(unversioned[0])]
 
123
                delta.show(to_file,
 
124
                           show_ids=show_ids,
 
125
                           show_unchanged=show_unchanged,
 
126
                           short_status=False)
191
127
            # show the new conflicts only for now. XXX: get them from the
192
128
            # delta.
193
129
            conflicts = new.conflicts()
201
137
                    prefix = 'C  '
202
138
                else:
203
139
                    prefix = ' '
204
 
                to_file.write("%s %s\n" % (prefix, unicode(conflict)))
 
140
                to_file.write("%s %s\n" % (prefix, conflict))
205
141
            # Show files that were requested but don't exist (and are
206
142
            # not versioned).  We don't involve delta in this; these
207
143
            # paths are really the province of just the status
222
158
                show_pending_merges(new, to_file, short, verbose=verbose)
223
159
            if nonexistents:
224
160
                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))
228
161
        finally:
229
162
            old.unlock()
230
163
            new.unlock()
264
197
    if len(parents) < 2:
265
198
        return
266
199
 
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
 
200
    # we need one extra space for terminals that wrap on last char
 
201
    term_width = osutils.terminal_width() - 1
271
202
    if short:
272
203
        first_prefix = 'P   '
273
204
        sub_prefix = 'P.   '
275
206
        first_prefix = '  '
276
207
        sub_prefix = '    '
277
208
 
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
209
    pending = parents[1:]
287
210
    branch = new.branch
288
211
    last_revision = parents[0]
290
213
        if verbose:
291
214
            to_file.write('pending merges:\n')
292
215
        else:
293
 
            to_file.write('pending merge tips:'
294
 
                          ' (use -v to see all merge revisions)\n')
 
216
            to_file.write('pending merge tips: (use -v to see all merge revisions)\n')
295
217
    graph = branch.repository.get_graph()
296
218
    other_revisions = [last_revision]
297
219
    log_formatter = log.LineLogFormatter(to_file)
305
227
            continue
306
228
 
307
229
        # Log the merge, as it gets a slightly different formatting
308
 
        show_log_message(rev, first_prefix)
 
230
        log_message = log_formatter.log_string(None, rev,
 
231
                        term_width - len(first_prefix))
 
232
        to_file.write(first_prefix + log_message + '\n')
309
233
        if not verbose:
310
234
            continue
311
235
 
343
267
            if rev is None:
344
268
                to_file.write(sub_prefix + '(ghost) ' + sub_merge + '\n')
345
269
                continue
346
 
            show_log_message(revisions[sub_merge], sub_prefix)
 
270
            log_message = log_formatter.log_string(None,
 
271
                            revisions[sub_merge],
 
272
                            term_width - len(sub_prefix))
 
273
            to_file.write(sub_prefix + log_message + '\n')
347
274
 
348
275
 
349
276
def _filter_nonexistent(orig_paths, old_tree, new_tree):
371
298
    # their groups individually.  But for consistency of this
372
299
    # function's API, it's better to sort both than just 'nonexistent'.
373
300
    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