ln

package module

v0.0.8 Latest Latest Go to latest Published: Jan 7, 2026 License: MIT Imports: 12 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/rafalb8/ln

Links

Open Source Insights

Documentation ¶

Index ¶

func Debug(msg string, attrs ...Attr)
func DebugCtx(ctx context.Context, msg string, attrs ...Attr)
func Error(msg string, attrs ...Attr)
func ErrorCtx(ctx context.Context, msg string, attrs ...Attr)
func Fatal(msg string, attrs ...Attr)
func FatalCtx(ctx context.Context, msg string, attrs ...Attr)
func Info(msg string, attrs ...Attr)
func InfoCtx(ctx context.Context, msg string, attrs ...Attr)
func JSONHandler(w io.Writer) *jsonHandler
func Log(level Level, msg string, attrs ...Attr)
func LogCtx(ctx context.Context, level Level, msg string, attrs ...Attr)
func Must[T any](x T, err error) T
func PrintJSON(x any)
func RenderJSON(attrs []Attr, nl bool) []byte
func SimpleHandler(w io.Writer) *simpleHandler
func TextHandler(w io.Writer, multiline bool) *textHandler
func Trace(msg string, attrs ...Attr)
func TraceCtx(ctx context.Context, msg string, attrs ...Attr)
func Warn(msg string, attrs ...Attr)
func WarnCtx(ctx context.Context, msg string, attrs ...Attr)
type Attr
- func Any(key string, value any) Attr
- func Bool(key string, v bool) Attr
- func Duration(key string, v time.Duration) Attr
- func Err(v error) Attr
- func Float[T Floats](key string, v T) Attr
- func Group(key string, v ...Attr) Attr
- func Int[T Signed](key string, v T) Attr
- func String(key, value string) Attr
- func Time(key string, v time.Time) Attr
- func Uint[T Unsigned](key string, v T) Attr
type Config
type Floats
type Format
type Level
- func LevelFrom(str string) Level
- func (l Level) Color() string
- func (l Level) String() string
type Logger
- func New() Logger
- func NewWithConfiguration(cfg Config) Logger
- func (l *Logger) Copy(overrides Config) Logger
- func (l *Logger) Debug(msg string, attrs ...Attr)
- func (l *Logger) DebugCtx(ctx context.Context, msg string, attrs ...Attr)
- func (l *Logger) Error(msg string, attrs ...Attr)
- func (l *Logger) ErrorCtx(ctx context.Context, msg string, attrs ...Attr)
- func (l *Logger) Fatal(msg string, attrs ...Attr)
- func (l *Logger) FatalCtx(ctx context.Context, msg string, attrs ...Attr)
- func (l *Logger) Info(msg string, attrs ...Attr)
- func (l *Logger) InfoCtx(ctx context.Context, msg string, attrs ...Attr)
- func (l *Logger) Log(ctx context.Context, level Level, msg string, attrs []Attr)
- func (l *Logger) Trace(msg string, attrs ...Attr)
- func (l *Logger) TraceCtx(ctx context.Context, msg string, attrs ...Attr)
- func (l *Logger) Warn(msg string, attrs ...Attr)
- func (l *Logger) WarnCtx(ctx context.Context, msg string, attrs ...Attr)
type Record
type Signed
type Switch
type Unsigned

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Debug ¶

func Debug(msg string, attrs ...Attr)

func DebugCtx ¶

func DebugCtx(ctx context.Context, msg string, attrs ...Attr)

func Error ¶

func Error(msg string, attrs ...Attr)

func ErrorCtx ¶

func ErrorCtx(ctx context.Context, msg string, attrs ...Attr)

func Fatal ¶

func Fatal(msg string, attrs ...Attr)

func FatalCtx ¶

func FatalCtx(ctx context.Context, msg string, attrs ...Attr)

func Info ¶

func Info(msg string, attrs ...Attr)

func InfoCtx ¶

func InfoCtx(ctx context.Context, msg string, attrs ...Attr)

func JSONHandler ¶

func JSONHandler(w io.Writer) *jsonHandler

func Log ¶

func Log(level Level, msg string, attrs ...Attr)

func LogCtx ¶

func LogCtx(ctx context.Context, level Level, msg string, attrs ...Attr)

func Must ¶ added in v0.0.3

func Must[T any](x T, err error) T

func PrintJSON ¶ added in v0.0.3

func PrintJSON(x any)

func RenderJSON ¶

func RenderJSON(attrs []Attr, nl bool) []byte

func SimpleHandler ¶ added in v0.0.3

func SimpleHandler(w io.Writer) *simpleHandler

func TextHandler ¶

func TextHandler(w io.Writer, multiline bool) *textHandler

func Trace ¶

func Trace(msg string, attrs ...Attr)

func TraceCtx ¶

func TraceCtx(ctx context.Context, msg string, attrs ...Attr)

func Warn ¶

func Warn(msg string, attrs ...Attr)

func WarnCtx ¶

func WarnCtx(ctx context.Context, msg string, attrs ...Attr)

Types ¶

type Attr ¶

type Attr struct {
	Key   string
	Value any
}

An Attr is a key-value pair.

func Any ¶

func Any(key string, value any) Attr

Any returns any Attr

Use only if value is of a custom type or if specific Attr does not exist

func Bool ¶

func Bool(key string, v bool) Attr

Bool returns bool Attr

func Duration ¶

func Duration(key string, v time.Duration) Attr

Duration returns duration Attr

func Err ¶

func Err(v error) Attr

Err returns error Attr

func Float ¶

func Float[T Floats](key string, v T) Attr

Float returns float64 Attr

func Group ¶

func Group(key string, v ...Attr) Attr

Group returns group Attr

func Int ¶

func Int[T Signed](key string, v T) Attr

Int returns int64 Attr

func String ¶

func String(key, value string) Attr

String returns string Attr

func Time ¶

func Time(key string, v time.Time) Attr

Time returns time Attr

func Uint ¶

func Uint[T Unsigned](key string, v T) Attr

Uint returns uint64 Attr

type Config ¶

type Config struct {
	Level       Level
	Format      Format
	CallerDepth int

	// Switches
	Multiline  Switch
	HideCaller Switch

	Output io.Writer
}

type Floats ¶

type Floats interface {
	~float32 | ~float64
}

type Format ¶ added in v0.0.6

type Format string

const (
	Text   Format = "text"
	Simple Format = "simple"
	JSON   Format = "json"
)

type Level ¶

type Level int8

const (
	LevelTrace Level = iota*4 - 7
	LevelDebug
	LevelInfo
	LevelWarn
	LevelError
	LevelFatal
)

func LevelFrom ¶

func LevelFrom(str string) Level

func (Level) Color ¶

func (l Level) Color() string

Colors used by TextHandler renderer

func (Level) String ¶

func (l Level) String() string

type Logger ¶

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

var Default Logger = New()

Default logger

func New ¶

func New() Logger

New returns logger with default configuration

func NewWithConfiguration ¶

func NewWithConfiguration(cfg Config) Logger

NewWithConfiguration returns logger with given configuration

func (*Logger) Copy ¶ added in v0.0.7

func (l *Logger) Copy(overrides Config) Logger

func (*Logger) Debug ¶

func (l *Logger) Debug(msg string, attrs ...Attr)

func (*Logger) DebugCtx ¶

func (l *Logger) DebugCtx(ctx context.Context, msg string, attrs ...Attr)

func (*Logger) Error ¶

func (l *Logger) Error(msg string, attrs ...Attr)

func (*Logger) ErrorCtx ¶

func (l *Logger) ErrorCtx(ctx context.Context, msg string, attrs ...Attr)

func (*Logger) Fatal ¶

func (l *Logger) Fatal(msg string, attrs ...Attr)

func (*Logger) FatalCtx ¶

func (l *Logger) FatalCtx(ctx context.Context, msg string, attrs ...Attr)

func (*Logger) Info ¶

func (l *Logger) Info(msg string, attrs ...Attr)

func (*Logger) InfoCtx ¶

func (l *Logger) InfoCtx(ctx context.Context, msg string, attrs ...Attr)

func (*Logger) Log ¶

func (l *Logger) Log(ctx context.Context, level Level, msg string, attrs []Attr)

func (*Logger) Trace ¶

func (l *Logger) Trace(msg string, attrs ...Attr)

func (*Logger) TraceCtx ¶

func (l *Logger) TraceCtx(ctx context.Context, msg string, attrs ...Attr)

func (*Logger) Warn ¶

func (l *Logger) Warn(msg string, attrs ...Attr)

func (*Logger) WarnCtx ¶

func (l *Logger) WarnCtx(ctx context.Context, msg string, attrs ...Attr)

type Record ¶

type Record struct {
	Time    time.Time
	Level   Level
	Message string
	Attrs   []Attr

	Caller string
}

type Signed ¶

type Signed interface {
	~int | ~int8 | ~int16 | ~int32 | ~int64
}

type Switch ¶ added in v0.0.6

type Switch uint8

const (
	None Switch = iota
	On
	Off
)

type Unsigned ¶

type Unsigned interface {
	~uint | ~uint8 | ~uint16 | ~uint32 | ~uint64
}

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
middleware
util
env

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL