Documentation
¶
Overview ¶
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 [Provider]s), 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.
[Provider]: github.com/IBM/fp-go/di/erasure.Provider [InjectableFactory]: github.com/IBM/fp-go/di/erasure.InjectableFactory [MakeInjector]: github.com/IBM/fp-go/di/erasure.MakeInjector
Index ¶
- Variables
- func ConstProvider[R any](token InjectionToken[R], value R) DIE.Provider
- 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
- func MakeProvider10[T1, T2, T3, T4, T5, T6, T7, T8, T9, T10 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- 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], ...) DIE.Provider
- 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], ...) DIE.Provider
- 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], ...) DIE.Provider
- 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], ...) DIE.Provider
- 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], ...) DIE.Provider
- func MakeProvider2[T1, T2 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- func MakeProvider3[T1, T2, T3 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- func MakeProvider4[T1, T2, T3, T4 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- func MakeProvider5[T1, T2, T3, T4, T5 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- func MakeProvider6[T1, T2, T3, T4, T5, T6 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- func MakeProvider7[T1, T2, T3, T4, T5, T6, T7 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- func MakeProvider8[T1, T2, T3, T4, T5, T6, T7, T8 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- func MakeProvider9[T1, T2, T3, T4, T5, T6, T7, T8, T9 any, R any](token InjectionToken[R], d1 Dependency[T1], d2 Dependency[T2], ...) DIE.Provider
- 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
- 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], ...) DIE.ProviderFactory
- 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], ...) DIE.ProviderFactory
- 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], ...) DIE.ProviderFactory
- 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], ...) DIE.ProviderFactory
- 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], ...) DIE.ProviderFactory
- 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], ...) DIE.ProviderFactory
- func MakeProviderFactory2[T1, T2 any, R any](d1 Dependency[T1], d2 Dependency[T2], f func(T1, T2) IOE.IOEither[error, R]) DIE.ProviderFactory
- func MakeProviderFactory3[T1, T2, T3 any, R any](d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], ...) DIE.ProviderFactory
- func MakeProviderFactory4[T1, T2, T3, T4 any, R any](d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], ...) DIE.ProviderFactory
- func MakeProviderFactory5[T1, T2, T3, T4, T5 any, R any](d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], ...) DIE.ProviderFactory
- func MakeProviderFactory6[T1, T2, T3, T4, T5, T6 any, R any](d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], ...) DIE.ProviderFactory
- func MakeProviderFactory7[T1, T2, T3, T4, T5, T6, T7 any, R any](d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], d4 Dependency[T4], ...) DIE.ProviderFactory
- 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], ...) DIE.ProviderFactory
- 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], ...) DIE.ProviderFactory
- func Resolve[T any](token InjectionToken[T]) RIOE.ReaderIOEither[DIE.InjectableFactory, error, T]
- type Dependency
- type InjectionToken
- func MakeToken[T any](name string) InjectionToken[T]
- func MakeTokenWithDefault[T any](name string, providerFactory DIE.ProviderFactory) InjectionToken[T]
- func MakeTokenWithDefault0[R any](name string, fct IOE.IOEither[error, R]) InjectionToken[R]
- func MakeTokenWithDefault1[T1 any, R any](name string, d1 Dependency[T1], f func(T1) IOE.IOEither[error, R]) InjectionToken[R]
- 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], ...) InjectionToken[R]
- 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], ...) InjectionToken[R]
- 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], ...) InjectionToken[R]
- 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], ...) InjectionToken[R]
- 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], ...) InjectionToken[R]
- 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], ...) InjectionToken[R]
- func MakeTokenWithDefault2[T1, T2 any, R any](name string, d1 Dependency[T1], d2 Dependency[T2], ...) InjectionToken[R]
- func MakeTokenWithDefault3[T1, T2, T3 any, R any](name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], ...) InjectionToken[R]
- func MakeTokenWithDefault4[T1, T2, T3, T4 any, R any](name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], ...) InjectionToken[R]
- func MakeTokenWithDefault5[T1, T2, T3, T4, T5 any, R any](name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], ...) InjectionToken[R]
- func MakeTokenWithDefault6[T1, T2, T3, T4, T5, T6 any, R any](name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], ...) InjectionToken[R]
- func MakeTokenWithDefault7[T1, T2, T3, T4, T5, T6, T7 any, R any](name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], ...) InjectionToken[R]
- func MakeTokenWithDefault8[T1, T2, T3, T4, T5, T6, T7, T8 any, R any](name string, d1 Dependency[T1], d2 Dependency[T2], d3 Dependency[T3], ...) InjectionToken[R]
- 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], ...) InjectionToken[R]
- type MultiInjectionToken
Constants ¶
This section is empty.
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) )
var RunMain = F.Flow3( DIE.MakeInjector, Main, IOE.Fold(IO.Of[error], F.Constant1[any](IO.Of[error](nil))), )
RunMain runs the main application from a set of [DIE.Provider]s
Functions ¶
func ConstProvider ¶
func ConstProvider[R any](token InjectionToken[R], value R) DIE.Provider
ConstProvider simple implementation for a provider with a constant value
func MakeProvider0 ¶
func MakeProvider1 ¶
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 ¶ added in v1.0.82
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶
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 ¶ added in v1.0.69
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 ¶ added in v1.0.69
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶
func MakeProviderFactory1 ¶
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 ¶ added in v1.0.82
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶
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 ¶ added in v1.0.69
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 ¶ added in v1.0.69
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 Resolve ¶
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 ¶
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] }
Dependency describes the relationship to a service, that has a type and a behaviour such as required, option or lazy
type InjectionToken ¶
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]] }
InjectionToken uniquely identifies a dependency by giving it an Id, Type and name
func MakeToken ¶
func MakeToken[T any](name string) InjectionToken[T]
MakeToken create a unique InjectionToken for a specific type
func MakeTokenWithDefault ¶
func MakeTokenWithDefault[T any](name string, providerFactory DIE.ProviderFactory) InjectionToken[T]
MakeToken create a unique InjectionToken for a specific type
func MakeTokenWithDefault0 ¶
MakeTokenWithDefault0 creates a unique InjectionToken for a specific type with an attached default [DIE.Provider]
func MakeTokenWithDefault1 ¶
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 ¶ added in v1.0.82
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶ added in v1.0.140
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 ¶
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 ¶ added in v1.0.69
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 ¶ added in v1.0.69
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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 ¶ added in v1.0.82
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
type MultiInjectionToken ¶
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] }
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.
func MakeMultiToken ¶
func MakeMultiToken[T any](name string) MultiInjectionToken[T]
MakeMultiToken creates a MultiInjectionToken