handler

May 2, 2024

Changes in this version

+ func WithDebugMode(c *Config)

type Config

+ TimeClock rotatefile.Clocker

type ConfigFn

+ func WithTimeClock(clock rotatefile.Clocker) ConfigFn

Feb 5, 2024

Changes in this version

+ type SysLogOpt struct — darwin/amd64, js/wasm, linux/amd64

+ Network string

+ Priority syslog.Priority

+ Raddr string

+ Tag string

Jul 28, 2023

Changes in this version

type Config

+ DebugMode bool

Jul 12, 2023

Changes in this version

type ConsoleHandler

+ func ConsoleWithLevels(levels []slog.Level) *ConsoleHandler

+ func ConsoleWithMaxLevel(level slog.Level) *ConsoleHandler

+ func NewConsoleWithLF(lf slog.LevelFormattable) *ConsoleHandler

type FlushCloseHandler

+ func FlushCloserWithLevels(out FlushCloseWriter, levels []slog.Level) *FlushCloseHandler

+ func FlushCloserWithMaxLevel(out FlushCloseWriter, maxLevel slog.Level) *FlushCloseHandler

+ func NewFlushCloserWithLF(out FlushCloseWriter, lf slog.LevelFormattable) *FlushCloseHandler

+ type FormatWriterHandler interface

+ Formatter func() slog.Formatter

+ Writer func() io.Writer

type IOWriterHandler

+ func IOWriterWithLevels(out io.Writer, levels []slog.Level) *IOWriterHandler

+ func IOWriterWithMaxLevel(out io.Writer, maxLevel slog.Level) *IOWriterHandler

+ func NewIOWriterWithLF(out io.Writer, lf slog.LevelFormattable) *IOWriterHandler

+ func SimpleWithLevels(out io.Writer, levels []slog.Level) *IOWriterHandler

+ func (h *IOWriterHandler) TextFormatter() *slog.TextFormatter

type SyncCloseHandler

+ func NewSyncCloserWithLF(out SyncCloseWriter, lf slog.LevelFormattable) *SyncCloseHandler

+ func SyncCloserWithLevels(out SyncCloseWriter, levels []slog.Level) *SyncCloseHandler

+ func SyncCloserWithMaxLevel(out SyncCloseWriter, maxLevel slog.Level) *SyncCloseHandler

type WriteCloserHandler

+ func NewWriteCloserHandler(out io.WriteCloser, levels []slog.Level) *WriteCloserHandler

+ func NewWriteCloserWithLF(out io.WriteCloser, lf slog.LevelFormattable) *WriteCloserHandler

+ func WriteCloserWithLevels(out io.WriteCloser, levels []slog.Level) *WriteCloserHandler

+ func WriteCloserWithMaxLevel(out io.WriteCloser, maxLevel slog.Level) *WriteCloserHandler

Jun 19, 2023

Changes in this version

type Config

+ FilePerm fs.FileMode

+ RotateMode rotatefile.RotateMode

type ConfigFn

+ func WithFilePerm(filePerm fs.FileMode) ConfigFn

+ func WithRotateMode(m rotatefile.RotateMode) ConfigFn

Apr 7, 2023

Changes in this version

+ const LevelModeList

+ const LevelModeValue

type Builder

+ func (b *Builder) WithConfigFn(fns ...ConfigFn) *Builder

+ func (b *Builder) WithLevelMode(mode uint8) *Builder

+ func (b *Builder) WithLogLevel(level slog.Level) *Builder

type Config

+ Level slog.Level

+ LevelMode uint8

+ func (c *Config) WithConfigFn(fns ...ConfigFn) *Config

type ConfigFn

+ func WithBackupNum(bt uint) ConfigFn

+ func WithBackupTime(bt uint) ConfigFn

+ func WithLevelMode(mode uint8) ConfigFn

+ func WithLevelNames(names []string) ConfigFn

+ func WithLogLevel(level slog.Level) ConfigFn

Jun 13, 2022

Changes in this version

type Builder

+ func (b *Builder) WithBuffMode(bufMode string) *Builder

+ func (b *Builder) WithBuffSize(bufSize int) *Builder

+ func (b *Builder) WithCompress(compress bool) *Builder

+ func (b *Builder) WithLogLevels(levels []slog.Level) *Builder

+ func (b *Builder) WithLogfile(logfile string) *Builder

+ func (b *Builder) WithMaxSize(maxSize uint64) *Builder

+ func (b *Builder) WithRotateTime(rt rotatefile.RotateTime) *Builder

+ func (b *Builder) WithUseJSON(useJSON bool) *Builder

type Config

+ BackupNum uint

+ BackupTime uint

Jun 8, 2022

Changes in this version

type Config

+ Compress bool

type ConfigFn

+ func WithCompress(compress bool) ConfigFn

May 18, 2022

Changes in this version

type EmailOption

+ SMTPHost string

+ SMTPPort int

May 5, 2022

Changes in this version

+ const BuffModeBite

+ const BuffModeLine

+ var DefaultBufferSize = 8 * 1024

+ func LineBuffOsFile(f *os.File, bufSize int, levels []slog.Level) slog.Handler

+ func LineBuffWriter(w io.Writer, bufSize int, levels []slog.Level) slog.Handler

+ func LineBufferedFile(logfile string, bufSize int, levels []slog.Level) (slog.Handler, error)

+ type Builder struct

+ Output io.Writer

+ func NewBuilder() *Builder

+ func (b *Builder) Build() slog.Handler

+ func (b *Builder) With(fns ...ConfigFn) *Builder

+ func (b *Builder) WithOutput(w io.Writer) *Builder

+ type Config struct

+ BuffMode string

+ BuffSize int

+ Levels []slog.Level

+ Logfile string

+ MaxSize uint64

+ RenameFunc func(filepath string, rotateNum uint) string

+ RotateTime rotatefile.RotateTime

+ UseJSON bool

+ func NewConfig(fns ...ConfigFn) *Config

+ func NewEmptyConfig(fns ...ConfigFn) *Config

+ func (c *Config) CreateHandler() (*SyncCloseHandler, error)

+ func (c *Config) CreateWriter() (output SyncCloseWriter, err error)

+ func (c *Config) RotateWriter() (output SyncCloseWriter, err error)

+ func (c *Config) With(fns ...ConfigFn) *Config

+ type ConfigFn func(c *Config)

+ func WithBuffMode(buffMode string) ConfigFn

+ func WithBuffSize(buffSize int) ConfigFn

+ func WithLogLevels(levels slog.Levels) ConfigFn

+ func WithLogfile(logfile string) ConfigFn

+ func WithMaxSize(maxSize int) ConfigFn

+ func WithRotateTime(rt rotatefile.RotateTime) ConfigFn

+ func WithUseJSON(useJson bool) ConfigFn

+ type FlushCloseHandler struct

+ Output FlushCloseWriter

+ func NewFlushCloseHandler(out FlushCloseWriter, levels []slog.Level) *FlushCloseHandler

+ func NewFlushCloser(out FlushCloseWriter, levels []slog.Level) *FlushCloseHandler

+ func (h *FlushCloseHandler) Close() error

+ func (h *FlushCloseHandler) Flush() error

+ func (h *FlushCloseHandler) Handle(record *slog.Record) error

+ type FlushCloseWriter interface

+ Flush func() error

+ type FlushWriter interface

+ Flush func() error

+ type FormatterWriterHandler interface

+ Formatter func() slog.Formatter

+ Writer func() io.Writer

+ type LockWrapper struct

+ func (lw *LockWrapper) EnableLock(enable bool)

+ func (lw *LockWrapper) Lock()

+ func (lw *LockWrapper) LockEnabled() bool

+ func (lw *LockWrapper) Unlock()

+ type RotateTime = rotatefile.RotateTime

+ type SimpleHandler struct

+ Output io.Writer

+ func NewHandler(out io.Writer, level slog.Level) *SimpleHandler

+ func NewSimple(out io.Writer, level slog.Level) *SimpleHandler

+ func NewSimpleHandler(out io.Writer, level slog.Level) *SimpleHandler

+ func (h *SimpleHandler) Handle(record *slog.Record) error

+ type SyncCloseHandler struct

+ Output SyncCloseWriter

+ func NewBuffFileHandler(logfile string, buffSize int, fns ...ConfigFn) (*SyncCloseHandler, error)

+ func NewSyncCloseHandler(out SyncCloseWriter, levels []slog.Level) *SyncCloseHandler

+ func NewSyncCloser(out SyncCloseWriter, levels []slog.Level) *SyncCloseHandler

+ func (h *SyncCloseHandler) Close() error

+ func (h *SyncCloseHandler) Flush() error

+ func (h *SyncCloseHandler) Handle(record *slog.Record) error

+ func (h *SyncCloseHandler) Writer() io.Writer

+ type SyncCloseWriter interface

+ Sync func() error

+ type WriteCloserHandler struct

+ Output io.WriteCloser

+ func NewIOWriteCloserHandler(out io.WriteCloser, levels []slog.Level) *WriteCloserHandler

+ func NewWriteCloser(out io.WriteCloser, levels []slog.Level) *WriteCloserHandler

+ func (h *WriteCloserHandler) Close() error

+ func (h *WriteCloserHandler) Flush() error

+ func (h *WriteCloserHandler) Handle(record *slog.Record) error

Jan 18, 2021

Changes in this version

type RotateFileHandler

+ MaxFileCount int

+ MaxKeepTime int

Dec 29, 2020

Changes in this version

+ func OpenFile(filepath string, flag int, perm int) (*os.File, error)

+ func QuickOpenFile(filepath string) (*os.File, error)

type BufferedHandler

+ func NewBuffered(cWriter io.WriteCloser, bufSize int) *BufferedHandler

+ type IOWriterHandler struct

+ Output io.Writer

+ func NewIOWriter(out io.Writer, levels []slog.Level) *IOWriterHandler

+ func NewIOWriterHandler(out io.Writer, levels []slog.Level) *IOWriterHandler

+ func (h *IOWriterHandler) Close() error

+ func (h *IOWriterHandler) Flush() error

+ func (h *IOWriterHandler) Handle(record *slog.Record) error

+ func (lw *IOWriterHandler) Lock()

+ func (lw *IOWriterHandler) LockEnabled() bool

+ func (lw *IOWriterHandler) Unlock()

+ func (lw *IOWriterHandler) UseLock(enable bool)

Dec 29, 2020

Changes in this version

+ const Every15Minutes

+ func BufferWrapper(handler slog.FormatterWriterHandler, buffSize int) *bufferWrapper

type ConsoleHandler

+ func NewConsole(levels []slog.Level) *ConsoleHandler

type EmailHandler

+ From EmailOption

+ ToAddresses []string

+ func NewEmailHandler(from EmailOption, toAddresses []string) *EmailHandler

+ func (h *EmailHandler) Handle(r *slog.Record) error

+ type EmailOption struct

+ FromAddr string

+ Password string

+ SmtpHost string

+ SmtpPort string

type MultiFileHandler

+ func (lw *MultiFileHandler) Lock()

+ func (lw *MultiFileHandler) LockEnabled() bool

+ func (lw *MultiFileHandler) Unlock()

+ func (lw *MultiFileHandler) UseLock(enable bool)

+ type NopFlushClose struct

+ func (h *NopFlushClose) Close() error

+ func (h *NopFlushClose) Flush() error

type RotateFileHandler

+ func MustRotateFile(filepath string, rt rotateTime) *RotateFileHandler

+ func NewRotateFile(filepath string, rt rotateTime) (*RotateFileHandler, error)

+ func (h *RotateFileHandler) Close() error

+ func (h *RotateFileHandler) CloseBuffer()

+ func (h *RotateFileHandler) Flush() error

type SimpleFileHandler

+ func MustSimpleFile(filepath string) *SimpleFileHandler

+ func NewSimpleFile(filepath string) (*SimpleFileHandler, error)

+ func (h *SimpleFileHandler) Write(bts []byte) (n int, err error)

+ type SizeRotateFileHandler struct

+ MaxSize uint64

+ RenameFunc func(fpath string, rotateNum uint) string

+ func MustSizeRotateFile(filepath string, maxSize uint64) *SizeRotateFileHandler

+ func NewSizeRotateFile(filepath string, maxSize uint64) (*SizeRotateFileHandler, error)

+ func NewSizeRotateFileHandler(filepath string, maxSize uint64) (*SizeRotateFileHandler, error)

+ func (h *SizeRotateFileHandler) Handle(r *slog.Record) (err error)

+ func (lw *SizeRotateFileHandler) Lock()

+ func (lw *SizeRotateFileHandler) LockEnabled() bool

+ func (lw *SizeRotateFileHandler) Unlock()

+ func (lw *SizeRotateFileHandler) UseLock(enable bool)

type TimeRotateFileHandler

+ func MustTimeRotateFile(filepath string, rt rotateTime) *TimeRotateFileHandler

+ func NewTimeRotateFile(filepath string, rt rotateTime) (*TimeRotateFileHandler, error)

+ func (h *TimeRotateFileHandler) CloseBuffer()

+ func (h *TimeRotateFileHandler) Write(bts []byte) (n int, err error)

Dec 28, 2020

Changes in this version

+ const Every30Minutes

+ const EveryDay

+ const EveryHour

+ const EveryMinute

+ const EverySecond

+ var DefaultFileFlags = os.O_CREATE | os.O_WRONLY | os.O_APPEND

+ var DefaultFilePerm = 0664

+ var DefaultMaxSize uint64 = 1024 * 1024 * 1800

type BufferedHandler

+ func (l *BufferedHandler) Lock()

+ func (l *BufferedHandler) LockEnabled() bool

+ func (l *BufferedHandler) Unlock()

+ func (l *BufferedHandler) UseLock(enable bool)

type ConsoleHandler

+ func (l *ConsoleHandler) Lock()

+ func (l *ConsoleHandler) LockEnabled() bool

+ func (l *ConsoleHandler) Unlock()

+ func (l *ConsoleHandler) UseLock(enable bool)

type FileHandler

+ func MustFileHandler(filepath string, useJSON bool) *FileHandler

+ func (h *FileHandler) ReopenFile() error

+ func (l *FileHandler) Lock()

+ func (l *FileHandler) LockEnabled() bool

+ func (l *FileHandler) Unlock()

+ func (l *FileHandler) UseLock(enable bool)

type RotateFileHandler

+ MaxSize uint64

+ func NewRotateFileHandler(filepath string, maxSize uint64) (*RotateFileHandler, error)

+ func (h *RotateFileHandler) Handle(r *slog.Record) (err error)

+ func (l *RotateFileHandler) Lock()

+ func (l *RotateFileHandler) LockEnabled() bool

+ func (l *RotateFileHandler) Unlock()

+ func (l *RotateFileHandler) UseLock(enable bool)

+ type SimpleFileHandler struct

+ func NewSimpleFileHandler(filepath string) (*SimpleFileHandler, error)

+ func (h *SimpleFileHandler) Close() error

+ func (h *SimpleFileHandler) Flush() error

+ func (h *SimpleFileHandler) Handle(r *slog.Record) (err error)

+ func (h *SimpleFileHandler) ReopenFile() error

+ func (h *SimpleFileHandler) Writer() io.Writer

+ func (l *SimpleFileHandler) Lock()

+ func (l *SimpleFileHandler) LockEnabled() bool

+ func (l *SimpleFileHandler) Unlock()

+ func (l *SimpleFileHandler) UseLock(enable bool)

type StreamHandler

+ func (h *StreamHandler) Flush() error

+ func (l *StreamHandler) Lock()

+ func (l *StreamHandler) LockEnabled() bool

+ func (l *StreamHandler) Unlock()

+ type SysLogHandler struct — darwin/amd64, js/wasm, linux/amd64

+ func NewSysLogHandler(priority syslog.Priority, tag string) (*SysLogHandler, error)

+ func (h *SysLogHandler) Close() error

+ func (h *SysLogHandler) Flush() error

+ func (h *SysLogHandler) Handle(record *slog.Record) error

+ type TimeRotateFileHandler struct

+ func NewTimeRotateFileHandler(filepath string, rt rotateType) (*TimeRotateFileHandler, error)

+ func (h *TimeRotateFileHandler) Close() error

+ func (h *TimeRotateFileHandler) Flush() error

+ func (h *TimeRotateFileHandler) Handle(r *slog.Record) (err error)

+ func (l *TimeRotateFileHandler) Lock()

+ func (l *TimeRotateFileHandler) LockEnabled() bool

+ func (l *TimeRotateFileHandler) Unlock()

+ func (l *TimeRotateFileHandler) UseLock(enable bool)

Dec 23, 2020

Changes in this version

type BufferedHandler

+ BuffSize int

type ConsoleHandler

+ func (h *ConsoleHandler) TextFormatter() *slog.TextFormatter

+ type EmailHandler struct

type MultiFileHandler

+ func (h *MultiFileHandler) Close() error

+ func (h *MultiFileHandler) Flush() error

+ func (h *MultiFileHandler) Handle(record *slog.Record) error

+ func (h *MultiFileHandler) IsHandling(level slog.Level) bool

Sep 15, 2020

Changes in this version

type FileHandler

+ RenameFunc func(fpath string) string

+ type LevelWithFormatter struct

+ Level slog.Level

+ func (h *LevelWithFormatter) Close() error

+ func (h *LevelWithFormatter) Flush() error

+ func (h *LevelWithFormatter) IsHandling(level slog.Level) bool

+ type LevelsWithFormatter struct

+ Levels []slog.Level

+ func (h *LevelsWithFormatter) Close() error

+ func (h *LevelsWithFormatter) Flush() error

+ func (h *LevelsWithFormatter) IsHandling(level slog.Level) bool

+ type MultiFileHandler struct

+ BuffSize int

+ FileDir string

+ FileFlag int

+ FileLevels map[string][]slog.Level

+ FileMode uint32

+ MaxSize uint64

+ NoBuffer bool

+ func NewMultiFileHandler() *MultiFileHandler

type RotateFileHandler

+ RenameFunc func(fpath string) string

+ type SysLog struct — darwin/amd64, js/wasm, linux/amd64

+ func NewSysLog(priority syslog.Priority, tag string) *SysLog

+ func (h *SysLog) Handle(record *slog.Record) error

Aug 5, 2020

Changes in this version

+ type BaseHandler struct

+ Levels []slog.Level

+ func (h *BaseHandler) Flush() error

+ func (h *BaseHandler) HandleBatch(records []*slog.Record) error

+ func (h *BaseHandler) IsHandling(level slog.Level) bool

+ type BufferedHandler struct

+ FlushInterval int

+ func NewBufferedHandler(handler slog.WriterHandler, bufSize int) *BufferedHandler

+ func (h *BufferedHandler) Close() error

+ func (h *BufferedHandler) Flush() error

+ func (h *BufferedHandler) Handle(record *slog.Record) error

+ type ConsoleHandler struct

+ func NewConsoleHandler(levels []slog.Level) *ConsoleHandler

+ func (h *ConsoleHandler) ConfigFormatter(fn func(formatter *slog.TextFormatter))

+ type FileHandler struct

+ BuffSize int

+ FileFlag int

+ FileMode uint32

+ MaxSize uint64

+ NoBuffer bool

+ func JSONFileHandler(fpath string) *FileHandler

+ func NewFileHandler(fpath string, useJSON bool) *FileHandler

+ func (h *FileHandler) Close() error

+ func (h *FileHandler) Configure(fn func(h *FileHandler)) *FileHandler

+ func (h *FileHandler) Flush() error

+ func (h *FileHandler) Handle(r *slog.Record) (err error)

+ func (h *FileHandler) Sync() error

+ func (h *FileHandler) Writer() io.Writer

+ type GroupedHandler struct

+ IgnoreErr bool

+ Levels []slog.Level

+ func NewGroupedHandler(handlers []slog.Handler) *GroupedHandler

+ func (h *GroupedHandler) Close() error

+ func (h *GroupedHandler) Flush() error

+ func (h *GroupedHandler) Handle(record *slog.Record) error

+ func (h *GroupedHandler) IsHandling(level slog.Level) bool

+ type RotateFileHandler struct

+ func (h *RotateFileHandler) Write(p []byte) (n int, err error)

+ type StreamHandler struct

+ Output io.Writer

+ UseLock bool

+ func NewStreamHandler(out io.Writer, levels []slog.Level) *StreamHandler

+ func (h *StreamHandler) Close() error

+ func (h *StreamHandler) Handle(record *slog.Record) error