logging

type Attr struct {
	Key   string
	Value AttrValue
}

type AttrKind uint8

type AttrReplaceFunc func(groups []string, a Attr) (Attr, error)

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

type Color uint

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

type Config struct {
	// AddSource is set to true then the handler adds a ("source", "file:line")
	// attribute to the output indicating the source code position of the log
	// statement. AddSource is false by default to skip the cost of computing
	// this information.
	AddSource bool

	Colors bool

	// Level reports the minimum record level that will be logged.
	// The handler discards records with lower levels.
	// Default: LevelInfo
	Level Level

	// Secrets is a collection of log attr keys whose values are masked in logs.
	Secrets []string

	ReplaceAttr []AttrReplaceFunc

	TimeLoc        string
	TimeLayout     string
	DefaultHandler HandlerKind
}

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

type DefaultLogger[LVL LevelIface] struct {
	// contains filtered or unexported fields
}

type Handler interface {
	// Enabled reports whether the handler handles records at the given level.
	// The handler ignores records whose level is lower.
	// It is called early, before any arguments are processed,
	// to save effort if the log event should be discarded.
	// The Logger's context is passed so Enabled can use its values
	// to make a decision. The context may be nil.
	Enabled(ctx context.Context, level Level) bool

	// Handle handles the Record.
	// It will only be called if Enabled returns true.
	//
	// The first argument is the context of the Logger that created the Record,
	// which may be nil.
	// It is present solely to provide Handlers access to the context's values.
	// Canceling the context should not affect record processing.
	// (Among other things, log messages may be necessary to debug a
	// cancellation-related problem.)
	//
	// Handle methods that produce output should observe the following rules:
	//   - If r.Time is the zero time, ignore the time.
	//   - If an Attr's key is the empty string and the value is not a group,
	//     ignore the Attr.
	//   - If a group's key is empty, inline the group's Attrs.
	//   - If a group has no Attrs (even if it has a non-empty key),
	//     ignore it.
	Handle(ctx context.Context, r Record) error

	// WithAttrs returns a new Handler whose attributes consist of
	// both the receiver's attributes and the arguments.
	// The Handler owns the slice: it may retain, modify or discard it.
	// [Logger.With] will resolve the Attrs.
	WithAttrs(attrs ...Attr) Handler

	// WithGroup returns a new Handler with the given group appended to
	// the receiver's existing groups.
	// The keys of all subsequent attributes, whether added by With or in a
	// Record, should be qualified by the sequence of group names.
	//
	// How this qualification happens is up to the Handler, so long as
	// this Handler's attribute keys differ from those of another Handler
	// with a different sequence of group names.
	//
	// A Handler should treat WithGroup as starting a Group of Attrs that ends
	// at the end of the log event. That is,
	//
	//     logger.WithGroup("s").LogAttrs(level, msg, slog.Int("a", 1), slog.Int("b", 2))
	//
	// should behave like
	//
	//     logger.LogAttrs(level, msg, slog.Group("s", slog.Int("a", 1), slog.Int("b", 2)))
	//
	// If the name is empty, WithGroup returns the receiver.
	WithGroup(name string) Handler

	// Dispose discards handlerer and frees resources used by handler
	Dispose() error

	// Flags returns record flags for handler.
	Flags() RecordFlag
}

type HandlerKind uint8

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

type Level int32

type LevelIface interface {
	String() string
	Int() int
	MarshalText() ([]byte, error)
}

type Logger interface {
	Level() LevelIface
	SetLevel(LevelIface)
	SystemDebug(msg string, args ...any)
	Debug(msg string, args ...any)
	Info(msg string, args ...any)
	Ok(msg string, args ...any)
	Notice(msg string, args ...any)
	Warn(msg string, args ...any)
	NotImplemented(msg string, args ...any)
	Deprecated(msg string, args ...any)
	Issue(msg string, args ...any)
	Error(msg string, err error, args ...any)
	BUG(msg string, args ...any)
	Msg(msg string, args ...any)
	Msgf(format string, args ...any)
	Log(level LevelIface, msg string, args ...any)
	HTTP(status int, path string, args ...any)
	LogDepth(ctx context.Context, calldepth int, level LevelIface, msg string, err error, args ...any)
	With(args ...any) Logger
	WithGroup(group string) Logger
}

type LoggerIface[LVL LevelIface] interface {
	Level() LevelIface
	SetLevel(LevelIface)
	SystemDebug(msg string, args ...any)
	Debug(msg string, args ...any)
	Info(msg string, args ...any)
	Ok(msg string, args ...any)
	Notice(msg string, args ...any)
	Warn(msg string, args ...any)
	NotImplemented(msg string, args ...any)
	Deprecated(msg string, args ...any)
	Issue(msg string, args ...any)
	Error(msg string, err error, args ...any)
	BUG(msg string, args ...any)
	Msg(msg string, args ...any)
	Msgf(format string, args ...any)
	Log(level LevelIface, msg string, args ...any)
	HTTP(status int, path string, args ...any)
	LogDepth(ctx context.Context, calldepth int, level LevelIface, msg string, err error, args ...any)
	With(args ...any) Logger
	WithGroup(group string) Logger
}

type Record struct {
	Time       time.Time
	TimeString Attr
	Level      Attr
	Error      Attr
	Message    Attr
	Source     Attr
	Data       Attr
	// contains filtered or unexported fields
}

type RecordFlag uint8

type RecordTimestampKind int

type Settings struct {
	Level             Level           `key:"level" default:"ok" mutation:"mutable"`
	Secrets           settings.String `key:"secrets" mutation:"once"`
	Source            settings.Bool   `key:"source" default:"false" mutation:"once"`
	Handler           HandlerKind     `key:"default.handler" default:"colored" mutation:"once"`
	TimestampEnabled  settings.Bool   `key:"timestamp.enabled" default:"true" mutation:"once"`
	TimestampFormat   settings.String `key:"timestamp.format" default:"15:04:05.999" mutation:"once"`
	TimestampLocation settings.String `key:"timestamp.location" default:"Local" mutation:"once"`
	SlogGlobal        settings.Bool   `key:"slog.global" default:"false" mutation:"once"`
}

type TaskInfo struct {
	// Name of the task
	Name string
	// Description of the task
	Description string
	// contains filtered or unexported fields
}

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