Packages

abstract class PluginDef[T] extends PluginBase with ModuleDef

Use it to define Plugins using izumi.distage.model.definition.dsl.ModuleDefDSL syntax

object MyPlugin extends PluginDef {
  include(myModule[F])

  make[Xa[F]].from[Xa.Impl[F]]
}
Note

Since this is an abstract class, you cannot mix it with other classes or use it as a mixin. Instead, you may inherit from PluginBase, which is a trait – but in that case compile-time checks will not re-run when the class is updated in that case. Alternatively, you may use izumi.distage.model.definition.dsl.IncludesDSL#include to compose modules as values instead of using inheritance.

See also

Plugins

Compile-time checks

Linear Supertypes
ModuleDef, ModuleDefDSL, TagsDSL, IncludesDSL, AbstractBindingDefDSL[MakeDSL, MakeDSLUnnamedAfterFrom, SetDSL], AbstractBindingDefDSLMacro[MakeDSL], Module, PluginBase, ModuleBase, CachedHashcode, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. PluginDef
  2. ModuleDef
  3. ModuleDefDSL
  4. TagsDSL
  5. IncludesDSL
  6. AbstractBindingDefDSL
  7. AbstractBindingDefDSLMacro
  8. Module
  9. PluginBase
  10. ModuleBase
  11. CachedHashcode
  12. AnyRef
  13. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Instance Constructors

  1. new PluginDef()(implicit recompilationToken: ForcedRecompilationToken[T])

    recompilationToken

    Makes compile-time checks re-run when the source code of this PluginDef is changed, if it's used in the checked role.

Type Members

  1. final class MutationContext extends AnyRef

    Use this to create utility functions that add bindings mutably to the current module, as opposed to creating new modules and including them.

    Use this to create utility functions that add bindings mutably to the current module, as opposed to creating new modules and including them.

    Example:

    import distage.{ClassConstructor, Tag, ModuleDef}
import izumi.distage.model.definition.dsl.ModuleDefDSL

trait RegisteredComponent
class RegisteredComponentImpl extends RegisteredComponent

def addAndRegister[T <: RegisteredComponent: Tag: ClassConstructor](implicit mutateModule: ModuleDefDSL#MutationContext): Unit = {
  new mutateModule.dsl {
    make[T]

    many[RegisteredComponent]
      .weak[T]
  }
}

new ModuleDef {
  addAndRegister[RegisteredComponentImpl]
}
    Definition Classes
    AbstractBindingDefDSL

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. def _initialIncludes: ArrayBuffer[Include]
    Attributes
    protected[this]
    Definition Classes
    IncludesDSL
  5. def _initialState: ArrayBuffer[BindingRef]
    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
  6. def _initialTaggedIncludes: ArrayBuffer[IncludeApplyTags]
    Attributes
    protected[this]
    Definition Classes
    IncludesDSL
  7. def _initialTags: Set[BindingTag]
    Attributes
    protected[this]
    Definition Classes
    TagsDSL
  8. final def _make[T](provider: Functoid[T])(implicit arg0: Tag[T], pos: CodePositionMaterializer): MakeDSL[T]
    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
  9. def _registered[T <: BindingRef](bindingRef: T): T
    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
  10. final def addImplicit[T](implicit arg0: Tag[T], instance: T, pos: CodePositionMaterializer): MakeDSLUnnamedAfterFrom[T]

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

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

    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
  11. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  12. final def bindings: Set[Binding]
    Definition Classes
    ModuleDefDSL
  13. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native()
  14. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  15. final def equals(obj: Any): Boolean
    Definition Classes
    ModuleBase → AnyRef → Any
  16. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable])
  17. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  18. final def hash: Int
    Attributes
    protected
    Definition Classes
    ModuleBase → CachedHashcode
  19. final lazy val hashCode: Int
    Definition Classes
    CachedHashcode → AnyRef → Any
  20. final def include(that: ModuleBase): Unit

    Add all bindings in that module into this module

    Add all bindings in that module into this module

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

    Attributes
    protected[this]
    Definition Classes
    IncludesDSL
  21. final def includeApplyTags(that: ModuleBase): Unit

    Add all bindings in that module into this module

    Add all bindings in that module into this module

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

    Attributes
    protected[this]
    Definition Classes
    IncludesDSL
  22. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  23. final def iterator: Iterator[Binding]
    Definition Classes
    ModuleDefDSL
  24. final def keys: Set[DIKey]
    Definition Classes
    ModuleBase
  25. final def keysIterator: Iterator[DIKey]
    Definition Classes
    ModuleDefDSL
  26. final macro def make[T]: MakeDSL[T]
    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSLMacro
  27. final def makeFactory[T](implicit arg0: Tag[T], arg1: FactoryConstructor[T]): MakeDSLUnnamedAfterFrom[T]

    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
    See also

    Auto-Factories feature

  28. final def makeSubcontext[T](implicit arg0: Tag[T]): SubcontextDSL[T]

    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
    See also

    Subcontexts feature

  29. final def makeSubcontext[T](submodule: ModuleBase)(implicit arg0: Tag[T]): SubcontextDSL[T]

    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
    See also

    Subcontexts feature

  30. final def makeTrait[T](implicit arg0: Tag[T], arg1: TraitConstructor[T]): MakeDSLUnnamedAfterFrom[T]

    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
    See also

    Auto-Traits feature

  31. final def many[T](implicit tag: Tag[Set[T]], pos: CodePositionMaterializer): SetDSL[T]

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

    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''!
    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
    See also

    Guice wiki on Multibindings: https://github.com/google/guice/wiki/Multibindings

  32. final def modify[T]: ModifyDSL[T, MakeDSL, MakeDSLUnnamedAfterFrom, SetDSL]

    Modify a value bound at T.

    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)
})
    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
  33. implicit final lazy val mutationContext: MutationContext
    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
  34. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  35. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  36. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  37. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  38. final def tag(tags: BindingTag*): Unit

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

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

    Attributes
    protected[this]
    Definition Classes
    TagsDSL
  39. final def toString(): String
    Definition Classes
    ModuleBase → AnyRef → Any
  40. final def todo[T](implicit arg0: Tag[T], pos: CodePositionMaterializer): MakeDSLUnnamedAfterFrom[T]

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

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

    Useful for prototyping.

    Attributes
    protected[this]
    Definition Classes
    AbstractBindingDefDSL
  41. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  42. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  43. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()

Inherited from ModuleDef

Inherited from ModuleDefDSL

Inherited from TagsDSL

Inherited from IncludesDSL

Inherited from AbstractBindingDefDSL[MakeDSL, MakeDSLUnnamedAfterFrom, SetDSL]

Inherited from AbstractBindingDefDSLMacro[MakeDSL]

Inherited from Module

Inherited from PluginBase

Inherited from ModuleBase

Inherited from CachedHashcode

Inherited from AnyRef

Inherited from Any

Ungrouped