package slogtime

Import Path
	go.pact.im/x/slogtime (on go.dev)

Dependency Relation
	imports 4 packages, and imported by 0 packages

Involved Source Files

	  d slogtime.go
		Package slogtime provides an alternative [slog.Logger] implementation that
		allows using custom [time.Now] function for log records.
		
		It also has a smaller API surface that requires using explicit [slog.Level],
		[context.Context] and [slog.Attr]s.
Package-Level Type Names (only one, which is exported)

	/* sort exporteds by: alphabet | popularity */
	 type Logger (struct)
		Logger is an alternative implementation of [slog.Logger] that allows
		customizing the time source for log records.
		
		Unlike [slog.Logger], Logger does not provide convenience methods like
		Info, Debug, Warn, or Error. Instead, all logging is done through the
		Log method with explicit level, context, and attributes.

		Fields (total 2, neither is exported)
			/* 2 unexporteds ... *//* 2 unexporteds: */
			handler slog.Handler
			now func() time.Time
		Methods (total 7, in which 6 are exported)
			(*Logger) Enabled(ctx context.Context, level slog.Level) bool
				Enabled reports whether l emits log records at the given context and level.

			(*Logger) Handler() slog.Handler
				Handler returns the underlying [slog.Handler].

			(*Logger) Log(ctx context.Context, level slog.Level, msg string, attrs ...slog.Attr)
				Log emits a log record with the given level, message, and attributes.
				The record includes a source location obtained from the call stack.

			(*Logger) With(attrs ...slog.Attr) *Logger
				With returns a [Logger] that includes the given attributes in each output
				operation. Arguments are converted to attributes as if by [Logger.Log].

			(*Logger) WithGroup(name string) *Logger
				WithGroup returns a [Logger] that starts a group. The keys of all attributes
				added to the [Logger] will be qualified by the given name.

			(*Logger) WithTime(now func() time.Time) *Logger
				WithTime returns a [Logger] that uses the given time function.
				If now is nil, [time.Now] will be used.

			/* one unexported ... *//* one unexported: */
			(*Logger) clone() *Logger
				clone returns a copy of the Logger.

		As Outputs Of (at least 5, in which 4 are exported)
			func New(h slog.Handler, now func() time.Time) *Logger
			func (*Logger).With(attrs ...slog.Attr) *Logger
			func (*Logger).WithGroup(name string) *Logger
			func (*Logger).WithTime(now func() time.Time) *Logger
			/* at least one unexported ... *//* at least one unexported: */
			func (*Logger).clone() *Logger


Package-Level Functions (only one, which is exported)

	 func New(h slog.Handler, now func() time.Time) *Logger
		New creates a new [Logger] that uses the given handler and time function.
		If now is nil, [time.Now] will be used when logging.

The pages are generated with Golds v0.7.6. (GOOS=linux GOARCH=amd64)