node-7z

node-7z

A Node.js wrapper for 7-Zip

Usage

I chose to use Promises in this library. API is consistent with standard use:

var Zip = require('node-7z'); // Name the class as you want!
var myTask = new Zip();
myTask.extractFull('myArchive.7z', 'destination', { p: 'myPassword' })

// Equivalent to `on('data', function (files) { // ... });`
.progress(function (files) {
  console.log('Some files are extracted: %s', files);
});

// When all is done
.then(function () {
  console.log('Extracting done!');
});

// On error
.catch(function (err, code) {
  console.error('7-Zip exit with code %i', code);
  console.error(err);
});

Installation

You must have the 7za executable available in your PATH or in the same directory of your package.json file.

On Debian an Ubuntu install the p7zip-full package.

On Windows use the 7za.exe (link here) binary.

npm install --save node-7z

API

See the 7-Zip documentation for the full list of usages and options (switches).

Add: Zip.add

Arguments

• archive Path to the archive you want to create.
• files The file list to add.
• options An object of options (7-Zip switches).

Progress

• files A array of all the extracted files AND directories. The / character is used as a path separator on every platform.

Error

• err An Error object.

Delete: Zip.delete

Arguments

• archive Path to the archive you want to delete files from.
• files The file list to delete.
• options An object of options (7-Zip switches).

Error

• err An Error object.

Extract: Zip.extract

Arguments

• archive The path to the archive you want to extract.
• dest Where to extract the archive.
• options An object of options.

Progress

• files A array of all the extracted files AND directories. The / character is used as a path separator on every platform.

Error

• err An Error object.

Extract with full paths: Zip.extractFull

Arguments

• archive The path to the archive you want to extract.
• dest Where to extract the archive (creates folders for you).
• options An object of options.

Progress

• files A array of all the extracted files AND directories. The / character is used as a path separator on every platform.

Error

• err An Error object.

List contents of archive: Zip.list

Arguments

• archive The path to the archive you want to analyse.
• options An object of options.

Progress

• files A array of objects of all the extracted files AND directories. The / character is used as a path separator on every platform. Object's properties are: date, attr, size and name.

Fulfill

• spec An object of tech spec about the archive. Properties are: path, type, method, physicalSize and headersSize (Some of them may be missing with non-7z archives).

Error

• err An Error object.

Test integrity of archive: Zip.test

Arguments

• archive The path to the archive you want to analyse.
• options An object of options.

Progress

• files A array of all the extracted files AND directories. The / character is used as a path separator on every platform.

Error

• err An Error object.

Update: Zip.update

Arguments

• archive Path to the archive you want to update.
• files The file list to update.
• options An object of options (7-Zip switches).

Progress

• files A array of all the extracted files AND directories. The / character is used as a path separator on every platform.

Error

• err An Error object.

---

With :heart: from quentinrossetti

Changelog

0.1.0 (2014-08-26)

• Code quality tools (360cd10)
• JSHint (e9a0638)
• More test fixtures (08824e1)
• Reformat test folder (fbebb35)
• Replace rimraf by fs-extra (d11ddd1)
• Use 7za executable instead of 7z (712ddf5)
• v0.1.0 (153fff1)
• Features: Add, delete and update (27f2282)
• Feature: Add (aafa4b0)