Skip to content

mapbox/node-zipfile

node-zipfile

Bindings to libzip for handling zipfile archives in node.

Build StatusBuild statusDependenciesCoverage Status

Example

varzipfile=require('zipfile');// Creating a zipfile objectvarzf=newzipfile.ZipFile('./test/data/world_merc.zip');// the zipfile has a list of names:// zf.names[0] === 'world_merc.prj'// the zipfile also has a count property that is the number of files contained// zf.count == 2// finally it has a readFile method that uncompresses a single file// into a Buffer objectzf.readFile('world_merc.prj',function(err,buffer){if(err)throwerr;console.log(buffer.toString());});

Large files

To handle large zipfiles and avoid the overhead of passing data from C++ to JS use the copyFile interface:

varzipfile=require('zipfile');varzf=newzipfile.ZipFile('./test/data/world_merc.zip');varzip_entry_name='world_merc.shp';varoutput_file='out/world_merc.shp';zf.copyFile(zip_entry_name,output_file,function(err){if(err)throwerr;console.log('Successfully wrote '+output_file);});

Depends

  • Node v0.10.x, v4.x, v5.x, or v6.x

Installation

Install from binary:

npm install 

Install from source:

npm install --build-from-source 

Dynamically linking against libzip

node-zipfile depends on libzip, but by default bundles a copy in deps/ which is statically linked and packaged as a binary.

If you want to use an external libzip first install it:

Debian:

sudo apt-get install libzip-dev libzip1 

OS X:

brew install libzip 

Then configure node-zipfile with the --shared_libzip option:

npm install --build-from-source --shared_libzip 

If you installed libzip in a custom location then configure like:

npm install --build-from-source --shared_libzip \ --shared_libzip_includes=/opt/local/include \ --shared_libzip_libpath=/opt/local/lib 

If you installed libzip with homebrew do:

npm install --build-from-source --shared_libzip \ --shared_libzip_includes=`brew --prefix`/include \ --shared_libzip_libpath=`brew --prefix`/lib 

License

BSD, see LICENSE.txt

About

Inspect and uncompress zipfile archives in Node.js

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 9