Skip to content

SocketDev/node-zip-stream

This branch is 2 commits ahead of, 93 commits behind archiverjs/node-zip-stream:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f37b51b · Mar 10, 2021
Mar 3, 2021
Mar 3, 2021
Jan 6, 2014
Mar 3, 2021
Jan 6, 2014
May 20, 2015
Nov 19, 2020
Mar 10, 2021
Mar 10, 2021
Mar 10, 2021
Mar 10, 2021

Repository files navigation

ZipStream

zip-stream is a streaming zip archive generator based on the ZipArchiveOutputStream prototype found in the compress-commons project.

It was originally created to be a successor to zipstream.

Visit the API documentation for a list of all methods available.

Install

npm install zip-stream --save

You can also use npm install https://github.com/archiverjs/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.

const Packer = require('zip-stream');
const 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, entry) {
  if (err) throw err;
  archive.entry(null, { name: 'directory/' }, function(err, entry) {
    if (err) throw err;
    archive.finish();
  });
});

Credits

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

About

a streaming zip archive generator

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%