stealthy-require

Stealthy-Require

This is probably the closest you can currently get to require something in node.js with completely bypassing the require cache.

The restrictions are:

• Native modules cannot be required twice. Thus this module bypasses the require cache only for non-native (e.g. JS) modules.
• The require cache is only bypassed for all operations that happen synchronously when a module is required. If a module lazy loads another module at a later time that require call will not bypass the cache anymore.

This means you should have a close look at all internal require calls before you decide to use this library.

Installation

This is a module for node.js and is installed via npm:

npm install stealthy-require --save

Usage

Let's say you want to bypass the require cache for this require call:

var request = require('request');

With stealthy-require you can do that like this:

var stealthyRequire = require('stealthy-require')(require);

var requestFresh = stealthyRequire('request');

The require cache is bypassed for the module you require (i.e. request) as well as all modules the module requires (i.e. http and many more).

Contributing

To set up your development environment for stealthy-require:

1. Clone this repo to your desktop,
2. in the shell cd to the main folder,
3. hit npm install,
4. hit npm install gulp -g if you haven't installed gulp globally yet, and
5. run gulp dev. (Or run node ./node_modules/.bin/gulp dev if you don't want to install gulp globally.)

gulp dev watches all source files and if you save some changes it will lint the code and execute all tests. The test coverage report can be viewed from ./coverage/lcov-report/index.html.

If you want to debug a test you should use gulp test-without-coverage to run all tests without obscuring the code by the test coverage instrumentation.

Change History

• v0.1.0 (2016-05-26)
  • Initial version

License (ISC)

In case you never heard about the ISC license it is functionally equivalent to the MIT license.

See the LICENSE file for details.