container-ioc

IoC Container written in Typescript

Annotation based Inversion of Controll container implementation.

Installation:

npm install --save container-ioc

API usage:

Container's API and behaviour is very similar to the one used in Angular4.

in a Typescript project:

import { Container, Inject } from 'container-ioc';

let container = new Container();


// Register classes:
class RandomClass1 {};
class RandomClass3 {
    doSomething(): void {
        console.log('hello world');
    }
};


// Use Injector decorater to inject dependencies:
class RandomClass2 {
    constructor(@Inject(RandomClass3) public instance3: any) {
    }
};


// Register classes in the container:
// You can pass just a Class literal alone or a provider literal -> 
// { token: 'string or class literal', useClass: 'class literal' }
let providers = [
    RandomClass1,
    { token: 'anystring', useClass: RandomClass2 }, 
    { token: RandomClass3, useClass: RandomClass3 }
];

container.register(providers);


// Resolve instances
let instance1: RandomClass1 = container.resolve(RandomClass1);
let instance2: RandomClass2 = container.resolve('anystring');
instance2.instance3.doSomething(); // hello world

in a ES6 project:

let Container = require('container-ioc').Container;

let container = new Container();


// Register classes:
class RandomClass1 {};
class RandomClass3 {
    doSomething() {
        console.log('hello world');
    }
};


// Use Injector decorater to inject dependencies:
class RandomClass2 {
    instance3;
    constructor() {
        this.instance3 = container.resolve(RandomClass3);
    }
};


// Register classes in the container:
// You can pass just a Class literal alone or a provider literal -> 
// { token: 'string or class literal', useClass: 'class literal' }
let providers = [
    RandomClass1,
    { token: 'anystring', useClass: RandomClass2 }, 
    { token: RandomClass3, useClass: RandomClass3 }
];

container.register(providers);


// Resolve instances
let instance1 = container.resolve(RandomClass1);
let instance2 = container.resolve('anystring');
instance2.instance3.doSomething(); // hello world

Scoped containers

if a provider wasn't found in a container it will look up in ascendant containers if there's any:

import { Container } from 'container-ioc';

class SomeClass {
    doStuff(): void {
        console.log('hello world');
    }
}

let parentContainer = new Container();
let childContainer = parentContainer.createScope();

parentContainer.register({ token: 'ISome', useClass: SomeClass });
childContainer.resolve('ISome');

let instance = childContainer.resolve('ISome');
instance.doStuff(); // hello world

Future:

It's just a very basic version. I'm going to add more functionality to meet common use cases, such as ability to mark injections in constructor with types only (typescript projects) and more handy API.

Contribution:

If you want to help feel free to submit an bug or a feature request. Also leave a comment under the issue you'd like to work on.

see CONTRIBUTION.md