This package has been deprecated

Author message:

WARNING: This project has been renamed to @stdjs/di. Install using @stdjs/di instead.

Bottler

Very simple ioc container for Javascript(& Typescript).

Installation

npm install bottler --save

Usage

const bottler = require("bottler")
// or import * as bottler from "bottler"
 
const container = bottler.create()
// or const container = new bottler.Container()

Bind simple value

container.instance("obj1", {message: "this is obj1"})
container.instance("obj2", {message: "this is obj2"})
 
console.log(await container.get("obj1")) // {message: "this is obj1"}
console.log(await container.get("obj2")) // {message: "this is obj2"}
 
console.log(await container.get("obj1") === await container.get("obj1")) // true
console.log(await container.get("obj2") === await container.get("obj2")) // true

Bind promise value

function promise1() {
  return new Promise(resolve => resolve({message: "this is promise1"}))
}
async function promise2() {
  sleep(500)
  return {message: "this is promise2"}
}
container.instance("promise1", promise1())
container.instance("promise2", promise2())
 
console.log(await container.get("promise1")) // {message: "this is promise1"}
console.log(await container.get("promise2")) // {message: "this is promise2"}
 
console.log(await container.get("promise1") === await container.get("promise1")) // true
console.log(await container.get("promise2") === await container.get("promise2")) // true

Bind factory

container.factory("factory1", () => ({message: "this is factory"}))
container.factory("factory2", () => {
  return new Promise(resolve => {
    resolve({message: "this is promise factory"})
  })
})
container.factory("factory3", async () => {
  sleep(500)
  return {message: "this is async factory"}
})
 
console.log(await container.get("factory1")) // {message: "this is factory"}
console.log(await container.get("factory2")) // {message: "this is promise factory"}
console.log(await container.get("factory3")) // {message: "this is async factory"}

Bind class

class Driver {
}
 
class Connection {
  constructor(@bottler.inject("driver") public driver: Driver) {
  }
}
container.bind("driver", Driver)
container.bind("connection", Connection)
 
const connection = await container.get<Connection>("connection")
console.log(connection) // Connection { driver: Driver {} }
console.log(connection.driver) // Driver {}

Singleton descriptor

Descriptor is very useful if you using factory or bind. this is example of singleton.

container.factory("factory.normal", () => ({message: "this is factory"}))
container.factory("factory.singleton", () => ({message: "this is factory with singleton"})).singleton()
 
container.bind("class.normal", Foo)
container.bind("class.singleton", Foo).singleton()
 
// not same
console.log(await container.get("factory.normal") === await container.get("factory.normal")) // false
console.log(await container.get("class.normal") === await container.get("class.normal")) // false
 
// always same
console.log(await container.get("factory.singleton") === await container.get("factory.singleton")) // true
console.log(await container.get("class.singleton") === await container.get("class.singleton")) // true

After descriptor

 
container
  .factory("foo", () => ({message: "this is origin maessage."}))
  .after(async (context) => {
    await sleep(300)
    context.message = context.message + " and something appended."
    return context
  })
 
console.log(await container.get("foo")) // {message: "this is origin maessage. and something appended."}