root-require

root-require

a more convenient require method for running TESTS ONLY.

WARNING:

THIS MODULE DOES NOT WORK ALL THE TIME. I REPEAT. IT DOES NOT WORK ALL THE TIME. IT WILL CAUSE YOU HEADACHES IF YOU USE IT IN TWO MODULES WHICH DEPEND ON ONE ANOTHER, BECAUSE NPM OPTIMIZES DEPENDENCIES. AS LONG AS YOU ARE ONLY USING IT ONLY FOR TESTS, YOU SHOULD BE OK.

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.*Sync methods) 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.

Usage

Just once:

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.

Problems w/ require()

1. When you move a dependency file (A_x) required by multiple files (B_i), you have to find/replace the all references to A_x. This is normally hard, because the argument to the require(...) function depends on where the user file (B_i) is located.
2. When you move a file (B_x) which depends on another file (A_x), you normally have to update the require() call in B_x to reflect the new relative path from B_x to A_x.

e.g. Consider trying to change the path to giggle.js in an automated way:

hard

// 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`

easy

// 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.

License

MIT, c. 2014 Mike McNeil