zip-a-folder

Easy to use zip (or tar) a complete folder plain into a zip file including compression ratio handling and custom write streams.

Basic Usage

Install via npm

npm install zip-a-folder

Creating a ZIP file

1import { zip } from 'zip-a-folder';
2
3class TestMe {
4
5    static async main() {
6        await zip('/path/to/the/folder', '/path/to/archive.zip');
7    }
8}
9
10TestMe.main();

Creating a gzipped TAR file

1import { tar } from 'zip-a-folder';
2
3class TestMe {
4
5    static async main() {
6        await tar('/path/to/the/folder', '/path/to/archive.tgz');
7    }
8}
9
10TestMe.main();

Compression handling

For the sake of easy use, supported compression levels are (by now): COMPRESSION_LEVEL.high, COMPRESSION_LEVEL.medium or COMPRESSION_LEVEL.uncompressed.

The default compression - level is high.

1import { zip, COMPRESSION_LEVEL } from 'zip-a-folder';
2
3class TestMe {
4
5    static async main() {
6        await zip('/path/to/the/folder', '/path/to/archive.zip', {compression: COMPRESSION_LEVEL.high});
7    }
8}
9
10TestMe.main();

Custom writeStreams

You can now pipe output to any WriteStream (just pass WriteStream as a parameter).

To keep the existing api stable the 2nd parameter (targetFilePath) can now be either undefined or an empty string.

ATTENTION: customWritestreams cannot be checked. So it is up to the user to check on non existing target folders or if the targetfolder equals to the sourcefolder (which leads to a circularity).

1import { zip, COMPRESSION_LEVEL } from 'zip-a-folder';
2import { fs } from 'fs';
3
4class TestMe {
5    static async main() {
6        const customWS = fs.createWriteStream('test/1234.zip');
7        await zipafolder.zip(path.resolve(__dirname, 'data/'), undefined, {customWriteStream: customWS});    
8    }
9}
10
11TestMe.main();

Tests

Tests can be found in /test and run by jest. To run the tests call npm test.

Thanks

• Special thanks to @sole for her initial work.
• Thanks to YOONBYEONGIN
• Thanks to Wunschik
• Thanks to ratbeard
• Thanks to Xotabu4