options.go

package bilog

type loggerConfig struct {
	tt            timeTemplate
	st            sourceTemplate
	lowBufferSize int
	topBufferSize int
}

// 输出时间的模板
type timeTemplate struct {
	start  bool
	region int
}

// 显示源代码行号的模板
type sourceTemplate struct {
	start bool
	skip  int
	split byte
}

type WithFunc func(options *loggerConfig)

func (w WithFunc) apply(options *loggerConfig) {
	w(options)
}

func WithDefault() WithFunc {
	return func(options *loggerConfig) {
		options.tt.start = true
		options.st.start = false
		options.st.skip = defaultCallDepth
		options.lowBufferSize = DEFAULT_LOW_BUFFER_SIZE
		options.topBufferSize = DEFAULT_TOP_BUFFER_SIZE
	}
}

// WithCaller 指定是否输出源代码文件/行号信息, offSet指定在默认输出深度上的偏移值
// 有默认值是因为bilog内部在调用runtime.Callers时也有一定深度的封装, 这导致需要调整寻找的栈深度
func WithCaller(offSet int) WithFunc {
	return func(options *loggerConfig) {
		options.st.start = true
		options.st.skip = defaultCallDepth + offSet
	}
}

func WithTimes() WithFunc {
	return func(options *loggerConfig) {
		options.tt.start = true
	}
}

// WithLowBuffer 大小可已设置为 N * DEFAULT_TOP_BUFFER_SIZE
// nTopBuffer == N
func WithLowBuffer(nTopBuffer int8) WithFunc {
	return func(options *loggerConfig) {
		options.lowBufferSize = int(nTopBuffer) * DEFAULT_TOP_BUFFER_SIZE
	}
}

// WithTopBuffer 原来的pow语义不够清晰，设置0-Buffer时无法提供一个清晰的语义
// 所以将其改成直接设置Top-Buffer的大小
func WithTopBuffer(lowBufferSize int32) WithFunc {
	return func(options *loggerConfig) {
		options.topBufferSize = int(lowBufferSize)
	}
}