diff --git a/pkg/kube/logger.go b/pkg/kube/logger.go index 00724c7c3..f0ddfe49a 100644 --- a/pkg/kube/logger.go +++ b/pkg/kube/logger.go @@ -14,35 +14,53 @@ See the License for the specific language governing permissions and limitations under the License. */ +// Package kube provides Kubernetes client utilities for Helm. package kube import "log/slog" -// Logger defines a minimal logging interface compatible with slog.Logger +// Logger defines a minimal logging interface compatible with structured logging. +// It provides methods for different log levels with structured key-value pairs. type Logger interface { + // Debug logs a message at debug level with structured key-value pairs. Debug(msg string, args ...any) - Warn(msg string, args ...any) -} -type SlogAdapter struct { - logger *slog.Logger + // Warn logs a message at warning level with structured key-value pairs. + Warn(msg string, args ...any) } +// NopLogger is a logger implementation that discards all log messages. type NopLogger struct{} -func (n NopLogger) Debug(msg string, args ...any) {} -func (n NopLogger) Warn(msg string, args ...any) {} +// Debug implements Logger.Debug by doing nothing. +func (NopLogger) Debug(msg string, args ...any) {} -var nopLogger = NopLogger{} +// Warn implements Logger.Warn by doing nothing. +func (NopLogger) Warn(msg string, args ...any) {} + +// DefaultLogger provides a no-op logger that discards all messages. +// It can be used as a default when no logger is provided. +var DefaultLogger Logger = NopLogger{} + +// SlogAdapter adapts a standard library slog.Logger to the Logger interface. +type SlogAdapter struct { + logger *slog.Logger +} +// Debug implements Logger.Debug by forwarding to the underlying slog.Logger. func (a SlogAdapter) Debug(msg string, args ...any) { a.logger.Debug(msg, args...) } +// Warn implements Logger.Warn by forwarding to the underlying slog.Logger. func (a SlogAdapter) Warn(msg string, args ...any) { a.logger.Warn(msg, args...) } +// NewSlogAdapter creates a Logger that forwards log messages to a slog.Logger. func NewSlogAdapter(logger *slog.Logger) Logger { + if logger == nil { + return DefaultLogger + } return SlogAdapter{logger: logger} }