IPWorks ZIP 2020 Python Edition

Questions / Feedback?

on_progress Event

Fired as progress is made.

Syntax

class ZipProgressEventParams(object):
  @property
  def data() -> bytes: ...
  @property
  def filename() -> str: ...
  @property
  def bytes_processed() -> int: ...
  @property
  def percent_processed() -> int: ...

# In class Zip:
@property
def on_progress() -> Callable[[ZipProgressEventParams], None]: ...
@on_progress.setter
def on_progress(event_hook: Callable[[ZipProgressEventParams], None]) -> None: ...

Remarks

The on_progress event is automatically fired as compression or decompression is performed. When WriteToProgressEvent is true, the output data is provided through the Data parameter, allowing for it to be streamed out.

Filename contains the name of the file being written. If no file is being written, Filename will contain an empty string, and the output data will be provided exclusively through this event.

BytesProcessed contains the total number of uncompressed bytes processed. PercentProcessed contains the percent of uncompressed bytes processed, corresponding roughly to the running time of the operation.

For Gzip extraction only, BytesProcessed and PercentProcessed will reflect the number of compressed bytes extracted, as it is generally impossible to predetermine the total uncompressed size.

If WriteToProgressEvent is false, Data will contain null.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks ZIP 2020 Python Edition - Version 20.0 [Build 8300]