save Method
Compresses the archive and saves it to a file.
Syntax
def save(archive_name: str) -> None: ...
Remarks
Use this method to finalize all preparations, compress all the entries set up in files collection,and write the created archive to ArchiveName file.
This method carries out a lot of work and fires a number of events during its execution. Beforethe compression process starts, on_prepare_file event fires repeatedly to provide the summaryof what is being included into the archive. A handler of that event is a good place to makelast-minute modifications to the data sources, file names, and actions to take upon the files.
Compression of each entry is surrounded with on_before_compress_file and on_after_compress_file "brackets". Subscribe to on_before_compress_file to supply the file contents for entries with Buffer and Stream data sources. on_after_compress_fileis a good place to release the content stream alloated in the on_before_compress_file eventhandler.
on_progress event fires repeatedly to report the progress of the current and whole operations. It also provides an opportunity to abort the compression process.