@xingrz/decompress NPM

@xingrz/decompress

Extracting archives made easy.

Plugins

package	version	format
@xingrz/decompress-tar		`*.tar`
@xingrz/decompress-tarbz2		`*.tar.bz2`
@xingrz/decompress-targz		`*.tar.gz`
@xingrz/decompress-tarzst		`*.tar.zst`
@xingrz/decompress-unzip		`*.zip`

Plugin API

Install

npm install --save @xingrz/decompress

Usage

import decompress from 'decompress';

const files = await decompress('unicorn.zip', 'dist');
console.log('done!');

API

`decompress(input[, output][, options])`

Returns a Promise for an array of Files in the following format:

interface File {
	path: string;
	type: 'file' | 'link' | 'symlink' | 'directory';
	mode: number;
	mtime: Date | string;
	data?: Buffer;
}

If output is not presented, data will be populated with the content of the file. Otherwise the file will be written to disk and the data will be undefined.

`input`

Type: string | Buffer

Path of file or Buffer to decompress.

`output`

Type: string (optional)

Path to output directory.

`options`

`filter`

Type: (file: File) => boolean

Filter out files before extracting. E.g:

const files = await decompress('unicorn.zip', 'dist', {
	filter: file => path.extname(file.path) !== '.exe'
});
console.log('done!');

Note that in the current implementation, filter is only applied after fully reading all files from the archive in memory. Do not rely on this option to limit the amount of memory used by decompress to the size of the files included by filter. decompress will read the entire compressed file into memory regardless.

`map`

Type: (file: File) => File

Map files before extracting: E.g:

const files = await decompress('unicorn.zip', 'dist', {
	map: file => {
		file.path = `unicorn-${file.path}`;
		return file;
	}
});
console.log('done!');