logger

README

logger.go

logger-go is a simple Go module for doing logging.

Overview

It will do logging in the simple and easy way.

Installation

go get github.com/likexian/logger-go

Importing

import (
    "github.com/likexian/logger-go"
)

Documentation

Visit the docs on GoDoc

Example

Do logging to stderr

log := logger.New(os.Stderr, logger.INFO)
log.Info("This is Info")
log.SetLevel(logger.DEBUG)
log.Debug("This is Debug")

Do logging to a file

flog, err := logger.File("test.log", logger.DEBUG)
if err != nil {
    panic(err)
}
flog.Debug("This is Debug")
flog.Info("This is Info")

LICENSE

Copyright 2015-2019, Li Kexian

Apache License, Version 2.0

About

• Li Kexian

DONATE

• Help me make perfect

Documentation

Index

• func Author() string
• func License() string
• func Version() string
• type LogFile
• type LogLevel
• type Logger
  • func File(fname string, level LogLevel) (*Logger, error)
  • func New(w io.Writer, level LogLevel) *Logger
  • func (l *Logger) Close()
  • func (l *Logger) Debug(msg string, args ...interface{})
  • func (l *Logger) DebugOnce(msg string, args ...interface{})
  • func (l *Logger) Error(msg string, args ...interface{})
  • func (l *Logger) ErrorOnce(msg string, args ...interface{})
  • func (l *Logger) Fatal(msg string, args ...interface{})
  • func (l *Logger) FatalOnce(msg string, args ...interface{})
  • func (l *Logger) GetLevelByString(level string) LogLevel
  • func (l *Logger) Info(msg string, args ...interface{})
  • func (l *Logger) InfoOnce(msg string, args ...interface{})
  • func (l *Logger) Log(level string, msg string, args ...interface{})
  • func (l *Logger) LogOnce(level string, msg string, args ...interface{})
  • func (l *Logger) SetDailyRotate(rotateNum int64) error
  • func (l *Logger) SetLevel(level LogLevel)
  • func (l *Logger) SetLevelString(level string) error
  • func (l *Logger) SetRotate(rotateType string, rotateNum int64, rotateSize int64) error
  • func (l *Logger) SetSizeRotate(rotateNum int64, rotateSize int64) error
  • func (l *Logger) Warn(msg string, args ...interface{})
  • func (l *Logger) WarnOnce(msg string, args ...interface{})
• type OnceCache

Functions

func Author

func Author() string

Author returns package author

func License

func License() string

License returns package license

func Version

func Version() string

Version returns package version

Types

type LogFile

type LogFile struct {
	Name          string
	Fd            *os.File
	Writer        io.Writer
	RotateType    string
	RotateNum     int64
	RotateSize    int64
	RotateNowDate string
	RotateNowSize int64
	RotateNextNum int64
}

LogFile storing log file

type LogLevel

type LogLevel int

LogLevel storing log level

const (
	DEBUG LogLevel = iota
	INFO
	WARN
	ERROR
	FATAL
)

Log level const

type Logger

type Logger struct {
	LogFile  LogFile
	LogLevel LogLevel
	LogQueue chan string
	LogExit  chan bool
	Closed   bool
}

Logger storing logger

func File

func File(fname string, level LogLevel) (*Logger, error)

File returns a new file logger

func New

func New(w io.Writer, level LogLevel) *Logger

New returns a new logger

func (*Logger) Close

func (l *Logger) Close()

Close close the logger

func (*Logger) Debug

func (l *Logger) Debug(msg string, args ...interface{})

Debug level msg logging

func (*Logger) DebugOnce

func (l *Logger) DebugOnce(msg string, args ...interface{})

DebugOnce level msg logging

func (*Logger) Error

func (l *Logger) Error(msg string, args ...interface{})

Error level msg logging

func (*Logger) ErrorOnce

func (l *Logger) ErrorOnce(msg string, args ...interface{})

ErrorOnce level msg logging

func (*Logger) Fatal

func (l *Logger) Fatal(msg string, args ...interface{})

Fatal level msg logging, followed by a call to os.Exit(1)

func (*Logger) FatalOnce

func (l *Logger) FatalOnce(msg string, args ...interface{})

FatalOnce level msg logging, followed by a call to os.Exit(1)

func (*Logger) GetLevelByString

func (l *Logger) GetLevelByString(level string) LogLevel

GetLevelByString returns log level by string level

func (*Logger) Info

func (l *Logger) Info(msg string, args ...interface{})

Info level msg logging

func (*Logger) InfoOnce

func (l *Logger) InfoOnce(msg string, args ...interface{})

InfoOnce level msg logging

func (*Logger) Log

func (l *Logger) Log(level string, msg string, args ...interface{})

Log do log a msg

func (*Logger) LogOnce

func (l *Logger) LogOnce(level string, msg string, args ...interface{})

LogOnce do log a msg only one times

func (*Logger) SetDailyRotate

func (l *Logger) SetDailyRotate(rotateNum int64) error

SetDailyRotate set daily log rotate

func (*Logger) SetLevel

func (l *Logger) SetLevel(level LogLevel)

SetLevel set the log level by int level

func (*Logger) SetLevelString

func (l *Logger) SetLevelString(level string) error

SetLevelString set the log level by string level

func (*Logger) SetRotate

func (l *Logger) SetRotate(rotateType string, rotateNum int64, rotateSize int64) error

SetRotate set log rotate rotateType: date: daily rotate, size: filesize rotate

func (*Logger) SetSizeRotate

func (l *Logger) SetSizeRotate(rotateNum int64, rotateSize int64) error

SetSizeRotate set filesize log rotate

func (*Logger) Warn

func (l *Logger) Warn(msg string, args ...interface{})

Warn level msg logging

func (*Logger) WarnOnce

func (l *Logger) WarnOnce(msg string, args ...interface{})

WarnOnce level msg logging

type OnceCache

type OnceCache struct {
	Data map[string]int64
	sync.RWMutex
}

OnceCache storing once cache