a streaming interface for archive generation
npm install archiver --save
You can also use npm install https://github.com/ctalkington/node-archiver/archive/master.tar.gz
to test upcoming versions.
Creates an Archiver instance based on the format (zip, tar, etc) passed. Parameters can be passed directly to Archiver
constructor for convenience.
Registers an archive format. Format modules are essentially transform streams with a few required methods. They will be further documented once a formal spec is in place.
Inherits Transform Stream methods.
Appends an input source (text string, buffer, or stream) to the instance. When the instance has received, processed, and emitted the input, the entry
event is fired.
Replaced #addFile
in v0.5.
archive.append('string', { name:'string.txt' }); archive.append(new Buffer('string'), { name:'buffer.txt' }); archive.append(fs.createReadStream('mydir/file.txt'), { name:'stream.txt' }); archive.append(null, { name:'dir/' });
Appends multiple entries from passed array of src-dest mappings. A lazystream wrapper is used to prevent issues with open file limits.
Globbing patterns are supported through use of the file-utils package. Please note that multiple src files to single dest file (ie concat) is not supported.
The data
property can be set (per src-dest mapping) to define data for matched entries.
archive.bulk([ { src: ['mydir/**'], data: { date: new Date() } }, { expand: true, cwd: 'mydir', src: ['**'], dest: 'newdir' } ]);
For more detail on this feature, please see BULK.md.
Appends a file given its filepath using a lazystream wrapper to prevent issues with open file limits. When the instance has received, processed, and emitted the file, the entry
event is fired.
archive.file('mydir/file.txt', { name:'file.txt' });
Finalizes the instance and prevents further appending to the archive structure (queue will continue til drained). The end
, close
or finish
events on the destination stream may fire right after calling this method so you should set listeners beforehand to properly detect stream completion.
You must call this method to get a valid archive and end the instance stream.
Returns the current byte length emitted by archiver. Use this in your end callback to log generated size.
Inherits Transform Stream events.
Fired when the input has been received, processed, and emitted. Passes entry data as first argument.
string
Sets the zip comment.
boolean
If true, forces the entry date to UTC. Helps with testing across timezones.
boolean
If true, all entry contents will be archived without compression by default.
object
Passed to node's zlib module to control compression. Options may vary by node version.
string
required
Sets the entry name including internal path.
string|Date
Sets the entry date. This can be any valid date string or instance. Defaults to current time in locale.
boolean
If true, entry contents will be archived without compression.
string
Sets the entry comment.
number
Sets the entry permissions. Defaults to octal 0755 (directory) or 0644 (file).
boolean
Compresses the tar archive using gzip, default is false.
object
Passed to node's zlib module to control compression. Options may vary by node version.
string
required
Sets the entry name including internal path.
string|Date
Sets the entry date. This can be any valid date string or instance. Defaults to current time in locale.
number
Sets the entry permissions. Defaults to octal 0755 (directory) or 0644 (file).
Archiver makes use of several libraries/modules to avoid duplication of efforts.