README
¶
go-log 
Go logging done right (well, you know...)
Usage
import "github.com/golangly/log"
...
log.Trace("Hello!")
log.Debug("Hello!")
log.Info("Hello!")
log.Warn("Hello!")
log.Error("Hello!")
log.Panic("Hello!")
log.Fatal("Hello!")
So far, so good - right? well that's basic usage identical to most other loggers. In factm, this logging implementation is probably even a bit slower than loggers such as zerolog or ruslog. There are, however, a few extra features that make this library both opinionated and more compatible to my view of logging:
- Accept recovered panic objects (via
recover()in defer functions usually) and infer automatically whether they are errors or not, and treat them accordingly (it's still a panic, of course and treated as such also). - Automatic configuration from environment variables since you want to configure logging before everything else, including before command line parsing.
- Only print to console. Use other tools to route logging to other places.
- Supports
go-errorsfor error stack traces and error causes automatically. - Super simple.
Configuration
All environment variable names & values are case insensitive.
Set LOG_PRETTY to 1, y, yes or true to enable pretty print (by default JSON logging is used).
Set LOG_LEVEL to disabled, panic or fatal to disable logging (except panics & fatal events), or to error, warn, info, debug or trace to set the log level accordingly.
Contributing
Please read the Code of Conduct & Contributing documents.
License
Documentation
¶
Index ¶
- Variables
- func Debug(msg string)
- func Error(msg string)
- func Fatal(msg string)
- func Info(msg string)
- func JSONPrinter(c Logger, msg string)
- func Panic(msg string)
- func PrettyPrinter(c Logger, msg string)
- func Trace(msg string)
- func Warn(msg string)
- func Writer() io.Writer
- type Level
- type Logger
- func (c *Logger) Debug(msg string)
- func (c *Logger) Error(msg string)
- func (c *Logger) Fatal(msg string)
- func (c *Logger) Info(msg string)
- func (c *Logger) Panic(msg string)
- func (c *Logger) Trace(msg string)
- func (c *Logger) Warn(msg string)
- func (c *Logger) With(key string, val interface{}) *Logger
- func (c *Logger) WithErr(err error) *Logger
- func (c *Logger) WithLevel(level Level) *Logger
- func (c *Logger) WithPanic(recovered interface{}) *Logger
- func (c *Logger) Writer() io.Writer
Constants ¶
This section is empty.
Source Files