quill-tar

0.2.2 • Public • Published

quill-tar

quill-tar contains utility functions for packing and unpacking quill system tarballs.

Motivation

Unpacking system tarballs is a fundamental piece of functionality that will be reused in multiple parts of conservatory

Usage

There are two core methods:

  • quillTar.pack(tarball, dir, files, callback)
@tarball {string|Stream} Location of the tarball to create or stream to pipe to.
@dir {string} Base directoty the tarball is being created from.
@files {Array} List of files to include in the tarball
@callback {function} Continuation to respond to when complete.
  • quillTar.unpack(tarball, target, options, callback)
@tarball {string} Path to the tarball to untar.
@target {string} Parent directory to untar into
@options {Object} Options for untaring
@callback {function} Continuation to respond to when complete

Lets take a look at some sample usage:

  var quillTar = require('quill-tar');
  
  quillTar.unpack(
    '/path/to/some/tarball.tgz',
    '/parent/dir/to/untar/into',
    {
      modes: {
        exec: 0777 & (~022), 
        file: 0666 & (~022),
        umask: 022
      }
    },
    function (err, target) {
      //
      // This will output the absolute path of the directory
      // processed by `quill-tar`
      //
      console.dir(target);
    }
  );

Installation

Installing npm (node package manager)

  $ curl http://npmjs.org/install.sh | sh

Installing quill-tar

  $ npm install quill-tar

Tests

All tests are written with vows:

  $ npm test

Authors

Nodejitsu Inc

License and Attribution

  • (C) 2011, Isaac Schlueter
  • (C) 2012, Nodejitsu Inc.
  • Adapted from npm under MIT.
  • Adapted License: Private and not Open Source

Dependents (2)

Package Sidebar

Install

npm i quill-tar

Weekly Downloads

1

Version

0.2.2

License

none

Last publish

Collaborators

  • indexzero
  • bmeck