sugar.go

package slogx

import (
	"context"
	"fmt"
	"strings"
)

// SugaredLogger provides zap.SugaredLogger-like interface with flattened arguments
// Converts arguments into a single message string using fmt.Sprint
//
// SugaredLogger 提供类似 zap.SugaredLogger 的平铺参数接口
// 使用 fmt.Sprint 将参数转换为单个消息字符串
type SugaredLogger struct {
	logger *Logger
}

// NewSugaredLogger creates a new SugaredLogger with flattened argument support
// NewSugaredLogger 创建支持平铺参数的新 SugaredLogger
func NewSugaredLogger(logger *Logger) *SugaredLogger {
	return &SugaredLogger{
		logger: logger.Skip(1), // Extra skip to account of method calls
	}
}

// Debug logs flattened arguments at debug level (like fmt.Sprint)
// Debug 在调试级别记录平铺参数（类似 fmt.Sprint）
func (s *SugaredLogger) Debug(args ...any) {
	s.logger.Debug(s.formatSprint(args))
}

// Debugln logs flattened arguments at debug level with spaces (like fmt.Sprintln)
// Debugln 在调试级别记录平铺参数，用空格分隔（类似 fmt.Sprintln）
func (s *SugaredLogger) Debugln(args ...any) {
	s.logger.Debug(s.formatToLine(args))
}

// Info logs flattened arguments at info level (like fmt.Sprint)
// Info 在信息级别记录平铺参数（类似 fmt.Sprint）
func (s *SugaredLogger) Info(args ...any) {
	s.logger.Info(s.formatSprint(args))
}

// Infoln logs flattened arguments at info level with spaces (like fmt.Sprintln)
// Infoln 在信息级别记录平铺参数，用空格分隔（类似 fmt.Sprintln）
func (s *SugaredLogger) Infoln(args ...any) {
	s.logger.Info(s.formatToLine(args))
}

// Warn logs flattened arguments at warn level (like fmt.Sprint)
// Warn 在警告级别记录平铺参数（类似 fmt.Sprint）
func (s *SugaredLogger) Warn(args ...any) {
	s.logger.Warn(s.formatSprint(args))
}

// Warnln logs flattened arguments at warn level with spaces (like fmt.Sprintln)
// Warnln 在警告级别记录平铺参数，用空格分隔（类似 fmt.Sprintln）
func (s *SugaredLogger) Warnln(args ...any) {
	s.logger.Warn(s.formatToLine(args))
}

// Error logs flattened arguments at error level (like fmt.Sprint)
// Error 在错误级别记录平铺参数（类似 fmt.Sprint）
func (s *SugaredLogger) Error(args ...any) {
	s.logger.Error(s.formatSprint(args))
}

// Errorln logs flattened arguments at error level with spaces (like fmt.Sprintln)
// Errorln 在错误级别记录平铺参数，用空格分隔（类似 fmt.Sprintln）
func (s *SugaredLogger) Errorln(args ...any) {
	s.logger.Error(s.formatToLine(args))
}

// DebugContext logs flattened arguments at debug level with context
// DebugContext 在调试级别记录平铺参数，带上下文
func (s *SugaredLogger) DebugContext(ctx context.Context, args ...any) {
	s.logger.DebugContext(ctx, s.formatSprint(args))
}

// DebuglnContext logs flattened arguments at debug level with context and spaces
// DebuglnContext 在调试级别记录平铺参数，带上下文，用空格分隔
func (s *SugaredLogger) DebuglnContext(ctx context.Context, args ...any) {
	s.logger.DebugContext(ctx, s.formatToLine(args))
}

// InfoContext logs flattened arguments at info level with context
// InfoContext 在信息级别记录平铺参数，带上下文
func (s *SugaredLogger) InfoContext(ctx context.Context, args ...any) {
	s.logger.InfoContext(ctx, s.formatSprint(args))
}

// InfolnContext logs flattened arguments at info level with context and spaces
// InfolnContext 在信息级别记录平铺参数，带上下文，用空格分隔
func (s *SugaredLogger) InfolnContext(ctx context.Context, args ...any) {
	s.logger.InfoContext(ctx, s.formatToLine(args))
}

// WarnContext logs flattened arguments at warn level with context
// WarnContext 在警告级别记录平铺参数，带上下文
func (s *SugaredLogger) WarnContext(ctx context.Context, args ...any) {
	s.logger.WarnContext(ctx, s.formatSprint(args))
}

// WarnlnContext logs flattened arguments at warn level with context and spaces
// WarnlnContext 在警告级别记录平铺参数，带上下文，用空格分隔
func (s *SugaredLogger) WarnlnContext(ctx context.Context, args ...any) {
	s.logger.WarnContext(ctx, s.formatToLine(args))
}

// ErrorContext logs flattened arguments at error level with context
// ErrorContext 在错误级别记录平铺参数，带上下文
func (s *SugaredLogger) ErrorContext(ctx context.Context, args ...any) {
	s.logger.ErrorContext(ctx, s.formatSprint(args))
}

// ErrorlnContext logs flattened arguments at error level with context and spaces
// ErrorlnContext 在错误级别记录平铺参数，带上下文，用空格分隔
func (s *SugaredLogger) ErrorlnContext(ctx context.Context, args ...any) {
	s.logger.ErrorContext(ctx, s.formatToLine(args))
}

// formatSprint converts arguments to a single message string using fmt.Sprint
// Uses fmt.Sprint semantics - no spaces between string arguments
//
// formatSprint 使用 fmt.Sprint 将参数转换为单个消息字符串
// 使用 fmt.Sprint 语义 - 字符串参数之间没有空格
func (s *SugaredLogger) formatSprint(args []any) string {
	return fmt.Sprint(args...)
}

// formatToLine converts arguments to a single message string with spaces
// Adds spaces between arguments like fmt.Sprintln semantics
//
// formatToLine 将参数转换为单个消息字符串，参数间用空格分隔
// 在参数之间添加空格，类似 fmt.Sprintln 语义
func (s *SugaredLogger) formatToLine(args []any) string {
	parts := make([]string, len(args))
	for i, arg := range args {
		parts[i] = fmt.Sprint(arg)
	}
	return strings.Join(parts, " ")
}