Di

di

Package di implements functions and data types supporting dependency injection patterns

import "github.com/IBM/fp-go/di"

Package di implements functions and data types supporting dependency injection patterns

The fundamental building block is the concept of a [Dependency]. This describes the abstract concept of a function, service or value together with its type. Examples for dependencies can be as simple as configuration values such as the API URL for a service, the current username, a [Dependency] could be the map of the configuration environment, an http client or as complex as a service interface. Important is that a [Dependency] only defines the concept but not the implementation.

The implementation of a [Dependency] is called a Provider, the dependency of an API URL could e.g. be realized by a provider that consults the environment to read the information or a config file or simply hardcode it. In many cases the implementation of a Provider depends in turn on other [Dependency] (but never directly on other Providers), a provider for an API URL that reads the information from the environment would e.g. depend on a [Dependency] that represents this environment.

It is the resposibility of the InjectableFactory to create an instance of a [Dependency]. All instances are considered singletons. Create an InjectableFactory via the MakeInjector method. Use [Resolve] to create a strongly typed factory for a particular [InjectionToken].

In most cases it is not required to use InjectableFactory directly, instead you would create a Provider via the [MakeProvider2] method (suffix indicates the number of dependencies). In this call you give a number of (strongly typed) [Dependency] identifiers and a (strongly typed) factory function for the implementation. The dependency injection framework makes sure to resolve the dependencies before calling the factory method.

For convenience purposes it can be helpful to attach a default implementation of a [Dependency]. In this case use the [MakeTokenWithDefault2] method (suffix indicates the number of dependencies) to define the [InjectionToken].

Variables

var (
	// InjMain is the [InjectionToken] for the main application
	InjMain = MakeToken[any]("APP")

	// Main is the resolver for the main application
	Main = Resolve(InjMain)
)

RunMain runs the main application from a set of [DIE.Provider]s

var RunMain = F.Flow3(
	DIE.MakeInjector,
	Main,
	IOE.Fold(IO.Of[error], F.Constant1[any](IO.Of[error](nil))),
)

Functions

func ConstProvider[R any](token InjectionToken[R], value R) DIE.Provider

ConstProvider simple implementation for a provider with a constant value

func MakeMultiToken[T any](name string) MultiInjectionToken[T]

MakeMultiToken creates a [MultiInjectionToken]

func MakeProvider0[R any]( token InjectionToken[R], fct IOE.IOEither[error, R], ) DIE.Provider

func MakeProvider1[T1 any, R any]( token InjectionToken[R], d1 Dependency[T1], f func(T1) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider1 creates a [DIE.Provider] for an [InjectionToken] from a function with 1 dependencies

func MakeProvider10[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider10 creates a [DIE.Provider] for an [InjectionToken] from a function with 10 dependencies

func MakeProvider11[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider11 creates a [DIE.Provider] for an [InjectionToken] from a function with 11 dependencies

func MakeProvider12[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider12 creates a [DIE.Provider] for an [InjectionToken] from a function with 12 dependencies

func MakeProvider13[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider13 creates a [DIE.Provider] for an [InjectionToken] from a function with 13 dependencies

func MakeProvider14[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], d14 Dependency[T14], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider14 creates a [DIE.Provider] for an [InjectionToken] from a function with 14 dependencies

func MakeProvider15[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], d14 Dependency[T14], d15 Dependency[T15], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider15 creates a [DIE.Provider] for an [InjectionToken] from a function with 15 dependencies

func MakeProvider2[T1, T2 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], f func(T1, T2) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider2 creates a [DIE.Provider] for an [InjectionToken] from a function with 2 dependencies

func MakeProvider3[T1, T2, T3 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], f func(T1, T2, T3) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider3 creates a [DIE.Provider] for an [InjectionToken] from a function with 3 dependencies

func MakeProvider4[T1, T2, T3, T4 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], f func(T1, T2, T3, T4) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider4 creates a [DIE.Provider] for an [InjectionToken] from a function with 4 dependencies

func MakeProvider5[T1, T2, T3, T4, T5 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], f func(T1, T2, T3, T4, T5) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider5 creates a [DIE.Provider] for an [InjectionToken] from a function with 5 dependencies

func MakeProvider6[T1, T2, T3, T4, T5, T6 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], f func(T1, T2, T3, T4, T5, T6) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider6 creates a [DIE.Provider] for an [InjectionToken] from a function with 6 dependencies

func MakeProvider7[T1, T2, T3, T4, T5, T6, T7 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], f func(T1, T2, T3, T4, T5, T6, T7) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider7 creates a [DIE.Provider] for an [InjectionToken] from a function with 7 dependencies

func MakeProvider8[T1, T2, T3, T4, T5, T6, T7, T8 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], f func(T1, T2, T3, T4, T5, T6, T7, T8) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider8 creates a [DIE.Provider] for an [InjectionToken] from a function with 8 dependencies

func MakeProvider9[T1, T2, T3, T4, T5, T6, T7, T8, T9 any, R any]( token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9) IOE.IOEither[error, R], ) DIE.Provider

MakeProvider9 creates a [DIE.Provider] for an [InjectionToken] from a function with 9 dependencies

func MakeProviderFactory0[R any]( fct IOE.IOEither[error, R], ) DIE.ProviderFactory

func MakeProviderFactory1[T1 any, R any]( d1 Dependency[T1], f func(T1) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory1 creates a [DIE.ProviderFactory] from a function with 1 arguments and 1 dependencies

func MakeProviderFactory10[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory10 creates a [DIE.ProviderFactory] from a function with 10 arguments and 10 dependencies

func MakeProviderFactory11[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory11 creates a [DIE.ProviderFactory] from a function with 11 arguments and 11 dependencies

func MakeProviderFactory12[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory12 creates a [DIE.ProviderFactory] from a function with 12 arguments and 12 dependencies

func MakeProviderFactory13[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory13 creates a [DIE.ProviderFactory] from a function with 13 arguments and 13 dependencies

func MakeProviderFactory14[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], d14 Dependency[T14], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory14 creates a [DIE.ProviderFactory] from a function with 14 arguments and 14 dependencies

func MakeProviderFactory15[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], d14 Dependency[T14], d15 Dependency[T15], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory15 creates a [DIE.ProviderFactory] from a function with 15 arguments and 15 dependencies

func MakeProviderFactory2[T1, T2 any, R any]( d1 Dependency[T1], d2 Dependency[T2], f func(T1, T2) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory2 creates a [DIE.ProviderFactory] from a function with 2 arguments and 2 dependencies

func MakeProviderFactory3[T1, T2, T3 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], f func(T1, T2, T3) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory3 creates a [DIE.ProviderFactory] from a function with 3 arguments and 3 dependencies

func MakeProviderFactory4[T1, T2, T3, T4 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], f func(T1, T2, T3, T4) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory4 creates a [DIE.ProviderFactory] from a function with 4 arguments and 4 dependencies

func MakeProviderFactory5[T1, T2, T3, T4, T5 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], f func(T1, T2, T3, T4, T5) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory5 creates a [DIE.ProviderFactory] from a function with 5 arguments and 5 dependencies

func MakeProviderFactory6[T1, T2, T3, T4, T5, T6 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], f func(T1, T2, T3, T4, T5, T6) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory6 creates a [DIE.ProviderFactory] from a function with 6 arguments and 6 dependencies

func MakeProviderFactory7[T1, T2, T3, T4, T5, T6, T7 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], f func(T1, T2, T3, T4, T5, T6, T7) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory7 creates a [DIE.ProviderFactory] from a function with 7 arguments and 7 dependencies

func MakeProviderFactory8[T1, T2, T3, T4, T5, T6, T7, T8 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], f func(T1, T2, T3, T4, T5, T6, T7, T8) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory8 creates a [DIE.ProviderFactory] from a function with 8 arguments and 8 dependencies

func MakeProviderFactory9[T1, T2, T3, T4, T5, T6, T7, T8, T9 any, R any]( d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9) IOE.IOEither[error, R], ) DIE.ProviderFactory

MakeProviderFactory9 creates a [DIE.ProviderFactory] from a function with 9 arguments and 9 dependencies

func MakeToken[T any](name string) InjectionToken[T]

MakeToken create a unique [InjectionToken] for a specific type

func MakeTokenWithDefault[T any](name string, providerFactory DIE.ProviderFactory) InjectionToken[T]

MakeToken create a unique [InjectionToken] for a specific type

func MakeTokenWithDefault0[R any](name string, fct IOE.IOEither[error, R]) InjectionToken[R]

MakeTokenWithDefault0 creates a unique [InjectionToken] for a specific type with an attached default [DIE.Provider]

func MakeTokenWithDefault1[T1 any, R any]( name string, d1 Dependency[T1], f func(T1) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault1 creates an [InjectionToken] with a default implementation with 1 dependencies

func MakeTokenWithDefault10[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault10 creates an [InjectionToken] with a default implementation with 10 dependencies

func MakeTokenWithDefault11[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault11 creates an [InjectionToken] with a default implementation with 11 dependencies

func MakeTokenWithDefault12[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault12 creates an [InjectionToken] with a default implementation with 12 dependencies

func MakeTokenWithDefault13[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault13 creates an [InjectionToken] with a default implementation with 13 dependencies

func MakeTokenWithDefault14[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], d14 Dependency[T14], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault14 creates an [InjectionToken] with a default implementation with 14 dependencies

func MakeTokenWithDefault15[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], d10 Dependency[T10], d11 Dependency[T11], d12 Dependency[T12], d13 Dependency[T13], d14 Dependency[T14], d15 Dependency[T15], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault15 creates an [InjectionToken] with a default implementation with 15 dependencies

func MakeTokenWithDefault2[T1, T2 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], f func(T1, T2) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault2 creates an [InjectionToken] with a default implementation with 2 dependencies

func MakeTokenWithDefault3[T1, T2, T3 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], f func(T1, T2, T3) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault3 creates an [InjectionToken] with a default implementation with 3 dependencies

func MakeTokenWithDefault4[T1, T2, T3, T4 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], f func(T1, T2, T3, T4) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault4 creates an [InjectionToken] with a default implementation with 4 dependencies

func MakeTokenWithDefault5[T1, T2, T3, T4, T5 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], f func(T1, T2, T3, T4, T5) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault5 creates an [InjectionToken] with a default implementation with 5 dependencies

func MakeTokenWithDefault6[T1, T2, T3, T4, T5, T6 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], f func(T1, T2, T3, T4, T5, T6) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault6 creates an [InjectionToken] with a default implementation with 6 dependencies

func MakeTokenWithDefault7[T1, T2, T3, T4, T5, T6, T7 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], f func(T1, T2, T3, T4, T5, T6, T7) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault7 creates an [InjectionToken] with a default implementation with 7 dependencies

func MakeTokenWithDefault8[T1, T2, T3, T4, T5, T6, T7, T8 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], f func(T1, T2, T3, T4, T5, T6, T7, T8) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault8 creates an [InjectionToken] with a default implementation with 8 dependencies

func MakeTokenWithDefault9[T1, T2, T3, T4, T5, T6, T7, T8, T9 any, R any]( name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], d5 Dependency[T5], d6 Dependency[T6], d7 Dependency[T7], d8 Dependency[T8], d9 Dependency[T9], f func(T1, T2, T3, T4, T5, T6, T7, T8, T9) IOE.IOEither[error, R], ) InjectionToken[R]

MakeTokenWithDefault9 creates an [InjectionToken] with a default implementation with 9 dependencies

func Resolve[T any](token InjectionToken[T]) RIOE.ReaderIOEither[DIE.InjectableFactory, error, T]

Resolve performs a type safe resolution of a dependency

Types

type Dependency

Dependency describes the relationship to a service, that has a type and a behaviour such as required, option or lazy

type Dependency[T any] interface {
	DIE.Dependency
	// Unerase converts a value with erased type signature into a strongly typed value
	Unerase(val any) E.Either[error, T]
}
Methods
  • DIE.Dependency
  • Unerase func(val any) E.Either[error, T]

    Unerase converts a value with erased type signature into a strongly typed value

type InjectionToken

InjectionToken uniquely identifies a dependency by giving it an Id, Type and name

type InjectionToken[T any] interface {
	Dependency[T]
	// Identity idenifies this dependency as a mandatory, required dependency, it will be resolved eagerly and injected as `T`.
	// If the dependency cannot be resolved, the resolution process fails
	Identity() Dependency[T]
	// Option identifies this dependency as optional, it will be resolved eagerly and injected as [O.Option[T]].
	// If the dependency cannot be resolved, the resolution process continues and the dependency is represented as [O.None[T]]
	Option() Dependency[O.Option[T]]
	// IOEither identifies this dependency as mandatory but it will be resolved lazily as a [IOE.IOEither[error, T]]. This
	// value is memoized to make sure the dependency is a singleton.
	// If the dependency cannot be resolved, the resolution process fails
	IOEither() Dependency[IOE.IOEither[error, T]]
	// IOOption identifies this dependency as optional but it will be resolved lazily as a [IOO.IOOption[T]]. This
	// value is memoized to make sure the dependency is a singleton.
	// If the dependency cannot be resolved, the resolution process continues and the dependency is represented as the none value.
	IOOption() Dependency[IOO.IOOption[T]]
}
Methods
  • Dependency[T]
  • Identity func() Dependency[T]

    Identity idenifies this dependency as a mandatory, required dependency, it will be resolved eagerly and injected as T. If the dependency cannot be resolved, the resolution process fails

  • Option func() Dependency[O.Option[T]]

    Option identifies this dependency as optional, it will be resolved eagerly and injected as [O.Option[T]]. If the dependency cannot be resolved, the resolution process continues and the dependency is represented as [O.None[T]]

  • IOEither func() Dependency[IOE.IOEither[error, T]]

    IOEither identifies this dependency as mandatory but it will be resolved lazily as a [IOE.IOEither[error, T]]. This value is memoized to make sure the dependency is a singleton. If the dependency cannot be resolved, the resolution process fails

  • IOOption func() Dependency[IOO.IOOption[T]]

    IOOption identifies this dependency as optional but it will be resolved lazily as a [IOO.IOOption[T]]. This value is memoized to make sure the dependency is a singleton. If the dependency cannot be resolved, the resolution process continues and the dependency is represented as the none value.

type MultiInjectionToken

MultiInjectionToken uniquely identifies a dependency by giving it an Id, Type and name that can have multiple implementations. Implementations are provided via the [MultiInjectionToken.Item] injection token.

type MultiInjectionToken[T any] interface {
	// Container returns the injection token used to request an array of all provided items
	Container() InjectionToken[[]T]
	// Item returns the injection token used to provide an item
	Item() InjectionToken[T]
}
Methods
  • Container func() InjectionToken[[]T]

    Container returns the injection token used to request an array of all provided items

  • Item func() InjectionToken[T]

    Item returns the injection token used to provide an item

Built withSourcey