logger

Documentation

Index

• Constants
• Variables
• func Debugf(format string, v ...interface{})
• func MockLogger() (buf *bytes.Buffer, restore func())
• func Noticef(format string, v ...interface{})
• func Panicf(format string, v ...interface{})
• func SetLogger(l Logger)
• func SimpleSetup() error
• func StartupStageTimestamp(stage string)
• func WithLoggerLock(f func())
• type Log
  • func (l *Log) Debug(msg string)
  • func (l *Log) Notice(msg string)
• type Logger
  • func New(w io.Writer, flag int) (Logger, error)

Constants

const (
	// DefaultFlags are passed to the default console log.Logger
	DefaultFlags = log.Ldate | log.Ltime | log.Lmicroseconds | log.Lshortfile
)

Variables

var NullLogger = nullLogger{}

NullLogger is a logger that does nothing

Functions

func Debugf

func Debugf(format string, v ...interface{})

Debugf records something in the debug log

func MockLogger

func MockLogger() (buf *bytes.Buffer, restore func())

MockLogger replaces the exiting logger with a buffer and returns the log buffer and a restore function.

func Noticef

func Noticef(format string, v ...interface{})

Noticef notifies the user of something

func Panicf

func Panicf(format string, v ...interface{})

Panicf notifies the user and then panics

func SetLogger

func SetLogger(l Logger)

SetLogger sets the global logger to the given one

func SimpleSetup

func SimpleSetup() error

SimpleSetup creates the default (console) logger

func StartupStageTimestamp

func StartupStageTimestamp(stage string)

StartupStageTimestamp produce snap startup timings message.

func WithLoggerLock

func WithLoggerLock(f func())

WithLoggerLock invokes f with the global logger lock, useful for tests involving goroutines with MockLogger.

Types

type Log

type Log struct {
	// contains filtered or unexported fields
}

func (*Log) Debug

func (l *Log) Debug(msg string)

Debug only prints if SNAPD_DEBUG is set

func (*Log) Notice

func (l *Log) Notice(msg string)

Notice alerts the user about something, as well as putting it syslog

type Logger

type Logger interface {
	// Notice is for messages that the user should see
	Notice(msg string)
	// Debug is for messages that the user should be able to find if they're debugging something
	Debug(msg string)
}

A Logger is a fairly minimal logging tool.

func New

func New(w io.Writer, flag int) (Logger, error)

New creates a log.Logger using the given io.Writer and flag.