SevenZipComponent

7-Zip. File archiver with high compression ratio - www.7-zip.org

[ v0.12.6+ ]

Configuration

Available compression methods

Available compression levels

Available types of archive

pack

Packing with 7-zip engine.

#[7z pack]

files

To compress selected files with default settings.

void pack.files(object files, string output [, object except][, enum format, enum method, integer level])

Individual signatures:

void pack.files(object files, string output)

void pack.files(object files, string output, object except)

void pack.files(object files, string output, enum format, enum method, integer level)

void pack.files(object files, string output, object except, enum format, enum method, integer level)

Arguments:

• files - List of files as {"f1", "path\*.dll", ..}. May contain file mask.
• output - Archive name.
• except - List of files to exclude from input list. May contain file mask.
  • requires path to file as it presented for input list, for example: { "$(dir)*.iobj", "$(dir)/rel/*.*" }
• format - Type of archive: SevenZip, Zip, GZip, BZip2, Tar, XZ
• method - Compression method: Copy, Deflate, Deflate64, BZip2, Lzma, Lzma2, Ppmd
• level - Compression level: 0 (None) to 5 (Maximum)

Samples:

#[7z pack.files({"IntelOCL.log", "IntelChipset.log"}, "ilog.7z")]
#[7z pack.files({"bin\gpp.exe", "bin\lib\*.dll"}, "gpp.7z", {"bin\lib\stub.dll"}, SevenZip, Lzma2, 4)]
#[7z pack.files({"C:\Intel\Logs\IntelAMT.log"}, "P:\s01\CodeAnalysisLog.xml"}, "D:\output.zip", Zip, Deflate, 2)]

#[7z pack.files({"bin\xscale.exe", "bin\libintl-8.dll"}, "xscale.tar", Tar, Copy, 0)]
#[7z pack.files({"xscale.tar"}, "xscale.tar.xz", XZ, Lzma2, 4)]

Notes:

• The solution directory is path by default for all input & output files.
• The \ as path separator is used for relative structure of directories in the final archive.
• The / as path separator is used for absolute structure of directories in the final archive.

#[7z pack.files({ "$(path)bin\Debug\subdir\File3.dll", "$(path)bin\Debug\File1.dll", "$(path)bin\Debug\File2.dll" }, "$(output)Archive1.zip")]

The final Archive1.zip will be:

│   File1.dll
│   File2.dll
│
└───subdir
        File3.dll

#[7z pack.files({ "$(path)bin/Debug/subdir/File3.dll", "$(path)bin/Debug/File1.dll", "$(path)bin/Debug/File2.dll" }, "$(output)Archive2.zip")]

The final Archive2.zip will be:

└───bin
    └───Debug
        │   File1.dll
        │   File2.dll
        │
        └───subdir
                File3.dll

directory

To compress selected directory with default settings.

void pack.directory(string dir, string output [, enum format, enum method, integer level])

Individual signatures:

void pack.directory(string dir, string output)

void pack.directory(string dir, string output, enum format, enum method, integer level)

Arguments:

• dir - Path to directory for packing.
• output - Archive name.
• format - Type of archive: SevenZip, Zip, GZip, BZip2, Tar, XZ
• method - Compression method: Copy, Deflate, Deflate64, BZip2, Lzma, Lzma2, Ppmd
• level - Compression level: 0 (None) to 5 (Maximum)

Samples:

#[7z pack.directory("bin", "release.zip")]
#[7z pack.directory("D:\log", "log.7z", SevenZip, Lzma2, 4)]

check

#[7z check]

Method:

Verification data of archive. Returns true if no any errors for archive.

boolean check(string file [, string pwd])

Individual signatures:

boolean check(string file)

boolean check(string file, string pwd)

Arguments:

• file - Archive for testing.
• pwd - Password of archive if requires.

Samples:

#[( !#[7z check("arch.tar.xz")] ){
    #[Build cancel = true]
}]

#[var arch = #[7z check("arch.tar.xz", "pass-123")]]

unpack

Method:

Extract archive data.

void unpack(string file [, string output][, boolean delete][, string pwd])

Individual signatures

Extract archive data into same directory:

void unpack(string file)

Extract archive data into selected directory:

void unpack(string file, string output)

Extract data from protected archive into selected directory:

void unpack(string file, string output, string pwd)

Extract archive data into selected directory and delete it after extraction if needed:

void unpack(string file, string output, boolean delete)

Extract data from protected archive into selected directory and delete it after extraction if needed:

void unpack(string file, string output, boolean delete, string pwd)

Extract archive data into same directory and delete it after extraction if needed:

void unpack(string file, boolean delete)

Extract data from protected archive into same directory and delete it after extraction if needed:

void unpack(string file, boolean delete, string pwd)

Arguments:

• file - Archive for unpacking.
• output - Output path to unpacking archive data.
• delete - To delete archive after extraction if true.
• pwd - Password of archive.

Samples:

#[7z unpack("release.7z", true)]

#[7z unpack("xscale.zip", "D:\app\xscale", false, "pass-123")]

References

• 7-zip engine
• SBE-Scripts
  • ConditionComponent
• Examples & Features
• Compression
  • Methods:
    • Deflate
    • Deflate64
    • BZip2
    • Lzma
    • Lzma2
    • Ppmd
  • Formats:
    • SevenZip
    • Zip
    • GZip
    • BZip2
    • Tar
    • XZ