2020-02-07 00:35:46 +03:00
|
|
|
// Package log provides a log interface
|
|
|
|
package logger
|
|
|
|
|
2020-02-21 10:57:59 +03:00
|
|
|
var (
|
|
|
|
// Default logger
|
|
|
|
DefaultLogger Logger = NewLogger()
|
2020-02-07 00:35:46 +03:00
|
|
|
)
|
|
|
|
|
|
|
|
// Logger is a generic logging interface
|
|
|
|
type Logger interface {
|
2020-02-07 00:36:33 +03:00
|
|
|
// Init initialises options
|
2020-02-07 00:35:46 +03:00
|
|
|
Init(options ...Option) error
|
2020-02-20 11:26:12 +03:00
|
|
|
// The Logger options
|
|
|
|
Options() Options
|
2020-02-15 21:19:28 +03:00
|
|
|
// Error set `error` field to be logged
|
|
|
|
Error(err error) Logger
|
2020-02-20 11:26:12 +03:00
|
|
|
// Fields set fields to always be logged
|
|
|
|
Fields(fields map[string]interface{}) Logger
|
|
|
|
// Log writes a log entry
|
|
|
|
Log(level Level, v ...interface{})
|
|
|
|
// Logf writes a formatted log entry
|
|
|
|
Logf(level Level, format string, v ...interface{})
|
2020-02-07 00:36:33 +03:00
|
|
|
// String returns the name of logger
|
|
|
|
String() string
|
2020-02-07 00:35:46 +03:00
|
|
|
}
|
|
|
|
|
2020-02-21 10:57:59 +03:00
|
|
|
func Init(opts ...Option) error {
|
|
|
|
return DefaultLogger.Init(opts...)
|
|
|
|
}
|
2020-02-07 00:35:46 +03:00
|
|
|
|
2020-02-21 10:57:59 +03:00
|
|
|
func Fields(fields map[string]interface{}) Logger {
|
|
|
|
return DefaultLogger.Fields(fields)
|
2020-02-07 00:35:46 +03:00
|
|
|
}
|
|
|
|
|
2020-02-21 10:57:59 +03:00
|
|
|
func Log(level Level, v ...interface{}) {
|
|
|
|
DefaultLogger.Log(level, v...)
|
|
|
|
}
|
2020-02-07 00:35:46 +03:00
|
|
|
|
2020-02-21 10:57:59 +03:00
|
|
|
func Logf(level Level, format string, v ...interface{}) {
|
|
|
|
DefaultLogger.Logf(level, format, v...)
|
2020-02-07 00:35:46 +03:00
|
|
|
}
|
2020-02-15 21:19:28 +03:00
|
|
|
|
2020-02-21 10:57:59 +03:00
|
|
|
func String() string {
|
|
|
|
return DefaultLogger.String()
|
2020-02-15 21:19:28 +03:00
|
|
|
}
|
2020-02-21 11:43:23 +03:00
|
|
|
|
|
|
|
func WithError(err error) Logger {
|
|
|
|
return DefaultLogger.Error(err)
|
|
|
|
}
|