Skip to content

archiverjs/node-zip-stream

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

zip-stream v0.1.2 Build Status

zip-stream is a streaming zip generator. It was built to be a successor to zipstream. Dependencies are kept to a minimum through the use of many of node's built-in modules including the use of zlib module for compression.

Install

npm install zip-stream --save

You can also use npm install https://github.com/ctalkington/node-zip-stream/archive/master.tar.gz to test upcoming versions.

Usage

This module is meant to be wrapped internally by other modules and therefore lacks any queue management. This means you have to wait until the previous entry has been fully consumed to add another. Nested callbacks should be used to add multiple entries. There are modules like async that ease the so called "callback hell".

If you want a module that handles entry queueing and much more, you should check out archiver which uses this module internally.

var packer = require('zip-stream');
var archive = new packer(); // OR new packer(options)

archive.on('error', function(err) {
  throw err;
});

// pipe archive where you want it (ie fs, http, etc)
// listen to the destination's end, close, or finish event

archive.entry('string contents', { name: 'string.txt' }, function(err) {
  if (err) throw err;

  archive.finalize();
});

Instance API

entry(input, data, callback(err))

Appends an input source (text string, buffer, or stream) to the instance. When the instance has received, processed, and emitted the input, the callback is fired.

finalize()

Finalizes the instance. You should listen to the destination stream's end/close/finish event to know when all output has been safely consumed.

Instance Options

comment string

Sets the zip comment.

forceUTC boolean

If true, forces the file date and time to UTC. Helps with testing across timezones.

zlib object

Passed to node's zlib module to control compression. Options may vary by node version.

Entry Data

name string required

Sets the entry name including internal path.

type string

Sets the entry type. Defaults to file. (allowed types to be expanded in future)

date string|Date

Sets the entry date. This can be any valid date string or instance. Defaults to current time in locale.

store boolean

If true, entry contents will be stored without compression.

comment string

Sets the entry comment.

mode number

Sets the entry permissions. (experimental)

Things of Interest

Credits

Concept inspired by Antoine van Wel's zipstream module, which is no longer being updated.