Extra comment + Default logger fallback

Signed-off-by: Benoit Tigeot <benoit.tigeot@lifen.fr>

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}
 }