log

type AllLogger interface {
	CommonLogger
	ControlLogger
	// WithContext returns a logger that is associated with a given context.
	// Parameters:
	//   - ctx: The context to associate with the logger.
	WithContext(ctx context.Context) CommonLogger
}

type CommonLogger interface {
	Logger
	FormatLogger
	WithLogger
}

type ControlLogger interface {
	// SetLevel sets the logging level for the logger.
	// Parameters:
	//   - level: The logging level to set.
	SetLevel(Level)
	// SetOutput sets the output destination for the logger.
	// Parameters:
	//   - writer: The io.Writer to write logs to.
	SetOutput(io.Writer)
}

type FormatLogger interface {
	// Tracef logs a formatted message at the Trace level.
	// Parameters:
	//   - format: The format string.
	//   - v: The variables or objects to format and log.
	Tracef(format string, v ...any)
	// Debugf logs a formatted message at the Debug level.
	// Parameters:
	//   - format: The format string.
	//   - v: The variables or objects to format and log.
	Debugf(format string, v ...any)
	// Infof logs a formatted message at the Info level.
	// Parameters:
	//   - format: The format string.
	//   - v: The variables or objects to format and log.
	Infof(format string, v ...any)
	// Warnf logs a formatted message at the Warning level.
	// Parameters:
	//   - format: The format string.
	//   - v: The variables or objects to format and log.
	Warnf(format string, v ...any)
	// Errorf logs a formatted message at the Error level.
	// Parameters:
	//   - format: The format string.
	//   - v: The variables or objects to format and log.
	Errorf(format string, v ...any)
	// Fatalf logs a formatted message at the Fatal level and exits the application.
	// Parameters:
	//   - format: The format string.
	//   - v: The variables or objects to format and log.
	Fatalf(format string, v ...any)
	// Panicf logs a formatted message at the Panic level.
	// Note: Despite the name, this method does not actually panic.
	// Parameters:
	//   - format: The format string.
	//   - v: The variables or objects to format and log.
	Panicf(format string, v ...any)
}

type Level int

type Logger interface {
	// Trace logs a message at the Trace level.
	// Parameters:
	//   - v: The variables or objects to log.
	Trace(v ...any)
	// Debug logs a message at the Debug level.
	// Parameters:
	//   - v: The variables or objects to log.
	Debug(v ...any)
	// Info logs a message at the Info level.
	// Parameters:
	//   - v: The variables or objects to log.
	Info(v ...any)
	// Warn logs a message at the Warning level.
	// Parameters:
	//   - v: The variables or objects to log.
	Warn(v ...any)
	// Error logs a message at the Error level.
	// Parameters:
	//   - v: The variables or objects to log.
	Error(v ...any)
	// Fatal logs a message at the Fatal level and exits the application.
	// Parameters:
	//   - v: The variables or objects to log.
	Fatal(v ...any)
	// Panic logs a message at the Panic level.
	// Note: Despite the name, this method does not actually panic.
	// Parameters:
	//   - v: The variables or objects to log.
	Panic(v ...any)
}

type WithLogger interface {
	// Tracew logs a message at the Trace level with key-value pairs.
	// Parameters:
	//   - msg: The message string.
	//   - keysAndValues: The key-value pairs to log.
	Tracew(msg string, keysAndValues ...any)
	// Debugw logs a message at the Debug level with key-value pairs.
	// Parameters:
	//   - msg: The message string.
	//   - keysAndValues: The key-value pairs to log.
	Debugw(msg string, keysAndValues ...any)
	// Infow logs a message at the Info level with key-value pairs.
	// Parameters:
	//   - msg: The message string.
	//   - keysAndValues: The key-value pairs to log.
	Infow(msg string, keysAndValues ...any)
	// Warnw logs a message at the Warning level with key-value pairs.
	// Parameters:
	//   - msg: The message string.
	//   - keysAndValues: The key-value pairs to log.
	Warnw(msg string, keysAndValues ...any)
	// Errorw logs a message at the Error level with key-value pairs.
	// Parameters:
	//   - msg: The message string.
	//   - keysAndValues: The key-value pairs to log.
	Errorw(msg string, keysAndValues ...any)
	// Fatalw logs a message at the Fatal level with key-value pairs and exits the application.
	// Parameters:
	//   - msg: The message string.
	//   - keysAndValues: The key-value pairs to log.
	Fatalw(msg string, keysAndValues ...any)
	// Panicw logs a message at the Panic level with key-value pairs.
	// Note: Despite the name, this method does not actually panic.
	// Parameters:
	//   - msg: The message string.
	//   - keysAndValues: The key-value pairs to log.
	Panicw(msg string, keysAndValues ...any)
}