~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/ui/text.py

  • Committer: John Arbash Meinel
  • Date: 2010-02-17 17:11:16 UTC
  • mfrom: (4797.2.17 2.1)
  • mto: (4797.2.18 2.1)
  • mto: This revision was merged to the branch mainline in revision 5055.
  • Revision ID: john@arbash-meinel.com-20100217171116-h7t9223ystbnx5h8
merge bzr.2.1 in preparation for NEWS entry.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2008, 2009 Canonical Ltd
 
1
# Copyright (C) 2005-2010 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
18
18
"""Text UI, write output to the console.
19
19
"""
20
20
 
 
21
import codecs
21
22
import getpass
22
23
import os
23
24
import sys
31
32
    progress,
32
33
    osutils,
33
34
    symbol_versioning,
 
35
    trace,
34
36
    )
35
37
 
36
38
""")
37
39
 
 
40
from bzrlib.osutils import watch_sigwinch
 
41
 
38
42
from bzrlib.ui import (
39
43
    UIFactory,
40
44
    NullProgressView,
58
62
        self.stderr = stderr
59
63
        # paints progress, network activity, etc
60
64
        self._progress_view = self.make_progress_view()
61
 
        
 
65
        # hook up the signals to watch for terminal size changes
 
66
        watch_sigwinch()
 
67
 
 
68
    def be_quiet(self, state):
 
69
        if state and not self._quiet:
 
70
            self.clear_term()
 
71
        UIFactory.be_quiet(self, state)
 
72
        self._progress_view = self.make_progress_view()
 
73
 
62
74
    def clear_term(self):
63
75
        """Prepare the terminal for output.
64
76
 
82
94
                # end-of-file; possibly should raise an error here instead
83
95
                return None
84
96
 
 
97
    def get_integer(self, prompt):
 
98
        while True:
 
99
            self.prompt(prompt)
 
100
            line = self.stdin.readline()
 
101
            try:
 
102
                return int(line)
 
103
            except ValueError:
 
104
                pass
 
105
 
85
106
    def get_non_echoed_password(self):
86
107
        isatty = getattr(self.stdin, 'isatty', None)
87
108
        if isatty is not None and isatty():
135
156
    def make_progress_view(self):
136
157
        """Construct and return a new ProgressView subclass for this UI.
137
158
        """
138
 
        # if the user specifically requests either text or no progress bars,
139
 
        # always do that.  otherwise, guess based on $TERM and tty presence.
140
 
        if os.environ.get('BZR_PROGRESS_BAR') == 'text':
 
159
        # with --quiet, never any progress view
 
160
        # <https://bugs.edge.launchpad.net/bzr/+bug/320035>.  Otherwise if the
 
161
        # user specifically requests either text or no progress bars, always
 
162
        # do that.  otherwise, guess based on $TERM and tty presence.
 
163
        if self.is_quiet():
 
164
            return NullProgressView()
 
165
        elif os.environ.get('BZR_PROGRESS_BAR') == 'text':
141
166
            return TextProgressView(self.stderr)
142
167
        elif os.environ.get('BZR_PROGRESS_BAR') == 'none':
143
168
            return NullProgressView()
146
171
        else:
147
172
            return NullProgressView()
148
173
 
 
174
    def _make_output_stream_explicit(self, encoding, encoding_type):
 
175
        if encoding_type == 'exact':
 
176
            # force sys.stdout to be binary stream on win32; 
 
177
            # NB: this leaves the file set in that mode; may cause problems if
 
178
            # one process tries to do binary and then text output
 
179
            if sys.platform == 'win32':
 
180
                fileno = getattr(self.stdout, 'fileno', None)
 
181
                if fileno:
 
182
                    import msvcrt
 
183
                    msvcrt.setmode(fileno(), os.O_BINARY)
 
184
            return TextUIOutputStream(self, self.stdout)
 
185
        else:
 
186
            encoded_stdout = codecs.getwriter(encoding)(self.stdout,
 
187
                errors=encoding_type)
 
188
            # For whatever reason codecs.getwriter() does not advertise its encoding
 
189
            # it just returns the encoding of the wrapped file, which is completely
 
190
            # bogus. So set the attribute, so we can find the correct encoding later.
 
191
            encoded_stdout.encoding = encoding
 
192
            return TextUIOutputStream(self, encoded_stdout)
 
193
 
149
194
    def note(self, msg):
150
195
        """Write an already-formatted message, clearing the progress bar if necessary."""
151
196
        self.clear_term()
173
218
        self._progress_view.show_transport_activity(transport,
174
219
            direction, byte_count)
175
220
 
 
221
    def log_transport_activity(self, display=False):
 
222
        """See UIFactory.log_transport_activity()"""
 
223
        log = getattr(self._progress_view, 'log_transport_activity', None)
 
224
        if log is not None:
 
225
            log(display=display)
 
226
 
176
227
    def show_error(self, msg):
177
228
        self.clear_term()
178
229
        self.stderr.write("bzr: error: %s\n" % msg)
218
269
        self._term_file = term_file
219
270
        # true when there's output on the screen we may need to clear
220
271
        self._have_output = False
221
 
        # XXX: We could listen for SIGWINCH and update the terminal width...
222
 
        # https://launchpad.net/bugs/316357
223
 
        self._width = osutils.terminal_width()
224
272
        self._last_transport_msg = ''
225
273
        self._spin_pos = 0
226
274
        # time we last repainted the screen
230
278
        self._last_task = None
231
279
        self._total_byte_count = 0
232
280
        self._bytes_since_update = 0
 
281
        self._bytes_by_direction = {'unknown': 0, 'read': 0, 'write': 0}
 
282
        self._first_byte_time = None
233
283
        self._fraction = 0
 
284
        # force the progress bar to be off, as at the moment it doesn't 
 
285
        # correspond reliably to overall command progress
 
286
        self.enable_bar = False
234
287
 
235
288
    def _show_line(self, s):
236
289
        # sys.stderr.write("progress %r\n" % s)
237
 
        n = self._width - 1
238
 
        self._term_file.write('\r%-*.*s\r' % (n, n, s))
 
290
        width = osutils.terminal_width()
 
291
        if width is not None:
 
292
            # we need one extra space for terminals that wrap on last char
 
293
            width = width - 1
 
294
            s = '%-*.*s' % (width, width, s)
 
295
        self._term_file.write('\r' + s + '\r')
239
296
 
240
297
    def clear(self):
241
298
        if self._have_output:
244
301
 
245
302
    def _render_bar(self):
246
303
        # return a string for the progress bar itself
247
 
        if (self._last_task is None) or self._last_task.show_bar:
 
304
        if self.enable_bar and (
 
305
            (self._last_task is None) or self._last_task.show_bar):
248
306
            # If there's no task object, we show space for the bar anyhow.
249
307
            # That's because most invocations of bzr will end showing progress
250
308
            # at some point, though perhaps only after doing some initial IO.
266
324
            markers = int(round(float(cols) * completion_fraction)) - 1
267
325
            bar_str = '[' + ('#' * markers + spin_str).ljust(cols) + '] '
268
326
            return bar_str
269
 
        elif self._last_task.show_spinner:
 
327
        elif (self._last_task is None) or self._last_task.show_spinner:
270
328
            # The last task wanted just a spinner, no bar
271
329
            spin_str =  r'/-\|'[self._spin_pos % 4]
272
330
            self._spin_pos += 1
334
392
        This may update a progress bar, spinner, or similar display.
335
393
        By default it does nothing.
336
394
        """
337
 
        # XXX: Probably there should be a transport activity model, and that
338
 
        # too should be seen by the progress view, rather than being poked in
339
 
        # here.
340
 
        if not self._have_output:
341
 
            # As a workaround for <https://launchpad.net/bugs/321935> we only
342
 
            # show transport activity when there's already a progress bar
343
 
            # shown, which time the application code is expected to know to
344
 
            # clear off the progress bar when it's going to send some other
345
 
            # output.  Eventually it would be nice to have that automatically
346
 
            # synchronized.
347
 
            return
 
395
        # XXX: there should be a transport activity model, and that too should
 
396
        #      be seen by the progress view, rather than being poked in here.
348
397
        self._total_byte_count += byte_count
349
398
        self._bytes_since_update += byte_count
 
399
        if self._first_byte_time is None:
 
400
            # Note that this isn't great, as technically it should be the time
 
401
            # when the bytes started transferring, not when they completed.
 
402
            # However, we usually start with a small request anyway.
 
403
            self._first_byte_time = time.time()
 
404
        if direction in self._bytes_by_direction:
 
405
            self._bytes_by_direction[direction] += byte_count
 
406
        else:
 
407
            self._bytes_by_direction['unknown'] += byte_count
 
408
        if 'no_activity' in debug.debug_flags:
 
409
            # Can be used as a workaround if
 
410
            # <https://launchpad.net/bugs/321935> reappears and transport
 
411
            # activity is cluttering other output.  However, thanks to
 
412
            # TextUIOutputStream this shouldn't be a problem any more.
 
413
            return
350
414
        now = time.time()
351
415
        if self._total_byte_count < 2000:
352
416
            # a little resistance at first, so it doesn't stay stuck at 0
365
429
            self._bytes_since_update = 0
366
430
            self._last_transport_msg = msg
367
431
            self._repaint()
 
432
 
 
433
    def _format_bytes_by_direction(self):
 
434
        if self._first_byte_time is None:
 
435
            bps = 0.0
 
436
        else:
 
437
            transfer_time = time.time() - self._first_byte_time
 
438
            if transfer_time < 0.001:
 
439
                transfer_time = 0.001
 
440
            bps = self._total_byte_count / transfer_time
 
441
 
 
442
        msg = ('Transferred: %.0fKiB'
 
443
               ' (%.1fK/s r:%.0fK w:%.0fK'
 
444
               % (self._total_byte_count / 1024.,
 
445
                  bps / 1024.,
 
446
                  self._bytes_by_direction['read'] / 1024.,
 
447
                  self._bytes_by_direction['write'] / 1024.,
 
448
                 ))
 
449
        if self._bytes_by_direction['unknown'] > 0:
 
450
            msg += ' u:%.0fK)' % (
 
451
                self._bytes_by_direction['unknown'] / 1024.
 
452
                )
 
453
        else:
 
454
            msg += ')'
 
455
        return msg
 
456
 
 
457
    def log_transport_activity(self, display=False):
 
458
        msg = self._format_bytes_by_direction()
 
459
        trace.mutter(msg)
 
460
        if display and self._total_byte_count > 0:
 
461
            self.clear()
 
462
            self._term_file.write(msg + '\n')
 
463
 
 
464
 
 
465
class TextUIOutputStream(object):
 
466
    """Decorates an output stream so that the terminal is cleared before writing.
 
467
 
 
468
    This is supposed to ensure that the progress bar does not conflict with bulk
 
469
    text output.
 
470
    """
 
471
    # XXX: this does not handle the case of writing part of a line, then doing
 
472
    # progress bar output: the progress bar will probably write over it.
 
473
    # one option is just to buffer that text until we have a full line;
 
474
    # another is to save and restore it
 
475
 
 
476
    # XXX: might need to wrap more methods
 
477
 
 
478
    def __init__(self, ui_factory, wrapped_stream):
 
479
        self.ui_factory = ui_factory
 
480
        self.wrapped_stream = wrapped_stream
 
481
        # this does no transcoding, but it must expose the underlying encoding
 
482
        # because some callers need to know what can be written - see for
 
483
        # example unescape_for_display.
 
484
        self.encoding = getattr(wrapped_stream, 'encoding', None)
 
485
 
 
486
    def flush(self):
 
487
        self.ui_factory.clear_term()
 
488
        self.wrapped_stream.flush()
 
489
 
 
490
    def write(self, to_write):
 
491
        self.ui_factory.clear_term()
 
492
        self.wrapped_stream.write(to_write)
 
493
 
 
494
    def writelines(self, lines):
 
495
        self.ui_factory.clear_term()
 
496
        self.wrapped_stream.writelines(lines)