Same as make[T].from(implicitly[T]) *

Add all bindings in that module into this module

WON'T add global tags from TagsDSL#tag to included bindings.

Add all bindings in that module into this module

WILL add global tags from TagsDSL#tag to included bindings.

Set bindings are useful for implementing event listeners, plugins, hooks, http routes, etc.

To define a multibinding use .many and .add methods in ModuleDef DSL:

import cats.effect._, org.http4s._, org.http4s.dsl.io._, scala.concurrent.ExecutionContext.Implicits.global
import distage._

object HomeRouteModule extends ModuleDef {
  many[HttpRoutes[IO]].add {
    HttpRoutes.of[IO] { case GET -> Root / "home" => Ok(s"Home page!") }
  }
}

Set bindings defined in different modules will be merged together into a single Set. You can summon a created Set by type Set[T]:

import cats.implicits._, org.http4s.server.blaze._, org.http4s.implicits._

object BlogRouteModule extends ModuleDef {
  many[HttpRoutes[IO]].add {
    HttpRoutes.of[IO] { case GET -> Root / "blog" / post => Ok("Blog post ``$post''!") }
  }
}

class HttpServer(routes: Set[HttpRoutes[IO]]) {
  val router = routes.foldK

  def serve = BlazeBuilder[IO]
    .bindHttp(8080, "localhost")
    .mountService(router, "/")
    .start
}

val objects = Injector().produce(HomeRouteModule ++ BlogRouteModule)
val server = objects.get[HttpServer]

val testRouter = server.router.orNotFound

testRouter.run(Request[IO](uri = uri("/home"))).flatMap(_.as[String]).unsafeRunSync
// Home page!

testRouter.run(Request[IO](uri = uri("/blog/1"))).flatMap(_.as[String]).unsafeRunSync
// Blog post ``1''!

Modify a value bound at T. Modifiers stack and are all applied before T is added to the object graph; only the final instance is observable.

import distage.{Injector, ModuleDef}

Injector().produceGet[Int](new ModuleDef {
  make[Int].from(1)
  modify[Int](_ + 1)
  modify[Int](_ + 1)
}).use(i => println(s"Got `Int` $i"))
// Got `Int` 3

You can also modify while summoning additional dependencies:

modify[Int]("named").by(_.flatAp {
  (adder: Adder, multiplier: Multiplier) =>
    int: Int =>
      multiplier.multiply(adder.add(int, 1), 10)
})

Add tags to all bindings in this module, except for included bindings

Create a dummy binding that throws an exception with an error message when it's created.

Useful for prototyping.