43
class TestTextProgressView(TestCase):
44
"""Tests for text display of progress bars.
46
These try to exercise the progressview independently of its construction,
47
which is arranged by the TextUIFactory.
49
# The ProgressTask now connects directly to the ProgressView, so we can
50
# check them independently of the factory or of the determination of what
55
view = TextProgressView(out)
56
view._avail_width = lambda: 79
59
def make_task(self, parent_task, view, msg, curr, total):
60
# would normally be done by UIFactory; is done here so that we don't
62
task = ProgressTask(parent_task, progress_view=view)
64
task.current_cnt = curr
65
task.total_cnt = total
55
class TestProgress(TestCase):
59
self.top = ChildProgress(_stack=FakeStack(q))
61
def test_propogation(self):
62
self.top.update('foobles', 1, 2)
63
self.assertEqual(self.top.message, 'foobles')
64
self.assertEqual(self.top.current, 1)
65
self.assertEqual(self.top.total, 2)
66
self.assertEqual(self.top.child_fraction, 0)
67
child = ChildProgress(_stack=FakeStack(self.top))
68
child.update('baubles', 2, 4)
69
self.assertEqual(self.top.message, 'foobles')
70
self.assertEqual(self.top.current, 1)
71
self.assertEqual(self.top.total, 2)
72
self.assertEqual(self.top.child_fraction, 0.5)
73
grandchild = ChildProgress(_stack=FakeStack(child))
74
grandchild.update('barbells', 1, 2)
75
self.assertEqual(self.top.child_fraction, 0.625)
76
self.assertEqual(child.child_fraction, 0.5)
77
child.update('baubles', 3, 4)
78
self.assertEqual(child.child_fraction, 0)
79
self.assertEqual(self.top.child_fraction, 0.75)
80
grandchild.update('barbells', 1, 2)
81
self.assertEqual(self.top.child_fraction, 0.875)
82
grandchild.update('barbells', 2, 2)
83
self.assertEqual(self.top.child_fraction, 1)
84
child.update('baubles', 4, 4)
85
self.assertEqual(self.top.child_fraction, 1)
87
grandchild.update('barbells', 2, 2)
88
self.assertEqual(self.top.child_fraction, 1)
90
def test_implementations(self):
91
for implementation in (TTYProgressBar, DotsProgressBar,
93
self.check_parent_handling(implementation)
95
def check_parent_handling(self, parentclass):
96
top = parentclass(to_file=StringIO())
97
top.update('foobles', 1, 2)
98
child = ChildProgress(_stack=FakeStack(top))
99
child.update('baubles', 4, 4)
100
top.update('lala', 2, 2)
101
child.update('baubles', 4, 4)
103
def test_stacking(self):
104
self.check_stack(TTYProgressBar, ChildProgress)
105
self.check_stack(DotsProgressBar, ChildProgress)
106
self.check_stack(DummyProgress, DummyProgress)
108
def check_stack(self, parent_class, child_class):
109
stack = ProgressBarStack(klass=parent_class, to_file=StringIO())
110
parent = stack.get_nested()
112
self.assertIs(parent.__class__, parent_class)
113
child = stack.get_nested()
115
self.assertIs(child.__class__, child_class)
121
def test_throttling(self):
122
pb = InstrumentedProgress(to_file=StringIO())
123
# instantaneous updates should be squelched
124
pb.update('me', 1, 1)
125
self.assertTrue(pb.always_throttled)
126
pb = InstrumentedProgress(to_file=StringIO())
127
# It's like an instant sleep(1)!
129
# Updates after a second should not be squelched
130
pb.update('me', 1, 1)
131
self.assertFalse(pb.always_throttled)
68
133
def test_clear(self):
69
# <https://bugs.launchpad.net/bzr/+bug/611127> clear must actually
70
# send spaces to clear the line
71
out, view = self.make_view()
72
task = self.make_task(None, view, 'reticulating splines', 5, 20)
73
view.show_progress(task)
75
'\r/ reticulating splines 5/20 \r'
79
'\r/ reticulating splines 5/20 \r'
80
+ '\r' + 79 * ' ' + '\r',
83
def test_render_progress_no_bar(self):
84
"""The default view now has a spinner but no bar."""
85
out, view = self.make_view()
86
# view.enable_bar = False
87
task = self.make_task(None, view, 'reticulating splines', 5, 20)
88
view.show_progress(task)
90
'\r/ reticulating splines 5/20 \r'
93
def test_render_progress_easy(self):
94
"""Just one task and one quarter done"""
95
out, view = self.make_view()
96
view.enable_bar = True
97
task = self.make_task(None, view, 'reticulating splines', 5, 20)
98
view.show_progress(task)
100
'\r[####/ ] reticulating splines 5/20 \r'
103
def test_render_progress_nested(self):
104
"""Tasks proportionally contribute to overall progress"""
105
out, view = self.make_view()
106
task = self.make_task(None, view, 'reticulating splines', 0, 2)
107
task2 = self.make_task(task, view, 'stage2', 1, 2)
108
view.show_progress(task2)
109
view.enable_bar = True
110
# so we're in the first half of the main task, and half way through
113
'[####- ] reticulating splines:stage2 1/2 '
114
, view._render_line())
115
# if the nested task is complete, then we're all the way through the
116
# first half of the overall work
117
task2.update('stage2', 2, 2)
119
'[#########\ ] reticulating splines:stage2 2/2 '
120
, view._render_line())
122
def test_render_progress_sub_nested(self):
123
"""Intermediate tasks don't mess up calculation."""
124
out, view = self.make_view()
125
view.enable_bar = True
126
task_a = ProgressTask(None, progress_view=view)
127
task_a.update('a', 0, 2)
128
task_b = ProgressTask(task_a, progress_view=view)
130
task_c = ProgressTask(task_b, progress_view=view)
131
task_c.update('c', 1, 2)
132
# the top-level task is in its first half; the middle one has no
133
# progress indication, just a label; and the bottom one is half done,
134
# so the overall fraction is 1/4
136
'[####| ] a:b:c 1/2 '
137
, view._render_line())
139
def test_render_truncated(self):
140
# when the bar is too long for the terminal, we prefer not to truncate
141
# the counters because they might be interesting, and because
142
# truncating the numbers might be misleading
143
out, view = self.make_view()
144
task_a = ProgressTask(None, progress_view=view)
145
task_a.update('start_' + 'a' * 200 + '_end', 2000, 5000)
146
line = view._render_line()
148
'- start_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.. 2000/5000',
150
self.assertEqual(len(line), 79)
153
def test_render_with_activity(self):
154
# if the progress view has activity, it's shown before the spinner
155
out, view = self.make_view()
156
task_a = ProgressTask(None, progress_view=view)
157
view._last_transport_msg = ' 123kB 100kB/s '
158
line = view._render_line()
162
self.assertEqual(len(line), 79)
164
task_a.update('start_' + 'a' * 200 + '_end', 2000, 5000)
165
view._last_transport_msg = ' 123kB 100kB/s '
166
line = view._render_line()
168
' 123kB 100kB/s \\ start_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.. 2000/5000',
170
self.assertEqual(len(line), 79)
135
pb = TTYProgressBar(to_file=sio, show_eta=False)
136
pb.width = 20 # Just make it easier to test
137
# This should not output anything
139
# These two should not be displayed because
141
pb.update('foo', 1, 3)
142
pb.update('bar', 2, 3)
143
# So pb.clear() has nothing to do
146
# Make sure the next update isn't throttled
148
pb.update('baz', 3, 3)
151
self.assertEqual('\r[=========] baz 3/3'
155
def test_no_eta(self):
156
# An old version of the progress bar would
157
# store every update if show_eta was false
158
# because the eta routine was where it was
160
pb = InstrumentedProgress(to_file=StringIO(), show_eta=False)
161
# Just make sure this first few are throttled
164
# These messages are throttled, and don't contribute
165
for count in xrange(100):
166
pb.update('x', count, 300)
167
self.assertEqual(0, len(pb.last_updates))
172
# These happen too fast, so only one gets through
173
for count in xrange(100):
174
pb.update('x', count+100, 200)
175
self.assertEqual(1, len(pb.last_updates))
179
# But all of these go through, don't let the
180
# last_update list grow without bound
181
for count in xrange(100):
182
pb.update('x', count+100, 200)
184
self.assertEqual(pb._max_last_updates, len(pb.last_updates))
187
class TestProgressTypes(TestCase):
188
"""Test that the right ProgressBar gets instantiated at the right time."""
190
def get_nested(self, outf, term, env_progress=None):
191
"""Setup so that ProgressBar thinks we are in the supplied terminal."""
192
orig_term = os.environ.get('TERM')
193
orig_progress = os.environ.get('BZR_PROGRESS_BAR')
194
os.environ['TERM'] = term
195
if env_progress is not None:
196
os.environ['BZR_PROGRESS_BAR'] = env_progress
197
elif orig_progress is not None:
198
del os.environ['BZR_PROGRESS_BAR']
201
if orig_term is None:
202
del os.environ['TERM']
204
os.environ['TERM'] = orig_term
205
# We may have never created BZR_PROGRESS_BAR
206
# So we can't just delete like we can 'TERM' (which is always set)
207
if orig_progress is None:
208
if 'BZR_PROGRESS_BAR' in os.environ:
209
del os.environ['BZR_PROGRESS_BAR']
211
os.environ['BZR_PROGRESS_BAR'] = orig_progress
213
self.addCleanup(reset)
215
stack = ProgressBarStack(to_file=outf)
216
pb = stack.get_nested()
217
pb.start_time -= 1 # Make sure it is ready to write
218
pb.width = 20 # And it is of reasonable size
221
def test_tty_progress(self):
222
# Make sure the ProgressBarStack thinks it is
223
# writing out to a terminal, and thus uses a TTYProgressBar
225
pb = self.get_nested(out, 'xterm')
226
self.assertIsInstance(pb, TTYProgressBar)
228
pb.update('foo', 1, 2)
229
pb.update('bar', 2, 2)
233
self.assertEqual('\r/ [==== ] foo 1/2'
234
'\r- [=======] bar 2/2'
238
def test_noninteractive_progress(self):
239
out = _NonTTYStringIO()
240
pb = self.get_nested(out, 'xterm')
241
self.assertIsInstance(pb, DummyProgress)
243
pb.update('foo', 1, 2)
244
pb.update('bar', 2, 2)
247
self.assertEqual('', out.getvalue())
249
def test_dots_progress(self):
250
# make sure we get the right progress bar when not on a terminal
251
out = _NonTTYStringIO()
252
pb = self.get_nested(out, 'xterm', 'dots')
253
self.assertIsInstance(pb, DotsProgressBar)
255
pb.update('foo', 1, 2)
256
pb.update('bar', 2, 2)
259
self.assertEqual('foo: .'
264
def test_no_isatty_progress(self):
265
# Make sure ProgressBarStack handles a plain StringIO()
267
out = cStringIO.StringIO()
268
pb = self.get_nested(out, 'xterm')
270
self.assertIsInstance(pb, DummyProgress)
272
def test_dumb_progress(self):
273
# using a terminal that can't do cursor movement
275
pb = self.get_nested(out, 'dumb')
277
self.assertIsInstance(pb, DummyProgress)
279
def test_progress_env_tty(self):
280
# The environ variable BZR_PROGRESS_BAR controls what type of
281
# progress bar we will get, even if it wouldn't usually be that type
284
# Usually, this would be a DotsProgressBar
285
out = cStringIO.StringIO()
286
pb = self.get_nested(out, 'dumb', 'tty')
288
# Even though we are not a tty, the env_var will override
289
self.assertIsInstance(pb, TTYProgressBar)
291
def test_progress_env_none(self):
292
# Even though we are in a valid tty, no progress
294
pb = self.get_nested(out, 'xterm', 'none')
296
self.assertIsInstance(pb, DummyProgress)
298
def test_progress_env_invalid(self):
300
self.assertRaises(errors.InvalidProgressBarType, self.get_nested,
301
out, 'xterm', 'nonexistant')
added
removed
bzrlib/tests/test_progress.py
