IPWorks ZIP 2020 Python Edition

Questions / Feedback?

on_error Event

Information about non-fatal errors.


class JarErrorEventParams(object):
  def description() -> str: ...
  def error_code() -> int: ...
  def index() -> int: ...
  def filename() -> str: ...
  def ignore() -> bool: ...
  def ignore(value) -> None: ...

# In class Jar:
def on_error() -> Callable[[JarErrorEventParams], None]: ...
def on_error(event_hook: Callable[[JarErrorEventParams], None]) -> None: ...


The on_error event is fired when non-fatal errors occur during compression or decompression. Note that if this event is fired during decompression this may indicate that the archive is corrupt.

By default these errors will cause the component to fail with an exception. The exception may be overridden by setting Ignore to true. This will cause the error to be ignored, the file will be skipped if necessary, and the class will continue operation.

ErrorCode will correspond to one of the following errors:

1Bad or missing CRC-32 checksum.
2Failed to set creation date of a file.
111Can't open file for read (skipping).

Description contains a textual description of the error. Index and Filename contain the array index (where appropriate) and filename of the file being processed at the time of the error.

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