← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/progress.py

  • Committer: Martin Pool
  • Date: 2005-07-17 18:26:45 UTC
  • Revision ID: mbp@sourcefrog.net-20050717182642-9116d11beacc6bc5
- oops, set() is much faster than intset

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/progress.py
26
26
not to clutter log files.
27
27
"""
28
28
 
 
29
# TODO: remove functions in favour of keeping everything in one class
 
30
 
29
31
# TODO: should be a global option e.g. --silent that disables progress
30
32
# indicators, preferably without needing to adjust all code that
31
33
# potentially calls them.
32
34
 
33
 
# TODO: If not on a tty perhaps just print '......' for the benefit of IDEs, etc
34
 
 
35
 
# TODO: Optionally show elapsed time instead/as well as ETA; nicer
36
 
# when the rate is unpredictable
 
35
# TODO: Perhaps don't write updates faster than a certain rate, say
 
36
# 5/second.
37
37
 
38
38
 
39
39
import sys
40
40
import time
41
 
import os
42
41
 
43
42
 
44
43
def _width():
49
48
    TODO: Is there anything that gets a better update when the window
50
49
          is resized while the program is running?
51
50
    """
 
51
    import os
52
52
    try:
53
53
        return int(os.environ['COLUMNS'])
54
54
    except (IndexError, KeyError, ValueError):
60
60
        return False
61
61
    if not f.isatty():
62
62
        return False
 
63
    import os
63
64
    if os.environ.get('TERM') == 'dumb':
64
65
        # e.g. emacs compile window
65
66
        return False
67
68
 
68
69
 
69
70
 
70
 
def ProgressBar(to_file=sys.stderr, **kwargs):
71
 
    """Abstract factory"""
72
 
    if _supports_progress(to_file):
73
 
        return TTYProgressBar(to_file=to_file, **kwargs)
74
 
    else:
75
 
        return DotsProgressBar(to_file=to_file, **kwargs)
76
 
    
77
 
    
78
 
class _BaseProgressBar(object):
79
 
    def __init__(self,
80
 
                 to_file=sys.stderr,
81
 
                 show_pct=False,
82
 
                 show_spinner=False,
83
 
                 show_eta=True,
84
 
                 show_bar=True,
85
 
                 show_count=True):
86
 
        object.__init__(self)
87
 
        self.to_file = to_file
88
 
 
89
 
        self.last_msg = None
90
 
        self.last_cnt = None
91
 
        self.last_total = None
92
 
        self.show_pct = show_pct
93
 
        self.show_spinner = show_spinner
94
 
        self.show_eta = show_eta
95
 
        self.show_bar = show_bar
96
 
        self.show_count = show_count
97
 
 
98
 
 
99
 
 
100
 
class DummyProgress(_BaseProgressBar):
101
 
    """Progress-bar standin that does nothing.
102
 
 
103
 
    This can be used as the default argument for methods that
104
 
    take an optional progress indicator."""
105
 
    def tick(self):
106
 
        pass
107
 
 
108
 
    def update(self, msg=None, current=None, total=None):
109
 
        pass
110
 
 
111
 
    def clear(self):
112
 
        pass
113
 
        
114
 
    
115
 
class DotsProgressBar(_BaseProgressBar):
116
 
    def __init__(self, **kwargs):
117
 
        _BaseProgressBar.__init__(self, **kwargs)
118
 
        self.last_msg = None
119
 
        self.need_nl = False
120
 
        
121
 
    def tick(self):
122
 
        self.update()
123
 
        
124
 
    def update(self, msg=None, current_cnt=None, total_cnt=None):
125
 
        if msg and msg != self.last_msg:
126
 
            if self.need_nl:
127
 
                self.to_file.write('\n')
128
 
            
129
 
            self.to_file.write(msg + ': ')
130
 
            self.last_msg = msg
131
 
        self.need_nl = True
132
 
        self.to_file.write('.')
133
 
        
134
 
    def clear(self):
135
 
        if self.need_nl:
136
 
            self.to_file.write('\n')
137
 
        
138
 
    
139
 
class TTYProgressBar(_BaseProgressBar):
 
71
class ProgressBar(object):
140
72
    """Progress bar display object.
141
73
 
142
74
    Several options are available to control the display.  These can
159
91
    SPIN_CHARS = r'/-\|'
160
92
    MIN_PAUSE = 0.1 # seconds
161
93
 
162
 
 
163
 
    def __init__(self, **kwargs):
164
 
        _BaseProgressBar.__init__(self, **kwargs)
 
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)
165
107
        self.spin_pos = 0
166
 
        self.width = _width()
167
 
        self.start_time = None
168
 
        self.last_update = None
169
 
    
170
 
 
171
 
    def throttle(self):
172
 
        """Return True if the bar was updated too recently"""
173
 
        now = time.time()
174
 
        if self.start_time is None:
175
 
            self.start_time = self.last_update = now
176
 
            return False
177
 
        else:
178
 
            interval = now - self.last_update
179
 
            if interval > 0 and interval < self.MIN_PAUSE:
180
 
                return True
181
 
 
182
 
        self.last_update = now
183
 
        return False
184
 
        
 
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
 
185
118
 
186
119
    def tick(self):
187
120
        self.update(self.last_msg, self.last_cnt, self.last_total)
190
123
 
191
124
    def update(self, msg, current_cnt=None, total_cnt=None):
192
125
        """Update and redraw progress bar."""
 
126
        if self.suppressed:
 
127
            return
193
128
 
194
129
        # save these for the tick() function
195
130
        self.last_msg = msg
196
131
        self.last_cnt = current_cnt
197
132
        self.last_total = total_cnt
198
133
            
199
 
        if self.throttle():
200
 
            return 
 
134
        now = time.time()
 
135
        if self.start_time is None:
 
136
            self.start_time = now
 
137
        else:
 
138
            interval = now - self.last_update
 
139
            if interval > 0 and interval < self.MIN_PAUSE:
 
140
                return
 
141
 
 
142
        self.last_update = now
201
143
        
 
144
        width = _width()
 
145
 
202
146
        if total_cnt:
203
147
            assert current_cnt <= total_cnt
204
148
        if current_cnt:
238
182
 
239
183
        if self.show_bar:
240
184
            # progress bar, if present, soaks up all remaining space
241
 
            cols = self.width - 1 - len(msg) - len(spin_str) - len(pct_str) \
 
185
            cols = width - 1 - len(msg) - len(spin_str) - len(pct_str) \
242
186
                   - len(eta_str) - len(count_str) - 3
243
187
 
244
188
            if total_cnt:
259
203
 
260
204
        m = spin_str + bar_str + msg + count_str + pct_str + eta_str
261
205
 
262
 
        assert len(m) < self.width
263
 
        self.to_file.write('\r' + m.ljust(self.width - 1))
 
206
        assert len(m) < width
 
207
        self.to_file.write('\r' + m.ljust(width - 1))
264
208
        #self.to_file.flush()
265
209
            
266
210
 
267
 
    def clear(self):        
268
 
        self.to_file.write('\r%s\r' % (' ' * (self.width - 1)))
 
211
    def clear(self):
 
212
        if self.suppressed:
 
213
            return
 
214
        
 
215
        self.to_file.write('\r%s\r' % (' ' * (_width() - 1)))
269
216
        #self.to_file.flush()        
270
217
    
271
218
 
315
262
 
316
263
 
317
264
def demo():
318
 
    sleep = time.sleep
319
 
    
320
 
    print 'dumb-terminal test:'
321
 
    pb = DotsProgressBar()
322
 
    for i in range(100):
323
 
        pb.update('Leoparden', i, 99)
324
 
        sleep(0.1)
325
 
    sleep(1.5)
326
 
    pb.clear()
327
 
    sleep(1.5)
328
 
    
329
 
    print 'smart-terminal test:'
 
265
    from time import sleep
330
266
    pb = ProgressBar(show_pct=True, show_bar=True, show_spinner=False)
331
267
    for i in range(100):
332
268
        pb.update('Elephanten', i, 99)
334
270
    sleep(2)
335
271
    pb.clear()
336
272
    sleep(1)
337
 
 
338
273
    print 'done!'
339
274
 
340
275
if __name__ == "__main__":