2020-11-02 13:25:29 +03:00
|
|
|
// Package logger provides a log interface
|
2020-02-07 05:35:46 +08:00
|
|
|
package logger
|
|
|
|
|
2021-01-10 18:56:39 +03:00
|
|
|
import "context"
|
|
|
|
|
2020-02-20 23:57:59 -08:00
|
|
|
var (
|
2020-11-02 13:25:29 +03:00
|
|
|
// DefaultLogger variable
|
2020-11-04 00:38:12 +03:00
|
|
|
DefaultLogger Logger = NewLogger()
|
2021-01-10 18:56:39 +03:00
|
|
|
// DefaultLogger level
|
|
|
|
DefaultLevel Level = InfoLevel
|
2020-02-07 05:35:46 +08:00
|
|
|
)
|
|
|
|
|
|
|
|
// Logger is a generic logging interface
|
|
|
|
type Logger interface {
|
2020-02-06 21:36:33 +00:00
|
|
|
// Init initialises options
|
2020-10-16 09:38:57 +03:00
|
|
|
Init(opts ...Option) error
|
2020-08-29 17:43:06 +03:00
|
|
|
// V compare provided verbosity level with current log level
|
|
|
|
V(level Level) bool
|
2020-02-20 08:26:12 +00:00
|
|
|
// The Logger options
|
|
|
|
Options() Options
|
|
|
|
// Fields set fields to always be logged
|
|
|
|
Fields(fields map[string]interface{}) Logger
|
2020-11-04 00:38:12 +03:00
|
|
|
// Info level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Info(ctx context.Context, args ...interface{})
|
2020-11-04 00:38:12 +03:00
|
|
|
// Trace level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Trace(ctx context.Context, args ...interface{})
|
2020-11-04 00:38:12 +03:00
|
|
|
// Debug level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Debug(ctx context.Context, args ...interface{})
|
2020-11-04 00:38:12 +03:00
|
|
|
// Warn level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Warn(ctx context.Context, args ...interface{})
|
2020-11-04 00:38:12 +03:00
|
|
|
// Error level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Error(ctx context.Context, args ...interface{})
|
2020-11-04 00:38:12 +03:00
|
|
|
// Fatal level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Fatal(ctx context.Context, args ...interface{})
|
2020-11-10 22:18:16 +03:00
|
|
|
// Infof level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Infof(ctx context.Context, msg string, args ...interface{})
|
2020-11-10 22:18:16 +03:00
|
|
|
// Tracef level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Tracef(ctx context.Context, msg string, args ...interface{})
|
2020-11-10 22:18:16 +03:00
|
|
|
// Debug level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Debugf(ctx context.Context, msg string, args ...interface{})
|
2020-11-10 22:18:16 +03:00
|
|
|
// Warn level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Warnf(ctx context.Context, msg string, args ...interface{})
|
2020-11-10 22:18:16 +03:00
|
|
|
// Error level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Errorf(ctx context.Context, msg string, args ...interface{})
|
2020-11-10 22:18:16 +03:00
|
|
|
// Fatal level message
|
2021-01-10 18:56:39 +03:00
|
|
|
Fatalf(ctx context.Context, msg string, args ...interface{})
|
|
|
|
// Log logs message with needed level
|
|
|
|
Log(ctx context.Context, level Level, args ...interface{})
|
|
|
|
// Logf logs message with needed level
|
|
|
|
Logf(ctx context.Context, level Level, msg string, args ...interface{})
|
2020-02-06 21:36:33 +00:00
|
|
|
// String returns the name of logger
|
|
|
|
String() string
|
2020-02-07 05:35:46 +08:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Info writes msg to default logger on info level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Info(ctx context.Context, args ...interface{}) {
|
|
|
|
DefaultLogger.Info(ctx, args...)
|
2020-11-10 22:18:16 +03:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Error writes msg to default logger on error level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Error(ctx context.Context, args ...interface{}) {
|
|
|
|
DefaultLogger.Error(ctx, args...)
|
2020-11-10 22:18:16 +03:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Debug writes msg to default logger on debug level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Debug(ctx context.Context, args ...interface{}) {
|
|
|
|
DefaultLogger.Debug(ctx, args...)
|
2020-11-10 22:18:16 +03:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Warn writes msg to default logger on warn level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Warn(ctx context.Context, args ...interface{}) {
|
|
|
|
DefaultLogger.Warn(ctx, args...)
|
2020-11-10 22:18:16 +03:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Trace writes msg to default logger on trace level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Trace(ctx context.Context, args ...interface{}) {
|
|
|
|
DefaultLogger.Trace(ctx, args...)
|
2020-11-10 22:18:16 +03:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Fatal writes msg to default logger on fatal level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Fatal(ctx context.Context, args ...interface{}) {
|
|
|
|
DefaultLogger.Fatal(ctx, args...)
|
2020-11-10 22:18:16 +03:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Infof writes formatted msg to default logger on info level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Infof(ctx context.Context, msg string, args ...interface{}) {
|
|
|
|
DefaultLogger.Infof(ctx, msg, args...)
|
2020-02-20 23:57:59 -08:00
|
|
|
}
|
2020-02-07 05:35:46 +08:00
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Errorf writes formatted msg to default logger on error level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Errorf(ctx context.Context, msg string, args ...interface{}) {
|
|
|
|
DefaultLogger.Errorf(ctx, msg, args...)
|
2020-11-04 00:38:12 +03:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Debugf writes formatted msg to default logger on debug level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Debugf(ctx context.Context, msg string, args ...interface{}) {
|
|
|
|
DefaultLogger.Debugf(ctx, msg, args...)
|
2020-11-04 00:38:12 +03:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Warnf writes formatted msg to default logger on warn level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Warnf(ctx context.Context, msg string, args ...interface{}) {
|
|
|
|
DefaultLogger.Warnf(ctx, msg, args...)
|
2020-02-07 05:35:46 +08:00
|
|
|
}
|
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Tracef writes formatted msg to default logger on trace level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Tracef(ctx context.Context, msg string, args ...interface{}) {
|
|
|
|
DefaultLogger.Tracef(ctx, msg, args...)
|
2020-02-20 23:57:59 -08:00
|
|
|
}
|
2020-02-07 05:35:46 +08:00
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// Fatalf writes formatted msg to default logger on fatal level
|
2021-01-10 18:56:39 +03:00
|
|
|
func Fatalf(ctx context.Context, msg string, args ...interface{}) {
|
|
|
|
DefaultLogger.Fatalf(ctx, msg, args...)
|
2020-02-07 05:35:46 +08:00
|
|
|
}
|
2020-02-15 10:19:28 -08:00
|
|
|
|
2020-12-08 00:38:37 +03:00
|
|
|
// V returns true if passed level enabled in default logger
|
2020-11-04 00:38:12 +03:00
|
|
|
func V(level Level) bool {
|
|
|
|
return DefaultLogger.V(level)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Init initialize logger
|
|
|
|
func Init(opts ...Option) error {
|
|
|
|
return DefaultLogger.Init(opts...)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Fields create logger with specific fields
|
|
|
|
func Fields(fields map[string]interface{}) Logger {
|
|
|
|
return DefaultLogger.Fields(fields)
|
2020-02-15 10:19:28 -08:00
|
|
|
}
|