subsystem

package

v0.9.1 Latest Latest Go to latest Published: Jun 4, 2026 License: Apache-2.0 Imports: 4 Imported by: 0

Details

Package subsystem provides infrastructure for building composable server subsystems.

Subsystems group related components that are built together with explicit dependencies. Each subsystem follows a pattern:

This section is empty.

This section is empty.

This section is empty.

type Subsystem interface {
	io.Closer
}

Subsystem is implemented by all subsystems that require cleanup.

type ValidationError struct {
	Subsystem string
	Field     string
	Message   string
}

ValidationError represents a missing or invalid configuration field.

func (e *ValidationError) Error() string

type Validator struct {
	// contains filtered or unexported fields
}

Validator collects validation errors for a subsystem configuration.

func NewValidator(subsystem string) *Validator

NewValidator creates a validator for the named subsystem.

func (v *Validator) Error() error

Error returns a combined error if any validations failed, nil otherwise.

func (v *Validator) Required(field string, value any)

Required checks that a value is non-nil/non-zero and records an error if not.

func (v *Validator) RequiredString(field string, value string)

RequiredString checks that a string is non-empty.

Path	Synopsis
metrics Package metrics provides a subsystem for building metrics collection components.	Package metrics provides a subsystem for building metrics collection components.
observability Package observability provides a subsystem for building observability components.	Package observability provides a subsystem for building observability components.