Categorygithub.com/issue9/logs/v6
modulepackage
6.0.0
Repository: https://github.com/issue9/logs.git
Documentation: pkg.go.dev

# README

logs Go PkgGoDev Go version codecov

高性能日志库

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

版权

本项目采用 MIT 开源授权许可证,完整的授权说明可在 LICENSE 文件中找到。

# 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

常用的日志时间格式.
常用的日志时间格式.
常用的日志时间格式.
目前支持的日志类型.
目前支持的日志类型.
目前支持的日志类型.
目前支持的日志类型.
目前支持的日志类型.
目前支持的日志类型.
常用的日志时间格式.
常用的日志时间格式.
常用的日志时间格式.

# Structs

Buffer []byte 复用对象池 同时实现了 [xerrors.Printer] 接口。.
No description provided by the author
No description provided by the author
No description provided by the author

# Interfaces

No description provided by the author
No description provided by the author

# 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