~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/progress.py

  • Committer: Martin Pool
  • Date: 2005-07-18 13:38:13 UTC
  • Revision ID: mbp@sourcefrog.net-20050718133813-4343f0cde39537de
- refactor member names in Weave code

Show diffs side-by-side

added added

removed removed

Lines of Context:
30
30
# indicators, preferably without needing to adjust all code that
31
31
# potentially calls them.
32
32
 
33
 
# TODO: If not on a tty perhaps just print '......' for the benefit of IDEs, etc
 
33
# TODO: Perhaps don't write updates faster than a certain rate, say
 
34
# 5/second.
34
35
 
35
36
# TODO: Optionally show elapsed time instead/as well as ETA; nicer
36
37
# when the rate is unpredictable
38
39
 
39
40
import sys
40
41
import time
41
 
import os
42
 
from collections import deque
43
42
 
44
43
 
45
44
def _width():
50
49
    TODO: Is there anything that gets a better update when the window
51
50
          is resized while the program is running?
52
51
    """
 
52
    import os
53
53
    try:
54
54
        return int(os.environ['COLUMNS'])
55
55
    except (IndexError, KeyError, ValueError):
61
61
        return False
62
62
    if not f.isatty():
63
63
        return False
 
64
    import os
64
65
    if os.environ.get('TERM') == 'dumb':
65
66
        # e.g. emacs compile window
66
67
        return False
68
69
 
69
70
 
70
71
 
71
 
def ProgressBar(to_file=sys.stderr, **kwargs):
72
 
    """Abstract factory"""
73
 
    if _supports_progress(to_file):
74
 
        return TTYProgressBar(to_file=to_file, **kwargs)
75
 
    else:
76
 
        return DotsProgressBar(to_file=to_file, **kwargs)
77
 
    
78
 
    
79
 
class _BaseProgressBar(object):
80
 
    def __init__(self,
81
 
                 to_file=sys.stderr,
82
 
                 show_pct=False,
83
 
                 show_spinner=False,
84
 
                 show_eta=True,
85
 
                 show_bar=True,
86
 
                 show_count=True):
87
 
        object.__init__(self)
88
 
        self.to_file = to_file
89
 
 
90
 
        self.last_msg = None
91
 
        self.last_cnt = None
92
 
        self.last_total = None
93
 
        self.show_pct = show_pct
94
 
        self.show_spinner = show_spinner
95
 
        self.show_eta = show_eta
96
 
        self.show_bar = show_bar
97
 
        self.show_count = show_count
98
 
 
99
 
 
100
 
 
101
 
class DummyProgress(_BaseProgressBar):
102
 
    """Progress-bar standin that does nothing.
103
 
 
104
 
    This can be used as the default argument for methods that
105
 
    take an optional progress indicator."""
106
 
    def tick(self):
107
 
        pass
108
 
 
109
 
    def update(self, msg=None, current=None, total=None):
110
 
        pass
111
 
 
112
 
    def clear(self):
113
 
        pass
114
 
        
115
 
    
116
 
class DotsProgressBar(_BaseProgressBar):
117
 
    def __init__(self, **kwargs):
118
 
        _BaseProgressBar.__init__(self, **kwargs)
119
 
        self.last_msg = None
120
 
        self.need_nl = False
121
 
        
122
 
    def tick(self):
123
 
        self.update()
124
 
        
125
 
    def update(self, msg=None, current_cnt=None, total_cnt=None):
126
 
        if msg and msg != self.last_msg:
127
 
            if self.need_nl:
128
 
                self.to_file.write('\n')
129
 
            
130
 
            self.to_file.write(msg + ': ')
131
 
            self.last_msg = msg
132
 
        self.need_nl = True
133
 
        self.to_file.write('.')
134
 
        
135
 
    def clear(self):
136
 
        if self.need_nl:
137
 
            self.to_file.write('\n')
138
 
        
139
 
    
140
 
class TTYProgressBar(_BaseProgressBar):
 
72
class ProgressBar(object):
141
73
    """Progress bar display object.
142
74
 
143
75
    Several options are available to control the display.  These can
160
92
    SPIN_CHARS = r'/-\|'
161
93
    MIN_PAUSE = 0.1 # seconds
162
94
 
163
 
 
164
 
    def __init__(self, **kwargs):
165
 
        _BaseProgressBar.__init__(self, **kwargs)
 
95
    start_time = None
 
96
    last_update = None
 
97
    
 
98
    def __init__(self,
 
99
                 to_file=sys.stderr,
 
100
                 show_pct=False,
 
101
                 show_spinner=False,
 
102
                 show_eta=True,
 
103
                 show_bar=True,
 
104
                 show_count=True):
 
105
        object.__init__(self)
 
106
        self.to_file = to_file
 
107
        self.suppressed = not _supports_progress(self.to_file)
166
108
        self.spin_pos = 0
 
109
 
 
110
        self.last_msg = None
 
111
        self.last_cnt = None
 
112
        self.last_total = None
 
113
        self.show_pct = show_pct
 
114
        self.show_spinner = show_spinner
 
115
        self.show_eta = show_eta
 
116
        self.show_bar = show_bar
 
117
        self.show_count = show_count
 
118
 
167
119
        self.width = _width()
168
 
        self.start_time = None
169
 
        self.last_update = None
170
 
        self.last_updates = deque()
171
 
    
172
 
 
173
 
    def throttle(self):
174
 
        """Return True if the bar was updated too recently"""
175
 
        now = time.time()
176
 
        if self.start_time is None:
177
 
            self.start_time = self.last_update = now
178
 
            return False
179
 
        else:
180
 
            interval = now - self.last_update
181
 
            if interval > 0 and interval < self.MIN_PAUSE:
182
 
                return True
183
 
 
184
 
        self.last_updates.append(now - self.last_update)
185
 
        self.last_update = now
186
 
        return False
187
120
        
188
121
 
189
122
    def tick(self):
193
126
 
194
127
    def update(self, msg, current_cnt=None, total_cnt=None):
195
128
        """Update and redraw progress bar."""
196
 
 
197
 
        if current_cnt < 0:
198
 
            current_cnt = 0
199
 
            
200
 
        if current_cnt > total_cnt:
201
 
            total_cnt = current_cnt
 
129
        if self.suppressed:
 
130
            return
202
131
 
203
132
        # save these for the tick() function
204
133
        self.last_msg = msg
205
134
        self.last_cnt = current_cnt
206
135
        self.last_total = total_cnt
207
136
            
208
 
        if self.throttle():
209
 
            return 
 
137
        now = time.time()
 
138
        if self.start_time is None:
 
139
            self.start_time = now
 
140
        else:
 
141
            interval = now - self.last_update
 
142
            if interval > 0 and interval < self.MIN_PAUSE:
 
143
                return
 
144
 
 
145
        self.last_update = now
 
146
        
 
147
        if total_cnt:
 
148
            assert current_cnt <= total_cnt
 
149
        if current_cnt:
 
150
            assert current_cnt >= 0
210
151
        
211
152
        if self.show_eta and self.start_time and total_cnt:
212
 
            eta = get_eta(self.start_time, current_cnt, total_cnt,
213
 
                    last_updates = self.last_updates)
 
153
            eta = get_eta(self.start_time, current_cnt, total_cnt)
214
154
            eta_str = " " + str_tdelta(eta)
215
155
        else:
216
156
            eta_str = ""
269
209
        #self.to_file.flush()
270
210
            
271
211
 
272
 
    def clear(self):        
 
212
    def clear(self):
 
213
        if self.suppressed:
 
214
            return
 
215
        
273
216
        self.to_file.write('\r%s\r' % (' ' * (self.width - 1)))
274
217
        #self.to_file.flush()        
275
218
    
284
227
                             delt % 60)
285
228
 
286
229
 
287
 
def get_eta(start_time, current, total, enough_samples=3, last_updates=None, n_recent=10):
 
230
def get_eta(start_time, current, total, enough_samples=3):
288
231
    if start_time is None:
289
232
        return None
290
233
 
306
249
 
307
250
    assert total_duration >= elapsed
308
251
 
309
 
    if last_updates and len(last_updates) >= n_recent:
310
 
        while len(last_updates) > n_recent:
311
 
            last_updates.popleft()
312
 
        avg = sum(last_updates) / float(len(last_updates))
313
 
        time_left = avg * (total - current)
314
 
 
315
 
        old_time_left = total_duration - elapsed
316
 
 
317
 
        # We could return the average, or some other value here
318
 
        return (time_left + old_time_left) / 2
319
 
 
320
252
    return total_duration - elapsed
321
253
 
322
254
 
331
263
 
332
264
 
333
265
def demo():
334
 
    sleep = time.sleep
335
 
    
336
 
    print 'dumb-terminal test:'
337
 
    pb = DotsProgressBar()
338
 
    for i in range(100):
339
 
        pb.update('Leoparden', i, 99)
340
 
        sleep(0.1)
341
 
    sleep(1.5)
342
 
    pb.clear()
343
 
    sleep(1.5)
344
 
    
345
 
    print 'smart-terminal test:'
 
266
    from time import sleep
346
267
    pb = ProgressBar(show_pct=True, show_bar=True, show_spinner=False)
347
268
    for i in range(100):
348
269
        pb.update('Elephanten', i, 99)
350
271
    sleep(2)
351
272
    pb.clear()
352
273
    sleep(1)
353
 
 
354
274
    print 'done!'
355
275
 
356
276
if __name__ == "__main__":