README
¶
slog
A simple logger for Go, to replace the log standard library.
Install
go get -u github.com/winterssy/slog
Usage
import "github.com/winterssy/slog"
Quick Start
package main
import "github.com/winterssy/slog"
func main() {
slog.SetLevel(slog.Ldebug)
slog.Debug("hello world")
slog.Info("hello world")
slog.Warn("hello world")
slog.Error("hello world")
}
License
Documentation
¶
Index ¶
- Constants
- func Debug(v ...interface{})
- func Debugf(format string, v ...interface{})
- func Error(v ...interface{})
- func Errorf(format string, v ...interface{})
- func Fatal(v ...interface{})
- func Fatalf(format string, v ...interface{})
- func Flags() int
- func Info(v ...interface{})
- func Infof(format string, v ...interface{})
- func Level() int
- func Output(calldepth int, s string, level int) error
- func Panic(v ...interface{})
- func Panicf(format string, v ...interface{})
- func Prefix() string
- func SetFlags(flag int)
- func SetLevel(level int)
- func SetOutput(w io.Writer)
- func SetPrefix(prefix string)
- func Warn(v ...interface{})
- func Warnf(format string, v ...interface{})
- type Logger
- func (l *Logger) Debug(v ...interface{})
- func (l *Logger) Debugf(format string, v ...interface{})
- func (l *Logger) Error(v ...interface{})
- func (l *Logger) Errorf(format string, v ...interface{})
- func (l *Logger) Fatal(v ...interface{})
- func (l *Logger) Fatalf(format string, v ...interface{})
- func (l *Logger) Flags() int
- func (l *Logger) Info(v ...interface{})
- func (l *Logger) Infof(format string, v ...interface{})
- func (l *Logger) Level() int
- func (l *Logger) Output(calldepth int, s string, level int) error
- func (l *Logger) Panic(v ...interface{})
- func (l *Logger) Panicf(format string, v ...interface{})
- func (l *Logger) Prefix() string
- func (l *Logger) SetFlags(flag int)
- func (l *Logger) SetLevel(level int)
- func (l *Logger) SetOutput(w io.Writer)
- func (l *Logger) SetPrefix(prefix string)
- func (l *Logger) Warn(v ...interface{})
- func (l *Logger) Warnf(format string, v ...interface{})
- func (l *Logger) Writer() io.Writer
Constants ¶
const ( Ldebug = iota Linfo Lwarn Lerror Lpanic Lfatal )
Log output level.
const ( Ldate = 1 << iota // the date in the local time zone: 2009/01/23 Ltime // the time in the local time zone: 01:23:23 Lmilliseconds // millisecond resolution: 01:23:23,123. assumes Ltime. Llongfile // full file name and line number: /a/b/c/d.go:23 Lshortfile // final file name element and line number: d.go:23. overrides Llongfile LUTC // if Ldate or Ltime is set, use UTC rather than the local time zone LstdFlags = Ldate | Ltime | Lmilliseconds // initial values for the standard logger )
These flags define which text to prefix to each log entry generated by the Logger. Bits are or'ed together to control what's printed. There is no control over the order they appear (the order listed here) or the format they present (as described in the comments). The prefix is followed by a colon only when Llongfile or Lshortfile is specified. For example, flags Ldate | Ltime (or LstdFlags) produce,
2009-01-23 01:23:23 [level] message
while flags Ldate | Ltime | Lmilliseconds | Llongfile produce,
2009-01-23 01:23:23,123 [level] /a/b/c/d.go:23: message
Variables ¶
This section is empty.
Functions ¶
func Debugf ¶
func Debugf(format string, v ...interface{})
Debugf uses fmt.Sprintf to construct and log a message.
func Errorf ¶
func Errorf(format string, v ...interface{})
Errorf uses fmt.Sprintf to construct and log a message.
func Fatal ¶
func Fatal(v ...interface{})
Fatal uses fmt.Sprintln to construct and log a message, then calls os.Exit(1).
func Fatalf ¶
func Fatalf(format string, v ...interface{})
Fatalf uses fmt.Sprintf to construct and log a message, then calls os.Exit(1).
func Infof ¶
func Infof(format string, v ...interface{})
Infof uses fmt.Sprintf to construct and log a message.
func Output ¶
Output writes the output for a logging event. The string s contains the text to print after the prefix specified by the flags of the Logger. A newline is appended if the last character of s is not already a newline. Calldepth is the count of the number of frames to skip when computing the file name and line number if Llongfile or Lshortfile is set; a value of 1 will print the details for the caller of Output.
func Panic ¶
func Panic(v ...interface{})
Panic uses fmt.Sprintln to construct and log a message, then panics.
func Panicf ¶
func Panicf(format string, v ...interface{})
Panicf uses fmt.Sprintf to construct and log a message, then panics.
Types ¶
type Logger ¶
type Logger struct {
// contains filtered or unexported fields
}
A Logger represents an active logging object that generates lines of output to an io.Writer. Each logging operation makes a single call to the Writer's Write method. A Logger can be used simultaneously from multiple goroutines; it guarantees to serialize access to the Writer.
func New ¶
New creates a new Logger. The out variable sets the destination to which log data will be written. The prefix appears at the beginning of each generated log line. The flag argument defines the logging properties.
func (*Logger) Debug ¶
func (l *Logger) Debug(v ...interface{})
Debug uses fmt.Sprintln to construct and log a message.
func (*Logger) Error ¶
func (l *Logger) Error(v ...interface{})
Error uses fmt.Sprintln to construct and log a message.
func (*Logger) Fatal ¶
func (l *Logger) Fatal(v ...interface{})
Fatal uses fmt.Sprintln to construct and log a message, then calls os.Exit(1).
func (*Logger) Fatalf ¶
Fatalf uses fmt.Sprintf to construct and log a message, then calls os.Exit(1).
func (*Logger) Info ¶
func (l *Logger) Info(v ...interface{})
Info uses fmt.Sprintln to construct and log a message.
func (*Logger) Output ¶
Output writes the output for a logging event. The string s contains the text to print after the prefix specified by the flags of the Logger. A newline is appended if the last character of s is not already a newline. Calldepth is used to recover the PC and is provided for generality, although at the moment on all pre-defined paths it will be 2.
func (*Logger) Panic ¶
func (l *Logger) Panic(v ...interface{})
Panic uses fmt.Sprintln to construct and log a message, then panics.
func (*Logger) Warn ¶
func (l *Logger) Warn(v ...interface{})
Warn uses fmt.Sprintln to construct and log a message.
Source Files