Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chzyer/logex

An golang log lib, supports tracking and level, wrap by standard log lib
https://github.com/chzyer/logex

Last synced: 9 days ago
JSON representation

An golang log lib, supports tracking and level, wrap by standard log lib

Awesome Lists containing this project

README

        

Logex
=======
[![Build Status](https://travis-ci.org/chzyer/logex.svg?branch=master)](https://travis-ci.org/chzyer/logex)
[![GoDoc](https://godoc.org/github.com/chzyer/logex?status.svg)](https://godoc.org/github.com/chzyer/logex)

An golang log lib, supports tracing and level, wrap by standard log lib

How To Get
=======
shell
```
go get github.com/chzyer/logex
```

source code
```{go}
import "github.com/chzyer/logex" // package name is logex

func main() {
logex.Info("Hello!")
}
```

Level
=======

```{go}
import "github.com/chzyer/logex"

func main() {
logex.Println("")
logex.Debug("debug staff.") // Only show if has an "DEBUG" named env variable(whatever value).
logex.Info("info")
logex.Warn("")
logex.Fatal("") // also trigger exec "os.Exit(1)"
logex.Error(err) // print error
logex.Struct(obj) // print objs follow such layout "%T(%+v)"
logex.Pretty(obj) // print objs as JSON-style, more readable and hide non-publish properties, just JSON
}
```

Extendability
======

source code
```{go}
type MyStruct struct {
BiteMe bool
}
```

may change to

```{go}
type MyStruct struct {
BiteMe bool
logex.Logger // just this
}

func main() {
ms := new(MyStruct)
ms.Info("woo!")
}
```

Runtime Tracing
======
All log will attach theirs stack info. Stack Info will shown by an layout, `{packageName}.{FuncName}:{FileName}:{FileLine}`

```{go}
package main

import "github.com/chzyer/logex"

func test() {
logex.Pretty("hello")
}

func main() {
test()
}
```

response
```
2014/10/10 15:17:14 [main.test:testlog.go:6][PRETTY] "hello"
```

Error Tracing
======
You can trace an error if you want.

```{go}
package main

import (
"github.com/chzyer/logex"
"os"
)

func openfile() (*os.File, error) {
f, err := os.Open("xxx")
if err != nil {
err = logex.Trace(err)
}
return f, err
}

func test() error {
f, err := openfile()
if err != nil {
return logex.Trace(err)
}
f.Close()
return nil
}

func main() {
err := test()
if err != nil {
logex.Error(err)
return
}
logex.Info("test success")
}
```

response
```
2014/10/10 15:22:29 [main.main:testlog.go:28][ERROR] [main.openfile:11;main.test:19] open xxx: no such file or directory
```