1
# Copyright (C) 2006, 2007 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18
from StringIO import StringIO
20
from bzrlib import errors
21
from bzrlib.progress import (
28
from bzrlib.tests import TestCase
32
def __init__(self, top):
38
class InstrumentedProgress(TTYProgressBar):
39
"""TTYProgress variant that tracks outcomes"""
41
def __init__(self, *args, **kwargs):
42
self.always_throttled = True
43
TTYProgressBar.__init__(self, *args, **kwargs)
45
def throttle(self, old_message):
46
result = TTYProgressBar.throttle(self, old_message)
48
self.always_throttled = False
51
class _TTYStringIO(StringIO):
52
"""A helper class which makes a StringIO look like a terminal"""
58
class _NonTTYStringIO(StringIO):
59
"""Helper that implements isatty() but returns False"""
65
class TestProgress(TestCase):
68
self.top = ChildProgress(_stack=FakeStack(q))
70
def test_propogation(self):
71
self.top.update('foobles', 1, 2)
72
self.assertEqual(self.top.message, 'foobles')
73
self.assertEqual(self.top.current, 1)
74
self.assertEqual(self.top.total, 2)
75
self.assertEqual(self.top.child_fraction, 0)
76
child = ChildProgress(_stack=FakeStack(self.top))
77
child.update('baubles', 2, 4)
78
self.assertEqual(self.top.message, 'foobles')
79
self.assertEqual(self.top.current, 1)
80
self.assertEqual(self.top.total, 2)
81
self.assertEqual(self.top.child_fraction, 0.5)
82
grandchild = ChildProgress(_stack=FakeStack(child))
83
grandchild.update('barbells', 1, 2)
84
self.assertEqual(self.top.child_fraction, 0.625)
85
self.assertEqual(child.child_fraction, 0.5)
86
child.update('baubles', 3, 4)
87
self.assertEqual(child.child_fraction, 0)
88
self.assertEqual(self.top.child_fraction, 0.75)
89
grandchild.update('barbells', 1, 2)
90
self.assertEqual(self.top.child_fraction, 0.875)
91
grandchild.update('barbells', 2, 2)
92
self.assertEqual(self.top.child_fraction, 1)
93
child.update('baubles', 4, 4)
94
self.assertEqual(self.top.child_fraction, 1)
96
grandchild.update('barbells', 2, 2)
97
self.assertEqual(self.top.child_fraction, 1)
99
def test_implementations(self):
100
for implementation in (TTYProgressBar, DotsProgressBar,
102
self.check_parent_handling(implementation)
104
def check_parent_handling(self, parentclass):
105
top = parentclass(to_file=StringIO())
106
top.update('foobles', 1, 2)
107
child = ChildProgress(_stack=FakeStack(top))
108
child.update('baubles', 4, 4)
109
top.update('lala', 2, 2)
110
child.update('baubles', 4, 4)
112
def test_stacking(self):
113
self.check_stack(TTYProgressBar, ChildProgress)
114
self.check_stack(DotsProgressBar, ChildProgress)
115
self.check_stack(DummyProgress, DummyProgress)
117
def check_stack(self, parent_class, child_class):
118
stack = ProgressBarStack(klass=parent_class, to_file=StringIO())
119
parent = stack.get_nested()
121
self.assertIs(parent.__class__, parent_class)
122
child = stack.get_nested()
124
self.assertIs(child.__class__, child_class)
130
def test_throttling(self):
131
pb = InstrumentedProgress(to_file=StringIO())
132
# instantaneous updates should be squelched
133
pb.update('me', 1, 1)
134
self.assertTrue(pb.always_throttled)
135
pb = InstrumentedProgress(to_file=StringIO())
136
# It's like an instant sleep(1)!
138
# Updates after a second should not be squelched
139
pb.update('me', 1, 1)
140
self.assertFalse(pb.always_throttled)
142
def test_clear(self):
144
pb = TTYProgressBar(to_file=sio, show_eta=False)
145
pb.width = 20 # Just make it easier to test
146
# This should not output anything
148
# These two should not be displayed because
150
pb.update('foo', 1, 3)
151
pb.update('bar', 2, 3)
152
# So pb.clear() has nothing to do
155
# Make sure the next update isn't throttled
157
pb.update('baz', 3, 3)
160
self.assertEqual('\r[=========] baz 3/3'
164
def test_no_eta(self):
165
# An old version of the progress bar would
166
# store every update if show_eta was false
167
# because the eta routine was where it was
169
pb = InstrumentedProgress(to_file=StringIO(), show_eta=False)
170
# Just make sure this first few are throttled
173
# These messages are throttled, and don't contribute
174
for count in xrange(100):
175
pb.update('x', count, 300)
176
self.assertEqual(0, len(pb.last_updates))
181
# These happen too fast, so only one gets through
182
for count in xrange(100):
183
pb.update('x', count+100, 200)
184
self.assertEqual(1, len(pb.last_updates))
188
# But all of these go through, don't let the
189
# last_update list grow without bound
190
for count in xrange(100):
191
pb.update('x', count+100, 200)
193
self.assertEqual(pb._max_last_updates, len(pb.last_updates))
196
class TestProgressTypes(TestCase):
197
"""Test that the right ProgressBar gets instantiated at the right time."""
199
def get_nested(self, outf, term, env_progress=None):
200
"""Setup so that ProgressBar thinks we are in the supplied terminal."""
201
orig_term = os.environ.get('TERM')
202
orig_progress = os.environ.get('BZR_PROGRESS_BAR')
203
os.environ['TERM'] = term
204
if env_progress is not None:
205
os.environ['BZR_PROGRESS_BAR'] = env_progress
206
elif orig_progress is not None:
207
del os.environ['BZR_PROGRESS_BAR']
210
if orig_term is None:
211
del os.environ['TERM']
213
os.environ['TERM'] = orig_term
214
# We may have never created BZR_PROGRESS_BAR
215
# So we can't just delete like we can 'TERM' (which is always set)
216
if orig_progress is None:
217
if 'BZR_PROGRESS_BAR' in os.environ:
218
del os.environ['BZR_PROGRESS_BAR']
220
os.environ['BZR_PROGRESS_BAR'] = orig_progress
222
self.addCleanup(reset)
224
stack = ProgressBarStack(to_file=outf)
225
pb = stack.get_nested()
226
pb.start_time -= 1 # Make sure it is ready to write
227
pb.width = 20 # And it is of reasonable size
230
def test_tty_progress(self):
231
# Make sure the ProgressBarStack thinks it is
232
# writing out to a terminal, and thus uses a TTYProgressBar
234
pb = self.get_nested(out, 'xterm')
235
self.assertIsInstance(pb, TTYProgressBar)
237
pb.update('foo', 1, 2)
238
pb.update('bar', 2, 2)
242
self.assertEqual('\r/ [==== ] foo 1/2'
243
'\r- [=======] bar 2/2'
247
def test_noninteractive_progress(self):
248
out = _NonTTYStringIO()
249
pb = self.get_nested(out, 'xterm')
250
self.assertIsInstance(pb, DummyProgress)
252
pb.update('foo', 1, 2)
253
pb.update('bar', 2, 2)
256
self.assertEqual('', out.getvalue())
258
def test_dots_progress(self):
259
# make sure we get the right progress bar when not on a terminal
260
out = _NonTTYStringIO()
261
pb = self.get_nested(out, 'xterm', 'dots')
262
self.assertIsInstance(pb, DotsProgressBar)
264
pb.update('foo', 1, 2)
265
pb.update('bar', 2, 2)
268
self.assertEqual('foo: .'
273
def test_no_isatty_progress(self):
274
# Make sure ProgressBarStack handles a plain StringIO()
276
out = cStringIO.StringIO()
277
pb = self.get_nested(out, 'xterm')
279
self.assertIsInstance(pb, DummyProgress)
281
def test_dumb_progress(self):
282
# using a terminal that can't do cursor movement
284
pb = self.get_nested(out, 'dumb')
286
self.assertIsInstance(pb, DummyProgress)
288
def test_progress_env_tty(self):
289
# The environ variable BZR_PROGRESS_BAR controls what type of
290
# progress bar we will get, even if it wouldn't usually be that type
293
# Usually, this would be a DotsProgressBar
294
out = cStringIO.StringIO()
295
pb = self.get_nested(out, 'dumb', 'tty')
297
# Even though we are not a tty, the env_var will override
298
self.assertIsInstance(pb, TTYProgressBar)
300
def test_progress_env_none(self):
301
# Even though we are in a valid tty, no progress
303
pb = self.get_nested(out, 'xterm', 'none')
305
self.assertIsInstance(pb, DummyProgress)
307
def test_progress_env_invalid(self):
309
self.assertRaises(errors.InvalidProgressBarType, self.get_nested,
310
out, 'xterm', 'nonexistant')
added
removed
bzrlib/tests/test_progress.py
