better-dependency-injector

What is this about?

Good question. This project solves not directly a problem, but it helps to deal with dependency injection in node.js. This should enable everyone to develop his code fast as possbile, without caring to much about requiring and stuff like that.

It was desgined to be simple and flexible as much as possbile (annotations are allowed). If you miss something, just let me know.

Limitations

• The dependecy container does not allow refrences to classes which refrences itself.
• Further it does not allow references to classes each to other

How to use?

var CoolInjector = require("better-dependency-injector");
var coolInjector = new CoolInjector(['./lib/**/*.js', './helper/**/*.js'], function(err, objects){
    // if we have a class in the lib folder named lib/myClassName.js
    // an we add "module.exports = myfunction(fs){console.log(fs)}"
    // it creates an instance of it
    // and auto resolves all depndencies
    // coolInjector can now access classes and instances of them     
    // by using coolInjector.get("myClassName");
    // objects is the current container
    console.log(coolInjector, objects);
});

Some more examples with annotations

// note, that annotation support needs `@Class();` in the
// comment section
/*
* @Class();
* @lazy(true); // lazy means just return function (not an instance of it)
* @exportAs("logger") // this class will be accessible by inclcuding logger as 
*                     // constructor argument to other classes
*/
module.exports = function(){
}

Solve duplicated file name problems

Maybe we have class which has the same class name as an other class from our domain, we can try to use the @exportAs annotation or we can just try to use @forceOverwrite annotation

/*
* @Class();
* @forceOverwrite(true) // solve problems
* @lazy(true); // lazy means just return function (not an instance of it)
* @exportAs("logger") // this class will be accessible by including "logger" as 
*                     // constructor argument to other classes
*/
module.exports = function(){
}

Ignore files

/*
* @Class();
* @ignored(true); 
*
*/
module.exports = function(){
    // this class will be ignored
}

Make use of singelton

module.exports = function(){
    // this class will be loaded once
    mySingeltonClass = function(){
    }
 
    return new mySingeltonClass();
}