dependencies

type DependenciesIfc interface {
	// Add one or more Dependencies to the set
	Add(deps ...DependencyIfc) *dependencies

	// Get a dependency by name/variant
	Get(name string) DependencyIfc
	GetVariant(name, variant string) DependencyIfc

	// Check whether a dependency is in the set by name/variant
	Has(name string) bool
	HasVariant(name, variant string) bool

	// Get the list of currently set dependencies
	GetVariants(name string) []string
	GetAllVariants() map[string][]string
}

type DependencyCaptureFunc func(instance interface{}) bool

type DependencyIfc interface {
	GetName() string

	SetVariant(variant string) *dependency
	GetVariant() string

	SetRequired() *dependency
	IsRequired() bool

	CanCapture() bool
	CaptureWith(captureFunc DependencyCaptureFunc) *dependency
	Capture(instance interface{}) error
}

type DependencyInjectable struct {
	*startable.Startable
	// contains filtered or unexported fields
}

type DependencyInjectableIfc interface {
	// Embedded interface(s)
	startable.StartableIfc

	// Our own interface
	AddDeclaredDependencies(deps ...DependencyIfc) *DependencyInjectable

	// Injection & Retrieval
	// Receive dependency injection from external source
	InjectDependencies(depinst ...DependencyInstanceIfc) error
	// Have all required dependencies have been injected?
	HasAllRequiredDependencies() bool

	// Discovery (Declared)
	// What are all the declared Dependecies?
	GetDeclaredDependencies() DependenciesIfc
	// What are just the required Dependencies?
	GetRequiredDependencies() DependenciesIfc
	// What are just the optional Dependencies?
	GetOptionalDependencies() DependenciesIfc

	// Discovery (Injected)
	// What are the injected DependencyInstances?
	GetInjectedDependencies() DependenciesIfc
	// What Dependencies are Required that have not yet been injected?
	GetMissingDependencies() DependenciesIfc
	// What Dependencies are injected, but unknown (undeclared) to us?
	GetUnknownDependencies() DependenciesIfc

	// Retrieval (Injected)
	// Get the injected dependency matching name (default or any variant)
	GetInstance(name string) interface{}
	// Get the injected dependency matching name and specific variant
	GetInstanceVariant(name, variant string) interface{}
	// Get the injected, required Dependency Instances
	GetRequiredDependencyInstances() []dependencyInstance
	// Get the injected, optional Dependency Instances
	GetOptionalDependencyInstances() []dependencyInstance
	// Get the injected, unknown Dependency Instances
	GetUnknownDependencyInstances() []dependencyInstance
}

type DependencyInstanceIfc interface {
	GetName() string
	GetVariant() string
	GetInstance() interface{}
	SetVariant(variant string) *dependencyInstance
}