rogu

README

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.

Documentation

Index

• type Closer
• type Event
  • func (t *Event) Caller() *Event
  • func (t *Event) Discard()
  • func (t *Event) Err(err error) *Event
  • func (t *Event) Field(key, value any) *Event
  • func (t *Event) Fields(kv ...any) *Event
  • func (t *Event) Msg(v string) error
  • func (t *Event) Msgf(format string, args ...any) error
  • func (t *Event) Reset()
  • func (t *Event) Send() error
  • func (t *Event) Tag(tag string) *Event
• type Field
  • func (t *Field) Reset()
• type JsonWriter
  • func NewJsonWriter(outputs ...io.Writer) *JsonWriter
  • func (t *JsonWriter) Close() error
  • func (t *JsonWriter) Write(lvl level.Level, fields []*Field, tag string, lErr error, callerFile string, ...) (err error)
• type Logger
  • func NewLogger(writer ...Writer) Logger
• type MultiWriter
  • func (t MultiWriter) Close() error
  • func (t MultiWriter) Write(lvl level.Level, fields []*Field, tag string, lErr error, callerFile string, ...) (err error)
• type PrettyWriter
  • func NewPrettyWriter(outputs ...io.Writer) *PrettyWriter
  • func (t *PrettyWriter) Close() error
  • func (t *PrettyWriter) Write(lvl level.Level, fields []*Field, tag string, lErr error, callerFile string, ...) (err error)
• type Writer

Types

type Closer

type Closer interface {
	Close() error
}

Closer is used to close stuff. 🤯

type Event

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

Event is used to build and send log messages.

func (*Event) Caller

func (t *Event) Caller() *Event

Caller adds the current file and line to the event.

func (*Event) Discard

func (t *Event) Discard()

Discard simply throws away the event and gives back the used resources.

This should always be called when an event will not be commited.

func (*Event) Err

func (t *Event) Err(err error) *Event

Err sets an error value to the event.

func (*Event) Field

func (t *Event) Field(key, value any) *Event

Field adds a single key-value field.

func (*Event) Fields

func (t *Event) Fields(kv ...any) *Event

Fields adds passed value alternating as keys and values to the events fields.

When an odd number of values is passed, the last field's value will be nil.

Example:

rogu.Info().Fields(
    "name", "Bob",
    "age", 24,
    "hobbies", []stirng{"biking", "football", "gaming"},
)

func (*Event) Msg

func (t *Event) Msg(v string) error

Msg commits the event to the writer with the given message string returning an error when the log writing failed.

func (*Event) Msgf

func (t *Event) Msgf(format string, args ...any) error

Msgf is an alias for Msg with a format and given values.

func (*Event) Reset

func (t *Event) Reset()

func (*Event) Send

func (t *Event) Send() error

Send commits the event without any message.

func (*Event) Tag

func (t *Event) Tag(tag string) *Event

Tag sets the tag of the event.

This will overwtite the tag set by the logger.

type Field

type Field struct {
	Key any
	Val any
	// contains filtered or unexported fields
}

Field hols a hey-value pair of any type.

func (*Field) Reset

func (t *Field) Reset()

type JsonWriter

type JsonWriter struct {
	Output     io.Writer
	TimeFormat string
	// contains filtered or unexported fields
}

JsonWriter implements Writer for JSON formatted entry output.

func NewJsonWriter

func NewJsonWriter(outputs ...io.Writer) *JsonWriter

NewJsonWriter returns a new JsonWriter with the passed target output writers.

func (*JsonWriter) Close

func (t *JsonWriter) Close() error

func (*JsonWriter) Write

func (t *JsonWriter) Write(
	lvl level.Level,
	fields []*Field,
	tag string,
	lErr error,
	callerFile string,
	callerLine int,
	msg string,
) (err error)

type Logger

type Logger interface {
	Closer

	AddWriter(w Writer) Logger
	Copy() *logger
	Debug() *Event
	Error() *Event
	Fatal() *Event
	Info() *Event
	Panic() *Event
	SetCaller(enable bool) Logger
	SetLevel(lvl level.Level) Logger
	SetWriter(w Writer) Logger
	Tagged(tag string) Logger
	Trace() *Event
	Warn() *Event
	WithLevel(lvl level.Level) *Event
}

Logger is used to create log events and to specify writers which are used to write commited events.

func NewLogger

func NewLogger(writer ...Writer) Logger

NewLogger returns a new instance of Logger with the passed writers.

If no writer is specified or set via `SetWriter`, the logger will never output anything.

type MultiWriter

type MultiWriter []Writer

MultiWriter writes events to multiple registered writers.

func (MultiWriter) Close

func (t MultiWriter) Close() error

Close closes the set writers or all writers that are added to the logger and which are closable.

func (MultiWriter) Write

func (t MultiWriter) Write(
	lvl level.Level,
	fields []*Field,
	tag string,
	lErr error,
	callerFile string,
	callerLine int,
	msg string,
) (err error)

type PrettyWriter

type PrettyWriter struct {
	Output io.Writer

	NoColor    bool
	TimeFormat string

	StyleTimestamp          lipgloss.Style
	StyleLevelPanic         lipgloss.Style
	StyleLevelFatal         lipgloss.Style
	StyleLevelError         lipgloss.Style
	StyleLevelWarn          lipgloss.Style
	StyleLevelInfo          lipgloss.Style
	StyleLevelDebug         lipgloss.Style
	StyleLevelTrace         lipgloss.Style
	StyleCaller             lipgloss.Style
	StyleTag                lipgloss.Style
	StyleFieldKey           lipgloss.Style
	StyleFieldValue         lipgloss.Style
	StyleFieldMultipleKey   lipgloss.Style
	StyleFieldMultipleValue lipgloss.Style
	StyleFieldErrorKey      lipgloss.Style
	StyleFieldErrorValue    lipgloss.Style
	StyleMessage            lipgloss.Style
	// contains filtered or unexported fields
}

PrettyWriter implements Writer for human readable, colorful, structured console output.

You can set NoColor to true to supress colorful formatting.

With setting TimeFormat you specify the format of the timestamp and time.Time field values. When TimeFormat is set to an empty string, no timestamp will be printed.

If you want to alter the style of the output, feel free to set custom definitions for the defined styles.

func NewPrettyWriter

func NewPrettyWriter(outputs ...io.Writer) *PrettyWriter

NewPrettyWriter returns a new instance of PrettyWriter with the given output writers. When no writers are specified, os.Stdout will be used.

func (*PrettyWriter) Close

func (t *PrettyWriter) Close() error

func (*PrettyWriter) Write

func (t *PrettyWriter) Write(
	lvl level.Level,
	fields []*Field,
	tag string,
	lErr error,
	callerFile string,
	callerLine int,
	msg string,
) (err error)

type Writer

type Writer interface {
	Write(
		lvl level.Level,
		fields []*Field,
		tag string,
		err error,
		callerFile string,
		callerLine int,
		msg string,
	) error
}

Writer takes log entry components and writes them somewhere.