log

package module

Go to main page

Versions in this module

v0

v0.1.0

May 4, 2026

Changes in this version

+ const BufferFullPolicyDropOldest

+ var MaxLevel = RegisterLevel(999, "MAX")

+ var ReportError = func(err error)

+ func CloseFile(f *File)

+ func FastCaller(skip int) (file string, line int)

+ func Refresh(s flatten.Storage) error

+ func WriteEvent(w io.Writer, e *Event, layout Layout)

type Appender

+ ConcurrentSafe func() bool

type AppenderRef

+ Level LevelRange

+ func (c *AppenderRef) Append(e *Event)

+ type AppenderRefs interface

+ GetAppenderRefs func() (syncMode bool, _ []*AppenderRef)

type AsyncLogger

+ AppenderRefs []*AppenderRef

+ OnBufferFull BufferFullPolicy

+ func (c *AsyncLogger) Append(e *Event)

+ func (c *AsyncLogger) GetAppenderRefs() (syncMode bool, _ []*AppenderRef)

type BaseLayout

+ FileLineMaxLength int

+ type CallerType int

+ const CallerTypeDefault

+ const CallerTypeFast

+ const CallerTypeNone

+ func ParseCallerType(s string) (CallerType, error)

type ConsoleAppender

+ func (c *ConsoleAppender) ConcurrentSafe() bool

+ func (c *ConsoleAppender) Start() error

+ func (c *ConsoleAppender) Stop()

+ type ConsoleLogger struct

+ Layout Layout

+ func (c *ConsoleLogger) Append(e *Event)

+ func (c *ConsoleLogger) Start() error

+ func (c *ConsoleLogger) Stop()

type DiscardAppender

+ func (c *DiscardAppender) Append(e *Event)

+ func (c *DiscardAppender) ConcurrentSafe() bool

+ func (c *DiscardAppender) Start() error

+ func (c *DiscardAppender) Stop()

+ type DiscardLogger struct

+ func (d DiscardLogger) Append(e *Event)

+ func (d DiscardLogger) Start() error

+ func (d DiscardLogger) Stop()

type Event

+ RawBytes []byte

+ type File struct

+ func OpenFile(name string) (*File, error)

+ func (f *File) Name() string

+ func (f *File) Write(p []byte) (int, error)

type FileAppender

+ FileDir string

+ func (c *FileAppender) ConcurrentSafe() bool

+ type FileLogger struct

+ FileDir string

+ FileName string

+ Layout Layout

+ func (c *FileLogger) Append(e *Event)

+ func (c *FileLogger) Start() error

+ func (c *FileLogger) Stop()

type JSONLayout

+ func (c *JSONLayout) EncodeTo(e *Event, w Writer)

type Layout

+ EncodeTo func(e *Event, w Writer)

type Level

+ func (l Level) LowerName() string

+ func (l Level) UpperName() string

+ type LevelRange struct

+ MaxLevel Level

+ MinLevel Level

+ func ParseLevelRange(s string) (LevelRange, error)

+ func (c LevelRange) Enable(l Level) bool

type Logger

+ Append func(e *Event)

+ GetLevel func() LevelRange

+ GetTags func() []string

type LoggerBase

+ func (c *LoggerBase) GetLevel() LevelRange

+ func (c *LoggerBase) GetTags() []string

type LoggerWrapper

+ func (m *LoggerWrapper) Enable(l Level) bool

+ type RollingFileAppender struct

+ FileDir string

+ FileName string

+ Interval time.Duration

+ MaxAge time.Duration

+ SyncLock bool

+ func (c *RollingFileAppender) Append(e *Event)

+ func (c *RollingFileAppender) ConcurrentSafe() bool

+ func (c *RollingFileAppender) Start() error

+ func (c *RollingFileAppender) Stop()

+ type RollingFileLogger struct

+ AsyncWrite bool

+ BufferSize int

+ FileDir string

+ FileName string

+ Interval time.Duration

+ Layout Layout

+ MaxAge time.Duration

+ OnBufferFull BufferFullPolicy

+ Separate bool

+ func (f *RollingFileLogger) Append(e *Event)

+ func (f *RollingFileLogger) Start() error

+ func (f *RollingFileLogger) Stop()

+ type RollingFileWriter struct

+ func (w *RollingFileWriter) Close()

+ func (w *RollingFileWriter) Rotate() (*File, error)

type SyncLogger

+ AppenderRefs []*AppenderRef

+ func (c *SyncLogger) Append(e *Event)

+ func (c *SyncLogger) GetAppenderRefs() (syncMode bool, _ []*AppenderRef)

type TextLayout

+ func (c *TextLayout) EncodeTo(e *Event, w Writer)

+ type Writer interface

v0.1.0-rc

Mar 27, 2026

v0.1.0-alpha

Mar 8, 2026

v0.0.12

Oct 1, 2025

v0.0.11

Oct 1, 2025

v0.0.10

Sep 21, 2025

Changes in this version

+ const RootLoggerName

+ func EncodeFields(enc Encoder, fields []Field)

+ func FormatError(err error, format string, args ...any) error

+ type AppenderBase struct

+ Layout Layout

+ Name string

+ func (c *AppenderBase) Append(e *Event)

+ func (c *AppenderBase) GetName() string

+ func (c *AppenderBase) Start() error

+ func (c *AppenderBase) Stop()

+ func (c *AppenderBase) Write(b []byte)

+ type JSONTokenType int

+ const JSONTokenArrayBegin

+ const JSONTokenArrayEnd

+ const JSONTokenKey

+ const JSONTokenObjectBegin

+ const JSONTokenObjectEnd

+ const JSONTokenUnknown

+ const JSONTokenValue

+ type LoggerBase struct

+ AppenderRefs []*AppenderRef

+ Level Level

+ Name string

+ Tags string

+ func (c *LoggerBase) EnableLevel(level Level) bool

+ func (c *LoggerBase) GetName() string

v0.0.6

Sep 5, 2025

Changes in this version

+ func ReadJSON(b []byte) (map[string]any, error)

+ func ReadProperties(b []byte) (map[string]any, error)

+ func ReadXML(b []byte) (map[string]any, error)

+ func ReadYAML(b []byte) (map[string]any, error)

+ func RefreshConfig(s *barky.Storage) error

type Level

+ func RegisterLevel(code int32, name string) Level

+ func (l Level) Code() int32

type PluginType

+ const PluginTypeProperty

v0.0.5

Aug 10, 2025

Changes in this version

+ const BufferFullPolicyBlock

+ const BufferFullPolicyDiscard

+ const BufferFullPolicyDiscardOldest

+ func Destroy()

+ func RegisterProperty(key string, val func(string) error)

type AsyncLogger

+ BufferFullPolicy BufferFullPolicy

+ func (c *AsyncLogger) GetDiscardCounter() int64

+ type BufferFullPolicy int

+ func ParseBufferFullPolicy(s string) (BufferFullPolicy, error)

+ type LoggerHolder struct

type LoggerWrapper

+ func GetRootLogger() *LoggerWrapper

v0.0.4

Aug 8, 2025

Changes in this version

+ const ValueTypeFromMap

+ var TagAppDef = RegisterAppTag("def", "")

+ var TagBizDef = RegisterBizTag("def", "")

+ func BuildTag(mainType, subType, action string) string

type Appender

+ Write func(b []byte)

+ type AsyncLogger struct

+ BufferSize int

+ func (c *AsyncLogger) Publish(e *Event)

+ func (c *AsyncLogger) Start() error

+ func (c *AsyncLogger) Stop()

+ func (c *AsyncLogger) Write(b []byte)

type BaseAppender

+ func (c *BaseAppender) Write(b []byte)

+ type BaseLogger struct

+ AppenderRefs []*AppenderRef

+ Level Level

+ Name string

+ Tags string

+ func (c *BaseLogger) EnableLevel(level Level) bool

+ func (c *BaseLogger) GetName() string

type ConsoleAppender

+ func (c *ConsoleAppender) Write(b []byte)

type Field

+ func FieldsFromMap(m map[string]any) Field

type FileAppender

+ func (c *FileAppender) Write(b []byte)

type Logger

+ EnableLevel func(level Level) bool

+ GetName func() string

+ Publish func(e *Event)

+ Write func(b []byte)

+ type LoggerWrapper struct

+ func GetLogger(name string) *LoggerWrapper

+ func (m *LoggerWrapper) Write(b []byte)

+ type SyncLogger struct

+ func (c *SyncLogger) Publish(e *Event)

+ func (c *SyncLogger) Start() error

+ func (c *SyncLogger) Stop()

+ func (c *SyncLogger) Write(b []byte)

type Tag

+ func RegisterAppTag(subType, action string) *Tag

+ func RegisterBizTag(subType, action string) *Tag

+ func RegisterRPCTag(subType, action string) *Tag

+ func RegisterTag(tag string) *Tag

v0.0.3

Aug 4, 2025

v0.0.2

Jun 14, 2025

Changes in this version

+ var Caller = func(skip int, fast bool) (file string, line int)

+ var TagApp = GetTag("_app")

v0.0.1

Jun 13, 2025

Changes in this version

+ const MsgKey

+ const ValueTypeArray

+ const ValueTypeBool

+ const ValueTypeFloat64

+ const ValueTypeInt64

+ const ValueTypeObject

+ const ValueTypeReflect

+ const ValueTypeString

+ const ValueTypeUint64

+ var FieldsFromContext func(ctx context.Context) []Field

+ var OnDropEvent func(logger string, e *Event)

+ var Stdout io.Writer = os.Stdout

+ var StringFromContext func(ctx context.Context) string

+ var TagBiz = GetTag("_biz")

+ var TagDef = GetTag("_def")

+ var TagGS = GetTag("_gs")

+ var TimeNow func(ctx context.Context) time.Time

+ func Debug(ctx context.Context, tag *Tag, fn func() []Field)

+ func Debugf(ctx context.Context, tag *Tag, format string, args ...any)

+ func DumpNode(node *Node, indent int, buf *bytes.Buffer)

+ func Error(ctx context.Context, tag *Tag, fields ...Field)

+ func Errorf(ctx context.Context, tag *Tag, format string, args ...any)

+ func Fatal(ctx context.Context, tag *Tag, fields ...Field)

+ func Fatalf(ctx context.Context, tag *Tag, format string, args ...any)

+ func GetAllTags() []string

+ func Info(ctx context.Context, tag *Tag, fields ...Field)

+ func Infof(ctx context.Context, tag *Tag, format string, args ...any)

+ func MapKeys[M ~map[K]V, K comparable, V any](m M) []K

+ func NewPlugin(t reflect.Type, node *Node, properties map[string]string) (reflect.Value, error)

+ func OrderedMapKeys[M ~map[K]V, K cmp.Ordered, V any](m M) []K

+ func Panic(ctx context.Context, tag *Tag, fields ...Field)

+ func Panicf(ctx context.Context, tag *Tag, format string, args ...any)

+ func Ptr[T any](i T) *T

+ func PutEvent(e *Event)

+ func Record(ctx context.Context, level Level, tag *Tag, skip int, fields ...Field)

+ func RefreshFile(fileName string) error

+ func RefreshReader(input io.Reader, ext string) error

+ func RegisterConverter[T any](fn Converter[T])

+ func RegisterPlugin[T any](name string, typ PluginType)

+ func RegisterReader(r Reader, ext ...string)

+ func Trace(ctx context.Context, tag *Tag, fn func() []Field)

+ func Tracef(ctx context.Context, tag *Tag, format string, args ...any)

+ func Warn(ctx context.Context, tag *Tag, fields ...Field)

+ func Warnf(ctx context.Context, tag *Tag, format string, args ...any)

+ func WrapError(err error, format string, args ...any) error

+ func WriteFields(enc Encoder, fields []Field)

+ func WriteLogString(buf *bytes.Buffer, s string)

+ type Appender interface

+ Append func(e *Event)

+ GetName func() string

+ type AppenderRef struct

+ Ref string

+ type ArrayValue interface

+ EncodeArray func(enc Encoder)

+ type AsyncLoggerConfig struct

+ BufferSize int

+ func (c *AsyncLoggerConfig) EnableLevel(level Level) bool

+ func (c *AsyncLoggerConfig) GetName() string

+ func (c *AsyncLoggerConfig) Publish(e *Event)

+ func (c *AsyncLoggerConfig) Start() error

+ func (c *AsyncLoggerConfig) Stop()

+ type BaseAppender struct

+ Layout Layout

+ Name string

+ func (c *BaseAppender) Append(e *Event)

+ func (c *BaseAppender) GetName() string

+ func (c *BaseAppender) Start() error

+ func (c *BaseAppender) Stop()

+ type BaseLayout struct

+ BufferSize HumanizeBytes

+ FileLineLength int

+ func (c *BaseLayout) GetBuffer() *bytes.Buffer

+ func (c *BaseLayout) GetFileLine(e *Event) string

+ func (c *BaseLayout) PutBuffer(buf *bytes.Buffer)

+ type ConsoleAppender struct

+ func (c *ConsoleAppender) Append(e *Event)

+ type Converter func(string) (T, error)

+ type DiscardAppender struct

+ type Encoder interface

+ AppendArrayBegin func()

+ AppendArrayEnd func()

+ AppendBool func(v bool)

+ AppendEncoderBegin func()

+ AppendEncoderEnd func()

+ AppendFloat64 func(v float64)

+ AppendInt64 func(v int64)

+ AppendKey func(key string)

+ AppendObjectBegin func()

+ AppendObjectEnd func()

+ AppendReflect func(v any)

+ AppendString func(v string)

+ AppendUint64 func(v uint64)

+ type Event struct

+ CtxFields []Field

+ CtxString string

+ Fields []Field

+ File string

+ Level Level

+ Line int

+ Tag string

+ Time time.Time

+ func GetEvent() *Event

+ func (e *Event) Reset()

+ type Field struct

+ Any any

+ Key string

+ Num uint64

+ Type ValueType

+ func Any(key string, value any) Field

+ func Array(key string, val ArrayValue) Field

+ func Bool(key string, val bool) Field

+ func BoolPtr(key string, val *bool) Field

+ func Bools(key string, val []bool) Field

+ func Fields(fields map[string]any) []Field

+ func FloatPtr[T FloatType](key string, val *T) Field

+ func Float[T FloatType](key string, val T) Field

+ func Floats[T FloatType](key string, val []T) Field

+ func IntPtr[T IntType](key string, val *T) Field

+ func Int[T IntType](key string, val T) Field

+ func Ints[T IntType](key string, val []T) Field

+ func Msg(msg string) Field

+ func Msgf(format string, args ...any) Field

+ func Nil(key string) Field

+ func Object(key string, fields ...Field) Field

+ func Reflect(key string, val any) Field

+ func String(key string, val string) Field

+ func StringPtr(key string, val *string) Field

+ func Strings(key string, val []string) Field

+ func UintPtr[T UintType](key string, val *T) Field

+ func Uint[T UintType](key string, val T) Field

+ func Uints[T UintType](key string, val []T) Field

+ func (f *Field) Encode(enc Encoder)

+ type FileAppender struct

+ FileName string

+ func (c *FileAppender) Append(e *Event)

+ func (c *FileAppender) Start() error

+ func (c *FileAppender) Stop()

+ type FloatType interface

+ type HumanizeBytes int

+ func ParseHumanizeBytes(s string) (HumanizeBytes, error)

+ type IntType interface

+ type JSONEncoder struct

+ func NewJSONEncoder(buf *bytes.Buffer) *JSONEncoder

+ func (enc *JSONEncoder) AppendArrayBegin()

+ func (enc *JSONEncoder) AppendArrayEnd()

+ func (enc *JSONEncoder) AppendBool(v bool)

+ func (enc *JSONEncoder) AppendEncoderBegin()

+ func (enc *JSONEncoder) AppendEncoderEnd()

+ func (enc *JSONEncoder) AppendFloat64(v float64)

+ func (enc *JSONEncoder) AppendInt64(v int64)

+ func (enc *JSONEncoder) AppendKey(key string)

+ func (enc *JSONEncoder) AppendObjectBegin()

+ func (enc *JSONEncoder) AppendObjectEnd()

+ func (enc *JSONEncoder) AppendReflect(v any)

+ func (enc *JSONEncoder) AppendString(v string)

+ func (enc *JSONEncoder) AppendUint64(u uint64)

+ func (enc *JSONEncoder) Reset()

+ type JSONLayout struct

+ func (c *JSONLayout) ToBytes(e *Event) []byte

+ type Layout interface

+ ToBytes func(e *Event) []byte

+ type Level int32

+ const DebugLevel

+ const ErrorLevel

+ const FatalLevel

+ const InfoLevel

+ const NoneLevel

+ const PanicLevel

+ const TraceLevel

+ const WarnLevel

+ func ParseLevel(s string) (Level, error)

+ func (l Level) String() string

+ type Lifecycle interface

+ Start func() error

+ Stop func()

+ type Logger struct

+ type LoggerConfig struct

+ func (c *LoggerConfig) EnableLevel(level Level) bool

+ func (c *LoggerConfig) GetName() string

+ func (c *LoggerConfig) Publish(e *Event)

+ func (c *LoggerConfig) Start() error

+ func (c *LoggerConfig) Stop()

+ type Node struct

+ Attributes map[string]string

+ Children []*Node

+ Label string

+ Text string

+ type Plugin struct

+ Class reflect.Type

+ File string

+ Line int

+ Name string

+ Type PluginType

+ type PluginTag string

+ func (tag PluginTag) Get(key string) string

+ func (tag PluginTag) Lookup(key string) (value string, ok bool)

+ type PluginType string

+ const PluginTypeAppender

+ const PluginTypeAppenderRef

+ const PluginTypeAsyncLogger

+ const PluginTypeAsyncRoot

+ const PluginTypeLayout

+ const PluginTypeLogger

+ const PluginTypeRoot

+ type Reader interface

+ Read func(b []byte) (*Node, error)

+ type Tag struct

+ func GetTag(tag string) *Tag

+ func (m *Tag) GetLogger() *Logger

+ func (m *Tag) GetName() string

+ func (m *Tag) SetLogger(logger *Logger)

+ type TextEncoder struct

+ func NewTextEncoder(buf *bytes.Buffer, separator string) *TextEncoder

+ func (enc *TextEncoder) AppendArrayBegin()

+ func (enc *TextEncoder) AppendArrayEnd()

+ func (enc *TextEncoder) AppendBool(v bool)

+ func (enc *TextEncoder) AppendEncoderBegin()

+ func (enc *TextEncoder) AppendEncoderEnd()

+ func (enc *TextEncoder) AppendFloat64(v float64)

+ func (enc *TextEncoder) AppendInt64(v int64)

+ func (enc *TextEncoder) AppendKey(key string)

+ func (enc *TextEncoder) AppendObjectBegin()

+ func (enc *TextEncoder) AppendObjectEnd()

+ func (enc *TextEncoder) AppendReflect(v any)

+ func (enc *TextEncoder) AppendString(v string)

+ func (enc *TextEncoder) AppendUint64(v uint64)

+ type TextLayout struct

+ func (c *TextLayout) ToBytes(e *Event) []byte

+ type UintType interface

+ type ValueType int

+ type XMLReader struct

+ func (r *XMLReader) Read(b []byte) (*Node, error)

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL