67 lines
2 KiB
Go
67 lines
2 KiB
Go
// Package component holds the main abstraction for components.
|
|
package component
|
|
|
|
import (
|
|
"reflect"
|
|
"strings"
|
|
|
|
"github.com/FAU-CDI/wisski-distillery/internal/config"
|
|
)
|
|
|
|
// Components represents a logical subsystem of the distillery.
|
|
// A Component should be implemented as a pointer to a struct.
|
|
// Every component must embed [Base] and should be initialized using [Init] inside a [lifetime.Lifetime].
|
|
//
|
|
// By convention these are defined within their corresponding subpackage.
|
|
// This subpackage also contains all required resources.
|
|
type Component interface {
|
|
// Name returns the name of this component
|
|
// Name should be implemented by the [ComponentBase] struct.
|
|
Name() string
|
|
|
|
// ID returns a unique id of this component
|
|
// ID should be implemented by the [ComponentBase] struct.
|
|
ID() string
|
|
|
|
// getBase returns the underlying ComponentBase object of this Component.
|
|
// It is used internally during initialization
|
|
getBase() *Base
|
|
}
|
|
|
|
// Base is embedded into every Component
|
|
type Base struct {
|
|
name, id string // name and id of this component
|
|
Still // the underlying still of the distillery
|
|
}
|
|
|
|
//lint:ignore U1000 used to implement the private methods of [Component]
|
|
func (cb *Base) getBase() *Base {
|
|
return cb
|
|
}
|
|
|
|
// Init initialzes a new componeont Component with the provided still.
|
|
// Init is only initended to be used within a lifetime.Lifetime[Component,Still].
|
|
func Init(component Component, core Still) Component {
|
|
base := component.getBase() // pointer to a struct
|
|
base.Still = core
|
|
|
|
tp := reflect.TypeOf(component).Elem()
|
|
base.name = strings.ToLower(tp.Name())
|
|
base.id = tp.PkgPath() + "." + tp.Name()
|
|
|
|
return component
|
|
}
|
|
|
|
func (cb Base) Name() string {
|
|
return cb.name
|
|
}
|
|
|
|
func (cb Base) ID() string {
|
|
return cb.id
|
|
}
|
|
|
|
// Still represents the central part of a distillery.
|
|
// It is used inside the main distillery struct, as well as every component via [ComponentBase].
|
|
type Still struct {
|
|
Config *config.Config // the configuration of the distillery
|
|
}
|