Progress reporters

Note

Concrete classes described in this chapter implement methods defined in AbstractProgressListener

class b2sdk.v1.AbstractProgressListener[source]

Interface expected by B2Api upload and download methods to report on progress.

This interface just accepts the number of bytes transferred so far. Subclasses will need to know the total size if they want to report a percent done.

abstract set_total_bytes(total_byte_count)[source]

Always called before __enter__ to set the expected total number of bytes.

May be called more than once if an upload is retried.

Parameters

total_byte_count (int) – expected total number of bytes

abstract bytes_completed(byte_count)[source]

Report the given number of bytes that have been transferred so far. This is not a delta, it is the total number of bytes transferred so far.

Transfer can fail and restart from beginning so byte count can decrease between calls.

Parameters

byte_count (int) – number of bytes have been transferred

close()[source]

Must be called when you’re done with the listener. In well-structured code, should be called only once.

class b2sdk.v1.TqdmProgressListener(description, *args, **kwargs)[source]

Progress listener based on tqdm library.

class b2sdk.v1.SimpleProgressListener(description, *args, **kwargs)[source]

Just a simple progress listener which prints info on a console.

class b2sdk.v1.DoNothingProgressListener[source]

This listener gives no output whatsoever.

class b2sdk.v1.ProgressListenerForTest(*args, **kwargs)[source]

Capture all of the calls so they can be checked.

b2sdk.v1.make_progress_listener(description, quiet)[source]

Return a progress listener object depending on some conditions.

Parameters
  • description (str) – listener description

  • quiet (bool) – if True, do not output anything

Returns

a listener object