indejection v0.1.5

indejection.js

Dead simple dependency injection for factory style functions

This project is in a very early stage of development, and usage is not recommended at this stage.

Usage

First, get me:

npm install --save indejection

Next, in your code, write factories that declare dependencies they'd like injected

app.js

var app = function(person) {
	return {
 		start: function() {
 			person.greet();
 		}
	}
};

app.$inject = ['person'];
module.exports = app;

person.js

var person = function() {
	return {
		greet: function() {
			console.log('hi!');
		}
	}
};

module.exports = person;

Then, in the 'main' part of your app, make a container and register your factories

index.js

var container = indejection();

Declare your factories

index.js

container.register('app', require('./app'), { maker: 'singleton' });  // singleton will only be made once
container.register('person', require('./person'));

To kickstart everything, get your entry point. It, and all other dependencies will be created as needed:

index.js

var app = container.get('app');
app.start();

Other options

handle a dependency that doesn't require instanciation (object literals for config data, etc.)

container.register('config', require('./config.json'), { maker: 'fixed' })

TODO List

• A better example
• Tests
• Remove lodash dependency
• Factories as a dependency
• Perhaps some kind of namespacing for dependencies, or nestable containers
• More lifecycles, other options (support for newing?)