YGZipLib 1.0.12

YGZipLib

YGZipLib is a compression/decompression library for ZIP archives.

Features

Compression/decompression processes are performed in multiprocessing
AES encryption support

Usage

• Compression method

    using YGZipLib;

    public void Compress()
    {
         using(ZipArcClass zipArc = new ZipArcClass(@"R:\example.zip"))
         {
             // Compression Option Setting
             zipArc.EncryptionOption = ZipArcClass.ENCRYPTION_OPTION.AES256;
             zipArc.Password = "password";
             // single file compression
             zipArc.AddFilePath(@"R:\example_file.txt");
             // directory compression
             zipArc.AddDirectory(@"R:\example_dir");
             // Finish call
             zipArc.Finish();
         }
     }

• Decompression Method

    using YGZipLib;
    using System.Collections.Generic;
    using System.IO;

    public void Decompress()
    {
        using(UnZipArcClass unzipArc = new UnZipArcClass(@"R:\example.zip"))
        {
            // Set password if the file is encrypted.
            unzipArc.Password = "password";

            // --- Processed per file ---
            // Obtaining a list of files in a ZIP archive
            List<UnZipArcClass.CentralDirectoryInfo> dirList = unzipArc.GetFileList;
            // Loop and process
            dirList.FindAll(d => d.IsDirectory == false).ForEach(d => unzipArc.PutFile(d, Path.Combine(@"R:\uncompressdir", d.FileName)));

            // --- batch directory processing ---
            unzipArc.ExtractAllFiles(new DirectoryInfo(@"R:\uncompressdir"));
        }
    }

• Output ZIP file as Stream by web service, etc.

    using YGZipLib;
    using System.IO;

    /// <summary>
    /// Example of sending a ZIP file via a web service, etc.
    /// </summary>
    /// <param name="resStream"></param>
    public async void SendZipFile (Stream resStream)
    {
        using(ZipArcClass zip = new ZipArcClass(resStream))
        {
            await zip.AddFileStreamAsync("example1.dat", stream1);
            await zip.AddFileStreamAsync("/dir/example2.dat", stream2);
            await zip.FinishAsync();
        }
    }

• Other Settings

ZipArcClass

    // Processing multiplicity and working directory
    // ProcessorCount or 4, whichever is smaller. 0 is the default value.
    // For slow storage, process multiplexing should be lowered.
    // The working directory should be a fast device; if null is specified, it is automatically set from the environment.
    YGZipLib.ZipArcClass zip = new ZipArcClass(@"D:\zipfile.zip", 8, @"R:\temp");

    // Only archive without compression
    zip.CompressionOption = ZipArcClass.COMPRESSION_OPTION.NOT_COMPRESSED;

    // If you want the file to be uncompressed, specify the extension with a regular expression.
    zip.DontCompressExtRegExList.Add(new Regex("jpg", RegexOptions.IgnoreCase));
    zip.DontCompressExtRegExList.Add(new Regex("xls.*", RegexOptions.IgnoreCase));

    // Encryption Algorithms
    zip.EncryptionOption = ZipArcClass.ENCRYPTION_OPTION.TRADITIONAL;   // default
    zip.EncryptionOption = ZipArcClass.ENCRYPTION_OPTION.AES256;        // AES 256bit

    // The file name to be stored is the code page obtained from System.Text.Encoding.Default.CodePage.
    // Default.CodePage is utf8 except for .net Framework, so set the appropriate encoding if necessary.
    // Non-.net Framework environments may require the encoding provider to be registered at the beginning of the program.
    // System.Text.Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
    zip.ZipFileNameEncoding = System.Text.Encoding.GetEncoding("shift-jis");

UnZipArcClass

    // Get list of stored files.
    List<YGZipLib.UnZipArcClass.CentralDirectoryInfo> dirList = unzip.GetFileList;

    // TextEncodings of stored files.
    // See ZipArcClass
    unzip.ZipFileNameEncoding = System.Text.Encoding.GetEncoding("shift-jis");

    // Processing multiplicity
    // See ZipArcClass
    // Working directory is not used during unzip.
    YGZipLib.UnZipArcClass unzip = new UnZipArcClass(@"D:\zipfile.zip", 4);

Note

Finish should be called at the end when creating a ZIP archive.

License

"YGZipLib" is under MIT license

This library includes the work that is distributed in the Apache License 2.0.
The Deflate64 code included in YGZipLib is based on the following java source from Apache Commons Compress™.