Function Register

component/component.go:79–100

Register registers a new component using the given constructor function and optional definition options. It panics if the component name already exists or if definition creation fails.

(fn ConstructorFunc, opts ...DefinitionOption)

// Register registers a new component using the given constructor function and optional definition options.
// It panics if the component name already exists or if definition creation fails.
func Register(fn ConstructorFunc, opts ...DefinitionOption) *Registration {
	muComponents.Lock()
	defer muComponents.Unlock()

	def, err := MakeDefinition(fn, opts...)
	if err != nil {
		panic(err)
	}

	name := def.Name()

	if _, exists := components[name]; exists {
		panic(fmt.Errorf("component with name '%s' already exists", name))
	}

	component := createComponent(def)

	components[name] = component
	return &Registration{
		component: component,
	}
}

// Load retrieves and constructs a component by its name, ensuring it matches the expected type T.
// It returns an error if the component is not found, if there is a type mismatch, or if construction fails.