@curiousdannii/node-7z

    0.4.1 • Public • Published

    node-7z

    Dependencies Status Build Status Code coverage Code quality Release

    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) {
      console.error(err);
    });

    Installation

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

    On Debian and Ubuntu install the p7zip-full package.

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

    On Mac OSX use Homebrew brew install p7zip

    npm install --save node-7z
    

    API

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

    The type of the list of files can be either String or Array.

    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.

    Advanced usage

    Compression method

    With the 7za binary compression is made like that:

    # adds *.exe and *.dll files to solid archive archive.7z using LZMA method
    # with 2 MB dictionary and BCJ filter.
    7z a archive.7z *.exe -m0=BCJ -m1=LZMA:d=21

    With node-7z you can translate it like that:

    var archive = new Zip();
    archive.add('archive.7z', '*.exe', {
      m0: '=BCJ',
      m1: '=LZMA:d=21'
    })
    .then(function () {
      // Do stuff...
    });

    Add, delete and update multiple files

    When adding, deleting or updating archives you can pass either a string or an array as second parameter (the files parameter).

    var archive = new Zip();
    archive.delete('bigArchive.7z', [ 'file1', 'file2' ])
    .then(function () {
      // Do stuff...
    });

    Wildcards

    You can extract with wildcards to specify one or more file extensions. To do this add a wildcards attribute to the options object. The wildcard attribute takes an Array as value. In this array each item is a wildcard.

    var archive = new Zip();
    archive.extractFull('archive.zip', 'destination/', {
      wildcards: [ '*.txt', '*.md' ], // extract all text and Markdown files
      r: true // in each subfolder too
    })
    .progress(function (files) {
      // Do stuff with files...
    })
    .then(function () {
      // Do stuff...
    });

    Note that the r (for recursive) attribute is passed in this example.

    Raw inputs

    Thanks to sketchpunk #9 for this one

    Sometimes you just want to use the lib as the original command line. For instance you want to apply to switches with different values (e.g.: -i!*.jpg -i!*.png to target only two types of extensions).

    In such cases the default behavior of the options argument is not enough. You can use the custom raw key in your options object and pass it an Array of values.

    var archive = new Zip();
    archive.list('archive.zip', {
      raw: [ '-i!*.jpg', '-i!*.png' ], // only images
    })
    .progress(function (files) {
      // Do stuff with files...
    })
    .then(function () {
      // Do stuff...
    });

    With ❤️ from quentinrossetti

    Install

    npm i @curiousdannii/node-7z

    DownloadsWeekly Downloads

    0

    Version

    0.4.1

    License

    ISC

    Last publish

    Collaborators

    • curiousdannii