/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/ui/text.py

  • Committer: John Ferlito
  • Date: 2009-09-02 04:31:45 UTC
  • mto: (4665.7.1 serve-init)
  • mto: This revision was merged to the branch mainline in revision 4913.
  • Revision ID: johnf@inodes.org-20090902043145-gxdsfw03ilcwbyn5
Add a debian init script for bzr --serve

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005-2011 Canonical Ltd
 
1
# Copyright (C) 2005, 2008, 2009 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
 
"""Text UI, write output to the console."""
18
 
 
19
 
import codecs
20
 
import io
 
17
 
 
18
"""Text UI, write output to the console.
 
19
"""
 
20
 
 
21
import getpass
21
22
import os
22
23
import sys
 
24
import time
23
25
import warnings
24
26
 
25
 
from ..lazy_import import lazy_import
 
27
from bzrlib.lazy_import import lazy_import
26
28
lazy_import(globals(), """
27
 
import getpass
28
 
import time
29
 
 
30
 
from breezy import (
 
29
from bzrlib import (
31
30
    debug,
32
31
    progress,
 
32
    osutils,
 
33
    symbol_versioning,
33
34
    )
 
35
 
34
36
""")
35
37
 
36
 
from .. import (
37
 
    config,
38
 
    osutils,
39
 
    trace,
40
 
    )
41
 
from . import (
 
38
from bzrlib.ui import (
 
39
    UIFactory,
42
40
    NullProgressView,
43
 
    UIFactory,
44
41
    )
45
42
 
46
43
 
47
 
class _ChooseUI(object):
48
 
 
49
 
    """ Helper class for choose implementation.
50
 
    """
51
 
 
52
 
    def __init__(self, ui, msg, choices, default):
53
 
        self.ui = ui
54
 
        self._setup_mode()
55
 
        self._build_alternatives(msg, choices, default)
56
 
 
57
 
    def _setup_mode(self):
58
 
        """Setup input mode (line-based, char-based) and echo-back.
59
 
 
60
 
        Line-based input is used if the BRZ_TEXTUI_INPUT environment
61
 
        variable is set to 'line-based', or if there is no controlling
62
 
        terminal.
63
 
        """
64
 
        is_tty = self.ui.raw_stdin.isatty()
65
 
        if (os.environ.get('BRZ_TEXTUI_INPUT') != 'line-based' and
66
 
                self.ui.raw_stdin == _unwrap_stream(sys.stdin) and is_tty):
67
 
            self.line_based = False
68
 
            self.echo_back = True
69
 
        else:
70
 
            self.line_based = True
71
 
            self.echo_back = not is_tty
72
 
 
73
 
    def _build_alternatives(self, msg, choices, default):
74
 
        """Parse choices string.
75
 
 
76
 
        Setup final prompt and the lists of choices and associated
77
 
        shortcuts.
78
 
        """
79
 
        index = 0
80
 
        help_list = []
81
 
        self.alternatives = {}
82
 
        choices = choices.split('\n')
83
 
        if default is not None and default not in range(0, len(choices)):
84
 
            raise ValueError("invalid default index")
85
 
        for c in choices:
86
 
            name = c.replace('&', '').lower()
87
 
            choice = (name, index)
88
 
            if name in self.alternatives:
89
 
                raise ValueError("duplicated choice: %s" % name)
90
 
            self.alternatives[name] = choice
91
 
            shortcut = c.find('&')
92
 
            if -1 != shortcut and (shortcut + 1) < len(c):
93
 
                help = c[:shortcut]
94
 
                help += '[' + c[shortcut + 1] + ']'
95
 
                help += c[(shortcut + 2):]
96
 
                shortcut = c[shortcut + 1]
97
 
            else:
98
 
                c = c.replace('&', '')
99
 
                shortcut = c[0]
100
 
                help = '[%s]%s' % (shortcut, c[1:])
101
 
            shortcut = shortcut.lower()
102
 
            if shortcut in self.alternatives:
103
 
                raise ValueError("duplicated shortcut: %s" % shortcut)
104
 
            self.alternatives[shortcut] = choice
105
 
            # Add redirections for default.
106
 
            if index == default:
107
 
                self.alternatives[''] = choice
108
 
                self.alternatives['\r'] = choice
109
 
            help_list.append(help)
110
 
            index += 1
111
 
 
112
 
        self.prompt = u'%s (%s): ' % (msg, ', '.join(help_list))
113
 
 
114
 
    def _getline(self):
115
 
        line = self.ui.stdin.readline()
116
 
        if '' == line:
117
 
            raise EOFError
118
 
        return line.strip()
119
 
 
120
 
    def _getchar(self):
121
 
        char = osutils.getchar()
122
 
        if char == chr(3):  # INTR
123
 
            raise KeyboardInterrupt
124
 
        if char == chr(4):  # EOF (^d, C-d)
125
 
            raise EOFError
126
 
        if isinstance(char, bytes):
127
 
            return char.decode('ascii', 'replace')
128
 
        return char
129
 
 
130
 
    def interact(self):
131
 
        """Keep asking the user until a valid choice is made.
132
 
        """
133
 
        if self.line_based:
134
 
            getchoice = self._getline
135
 
        else:
136
 
            getchoice = self._getchar
137
 
        iter = 0
138
 
        while True:
139
 
            iter += 1
140
 
            if 1 == iter or self.line_based:
141
 
                self.ui.prompt(self.prompt)
142
 
            try:
143
 
                choice = getchoice()
144
 
            except EOFError:
145
 
                self.ui.stderr.write(u'\n')
146
 
                return None
147
 
            except KeyboardInterrupt:
148
 
                self.ui.stderr.write(u'\n')
149
 
                raise
150
 
            choice = choice.lower()
151
 
            if choice not in self.alternatives:
152
 
                # Not a valid choice, keep on asking.
153
 
                continue
154
 
            name, index = self.alternatives[choice]
155
 
            if self.echo_back:
156
 
                self.ui.stderr.write(name + u'\n')
157
 
            return index
158
 
 
159
 
 
160
 
opt_progress_bar = config.Option(
161
 
    'progress_bar', help='Progress bar type.',
162
 
    default_from_env=['BRZ_PROGRESS_BAR'], default=None,
163
 
    invalid='error')
164
 
 
165
 
 
166
44
class TextUIFactory(UIFactory):
167
 
    """A UI factory for Text user interfaces."""
168
 
 
169
 
    def __init__(self, stdin, stdout, stderr):
170
 
        """Create a TextUIFactory."""
 
45
    """A UI factory for Text user interefaces."""
 
46
 
 
47
    def __init__(self,
 
48
                 stdin=None,
 
49
                 stdout=None,
 
50
                 stderr=None):
 
51
        """Create a TextUIFactory.
 
52
 
 
53
        :param bar_type: The type of progress bar to create.  Deprecated
 
54
            and ignored; a TextProgressView is always used.
 
55
        """
171
56
        super(TextUIFactory, self).__init__()
 
57
        # TODO: there's no good reason not to pass all three streams, maybe we
 
58
        # should deprecate the default values...
172
59
        self.stdin = stdin
173
60
        self.stdout = stdout
174
61
        self.stderr = stderr
175
 
        self._progress_view = NullProgressView()
176
 
 
177
 
    def __enter__(self):
178
 
        # Choose default encoding and handle py2/3 differences
179
 
        self._setup_streams()
180
62
        # paints progress, network activity, etc
181
63
        self._progress_view = self.make_progress_view()
182
 
        return self
183
 
 
184
 
    def _setup_streams(self):
185
 
        self.raw_stdin = _unwrap_stream(self.stdin)
186
 
        self.stdin = _wrap_in_stream(self.raw_stdin)
187
 
        self.raw_stdout = _unwrap_stream(self.stdout)
188
 
        self.stdout = _wrap_out_stream(self.raw_stdout)
189
 
        self.raw_stderr = _unwrap_stream(self.stderr)
190
 
        self.stderr = _wrap_out_stream(self.raw_stderr)
191
 
 
192
 
    def choose(self, msg, choices, default=None):
193
 
        """Prompt the user for a list of alternatives.
194
 
 
195
 
        Support both line-based and char-based editing.
196
 
 
197
 
        In line-based mode, both the shortcut and full choice name are valid
198
 
        answers, e.g. for choose('prompt', '&yes\n&no'): 'y', ' Y ', ' yes',
199
 
        'YES ' are all valid input lines for choosing 'yes'.
200
 
 
201
 
        An empty line, when in line-based mode, or pressing enter in char-based
202
 
        mode will select the default choice (if any).
203
 
 
204
 
        Choice is echoed back if:
205
 
        - input is char-based; which means a controlling terminal is available,
206
 
          and osutils.getchar is used
207
 
        - input is line-based, and no controlling terminal is available
208
 
        """
209
 
 
210
 
        choose_ui = _ChooseUI(self, msg, choices, default)
211
 
        return choose_ui.interact()
212
 
 
213
 
    def be_quiet(self, state):
214
 
        if state and not self._quiet:
215
 
            self.clear_term()
216
 
        UIFactory.be_quiet(self, state)
217
 
        self._progress_view = self.make_progress_view()
218
 
 
 
64
        
219
65
    def clear_term(self):
220
66
        """Prepare the terminal for output.
221
67
 
227
73
        # to clear it.  We might need to separately check for the case of
228
74
        self._progress_view.clear()
229
75
 
230
 
    def get_integer(self, prompt):
 
76
    def get_boolean(self, prompt):
231
77
        while True:
232
 
            self.prompt(prompt)
233
 
            line = self.stdin.readline()
234
 
            try:
235
 
                return int(line)
236
 
            except ValueError:
237
 
                pass
 
78
            self.prompt(prompt + "? [y/n]: ")
 
79
            line = self.stdin.readline().lower()
 
80
            if line in ('y\n', 'yes\n'):
 
81
                return True
 
82
            elif line in ('n\n', 'no\n'):
 
83
                return False
 
84
            elif line in ('', None):
 
85
                # end-of-file; possibly should raise an error here instead
 
86
                return None
238
87
 
239
88
    def get_non_echoed_password(self):
240
89
        isatty = getattr(self.stdin, 'isatty', None)
247
96
            password = self.stdin.readline()
248
97
            if not password:
249
98
                password = None
250
 
            else:
251
 
                if password[-1] == '\n':
252
 
                    password = password[:-1]
 
99
            elif password[-1] == '\n':
 
100
                password = password[:-1]
253
101
        return password
254
102
 
255
 
    def get_password(self, prompt=u'', **kwargs):
 
103
    def get_password(self, prompt='', **kwargs):
256
104
        """Prompt the user for a password.
257
105
 
258
106
        :param prompt: The prompt to present the user
283
131
        username = self.stdin.readline()
284
132
        if not username:
285
133
            username = None
286
 
        else:
287
 
            if username[-1] == '\n':
288
 
                username = username[:-1]
 
134
        elif username[-1] == '\n':
 
135
            username = username[:-1]
289
136
        return username
290
137
 
291
138
    def make_progress_view(self):
292
139
        """Construct and return a new ProgressView subclass for this UI.
293
140
        """
294
 
        # with --quiet, never any progress view
295
 
        # <https://bugs.launchpad.net/bzr/+bug/320035>.  Otherwise if the
296
 
        # user specifically requests either text or no progress bars, always
297
 
        # do that.  otherwise, guess based on $TERM and tty presence.
298
 
        if self.is_quiet():
299
 
            return NullProgressView()
300
 
        pb_type = config.GlobalStack().get('progress_bar')
301
 
        if pb_type == 'none':  # Explicit requirement
302
 
            return NullProgressView()
303
 
        if (pb_type == 'text' or # Explicit requirement
304
 
                progress._supports_progress(self.stderr)):  # Guess
305
 
            return TextProgressView(self.stderr)
306
 
        # No explicit requirement and no successful guess
307
 
        return NullProgressView()
308
 
 
309
 
    def _make_output_stream_explicit(self, encoding, encoding_type):
310
 
        return TextUIOutputStream(self, self.stdout, encoding, encoding_type)
 
141
        # if the user specifically requests either text or no progress bars,
 
142
        # always do that.  otherwise, guess based on $TERM and tty presence.
 
143
        if os.environ.get('BZR_PROGRESS_BAR') == 'text':
 
144
            return TextProgressView(self.stderr)
 
145
        elif os.environ.get('BZR_PROGRESS_BAR') == 'none':
 
146
            return NullProgressView()
 
147
        elif progress._supports_progress(self.stderr):
 
148
            return TextProgressView(self.stderr)
 
149
        else:
 
150
            return NullProgressView()
311
151
 
312
152
    def note(self, msg):
313
153
        """Write an already-formatted message, clearing the progress bar if necessary."""
316
156
 
317
157
    def prompt(self, prompt, **kwargs):
318
158
        """Emit prompt on the CLI.
319
 
 
 
159
        
320
160
        :param kwargs: Dictionary of arguments to insert into the prompt,
321
161
            to allow UIs to reformat the prompt.
322
162
        """
323
 
        if not isinstance(prompt, str):
324
 
            raise ValueError("prompt %r not a unicode string" % prompt)
325
163
        if kwargs:
326
164
            # See <https://launchpad.net/bugs/365891>
327
165
            prompt = prompt % kwargs
 
166
        prompt = prompt.encode(osutils.get_terminal_encoding(), 'replace')
328
167
        self.clear_term()
329
 
        self.stdout.flush()
330
168
        self.stderr.write(prompt)
331
 
        self.stderr.flush()
332
169
 
333
170
    def report_transport_activity(self, transport, byte_count, direction):
334
171
        """Called by transports as they do IO.
337
174
        By default it does nothing.
338
175
        """
339
176
        self._progress_view.show_transport_activity(transport,
340
 
                                                    direction, byte_count)
341
 
 
342
 
    def log_transport_activity(self, display=False):
343
 
        """See UIFactory.log_transport_activity()"""
344
 
        log = getattr(self._progress_view, 'log_transport_activity', None)
345
 
        if log is not None:
346
 
            log(display=display)
347
 
 
348
 
    def show_error(self, msg):
349
 
        self.clear_term()
350
 
        self.stderr.write("bzr: error: %s\n" % msg)
351
 
 
352
 
    def show_message(self, msg):
353
 
        self.note(msg)
354
 
 
355
 
    def show_warning(self, msg):
356
 
        self.clear_term()
357
 
        self.stderr.write("bzr: warning: %s\n" % msg)
 
177
            direction, byte_count)
358
178
 
359
179
    def _progress_updated(self, task):
360
180
        """A task has been updated and wants to be displayed.
361
181
        """
362
182
        if not self._task_stack:
363
183
            warnings.warn("%r updated but no tasks are active" %
364
 
                          (task,))
 
184
                (task,))
365
185
        elif task != self._task_stack[-1]:
366
 
            # We used to check it was the top task, but it's hard to always
367
 
            # get this right and it's not necessarily useful: any actual
368
 
            # problems will be evident in use
369
 
            # warnings.warn("%r is not the top progress task %r" %
370
 
            #     (task, self._task_stack[-1]))
371
 
            pass
 
186
            warnings.warn("%r is not the top progress task %r" %
 
187
                (task, self._task_stack[-1]))
372
188
        self._progress_view.show_progress(task)
373
189
 
374
190
    def _progress_all_finished(self):
375
191
        self._progress_view.clear()
376
192
 
377
 
    def show_user_warning(self, warning_id, **message_args):
378
 
        """Show a text message to the user.
379
 
 
380
 
        Explicitly not for warnings about bzr apis, deprecations or internals.
381
 
        """
382
 
        # eventually trace.warning should migrate here, to avoid logging and
383
 
        # be easier to test; that has a lot of test fallout so for now just
384
 
        # new code can call this
385
 
        if warning_id not in self.suppressed_warnings:
386
 
            warning = self.format_user_warning(warning_id, message_args)
387
 
            self.stderr.write(warning + '\n')
388
 
 
389
 
 
390
 
def pad_to_width(line, width, encoding_hint='ascii'):
391
 
    """Truncate or pad unicode line to width.
392
 
 
393
 
    This is best-effort for now, and strings containing control codes or
394
 
    non-ascii text may be cut and padded incorrectly.
395
 
    """
396
 
    s = line.encode(encoding_hint, 'replace')
397
 
    return (b'%-*.*s' % (width, width, s)).decode(encoding_hint)
398
 
 
399
193
 
400
194
class TextProgressView(object):
401
195
    """Display of progress bar and other information on a tty.
402
196
 
403
 
    This shows one line of text, including possibly a network indicator,
404
 
    spinner, progress bar, message, etc.
 
197
    This shows one line of text, including possibly a network indicator, spinner,
 
198
    progress bar, message, etc.
405
199
 
406
200
    One instance of this is created and held by the UI, and fed updates when a
407
201
    task wants to be painted.
412
206
    this only prints the stack from the nominated current task up to the root.
413
207
    """
414
208
 
415
 
    def __init__(self, term_file, encoding=None, errors=None):
 
209
    def __init__(self, term_file):
416
210
        self._term_file = term_file
417
 
        if encoding is None:
418
 
            self._encoding = getattr(term_file, "encoding", None) or "ascii"
419
 
        else:
420
 
            self._encoding = encoding
421
211
        # true when there's output on the screen we may need to clear
422
212
        self._have_output = False
 
213
        # XXX: We could listen for SIGWINCH and update the terminal width...
 
214
        # https://launchpad.net/bugs/316357
 
215
        self._width = osutils.terminal_width()
423
216
        self._last_transport_msg = ''
424
217
        self._spin_pos = 0
425
218
        # time we last repainted the screen
429
222
        self._last_task = None
430
223
        self._total_byte_count = 0
431
224
        self._bytes_since_update = 0
432
 
        self._bytes_by_direction = {'unknown': 0, 'read': 0, 'write': 0}
433
 
        self._first_byte_time = None
434
225
        self._fraction = 0
435
 
        # force the progress bar to be off, as at the moment it doesn't
436
 
        # correspond reliably to overall command progress
437
 
        self.enable_bar = False
438
 
 
439
 
    def _avail_width(self):
440
 
        # we need one extra space for terminals that wrap on last char
441
 
        w = osutils.terminal_width()
442
 
        if w is None:
443
 
            return None
444
 
        else:
445
 
            return w - 1
446
 
 
447
 
    def _show_line(self, u):
448
 
        width = self._avail_width()
449
 
        if width is not None:
450
 
            u = pad_to_width(u, width, encoding_hint=self._encoding)
451
 
        self._term_file.write('\r' + u + '\r')
 
226
 
 
227
    def _show_line(self, s):
 
228
        # sys.stderr.write("progress %r\n" % s)
 
229
        n = self._width - 1
 
230
        self._term_file.write('\r%-*.*s\r' % (n, n, s))
452
231
 
453
232
    def clear(self):
454
233
        if self._have_output:
457
236
 
458
237
    def _render_bar(self):
459
238
        # return a string for the progress bar itself
460
 
        if self.enable_bar and (
461
 
                (self._last_task is None) or self._last_task.show_bar):
 
239
        if (self._last_task is None) or self._last_task.show_bar:
462
240
            # If there's no task object, we show space for the bar anyhow.
463
241
            # That's because most invocations of bzr will end showing progress
464
242
            # at some point, though perhaps only after doing some initial IO.
465
243
            # It looks better to draw the progress bar initially rather than
466
244
            # to have what looks like an incomplete progress bar.
467
 
            spin_str = r'/-\|'[self._spin_pos % 4]
 
245
            spin_str =  r'/-\|'[self._spin_pos % 4]
468
246
            self._spin_pos += 1
469
247
            cols = 20
470
248
            if self._last_task is None:
474
252
                completion_fraction = \
475
253
                    self._last_task._overall_completion_fraction() or 0
476
254
            if (completion_fraction < self._fraction and 'progress' in
477
 
                    debug.debug_flags):
478
 
                debug.set_trace()
 
255
                debug.debug_flags):
 
256
                import pdb;pdb.set_trace()
479
257
            self._fraction = completion_fraction
480
258
            markers = int(round(float(cols) * completion_fraction)) - 1
481
259
            bar_str = '[' + ('#' * markers + spin_str).ljust(cols) + '] '
482
260
            return bar_str
483
 
        elif (self._last_task is None) or self._last_task.show_spinner:
 
261
        elif self._last_task.show_spinner:
484
262
            # The last task wanted just a spinner, no bar
485
 
            spin_str = r'/-\|'[self._spin_pos % 4]
 
263
            spin_str =  r'/-\|'[self._spin_pos % 4]
486
264
            self._spin_pos += 1
487
265
            return spin_str + ' '
488
266
        else:
489
267
            return ''
490
268
 
491
269
    def _format_task(self, task):
492
 
        """Format task-specific parts of progress bar.
493
 
 
494
 
        :returns: (text_part, counter_part) both unicode strings.
495
 
        """
496
270
        if not task.show_count:
497
271
            s = ''
498
272
        elif task.current_cnt is not None and task.total_cnt is not None:
508
282
            t = t._parent_task
509
283
            if t.msg:
510
284
                m = t.msg + ':' + m
511
 
        return m, s
 
285
        return m + s
512
286
 
513
287
    def _render_line(self):
514
288
        bar_string = self._render_bar()
515
289
        if self._last_task:
516
 
            task_part, counter_part = self._format_task(self._last_task)
 
290
            task_msg = self._format_task(self._last_task)
517
291
        else:
518
 
            task_part = counter_part = ''
 
292
            task_msg = ''
519
293
        if self._last_task and not self._last_task.show_transport_activity:
520
294
            trans = ''
521
295
        else:
522
296
            trans = self._last_transport_msg
523
 
        # the bar separates the transport activity from the message, so even
524
 
        # if there's no bar or spinner, we must show something if both those
525
 
        # fields are present
526
 
        if (task_part or trans) and not bar_string:
527
 
            bar_string = '| '
528
 
        # preferentially truncate the task message if we don't have enough
529
 
        # space
530
 
        avail_width = self._avail_width()
531
 
        if avail_width is not None:
532
 
            # if terminal avail_width is unknown, don't truncate
533
 
            current_len = len(bar_string) + len(trans) + \
534
 
                len(task_part) + len(counter_part)
535
 
            # GZ 2017-04-22: Should measure and truncate task_part properly
536
 
            gap = current_len - avail_width
537
 
            if gap > 0:
538
 
                task_part = task_part[:-gap - 2] + '..'
539
 
        s = trans + bar_string + task_part + counter_part
540
 
        if avail_width is not None:
541
 
            if len(s) < avail_width:
542
 
                s = s.ljust(avail_width)
543
 
            elif len(s) > avail_width:
544
 
                s = s[:avail_width]
545
 
        return s
 
297
            if trans:
 
298
                trans += ' | '
 
299
        return (bar_string + trans + task_msg)
546
300
 
547
301
    def _repaint(self):
548
302
        s = self._render_line()
551
305
 
552
306
    def show_progress(self, task):
553
307
        """Called by the task object when it has changed.
554
 
 
555
 
        :param task: The top task object; its parents are also included
 
308
        
 
309
        :param task: The top task object; its parents are also included 
556
310
            by following links.
557
311
        """
558
312
        must_update = task is not self._last_task
572
326
        This may update a progress bar, spinner, or similar display.
573
327
        By default it does nothing.
574
328
        """
575
 
        # XXX: there should be a transport activity model, and that too should
576
 
        #      be seen by the progress view, rather than being poked in here.
 
329
        # XXX: Probably there should be a transport activity model, and that
 
330
        # too should be seen by the progress view, rather than being poked in
 
331
        # here.
 
332
        if not self._have_output:
 
333
            # As a workaround for <https://launchpad.net/bugs/321935> we only
 
334
            # show transport activity when there's already a progress bar
 
335
            # shown, which time the application code is expected to know to
 
336
            # clear off the progress bar when it's going to send some other
 
337
            # output.  Eventually it would be nice to have that automatically
 
338
            # synchronized.
 
339
            return
577
340
        self._total_byte_count += byte_count
578
341
        self._bytes_since_update += byte_count
579
 
        if self._first_byte_time is None:
580
 
            # Note that this isn't great, as technically it should be the time
581
 
            # when the bytes started transferring, not when they completed.
582
 
            # However, we usually start with a small request anyway.
583
 
            self._first_byte_time = time.time()
584
 
        if direction in self._bytes_by_direction:
585
 
            self._bytes_by_direction[direction] += byte_count
586
 
        else:
587
 
            self._bytes_by_direction['unknown'] += byte_count
588
 
        if 'no_activity' in debug.debug_flags:
589
 
            # Can be used as a workaround if
590
 
            # <https://launchpad.net/bugs/321935> reappears and transport
591
 
            # activity is cluttering other output.  However, thanks to
592
 
            # TextUIOutputStream this shouldn't be a problem any more.
593
 
            return
594
342
        now = time.time()
595
343
        if self._total_byte_count < 2000:
596
344
            # a little resistance at first, so it doesn't stay stuck at 0
601
349
        elif now >= (self._transport_update_time + 0.5):
602
350
            # guard against clock stepping backwards, and don't update too
603
351
            # often
604
 
            rate = (self._bytes_since_update /
605
 
                    (now - self._transport_update_time))
606
 
            # using base-10 units (see HACKING.txt).
607
 
            msg = ("%6dkB %5dkB/s " %
608
 
                   (self._total_byte_count / 1000, int(rate) / 1000,))
 
352
            rate = self._bytes_since_update / (now - self._transport_update_time)
 
353
            msg = ("%6dKB %5dKB/s" %
 
354
                    (self._total_byte_count>>10, int(rate)>>10,))
609
355
            self._transport_update_time = now
610
356
            self._last_repaint = now
611
357
            self._bytes_since_update = 0
612
358
            self._last_transport_msg = msg
613
359
            self._repaint()
614
 
 
615
 
    def _format_bytes_by_direction(self):
616
 
        if self._first_byte_time is None:
617
 
            bps = 0.0
618
 
        else:
619
 
            transfer_time = time.time() - self._first_byte_time
620
 
            if transfer_time < 0.001:
621
 
                transfer_time = 0.001
622
 
            bps = self._total_byte_count / transfer_time
623
 
 
624
 
        # using base-10 units (see HACKING.txt).
625
 
        msg = ('Transferred: %.0fkB'
626
 
               ' (%.1fkB/s r:%.0fkB w:%.0fkB'
627
 
               % (self._total_byte_count / 1000.,
628
 
                  bps / 1000.,
629
 
                  self._bytes_by_direction['read'] / 1000.,
630
 
                  self._bytes_by_direction['write'] / 1000.,
631
 
                  ))
632
 
        if self._bytes_by_direction['unknown'] > 0:
633
 
            msg += ' u:%.0fkB)' % (
634
 
                self._bytes_by_direction['unknown'] / 1000.
635
 
                )
636
 
        else:
637
 
            msg += ')'
638
 
        return msg
639
 
 
640
 
    def log_transport_activity(self, display=False):
641
 
        msg = self._format_bytes_by_direction()
642
 
        trace.mutter(msg)
643
 
        if display and self._total_byte_count > 0:
644
 
            self.clear()
645
 
            self._term_file.write(msg + '\n')
646
 
 
647
 
 
648
 
def _get_stream_encoding(stream):
649
 
    encoding = config.GlobalStack().get('output_encoding')
650
 
    if encoding is None:
651
 
        encoding = getattr(stream, "encoding", None)
652
 
    if encoding is None:
653
 
        encoding = osutils.get_terminal_encoding(trace=True)
654
 
    return encoding
655
 
 
656
 
 
657
 
def _unwrap_stream(stream):
658
 
    inner = getattr(stream, "buffer", None)
659
 
    if inner is None:
660
 
        inner = getattr(stream, "stream", stream)
661
 
    return inner
662
 
 
663
 
 
664
 
def _wrap_in_stream(stream, encoding=None, errors='replace'):
665
 
    if encoding is None:
666
 
        encoding = _get_stream_encoding(stream)
667
 
    # Attempt to wrap using io.open if possible, since that can do
668
 
    # line-buffering.
669
 
    try:
670
 
        fileno = stream.fileno()
671
 
    except io.UnsupportedOperation:
672
 
        encoded_stream = codecs.getreader(encoding)(stream, errors=errors)
673
 
        encoded_stream.encoding = encoding
674
 
        return encoded_stream
675
 
    else:
676
 
        return io.open(fileno, encoding=encoding, errors=errors, mode='r', buffering=1)
677
 
 
678
 
 
679
 
def _wrap_out_stream(stream, encoding=None, errors='replace'):
680
 
    if encoding is None:
681
 
        encoding = _get_stream_encoding(stream)
682
 
    encoded_stream = codecs.getwriter(encoding)(stream, errors=errors)
683
 
    encoded_stream.encoding = encoding
684
 
    return encoded_stream
685
 
 
686
 
 
687
 
class TextUIOutputStream(object):
688
 
    """Decorates stream to interact better with progress and change encoding.
689
 
 
690
 
    Before writing to the wrapped stream, progress is cleared. Callers must
691
 
    ensure bulk output is terminated with a newline so progress won't overwrite
692
 
    partial lines.
693
 
 
694
 
    Additionally, the encoding and errors behaviour of the underlying stream
695
 
    can be changed at this point. If errors is set to 'exact' raw bytes may be
696
 
    written to the underlying stream.
697
 
    """
698
 
 
699
 
    def __init__(self, ui_factory, stream, encoding=None, errors='strict'):
700
 
        self.ui_factory = ui_factory
701
 
        # GZ 2017-05-21: Clean up semantics when callers are made saner.
702
 
        inner = _unwrap_stream(stream)
703
 
        self.raw_stream = None
704
 
        if errors == "exact":
705
 
            errors = "strict"
706
 
            self.raw_stream = inner
707
 
        if inner is None:
708
 
            self.wrapped_stream = stream
709
 
            if encoding is None:
710
 
                encoding = _get_stream_encoding(stream)
711
 
        else:
712
 
            self.wrapped_stream = _wrap_out_stream(inner, encoding, errors)
713
 
            if encoding is None:
714
 
                encoding = self.wrapped_stream.encoding
715
 
        self.encoding = encoding
716
 
        self.errors = errors
717
 
 
718
 
    def _write(self, to_write):
719
 
        if isinstance(to_write, bytes):
720
 
            try:
721
 
                to_write = to_write.decode(self.encoding, self.errors)
722
 
            except UnicodeDecodeError:
723
 
                self.raw_stream.write(to_write)
724
 
                return
725
 
        self.wrapped_stream.write(to_write)
726
 
 
727
 
    def flush(self):
728
 
        self.ui_factory.clear_term()
729
 
        self.wrapped_stream.flush()
730
 
 
731
 
    def write(self, to_write):
732
 
        self.ui_factory.clear_term()
733
 
        self._write(to_write)
734
 
 
735
 
    def writelines(self, lines):
736
 
        self.ui_factory.clear_term()
737
 
        for line in lines:
738
 
            self._write(line)