Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

yauzl-clone

Package Overview
Dependencies
Maintainers
1
Versions
6
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

yauzl-clone

Clone yauzl for patching

  • 1.0.3
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
541K
increased by0.15%
Maintainers
1
Weekly downloads
 
Created
Source

yauzl-clone.js

Clone yauzl for patching

Current status

NPM version Build Status Dependency Status Dev dependency Status Greenkeeper badge Coverage Status

Purpose

This module does not have any useful function in itself. It is purely designed to help with creating modules that modify yauzl unzipping library in some way.

yauzl-promise and yauzl-crc, for example, use this module internally.

When monkey-patching a module, it is good practice to clone the original module first so as not to alter the result of calling require('yauzl') somewhere else in your application (perhaps inside a dependency).

This module provides some helper methods for creating cloned versions of yauzl for later modification.

Usage

.clone( yauzl [, options ] )

Options are as follows (defaults shown):

{
  clone: true,
  subclassZipFile: false,
  subclassEntry: false,
  eventsIntercept: false
}
clone

Clones the yauzl object. Equivalent to Object.assign({}, yauzl).

const yauzl = require('yauzl');
const yauzlClone = require('yauzlClone');

const clone = yauzlClone(yauzl);
subclassZipFile

Creates a subclass of yauzl.ZipFile. The prototype of yauzl.ZipFile can then be altered without affecting the original.

This option also monkey patches the access methods (.open(), .fromFd(), .fromBuffer(), .testFromRandomAccessReader()) to callback with instances of this ZipFile subclass.

subclassEntry

Creates a subclass of yauzl.Entry (same idea as subclassZipFile).

This option also monkey-patches the access methods in order to intercept emitted 'entry' events and modify the emitted values to instances of the Entry subclass. events-intercept module is used internally for event interception.

eventsIntercept

Adds events-intercept methods to ZipFile prototype. This option is automatically set to true if subclassEntry option is true.

.patch( yauzl, methodName, wrapper )

Patches an access method. wrapper is called with the original method original and should return the replacement method. This API is identical to shimmer.

const yauzl = require('yauzl');
const yauzlClone = require('yauzlClone');

yauzlClone.patch( yauzl, 'fromRandomAccessReader', function(original) {
  return function(reader, totalSize, options, callback) {
    original(reader, totalSize, options, function(err, zipFile) {
      if (err) return callback(err);
      // Do something to zipFile
      callback(null, zipFile);
    });
  };
});

This method also does a couple of other useful things:

1. Arguments passed into the patched method are conformed to standard form

i.e. if no options are provided in the original call, an empty options object is created. There is no need to check for whether the 2nd or 3rd argument is the callback.

2. Always 4 arguments passed in to the patched method

.open(), .fromFd() and .fromBuffer() take 3 arguments, .fromRandomAccessReader() takes 4.

To allow patching all methods simply using the same wrapper function, the patched method will be called for .open(), .fromFd() and .fromBuffer() with an extra empty argument. original should also be called with an extra argument.

yauzlClone.patch( yauzl, 'open', function(original) {
  return function(path, unused, options, callback) {
    // NB Notice `unused` argument above
    original(reader, null, options, function(err, zipFile) {
      if (err) return callback(err);
      // Do something to zipFile
      callback(null, zipFile);
    });
  };
});

.patchAll( yauzl, wrapper )

Convenience method to patch all 4 access methods at once.

yauzlClone.patchAll( yauzl, wrapper );

// ...is equivalent to:
yauzlClone.patch( yauzl, 'open', wrapper );
yauzlClone.patch( yauzl, 'fromFd', wrapper );
yauzlClone.patch( yauzl, 'fromBuffer', wrapper );
yauzlClone.patch( yauzl, 'fromRandomAccessReader', wrapper );

Tests

Use npm test to run the tests. Use npm run cover to check coverage.

Changelog

See changelog.md

Issues

If you discover a bug, please raise an issue on Github. https://github.com/overlookmotel/yauzl-clone/issues

Contribution

Pull requests are very welcome. Please:

  • ensure all tests pass before submitting PR
  • add an entry to changelog
  • add tests for new features
  • document new functionality/API additions in README

Keywords

FAQs

Package last updated on 26 Apr 2018

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc