Skip to content
/ rogu Public

Yet another taggable, human readable, colorful, structured logger with a builder-like API.

License

Notifications You must be signed in to change notification settings

zekroTJA/rogu

Repository files navigation

rogu

ログ (rogu, jap. log) is yet another taggable, human readable, colorful, structured logging package with a builder-like API. This package is mainly created to be used within shinpuru and other projects of mine. Feel free to use it too, but beware that this package is not optimized for performance.

Warning
Just wanna let you know, the API of this package is not yet final and might change in coming updates.

This package is very much inspired by the colored output style of charmbracelet/log and the builder API style of rs/zerolog.

Levels

Log levels can be set to a Logger via the SetLevel method. Levels are defined in the sub-package level. Levels can be interpreted from a string using the function LevelFromString. Below, you can see available levels with their numeral values, names and aliases. The given names and aliases are valid values which can be passed to LevelFromString.

Level Numeral Value Name and aliases
Panic 1 "panic", "pnc", "p", "1"
Fatal 2 "fatal", "ftl", "f", "2"
Error 3 "error", "err", "e", "3"
Warn 4 "warn", "wrn", "w", "4"
Info 5 "info", "inf", "i", "5"
Debug 6 "debug", "dbg", "f", "6"
Trace 7 "trace", "trc", "t", "7"

slog Support

The rogu.Logger can be used as slog.Handler, so that rogu's pretty writer can be used to format slog records.

roguLogger := slog.New(rogu.NewLogger(rogu.NewPrettyWriter()))
slog.SetDefault(roguLogger)

slog.Info("Hello, world!")

See example/slog for a more complete example.

Because of the architecture of rogu, some implications of slog are not met. Keep those in mind when using rogu as your slog backend!

  • In rogu loggers, the caller is recorded when an event has been sent (using e.Send() or e.Msg(...)). Slog on the other hand sets the caller to the function which has created the record/event.
  • Also, rogu records the event time when the event has been sent. Slog, on the other hand, records the event time when the record/event has been created.

About

Yet another taggable, human readable, colorful, structured logger with a builder-like API.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages