yadi

Yet Another Dependency Injection library

yadi is a simple and small dependency injection library. yadi can inject dependencies using constructor injection and property injection

Installation

Installing yadi is easy like running

$ npm install Begad666/yadi reflect-metadata --save

or

$ yarn add Begad666/yadi reflect-metadata

You will need a transpiler that supports decorators

To enable decorator support in typescript, add "experimentalDecorators": true in your tsconfig.json like:

{
    // ...
    "compilerOptions": {
        // ...
        "experimentalDecorators": true,
        // ...
    }
    // ...
}

yadi also requires support for Map. If you need to support a JavaScript engine that doesn't support Map, you will need to import a polyfill.

Usage

Import reflect-metadata and yadi in your entry point like:

// src/index.ts
import "reflect-metadata";
import { Container, inject } from "yadi";
// ...

Create a new container:

const container = new Container();

Optional: Add a new namespace:

container.addNamespace("papers")

Bind dependencies:

// If using property injection
class VeryTallPaper {
    @inject()
    private ruler: Ruler;
    get height() {
        return this.ruler.measure();
    }
}
// Or if using constructor injection
class VeryTallPaper {
    public constructor(@inject("ruler") private ruler: Ruler) {}
    get height() {
        return this.ruler.measure();
    }
}
class Ruler {
    public measure() {
        return 10;
    }
}
container.bind("ruler")
         .toClass(Ruler);
container.bind("verytallpaper") // or container.bind("verytallpaper", "papers") if using namespaces
         .toClass(VeryTallPaper);

Resolve it!

const paper = container.resolve("verytallpaper") // or container.resolve("papers:verytallpaper") if using namespaces
paper.height // 10

If you don't want to inject everything into the container use the create method of container like:

container.unbind("verytallpaper"); // Or don't bind it at all
const paper = container.create(VeryTallPaper)
paper.height // 10

API Docs

The API docs is available at https://begad666.github.io/yadi