1
# Copyright (C) 2006-2011 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20
from ..progress import (
23
from ..ui.text import (
35
class TestTextProgressView(tests.TestCase):
36
"""Tests for text display of progress bars.
38
These try to exercise the progressview independently of its construction,
39
which is arranged by the TextUIFactory.
41
# The ProgressTask now connects directly to the ProgressView, so we can
42
# check them independently of the factory or of the determination of what
45
def make_view_only(self, out, width=79):
46
view = TextProgressView(out)
47
view._avail_width = lambda: width
51
out = ui_testing.StringIOWithEncoding()
52
return out, self.make_view_only(out)
54
def make_task(self, parent_task, view, msg, curr, total):
55
# would normally be done by UIFactory; is done here so that we don't
57
task = ProgressTask(parent_task, progress_view=view)
59
task.current_cnt = curr
60
task.total_cnt = total
64
# <https://bugs.launchpad.net/bzr/+bug/611127> clear must actually
65
# send spaces to clear the line
66
out, view = self.make_view()
67
task = self.make_task(None, view, 'reticulating splines', 5, 20)
68
view.show_progress(task)
70
'\r/ reticulating splines 5/20 \r', out.getvalue())
73
'\r/ reticulating splines 5/20 \r' +
74
'\r' + 79 * ' ' + '\r',
77
def test_render_progress_no_bar(self):
78
"""The default view now has a spinner but no bar."""
79
out, view = self.make_view()
80
# view.enable_bar = False
81
task = self.make_task(None, view, 'reticulating splines', 5, 20)
82
view.show_progress(task)
84
'\r/ reticulating splines 5/20 \r', out.getvalue())
86
def test_render_progress_easy(self):
87
"""Just one task and one quarter done"""
88
out, view = self.make_view()
89
view.enable_bar = True
90
task = self.make_task(None, view, 'reticulating splines', 5, 20)
91
view.show_progress(task)
93
'\r[####/ ] reticulating splines 5/20 \r', out.getvalue())
95
def test_render_progress_nested(self):
96
"""Tasks proportionally contribute to overall progress"""
97
out, view = self.make_view()
98
task = self.make_task(None, view, 'reticulating splines', 0, 2)
99
task2 = self.make_task(task, view, 'stage2', 1, 2)
100
view.show_progress(task2)
101
view.enable_bar = True
102
# so we're in the first half of the main task, and half way through
105
'[####- ] reticulating splines:stage2 1/2 ', view._render_line())
106
# if the nested task is complete, then we're all the way through the
107
# first half of the overall work
108
task2.update('stage2', 2, 2)
110
'[#########\\ ] reticulating splines:stage2 2/2 ', view._render_line())
112
def test_render_progress_sub_nested(self):
113
"""Intermediate tasks don't mess up calculation."""
114
out, view = self.make_view()
115
view.enable_bar = True
116
task_a = ProgressTask(None, progress_view=view)
117
task_a.update('a', 0, 2)
118
task_b = ProgressTask(task_a, progress_view=view)
120
task_c = ProgressTask(task_b, progress_view=view)
121
task_c.update('c', 1, 2)
122
# the top-level task is in its first half; the middle one has no
123
# progress indication, just a label; and the bottom one is half done,
124
# so the overall fraction is 1/4
126
'[####| ] a:b:c 1/2 ', view._render_line())
128
def test_render_truncated(self):
129
# when the bar is too long for the terminal, we prefer not to truncate
130
# the counters because they might be interesting, and because
131
# truncating the numbers might be misleading
132
out, view = self.make_view()
133
task_a = ProgressTask(None, progress_view=view)
134
task_a.update('start_' + 'a' * 200 + '_end', 2000, 5000)
135
line = view._render_line()
137
'- start_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.. 2000/5000',
139
self.assertEqual(len(line), 79)
141
def test_render_with_activity(self):
142
# if the progress view has activity, it's shown before the spinner
143
out, view = self.make_view()
144
task_a = ProgressTask(None, progress_view=view)
145
view._last_transport_msg = ' 123kB 100kB/s '
146
line = view._render_line()
150
self.assertEqual(len(line), 79)
152
task_a.update('start_' + 'a' * 200 + '_end', 2000, 5000)
153
view._last_transport_msg = ' 123kB 100kB/s '
154
line = view._render_line()
156
' 123kB 100kB/s \\ start_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.. 2000/5000',
158
self.assertEqual(len(line), 79)
160
def test_render_progress_unicode_enc_utf8(self):
161
out = ui_testing.StringIOWithEncoding()
162
out.encoding = "utf-8"
163
view = self.make_view_only(out, 20)
164
task = self.make_task(None, view, u"\xa7", 0, 1)
165
view.show_progress(task)
166
self.assertEqual(u'\r/ \xa7 0/1 \r', out.getvalue())
168
def test_render_progress_unicode_enc_missing(self):
169
out = codecs.getwriter("ascii")(io.BytesIO())
170
self.assertRaises(AttributeError, getattr, out, "encoding")
171
view = self.make_view_only(out, 20)
172
task = self.make_task(None, view, u"\xa7", 0, 1)
173
view.show_progress(task)
174
self.assertEqual(b'\r/ ? 0/1 \r', out.getvalue())
176
def test_render_progress_unicode_enc_none(self):
177
out = ui_testing.StringIOWithEncoding()
179
view = self.make_view_only(out, 20)
180
task = self.make_task(None, view, u"\xa7", 0, 1)
181
view.show_progress(task)
182
self.assertEqual(u'\r/ ? 0/1 \r', out.getvalue())