# README
logs

高性能日志库
goos: darwin
goarch: amd64
pkg: github.com/imkira/go-loggers-bench
cpu: Intel(R) Core(TM) i5-5257U CPU @ 2.70GHz
BenchmarkLogsTextPositive-4 100000000 320.9 ns/op 40 B/op 2 allocs/op
BenchmarkLogsTextNegative-4 1000000000 9.407 ns/op 0 B/op 0 allocs/op
BenchmarkLogsJSONNegative-4 1000000000 11.42 ns/op 0 B/op 0 allocs/op
BenchmarkLogsJSONPositive-4 65887180 578.6 ns/op 40 B/op 2 allocs/op
import "github.com/issue9/logs/v6"
l := logs.New(logs.NewTextHandler(...))
l.DEBUG().Print("debug start...")
erro := l.With(logs.LevelError, map[string]interface{}{"k1":"v1"})
erro.Printf("带默认参数 k1=v1") // 不用 With 指定 k1,err 全都自动带上此参数
安装
go get github.com/issue9/logs/v6
版权
# Packages
Package writers 提供了一组实现 [io.Writer] 接口的结构.
# Functions
No description provided by the author
MergeHandler 将多个 Handler 合并成一个 Handler 接口对象.
New 声明 Logs 对象
h 如果为 nil,则表示采用 [NewNopHandler]。.
NewBuffer 声明 [Buffer] 对象
detail 是否打印错误信息的调用堆栈;.
NewDispatchHandler 根据 [Level] 派发到不同的 [Handler] 对象.
NewJSONHandler 返回将 [Record] 以 JSON 的形式写入 w 的对象
NOTE: 如果向 w 输出内容时出错,会将错误信息输出到终端作为最后的处理方式。.
NewNopHandler 空的 Handler 接口实现.
NewTermHandler 返回将 [Record] 写入终端的对象
w 表示终端的接口,可以是 [os.Stderr] 或是 [os.Stdout], 如果是其它的实现者则会带控制字符一起输出; foreColors 表示各类别信息的字符颜色,背景始终是默认色,未指定的颜色会从 [defaultTermColors] 获取;
NOTE: 如果向 w 输出内容时出错,将会导致 panic。.
NewTextHandler 返回将 [Record] 以普通文本的形式写入 w 的对象
NOTE: 如果向 w 输出内容时出错,会将错误信息输出到终端作为最后的处理方式。.
No description provided by the author
WithCreated 指定日期的格式
如果 layout 为空将会禁用日期显示。.
WithDetail 错误信息的调用堆栈
如果向日志输出的是类型为 err 的信息,是否显示其调用堆栈。
NOTE: 该设置仅对 [Logger.Error] 方法有效果, 如果将 err 传递给 [Logger.Printf] 等方法,则遵照 [fmt.Appendf] 进行处理。.
WithLocale 指定本地化信息
如果为 nil,那么将禁用本地化输出。
设置了此值为影响以下几个方法中实现了 [localeutil.Stringer] 的参数: - Logger.Error 中的 error 类型参数; - Logger.Print/Printf/Println 中的 any 类型参数; - Logger.With 中的 any 类型参数.
WithLocation 是否显示定位信息.
# Constants
常用的日志时间格式.
常用的日志时间格式.
常用的日志时间格式.
目前支持的日志类型.
目前支持的日志类型.
目前支持的日志类型.
目前支持的日志类型.
目前支持的日志类型.
目前支持的日志类型.
常用的日志时间格式.
常用的日志时间格式.
常用的日志时间格式.
# Type aliases
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author