dyn-require

$3

 

Dynamic loading Node.js modules from filesystem.

#### Intro
Sometimes you need to dynamically scan some directory, load all modules (js or json files) and perform some generic work with all of them.
You need to recoursively scan directories and filter non js files, that causes lots of boilerplate to be written. DynRequire solves
this problem for you. Just pass base path, and it will scan all modules and provides it to you as object (relative path) -> (module).
require-like syntax also supported!

#### Installation
``bash
$ npm install dyn-require
`

#### Usage

##### Sync work
`javascript
var DynRequire = require('dyn-require');

var modules = new DynRequire(__dirname + '/modules');

/ get all modules as array /
console.log( modules.requireAll() );

/ get all modules as object (relative path) -> (module) /
console.log( modules.requireAllEx() );

/ require module /
console.log( modules.require('modules/a') );
`

##### Async work
If using async method, DynRequire will emit two kind of messages: 'next' on next module loaded and 'done' when all modules are scanned and loaded.


`javascript
var DynRequire = require('dyn-require');

var modules = new DynRequire(__dirname + '/modules', {
async: true
});

/ Next module /
modules.on('next', function(relPath, module) {
console.log(relPath, module);
});

/ All modules /
modules.on('done', function(allModules, allModulesWithPaths) {
console.log(allModules);

// Here you can use
// modules.require and modules.requireAll, etc...
});
``

#### Author
* Yaroslav Pogrebnyak

#### License
MIT