/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to breezy/progress.py

  • Committer: Jelmer Vernooij
  • Date: 2020-04-05 19:11:34 UTC
  • mto: (7490.7.16 work)
  • mto: This revision was merged to the branch mainline in revision 7501.
  • Revision ID: jelmer@jelmer.uk-20200405191134-0aebh8ikiwygxma5
Populate the .gitignore file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
 
 
18
17
"""Progress indicators.
19
18
 
20
 
The usual way to use this is via bzrlib.ui.ui_factory.nested_progress_bar which
 
19
The usual way to use this is via breezy.ui.ui_factory.nested_progress_bar which
21
20
will manage a conceptual stack of nested activities.
22
21
"""
23
22
 
 
23
from __future__ import absolute_import
24
24
 
25
 
import sys
26
25
import time
27
26
import os
28
27
 
29
28
 
30
 
from bzrlib.symbol_versioning import (
31
 
    deprecated_in,
32
 
    deprecated_method,
33
 
    )
34
 
 
35
 
 
36
29
def _supports_progress(f):
37
30
    """Detect if we can use pretty progress bars on file F.
38
31
 
65
58
    Code updating the task may also set fields as hints about how to display
66
59
    it: show_pct, show_spinner, show_eta, show_count, show_bar.  UIs
67
60
    will not necessarily respect all these fields.
68
 
    
 
61
 
 
62
    The message given when updating a task must be unicode, not bytes.
 
63
 
69
64
    :ivar update_latency: The interval (in seconds) at which the PB should be
70
65
        updated.  Setting this to zero suggests every update should be shown
71
66
        synchronously.
72
67
 
73
68
    :ivar show_transport_activity: If true (default), transport activity
74
 
        will be shown when this task is drawn.  Disable it if you're sure 
 
69
        will be shown when this task is drawn.  Disable it if you're sure
75
70
        that only irrelevant or uninteresting transport activity can occur
76
71
        during this task.
77
72
    """
83
78
 
84
79
        :param progress_view: ProgressView to display this ProgressTask.
85
80
 
86
 
        :param ui_factory: The UI factory that will display updates; 
 
81
        :param ui_factory: The UI factory that will display updates;
87
82
            deprecated in favor of passing progress_view directly.
88
83
 
89
84
        Normally you should not call this directly but rather through
113
108
            self.msg)
114
109
 
115
110
    def update(self, msg, current_cnt=None, total_cnt=None):
 
111
        """Report updated task message and if relevent progress counters
 
112
 
 
113
        The message given must be unicode, not a byte string.
 
114
        """
116
115
        self.msg = msg
117
116
        self.current_cnt = current_cnt
118
117
        if total_cnt:
133
132
 
134
133
    def make_sub_task(self):
135
134
        return ProgressTask(self, ui_factory=self.ui_factory,
136
 
            progress_view=self.progress_view)
 
135
                            progress_view=self.progress_view)
137
136
 
138
137
    def _overall_completion_fraction(self, child_fraction=0.0):
139
138
        """Return fractional completion of this task and its parents
140
139
 
141
140
        Returns None if no completion can be computed."""
142
141
        if self.current_cnt is not None and self.total_cnt:
143
 
            own_fraction = (float(self.current_cnt) + child_fraction) / self.total_cnt
 
142
            own_fraction = (float(self.current_cnt) +
 
143
                            child_fraction) / self.total_cnt
144
144
        else:
145
145
            # if this task has no estimation, it just passes on directly
146
146
            # whatever the child has measured...
152
152
                own_fraction = 0.0
153
153
            return self._parent_task._overall_completion_fraction(own_fraction)
154
154
 
155
 
    @deprecated_method(deprecated_in((2, 1, 0)))
156
 
    def note(self, fmt_string, *args):
157
 
        """Record a note without disrupting the progress bar.
158
 
        
159
 
        Deprecated: use ui_factory.note() instead or bzrlib.trace.  Note that
160
 
        ui_factory.note takes just one string as the argument, not a format
161
 
        string and arguments.
162
 
        """
163
 
        if args:
164
 
            self.ui_factory.note(fmt_string % args)
165
 
        else:
166
 
            self.ui_factory.note(fmt_string)
167
 
 
168
155
    def clear(self):
169
156
        # TODO: deprecate this method; the model object shouldn't be concerned
170
157
        # with whether it's shown or not.  Most callers use this because they
178
165
        else:
179
166
            self.ui_factory.clear_term()
180
167
 
181
 
 
182
 
# NOTE: This is also deprecated; you should provide a ProgressView instead.
183
 
class _BaseProgressBar(object):
184
 
 
185
 
    def __init__(self,
186
 
                 to_file=None,
187
 
                 show_pct=False,
188
 
                 show_spinner=False,
189
 
                 show_eta=False,
190
 
                 show_bar=True,
191
 
                 show_count=True,
192
 
                 to_messages_file=None,
193
 
                 _stack=None):
194
 
        object.__init__(self)
195
 
        if to_file is None:
196
 
            to_file = sys.stderr
197
 
        if to_messages_file is None:
198
 
            to_messages_file = sys.stdout
199
 
        self.to_file = to_file
200
 
        self.to_messages_file = to_messages_file
201
 
        self.last_msg = None
202
 
        self.last_cnt = None
203
 
        self.last_total = None
204
 
        self.show_pct = show_pct
205
 
        self.show_spinner = show_spinner
206
 
        self.show_eta = show_eta
207
 
        self.show_bar = show_bar
208
 
        self.show_count = show_count
209
 
        self._stack = _stack
210
 
        # seed throttler
211
 
        self.MIN_PAUSE = 0.1 # seconds
212
 
        now = time.time()
213
 
        # starting now
214
 
        self.start_time = now
215
 
        # next update should not throttle
216
 
        self.last_update = now - self.MIN_PAUSE - 1
217
 
 
218
 
    def finished(self):
219
 
        """Return this bar to its progress stack."""
220
 
        self.clear()
221
 
        self._stack.return_pb(self)
222
 
 
223
 
    def note(self, fmt_string, *args, **kwargs):
224
 
        """Record a note without disrupting the progress bar."""
225
 
        self.clear()
226
 
        self.to_messages_file.write(fmt_string % args)
227
 
        self.to_messages_file.write('\n')
 
168
    def __enter__(self):
 
169
        return self
 
170
 
 
171
    def __exit__(self, exc_type, exc_val, exc_tb):
 
172
        self.finished()
 
173
        return False
228
174
 
229
175
 
230
176
class DummyProgress(object):
248
194
    def clear(self):
249
195
        pass
250
196
 
251
 
    def note(self, fmt_string, *args, **kwargs):
252
 
        """See _BaseProgressBar.note()."""
253
 
 
254
197
    def child_progress(self, **kwargs):
255
198
        return DummyProgress(**kwargs)
256
199
 
259
202
    if delt is None:
260
203
        return "-:--:--"
261
204
    delt = int(round(delt))
262
 
    return '%d:%02d:%02d' % (delt/3600,
263
 
                             (delt/60) % 60,
 
205
    return '%d:%02d:%02d' % (delt / 3600,
 
206
                             (delt / 60) % 60,
264
207
                             delt % 60)
265
208
 
266
209
 
267
 
def get_eta(start_time, current, total, enough_samples=3, last_updates=None, n_recent=10):
 
210
def get_eta(start_time, current, total, enough_samples=3, last_updates=None,
 
211
            n_recent=10):
268
212
    if start_time is None:
269
213
        return None
270
214
 
298
242
 
299
243
class ProgressPhase(object):
300
244
    """Update progress object with the current phase"""
 
245
 
301
246
    def __init__(self, message, total, pb):
302
247
        object.__init__(self)
303
248
        self.pb = pb