For use in tests only! require() using a relative path from the root directory of the present module
Want to see pretty graphs? Log in now!
npm install root-require
|4||downloads in the last day|
|73||downloads in the last week|
|284||downloads in the last month|
|Last Published By|
|Version||0.3.1 last updated 3 months ago|
|Keywords||root, require, relative|
a more convenient require method for running TESTS ONLY.
THIS MODULE PROBABLY DOES NOT WORK IN THE WAY YOU EXPECT IT TO WORK ALL THE TIME. I REPEAT: IT HAS DIFFERENT BEHAVIOR BASED ON HOW IT'S BROUGHT IN AS A DEPENDENCY THAT WILL CAUSE YOU HEADACHES. ESPECIALLY IF YOU USE IT IN TWO MODULES WHICH DEPEND ON ONE ANOTHER. (this is because of the way npm optimizes dependencies, and this module doesn't address that, since it's for testing only.).
That said, as long as you use this module as a DEV DEPDENDENCY, everything should work as expected. Sorry for the capslock. ~Mike
How it do
This lets you
require() using a relative path from the root directory of the present module.
Keep in mind
require()is synchronous. And this library is not any more efficient-- (it uses
fs.*Syncmethods) Just like when you use
require(), you should be fine as long as you're doing this at the top of your file outside of any function declarations.
var Sails = require('root-require')('lib/app');
More than once:
var rootRequire = require('root-require'); var Sails = rootRequire('lib/app'); var Router = rootRequire('lib/router'); var MiddlewareLibrary = rootRequire('lib/middleware');
Why is this a good thing?
It's easier to reason about the structure of your module when the paths are consistent. The structure of your project becomes more declarative- dependencies are consistently referenced, irrespective of the user file's home in the directory structure.
- When you move a dependency file (Ax) required by multiple files (Bi), you have to find/replace the all references to Ax. This is normally hard, because the argument to the
require(...)function depends on where the user file (Bi) is located.
- When you move a file (Bx) which depends on another file (Ax), you normally have to update the
require()call in Bx to reflect the new relative path from Bx to Ax.
e.g. Consider trying to change the path to
giggle.js in an automated way:
// foo.js var Giggle = require('./wiggle/sniggle/giggle'); // bar.js var Giggle = require('../../../../../wiggle/sniggle/giggle'); // baz.js var Giggle = require('../../../../wiggle/sniggle/giggle'); // 20 more files like this, 100 other files like `giggle.js`
// foo.js var Giggle = require('root-require')('lib/wiggle/sniggle/giggle'); // bar.js var Giggle = require('root-require')('lib/wiggle/sniggle/giggle'); // baz.js var Giggle = require('root-require')('lib/wiggle/sniggle/giggle'); // 20 more files like this, 100 other files like `giggle.js`
Credit where credit is due
This module is literally a 3-line wrapper around the awesome
packpath module (https://github.com/jprichardson/node-packpath). I just made this for convenience/ so I could have it in one line because I always forget how
path.join works w/ Windows and all that.
MIT, c. 2014 Mike McNeil