zlog

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

type FileManagerConfig struct {
	// MaxAge is the maximum age to keep the archived files.
	// It does not work when time specifiers are not exit
	// in the Pattern. At least %Y, %M and %D, or %u must be specified.
	// Zero or negative value means no limit.
	MaxAge time.Duration
	// MaxHistory is the maximum number of archived files to keep.
	// Zero or negative value means no limit.
	MaxHistory int
	// MaxTotalBytes is the maximum total byte size to keep archived files.
	// Zero or negative value means no limit.
	MaxTotalBytes int64
	// GzipLv specifies the gzip compression level.
	// If non-zero, gzip compression is applied to archived files,
	// and the ".gz" file extension is added.
	// Valid range is from [compress/gzip.HuffmanOnly] to [compress/gzip.BestCompression].
	// If zero, compression is disabled.
	GzipLv int
	// SrcDir is the directory path where source files are exists.
	// File names should have the pattern specified at the Pattern.
	// Current working directory is used when empty.
	SrcDir string
	// DesDir is the destination directory path
	// to place archived files.
	// File names will have the pattern specified at the Pattern
	// with or without additional ".gz" extension.
	// Current working directory is used when empty.
	DstDir string
	// Pattern is the file name pattern to be manged.
	// If empty, "application.%i.log" is used.
	// Following specifiers can be used in the pattern.
	// A ".%i" will be added when no specifiers are found.
	//	%Y : YYYY 4 digits year. 0 <= YYYY
	//	%M : MM 2 digits month. 1 <= MM <= 12
	//	%D : DD 2 digits day of month. 1 <= DD <= 31
	//	%h : hh 2 digits hour. 0 <= hh <= 23
	//	%m : mm 2 digits minute. 0 <= mm <= 59
	//	%s : ss 2 digits second. 0 <= ss <= 59
	//	%u : unix second with free digits. 0 <= unix
	//	%i : index with free digits. 0 <= index
	//	%H : hostname
	//	%U : user id. "-1" on windows.
	//	%G : user group id. "-1" on windows.
	//	%p : pid (process id)
	//	%P : ppid (parent process id)
	Pattern string
}

type Level int

type Logger interface {
	Enabled(ctx context.Context, lv Level) bool
	Debug(ctx context.Context, msg string, args ...any)
	Info(ctx context.Context, msg string, args ...any)
	Warn(ctx context.Context, msg string, args ...any)
	Error(ctx context.Context, msg string, args ...any)
}

type LoggerOption struct {
	// Lv is the log level of the logger.
	Lv Level
	// Flag is the flag for standard logger.
	Flag int
}

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

type LogicalFileConfig struct {
	// Manager is the archive files manager config.
	Manager *FileManagerConfig
	// RotateBytes is the maximum physical file size in bytes.
	// Physical file will be rotated when reached to the size.
	// Zero or negative means no limit, or no file rotation.
	RotateBytes int64
	// FileName is the physical file name that is
	// actively written to.
	// If empty, "application.log" is used.
	FileName string
	// OnFallback is called when underlying physical file
	// operation failed. Before calling the function,
	// write target will be replaced to [os.Stderr].
	// If not set, [os.Stderr] will be used until
	// next file rotation occur.
	OnFallback func(error)
}

type Range uint

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