go-process/exec/logger.go

package exec

import "sync"

// Logger interface for command execution logging.
// Compatible with pkg/log.Logger and other structured loggers.
type Logger interface {
	// Debug logs a debug-level message with optional key-value pairs.
	//
	// Example:
	//   logger.Debug("starting", "cmd", "go")
	Debug(msg string, keyvals ...any)
	// Error logs an error-level message with optional key-value pairs.
	//
	// Example:
	//   logger.Error("failed", "cmd", "go", "err", err)
	Error(msg string, keyvals ...any)
}

// NopLogger is a no-op logger that discards all messages.
type NopLogger struct{}

// Debug discards the message (no-op implementation).
func (NopLogger) Debug(string, ...any) {}

// Error discards the message (no-op implementation).
func (NopLogger) Error(string, ...any) {}

var _ Logger = NopLogger{}

var (
	defaultLoggerMu sync.RWMutex
	defaultLogger   Logger = NopLogger{}
)

// SetDefaultLogger sets the package-level default logger.
// Commands without an explicit logger will use this.
//
// Example:
//
//	exec.SetDefaultLogger(logger)
func SetDefaultLogger(l Logger) {
	defaultLoggerMu.Lock()
	defer defaultLoggerMu.Unlock()

	if l == nil {
		l = NopLogger{}
	}
	defaultLogger = l
}

// DefaultLogger returns the current default logger.
//
// Example:
//
//	logger := exec.DefaultLogger()
func DefaultLogger() Logger {
	defaultLoggerMu.RLock()
	defer defaultLoggerMu.RUnlock()

	return defaultLogger
}