mlog

type Config struct {
	// Level is the log level.
	Level Level `mconv:"level"`
	// TimeFormat is the log time format.
	TimeFormat string `mconv:"time_format"`
	// Format is the log format.
	Format string `mconv:"format"`
	// Path is the log file path.
	// e.g., /var/log/app.log or /var/log/app.{YYYYmmdd}.log
	Filepath string `mconv:"filepath"`
	// MaxSize is the maximum size in megabytes of the log file before it gets rotated.
	// It is only applicable for 'size' rotation type.
	MaxSize int `mconv:"max_size"` // (MB)
	// MaxBackups is the maximum number of old log files to retain.
	// It is only applicable for 'size' rotation type.
	MaxBackups int `mconv:"max_backups"` // (files)
	// MaxAge is the maximum number of days to retain old log files.
	// It is applicable for both 'size' and 'date' rotation types.
	MaxAge int `mconv:"max_age"` // (days)
	// Stdout is the stdout print.
	Stdout bool `mconv:"stdout"`
	// CtxKeys is the context keys to extract.
	CtxKeys []string `mconv:"ctx_keys"`
}

type Entry struct {
	// log level
	Level Level
	// log message
	Message string
	// log fields
	Data map[string]interface{}
	// Context
	Context context.Context
	// contains filtered or unexported fields
}

type Fields map[string]any

type Hook interface {
	// Levels returns the log levels that the hook applies to.
	Levels() []Level
	// Fire executes the hook when a log entry is written.
	Fire(entry *Entry) error
}

type ILogger interface {
	Print(ctx context.Context, v ...any)                 // Print logs a message at level Info.
	Printf(ctx context.Context, format string, v ...any) // Printf logs a message at level Info.
	Debug(ctx context.Context, v ...any)                 // Debug logs a message at level Debug.
	Debugf(ctx context.Context, format string, v ...any) // Debugf logs a message at level Debug.
	Info(ctx context.Context, v ...any)                  // Info logs a message at level Info.
	Infof(ctx context.Context, format string, v ...any)  // Infof logs a message at level Info.
	Warn(ctx context.Context, v ...any)                  // Warn logs a message at level Warn.
	Warnf(ctx context.Context, format string, v ...any)  // Warnf logs a message at level Warn.
	Error(ctx context.Context, v ...any)                 // Error logs a message at level Error.
	Errorf(ctx context.Context, format string, v ...any) // Errorf logs a message at level Error.
	Fatal(ctx context.Context, v ...any)                 // Fatal logs a message at level Fatal.
	Fatalf(ctx context.Context, format string, v ...any) // Fatalf logs a message at level Fatal.
	Panic(ctx context.Context, v ...any)                 // Panic logs a message at level Panic.
	Panicf(ctx context.Context, format string, v ...any) // Panicf logs a message at level Panic.
}

type Level int

type Logger struct {
	// contains filtered or unexported fields
}