Browse Source

zlib: allow passing options to convenience methods

v0.11.1-release
Kyle Robinson Young 12 years ago
committed by Ben Noordhuis
parent
commit
74ef949072
  1. 25
      doc/api/zlib.markdown
  2. 56
      lib/zlib.js
  3. 65
      test/simple/test-zlib-convenience-methods.js

25
doc/api/zlib.markdown

@ -187,37 +187,35 @@ the header.
<!--type=misc--> <!--type=misc-->
All of these take a string or buffer as the first argument, and call the All of these take a string or buffer as the first argument, an optional second
supplied callback with `callback(error, result)`. The argument to supply options to the zlib classes and will call the supplied
compression/decompression engine is created using the default settings callback with `callback(error, result)`.
in all convenience methods. To supply different options, use the
zlib classes directly.
## zlib.deflate(buf, callback) ## zlib.deflate(buf, [options], callback)
Compress a string with Deflate. Compress a string with Deflate.
## zlib.deflateRaw(buf, callback) ## zlib.deflateRaw(buf, [options], callback)
Compress a string with DeflateRaw. Compress a string with DeflateRaw.
## zlib.gzip(buf, callback) ## zlib.gzip(buf, [options], callback)
Compress a string with Gzip. Compress a string with Gzip.
## zlib.gunzip(buf, callback) ## zlib.gunzip(buf, [options], callback)
Decompress a raw Buffer with Gunzip. Decompress a raw Buffer with Gunzip.
## zlib.inflate(buf, callback) ## zlib.inflate(buf, [options], callback)
Decompress a raw Buffer with Inflate. Decompress a raw Buffer with Inflate.
## zlib.inflateRaw(buf, callback) ## zlib.inflateRaw(buf, [options], callback)
Decompress a raw Buffer with InflateRaw. Decompress a raw Buffer with InflateRaw.
## zlib.unzip(buf, callback) ## zlib.unzip(buf, [options], callback)
Decompress a raw Buffer with Unzip. Decompress a raw Buffer with Unzip.
@ -225,8 +223,7 @@ Decompress a raw Buffer with Unzip.
<!--type=misc--> <!--type=misc-->
Each class takes an options object. All options are optional. (The Each class takes an options object. All options are optional.
convenience methods use the default settings for all options.)
Note that some options are only relevant when compressing, and are Note that some options are only relevant when compressing, and are
ignored by the decompression classes. ignored by the decompression classes.

56
lib/zlib.js

@ -107,32 +107,60 @@ exports.createUnzip = function(o) {
// Convenience methods. // Convenience methods.
// compress/decompress a string or buffer in one step. // compress/decompress a string or buffer in one step.
exports.deflate = function(buffer, callback) { exports.deflate = function(buffer, opts, callback) {
zlibBuffer(new Deflate(), buffer, callback); if (typeof opts === 'function') {
callback = opts;
opts = {};
}
zlibBuffer(new Deflate(opts), buffer, callback);
}; };
exports.gzip = function(buffer, callback) { exports.gzip = function(buffer, opts, callback) {
zlibBuffer(new Gzip(), buffer, callback); if (typeof opts === 'function') {
callback = opts;
opts = {};
}
zlibBuffer(new Gzip(opts), buffer, callback);
}; };
exports.deflateRaw = function(buffer, callback) { exports.deflateRaw = function(buffer, opts, callback) {
zlibBuffer(new DeflateRaw(), buffer, callback); if (typeof opts === 'function') {
callback = opts;
opts = {};
}
zlibBuffer(new DeflateRaw(opts), buffer, callback);
}; };
exports.unzip = function(buffer, callback) { exports.unzip = function(buffer, opts, callback) {
zlibBuffer(new Unzip(), buffer, callback); if (typeof opts === 'function') {
callback = opts;
opts = {};
}
zlibBuffer(new Unzip(opts), buffer, callback);
}; };
exports.inflate = function(buffer, callback) { exports.inflate = function(buffer, opts, callback) {
zlibBuffer(new Inflate(), buffer, callback); if (typeof opts === 'function') {
callback = opts;
opts = {};
}
zlibBuffer(new Inflate(opts), buffer, callback);
}; };
exports.gunzip = function(buffer, callback) { exports.gunzip = function(buffer, opts, callback) {
zlibBuffer(new Gunzip(), buffer, callback); if (typeof opts === 'function') {
callback = opts;
opts = {};
}
zlibBuffer(new Gunzip(opts), buffer, callback);
}; };
exports.inflateRaw = function(buffer, callback) { exports.inflateRaw = function(buffer, opts, callback) {
zlibBuffer(new InflateRaw(), buffer, callback); if (typeof opts === 'function') {
callback = opts;
opts = {};
}
zlibBuffer(new InflateRaw(opts), buffer, callback);
}; };
function zlibBuffer(engine, buffer, callback) { function zlibBuffer(engine, buffer, callback) {

65
test/simple/test-zlib-convenience-methods.js

@ -0,0 +1,65 @@
// Copyright Joyent, Inc. and other Node contributors.
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to permit
// persons to whom the Software is furnished to do so, subject to the
// following conditions:
//
// The above copyright notice and this permission notice shall be included
// in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
// USE OR OTHER DEALINGS IN THE SOFTWARE.
// test convenience methods with and without options supplied
var common = require('../common.js');
var assert = require('assert');
var zlib = require('zlib');
var hadRun = 0;
var expect = 'blahblahblahblahblahblah';
var opts = {
level: 9,
chunkSize: 1024,
};
[
['gzip', 'gunzip'],
['gzip', 'unzip'],
['deflate', 'inflate'],
['deflateRaw', 'inflateRaw'],
].forEach(function(method) {
zlib[method[0]](expect, opts, function(err, result) {
zlib[method[1]](result, opts, function(err, result) {
assert.equal(result, expect,
'Should get original string after ' +
method[0] + '/' + method[1] + ' with options.');
hadRun++;
});
});
zlib[method[0]](expect, function(err, result) {
zlib[method[1]](result, function(err, result) {
assert.equal(result, expect,
'Should get original string after ' +
method[0] + '/' + method[1] + ' without options.');
hadRun++;
});
});
});
process.on('exit', function() {
assert.equal(hadRun, 8, 'expect 8 compressions');
});
Loading…
Cancel
Save