Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lajosbencz/glo
Logging library for Golang
https://github.com/lajosbencz/glo
golang log
Last synced: 14 days ago
JSON representation
Logging library for Golang
- Host: GitHub
- URL: https://github.com/lajosbencz/glo
- Owner: lajosbencz
- License: mit
- Created: 2019-01-19T22:10:42.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2019-01-23T11:35:10.000Z (almost 6 years ago)
- Last Synced: 2024-07-31T20:52:12.801Z (3 months ago)
- Topics: golang, log
- Language: Go
- Size: 37.1 KB
- Stars: 15
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - glo - PHP Monolog inspired logging facility with identical severity levels. (Logging / Search and Analytic Databases)
- awesome-go-extra - glo - 01-19T22:10:42Z|2019-01-23T11:35:10Z| (Logging / Advanced Console UIs)
README
[](https://godoc.org/github.com/lajosbencz/glo)
[](https://goreportcard.com/report/github.com/lajosbencz/glo)
[](https://codecov.io/gh/lajosbencz/glo)
[](https://app.codacy.com/app/lajosbencz/glo)
[](https://travis-ci.com/lajosbencz/glo.svg?branch=master)
# GLO
## Logging library for Golang
Inspired by Monolog for PHP, severity levels are identical
### Install
```bash
go get github.com/lajosbencz/glo
```
### Severity levels
```bash
Debug = 100
Info = 200
Notice = 250
Warning = 300
Error = 400
Critical = 500
Alert = 550
Emergency = 600
```
### Simple example
```go
package main
import "github.com/lajosbencz/glo"
func main() {
// Info - Warning will go to os.Stdout
// Error - Emergency will go to os.Stderr
log := glo.NewStdFacility()
// goes to os.Stdout
log.Debug("Detailed debug line: %#v", map[string]string{"x": "foo", "y": "bar"})
// goes to os.Stderr
log.Error("Oooof!")
}
```
Output:
```bash
2019-01-22T15:16:08+01:00 [DEBUG] Detailed debug line [map[x:foo y:bar]]
2019-01-22T15:16:08+01:00 [ERROR] Oooof! []
```
### Customized example
```go
package main
import (
"bytes"
"fmt"
"os"
"strings"
"github.com/lajosbencz/glo"
)
func main() {
log := glo.NewFacility()
// write everything to a buffer
bfr := bytes.NewBufferString("")
handlerBfr := glo.NewHandler(bfr)
log.PushHandler(handlerBfr)
// write only errors and above using a short format
handlerStd := glo.NewHandler(os.Stdout)
formatter := glo.NewFormatter("{L}: {M}")
filter := glo.NewFilterLevel(glo.Error)
handlerStd.SetFormatter(formatter)
handlerStd.PushFilter(filter)
log.PushHandler(handlerStd)
fmt.Println("Log output:")
fmt.Println(strings.Repeat("=", 70))
log.Info("Only written to the buffer")
log.Alert("Written to both buffer and stdout")
fmt.Println("")
fmt.Println("Buffer contents:")
fmt.Println(strings.Repeat("=", 70))
fmt.Println(bfr.String())
}
```
Output:
```bash
Log output:
======================================================================
ALERT: Written to both buffer and stdout []
Buffer contents:
======================================================================
2019-01-22T15:14:16+01:00 [INFO] Only written to the buffer []
2019-01-22T15:14:16+01:00 [ALERT] Written to both buffer and stdout []
```
### Custom filter
```go
package main
import (
"os"
"regexp"
"github.com/lajosbencz/glo"
)
func main() {
handler := glo.NewHandler(os.Stdout)
filterEmptyLines := &filterRgx{regexp.MustCompile(`^.+$`)}
handler.PushFilter(filterEmptyLines)
log := glo.NewFacility()
log.PushHandler(handler)
log.Debug("", "format is empty, should be ignored")
log.Debug("only this should appear at the output")
}
type filterRgx struct {
rgx *regexp.Regexp
}
func (f *filterRgx) Check(level glo.Level, line string, params ...interface{}) bool {
return f.rgx.MatchString(line)
}
```
Output:
```bash
2019-01-22T15:30:23+01:00 [DEBUG] only this should appear at the output
```