~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/progress.py

  • Committer: Robert Collins
  • Date: 2006-03-02 07:43:46 UTC
  • mto: (1594.2.4 integration)
  • mto: This revision was merged to the branch mainline in revision 1596.
  • Revision ID: robertc@robertcollins.net-20060302074346-f6ea05e3f19f6b8b
Change WeaveStore into VersionedFileStore and make its versoined file class parameterisable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
38
38
 
39
39
import sys
40
40
import time
41
 
 
42
 
 
43
 
def _width():
44
 
    """Return estimated terminal width.
45
 
 
46
 
    TODO: Do something smart on Windows?
47
 
 
48
 
    TODO: Is there anything that gets a better update when the window
49
 
          is resized while the program is running?
50
 
    """
51
 
    import os
52
 
    try:
53
 
        return int(os.environ['COLUMNS'])
54
 
    except (IndexError, KeyError, ValueError):
55
 
        return 80
 
41
import os
 
42
from collections import deque
56
43
 
57
44
 
58
45
def _supports_progress(f):
60
47
        return False
61
48
    if not f.isatty():
62
49
        return False
63
 
    import os
64
50
    if os.environ.get('TERM') == 'dumb':
65
51
        # e.g. emacs compile window
66
52
        return False
68
54
 
69
55
 
70
56
 
71
 
class ProgressBar(object):
 
57
def ProgressBar(to_file=sys.stderr, **kwargs):
 
58
    """Abstract factory"""
 
59
    if _supports_progress(to_file):
 
60
        return TTYProgressBar(to_file=to_file, **kwargs)
 
61
    else:
 
62
        return DotsProgressBar(to_file=to_file, **kwargs)
 
63
    
 
64
    
 
65
class _BaseProgressBar(object):
 
66
    def __init__(self,
 
67
                 to_file=sys.stderr,
 
68
                 show_pct=False,
 
69
                 show_spinner=False,
 
70
                 show_eta=True,
 
71
                 show_bar=True,
 
72
                 show_count=True,
 
73
                 to_messages_file=sys.stdout):
 
74
        object.__init__(self)
 
75
        self.to_file = to_file
 
76
        self.to_messages_file = to_messages_file
 
77
        self.last_msg = None
 
78
        self.last_cnt = None
 
79
        self.last_total = None
 
80
        self.show_pct = show_pct
 
81
        self.show_spinner = show_spinner
 
82
        self.show_eta = show_eta
 
83
        self.show_bar = show_bar
 
84
        self.show_count = show_count
 
85
 
 
86
    def note(self, fmt_string, *args, **kwargs):
 
87
        """Record a note without disrupting the progress bar."""
 
88
        self.clear()
 
89
        self.to_messages_file.write(fmt_string % args)
 
90
        self.to_messages_file.write('\n')
 
91
 
 
92
 
 
93
class DummyProgress(_BaseProgressBar):
 
94
    """Progress-bar standin that does nothing.
 
95
 
 
96
    This can be used as the default argument for methods that
 
97
    take an optional progress indicator."""
 
98
    def tick(self):
 
99
        pass
 
100
 
 
101
    def update(self, msg=None, current=None, total=None):
 
102
        pass
 
103
 
 
104
    def clear(self):
 
105
        pass
 
106
        
 
107
    def note(self, fmt_string, *args, **kwargs):
 
108
        """See _BaseProgressBar.note()."""
 
109
 
 
110
 
 
111
class DotsProgressBar(_BaseProgressBar):
 
112
    def __init__(self, **kwargs):
 
113
        _BaseProgressBar.__init__(self, **kwargs)
 
114
        self.last_msg = None
 
115
        self.need_nl = False
 
116
        
 
117
    def tick(self):
 
118
        self.update()
 
119
        
 
120
    def update(self, msg=None, current_cnt=None, total_cnt=None):
 
121
        if msg and msg != self.last_msg:
 
122
            if self.need_nl:
 
123
                self.to_file.write('\n')
 
124
            
 
125
            self.to_file.write(msg + ': ')
 
126
            self.last_msg = msg
 
127
        self.need_nl = True
 
128
        self.to_file.write('.')
 
129
        
 
130
    def clear(self):
 
131
        if self.need_nl:
 
132
            self.to_file.write('\n')
 
133
        
 
134
    
 
135
class TTYProgressBar(_BaseProgressBar):
72
136
    """Progress bar display object.
73
137
 
74
138
    Several options are available to control the display.  These can
91
155
    SPIN_CHARS = r'/-\|'
92
156
    MIN_PAUSE = 0.1 # seconds
93
157
 
94
 
    start_time = None
95
 
    last_update = None
96
 
    
97
 
    def __init__(self,
98
 
                 to_file=sys.stderr,
99
 
                 show_pct=False,
100
 
                 show_spinner=False,
101
 
                 show_eta=True,
102
 
                 show_bar=True,
103
 
                 show_count=True):
104
 
        object.__init__(self)
105
 
        self.to_file = to_file
106
 
        self.suppressed = not _supports_progress(self.to_file)
 
158
 
 
159
    def __init__(self, **kwargs):
 
160
        from bzrlib.osutils import terminal_width
 
161
        _BaseProgressBar.__init__(self, **kwargs)
107
162
        self.spin_pos = 0
108
 
 
109
 
        self.last_msg = None
110
 
        self.last_cnt = None
111
 
        self.last_total = None
112
 
        self.show_pct = show_pct
113
 
        self.show_spinner = show_spinner
114
 
        self.show_eta = show_eta
115
 
        self.show_bar = show_bar
116
 
        self.show_count = show_count
117
 
 
118
 
        self.width = _width()
 
163
        self.width = terminal_width()
 
164
        self.start_time = None
 
165
        self.last_update = None
 
166
        self.last_updates = deque()
 
167
    
 
168
 
 
169
    def throttle(self):
 
170
        """Return True if the bar was updated too recently"""
 
171
        now = time.time()
 
172
        if self.start_time is None:
 
173
            self.start_time = self.last_update = now
 
174
            return False
 
175
        else:
 
176
            interval = now - self.last_update
 
177
            if interval > 0 and interval < self.MIN_PAUSE:
 
178
                return True
 
179
 
 
180
        self.last_updates.append(now - self.last_update)
 
181
        self.last_update = now
 
182
        return False
119
183
        
120
184
 
121
185
    def tick(self):
125
189
 
126
190
    def update(self, msg, current_cnt=None, total_cnt=None):
127
191
        """Update and redraw progress bar."""
128
 
        if self.suppressed:
129
 
            return
 
192
 
 
193
        if current_cnt < 0:
 
194
            current_cnt = 0
 
195
            
 
196
        if current_cnt > total_cnt:
 
197
            total_cnt = current_cnt
130
198
 
131
199
        # save these for the tick() function
132
200
        self.last_msg = msg
133
201
        self.last_cnt = current_cnt
134
202
        self.last_total = total_cnt
135
203
            
136
 
        now = time.time()
137
 
        if self.start_time is None:
138
 
            self.start_time = now
139
 
        else:
140
 
            interval = now - self.last_update
141
 
            if interval > 0 and interval < self.MIN_PAUSE:
142
 
                return
143
 
 
144
 
        self.last_update = now
145
 
        
146
 
        if total_cnt:
147
 
            assert current_cnt <= total_cnt
148
 
        if current_cnt:
149
 
            assert current_cnt >= 0
 
204
        if self.throttle():
 
205
            return 
150
206
        
151
207
        if self.show_eta and self.start_time and total_cnt:
152
 
            eta = get_eta(self.start_time, current_cnt, total_cnt)
 
208
            eta = get_eta(self.start_time, current_cnt, total_cnt,
 
209
                    last_updates = self.last_updates)
153
210
            eta_str = " " + str_tdelta(eta)
154
211
        else:
155
212
            eta_str = ""
207
264
        self.to_file.write('\r' + m.ljust(self.width - 1))
208
265
        #self.to_file.flush()
209
266
            
210
 
 
211
 
    def clear(self):
212
 
        if self.suppressed:
213
 
            return
214
 
        
 
267
    def clear(self):        
215
268
        self.to_file.write('\r%s\r' % (' ' * (self.width - 1)))
216
269
        #self.to_file.flush()        
217
 
    
218
270
 
219
271
        
220
272
def str_tdelta(delt):
226
278
                             delt % 60)
227
279
 
228
280
 
229
 
def get_eta(start_time, current, total, enough_samples=3):
 
281
def get_eta(start_time, current, total, enough_samples=3, last_updates=None, n_recent=10):
230
282
    if start_time is None:
231
283
        return None
232
284
 
248
300
 
249
301
    assert total_duration >= elapsed
250
302
 
 
303
    if last_updates and len(last_updates) >= n_recent:
 
304
        while len(last_updates) > n_recent:
 
305
            last_updates.popleft()
 
306
        avg = sum(last_updates) / float(len(last_updates))
 
307
        time_left = avg * (total - current)
 
308
 
 
309
        old_time_left = total_duration - elapsed
 
310
 
 
311
        # We could return the average, or some other value here
 
312
        return (time_left + old_time_left) / 2
 
313
 
251
314
    return total_duration - elapsed
252
315
 
253
316
 
262
325
 
263
326
 
264
327
def demo():
265
 
    from time import sleep
 
328
    sleep = time.sleep
 
329
    
 
330
    print 'dumb-terminal test:'
 
331
    pb = DotsProgressBar()
 
332
    for i in range(100):
 
333
        pb.update('Leoparden', i, 99)
 
334
        sleep(0.1)
 
335
    sleep(1.5)
 
336
    pb.clear()
 
337
    sleep(1.5)
 
338
    
 
339
    print 'smart-terminal test:'
266
340
    pb = ProgressBar(show_pct=True, show_bar=True, show_spinner=False)
267
341
    for i in range(100):
268
342
        pb.update('Elephanten', i, 99)
270
344
    sleep(2)
271
345
    pb.clear()
272
346
    sleep(1)
 
347
 
273
348
    print 'done!'
274
349
 
275
350
if __name__ == "__main__":