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
17
"""Text UI, write output to the console."""
18
"""Text UI, write output to the console.
25
from ..lazy_import import lazy_import
27
from bzrlib.lazy_import import lazy_import
26
28
lazy_import(globals(), """
38
from bzrlib.ui import (
47
class _ChooseUI(object):
49
""" Helper class for choose implementation.
52
def __init__(self, ui, msg, choices, default):
55
self._build_alternatives(msg, choices, default)
57
def _setup_mode(self):
58
"""Setup input mode (line-based, char-based) and echo-back.
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
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
70
self.line_based = True
71
self.echo_back = not is_tty
73
def _build_alternatives(self, msg, choices, default):
74
"""Parse choices string.
76
Setup final prompt and the lists of choices and associated
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")
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):
94
help += '[' + c[shortcut + 1] + ']'
95
help += c[(shortcut + 2):]
96
shortcut = c[shortcut + 1]
98
c = c.replace('&', '')
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.
107
self.alternatives[''] = choice
108
self.alternatives['\r'] = choice
109
help_list.append(help)
112
self.prompt = u'%s (%s): ' % (msg, ', '.join(help_list))
115
line = self.ui.stdin.readline()
121
char = osutils.getchar()
122
if char == chr(3): # INTR
123
raise KeyboardInterrupt
124
if char == chr(4): # EOF (^d, C-d)
126
if isinstance(char, bytes):
127
return char.decode('ascii', 'replace')
131
"""Keep asking the user until a valid choice is made.
134
getchoice = self._getline
136
getchoice = self._getchar
140
if 1 == iter or self.line_based:
141
self.ui.prompt(self.prompt)
145
self.ui.stderr.write(u'\n')
147
except KeyboardInterrupt:
148
self.ui.stderr.write(u'\n')
150
choice = choice.lower()
151
if choice not in self.alternatives:
152
# Not a valid choice, keep on asking.
154
name, index = self.alternatives[choice]
156
self.ui.stderr.write(name + u'\n')
160
opt_progress_bar = config.Option(
161
'progress_bar', help='Progress bar type.',
162
default_from_env=['BRZ_PROGRESS_BAR'], default=None,
166
44
class TextUIFactory(UIFactory):
167
"""A UI factory for Text user interfaces."""
169
def __init__(self, stdin, stdout, stderr):
170
"""Create a TextUIFactory."""
45
"""A UI factory for Text user interefaces."""
51
"""Create a TextUIFactory.
53
:param bar_type: The type of progress bar to create. Deprecated
54
and ignored; a TextProgressView is always used.
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()
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()
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)
192
def choose(self, msg, choices, default=None):
193
"""Prompt the user for a list of alternatives.
195
Support both line-based and char-based editing.
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'.
201
An empty line, when in line-based mode, or pressing enter in char-based
202
mode will select the default choice (if any).
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
210
choose_ui = _ChooseUI(self, msg, choices, default)
211
return choose_ui.interact()
213
def be_quiet(self, state):
214
if state and not self._quiet:
216
UIFactory.be_quiet(self, state)
217
self._progress_view = self.make_progress_view()
219
65
def clear_term(self):
220
66
"""Prepare the terminal for output.
283
131
username = self.stdin.readline()
287
if username[-1] == '\n':
288
username = username[:-1]
134
elif username[-1] == '\n':
135
username = username[:-1]
291
138
def make_progress_view(self):
292
139
"""Construct and return a new ProgressView subclass for this UI.
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.
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()
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)
150
return NullProgressView()
312
152
def note(self, msg):
313
153
"""Write an already-formatted message, clearing the progress bar if necessary."""
337
174
By default it does nothing.
339
176
self._progress_view.show_transport_activity(transport,
340
direction, byte_count)
342
def log_transport_activity(self, display=False):
343
"""See UIFactory.log_transport_activity()"""
344
log = getattr(self._progress_view, 'log_transport_activity', None)
348
def show_error(self, msg):
350
self.stderr.write("bzr: error: %s\n" % msg)
352
def show_message(self, msg):
355
def show_warning(self, msg):
357
self.stderr.write("bzr: warning: %s\n" % msg)
177
direction, byte_count)
359
179
def _progress_updated(self, task):
360
180
"""A task has been updated and wants to be displayed.
362
182
if not self._task_stack:
363
183
warnings.warn("%r updated but no tasks are active" %
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]))
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)
374
190
def _progress_all_finished(self):
375
191
self._progress_view.clear()
377
def show_user_warning(self, warning_id, **message_args):
378
"""Show a text message to the user.
380
Explicitly not for warnings about bzr apis, deprecations or internals.
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')
390
def pad_to_width(line, width, encoding_hint='ascii'):
391
"""Truncate or pad unicode line to width.
393
This is best-effort for now, and strings containing control codes or
394
non-ascii text may be cut and padded incorrectly.
396
s = line.encode(encoding_hint, 'replace')
397
return (b'%-*.*s' % (width, width, s)).decode(encoding_hint)
400
194
class TextProgressView(object):
401
195
"""Display of progress bar and other information on a tty.
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.
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.
508
282
t = t._parent_task
510
284
m = t.msg + ':' + m
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)
518
task_part = counter_part = ''
519
293
if self._last_task and not self._last_task.show_transport_activity:
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
526
if (task_part or trans) and not bar_string:
528
# preferentially truncate the task message if we don't have enough
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
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:
299
return (bar_string + trans + task_msg)
547
301
def _repaint(self):
548
302
s = self._render_line()
572
326
This may update a progress bar, spinner, or similar display.
573
327
By default it does nothing.
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
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
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
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.
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
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
615
def _format_bytes_by_direction(self):
616
if self._first_byte_time is None:
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
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.,
629
self._bytes_by_direction['read'] / 1000.,
630
self._bytes_by_direction['write'] / 1000.,
632
if self._bytes_by_direction['unknown'] > 0:
633
msg += ' u:%.0fkB)' % (
634
self._bytes_by_direction['unknown'] / 1000.
640
def log_transport_activity(self, display=False):
641
msg = self._format_bytes_by_direction()
643
if display and self._total_byte_count > 0:
645
self._term_file.write(msg + '\n')
648
def _get_stream_encoding(stream):
649
encoding = config.GlobalStack().get('output_encoding')
651
encoding = getattr(stream, "encoding", None)
653
encoding = osutils.get_terminal_encoding(trace=True)
657
def _unwrap_stream(stream):
658
inner = getattr(stream, "buffer", None)
660
inner = getattr(stream, "stream", stream)
664
def _wrap_in_stream(stream, encoding=None, errors='replace'):
666
encoding = _get_stream_encoding(stream)
667
# Attempt to wrap using io.open if possible, since that can do
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
676
return io.open(fileno, encoding=encoding, errors=errors, mode='r', buffering=1)
679
def _wrap_out_stream(stream, encoding=None, errors='replace'):
681
encoding = _get_stream_encoding(stream)
682
encoded_stream = codecs.getwriter(encoding)(stream, errors=errors)
683
encoded_stream.encoding = encoding
684
return encoded_stream
687
class TextUIOutputStream(object):
688
"""Decorates stream to interact better with progress and change encoding.
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
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.
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":
706
self.raw_stream = inner
708
self.wrapped_stream = stream
710
encoding = _get_stream_encoding(stream)
712
self.wrapped_stream = _wrap_out_stream(inner, encoding, errors)
714
encoding = self.wrapped_stream.encoding
715
self.encoding = encoding
718
def _write(self, to_write):
719
if isinstance(to_write, bytes):
721
to_write = to_write.decode(self.encoding, self.errors)
722
except UnicodeDecodeError:
723
self.raw_stream.write(to_write)
725
self.wrapped_stream.write(to_write)
728
self.ui_factory.clear_term()
729
self.wrapped_stream.flush()
731
def write(self, to_write):
732
self.ui_factory.clear_term()
733
self._write(to_write)
735
def writelines(self, lines):
736
self.ui_factory.clear_term()