log

type ContextExtractor func(ctx context.Context) []field.Field

type ContextExtractors []ContextExtractor

type ContextualLogger interface {
	// Debugc formats the message according to the format specifier
	// with some additional info in the context and logs it at debug level.
	Debugc(ctx context.Context, template string, args ...interface{})

	// Infoc formats the message according to the format specifier
	// with some additional info in the context and logs it at info level.
	Infoc(ctx context.Context, template string, args ...interface{})

	// Warnc formats the message according to the format specifier
	// with some additional info in the context and logs it at warn level.
	Warnc(ctx context.Context, template string, args ...interface{})

	// Errorc formats the message according to the format specifier
	// with some additional info in the context and logs it at error level.
	Errorc(ctx context.Context, template string, args ...interface{})

	// Fatalc formats the message according to the format specifier
	// with some additional info in the context and calls os.Exit.
	Fatalc(ctx context.Context, template string, args ...interface{})

	// Panicc formats the message according to the format specifier
	// with some additional info in the context and panics.
	Panicc(ctx context.Context, template string, args ...interface{})
}

type FiledKey int

type Logger interface {
	StdLogger
	ContextualLogger

	// WithCtx adds additional info in the context and
	// additional fields to the logging context.
	WithCtx(ctx context.Context, additionalFields ...field.Field) Logger

	// WithField adds a variadic number of fields to the logging context.
	WithField(fields ...field.Field) Logger

	// WithError adds an error with FieldKeyErr field to the logging context.
	WithError(err error) Logger

	// WithErrors adds a field with FieldKeyErr field that carries a slice of errors.
	WithErrors(errs ...error) Logger

	// WithAny adds a key and an arbitrary value and chooses the best way to represent
	// them as a field.
	WithAny(key string, value interface{}) Logger
}

type OptionFunc func(opt *Options)

type Options struct {
	// Development puts the logger in development mode, which changes the
	// behavior of DPanicLevel and takes stack traces more liberally.
	Development bool

	// LogLevel is the minimum enabled logging level.
	// In Development mode, LogLevel will be set to DEBUG,
	// Opposite, LogLevel will be set to INFO mode automatically.
	LogLevel string

	// JsonOutputMode Enable or disable json output mode.
	JsonOutputMode bool

	// DisableCaller stops annotating logs with the calling function's file
	// name and line number. By default, all logs are annotated.
	DisableCaller bool

	// DisableStacktrace completely disables automatic stacktrace capturing. By
	// default, stacktrace-s are captured for WarnLevel and above logs in
	// development and ErrorLevel and above in production.
	DisableStacktrace bool

	// CallerSkip Set the number of callers
	// will be skipped before show caller
	CallerSkip int

	// FieldKeyMap Set the keys used for each log entry.
	// If any key is empty, that portion of the entry is omitted.
	FieldKeyMap map[FiledKey]string

	// ContextExtractors Define the list of extractors
	// that will be used when extract value from log context.
	ContextExtractors ContextExtractors
}

type Properties struct {
	// Development puts the logger in development mode, which changes the
	// behavior of DPanicLevel and takes stack traces more liberally.
	Development bool `default:"false"`

	// LogLevel is the minimum enabled logging level.
	// In Development mode, LogLevel will be set to DEBUG,
	// Opposite, LogLevel will be set to INFO mode automatically.
	LogLevel string

	// JsonOutputMode Enable or disable json output mode.
	JsonOutputMode bool `default:"true"`

	// DisableCaller stops annotating logs with the calling function's file
	// name and line number. By default, all logs are annotated.
	DisableCaller bool

	// DisableStacktrace completely disables automatic stacktrace capturing. By
	// default, stacktrace-s are captured for WarnLevel and above logs in
	// development and ErrorLevel and above in production.
	DisableStacktrace bool

	// CallerSkip Set the number of callers
	// will be skipped before show caller
	CallerSkip int `default:"1"`
}

type StdLogger interface {
	// Debug logs the provided arguments at debug level.
	// Spaces are added between arguments when neither is a string.
	Debug(args ...interface{})

	// Info logs the provided arguments at debug level.
	// Spaces are added between arguments when neither is a string.
	Info(args ...interface{})

	// Warn logs the provided arguments at debug level.
	// Spaces are added between arguments when neither is a string.
	Warn(args ...interface{})

	// Error logs the provided arguments at debug level.
	// Spaces are added between arguments when neither is a string.
	Error(args ...interface{})

	// Fatal constructs a message with the provided arguments and calls os.Exit.
	// Spaces are added between arguments when neither is a string.
	Fatal(args ...interface{})

	// Panic constructs a message with the provided arguments and panics.
	// Spaces are added between arguments when neither is a string.
	Panic(args ...interface{})

	// Debugf formats the message according to the format specifier
	// and logs it at debug level.
	Debugf(template string, args ...interface{})

	// Infof formats the message according to the format specifier
	// and logs it at info level.
	Infof(template string, args ...interface{})

	// Warnf formats the message according to the format specifier
	// and logs it at warn level.
	Warnf(template string, args ...interface{})

	// Errorf formats the message according to the format specifier
	// and logs it at error level.
	Errorf(template string, args ...interface{})

	// Fatalf formats the message according to the format specifier
	// and calls os.Exit.
	Fatalf(template string, args ...interface{})

	// Panicf formats the message according to the format specifier
	// and panics.
	Panicf(template string, args ...interface{})
}

type TestingLogger struct {
	*ZapLogger
	// contains filtered or unexported fields
}

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

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