logging

package
v1.5.2-rc.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 23, 2021 License: BSD-3-Clause Imports: 18 Imported by: 434

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var DefaultLogDirectory = fmt.Sprintf("~/.%s/logs", constants.AppName)

DefaultLogDirectory is the default directory where logs are saved

Functions

func Sanitize added in v1.3.0 

func Sanitize(s string) string

func SanitizeArgs added in v1.3.0 

func SanitizeArgs(a []interface{}) []interface{}

Types

type Color 

type Color string
const (
	Black       Color = "\033[0;30m"
	DarkGray    Color = "\033[1;30m"
	Red         Color = "\033[0;31m"
	LightRed    Color = "\033[1;31m"
	Green       Color = "\033[0;32m"
	LightGreen  Color = "\033[1;32m"
	Orange      Color = "\033[0;33m"
	Yellow      Color = "\033[1;33m"
	Blue        Color = "\033[0;34m"
	LightBlue   Color = "\033[1;34m"
	Purple      Color = "\033[0;35m"
	LightPurple Color = "\033[1;35m"
	Cyan        Color = "\033[0;36m"
	LightCyan   Color = "\033[1;36m"
	LightGray   Color = "\033[0;37m"
	White       Color = "\033[1;37m"

	Reset   Color = "\033[0;0m"
	Bold    Color = "\033[;1m"
	Reverse Color = "\033[;7m"
)

Colors

func (Color) Wrap 

func (lc Color) Wrap(text string) string

type Config 

type Config struct {
	RotationInterval            time.Duration `json:"rotationInterval"`
	FileSize                    int           `json:"fileSize"`
	RotationSize                int           `json:"rotationSize"`
	FlushSize                   int           `json:"flushSize"`
	DisableLogging              bool          `json:"disableLogging"`
	DisableDisplaying           bool          `json:"disableDisplaying"`
	DisableContextualDisplaying bool          `json:"disableContextualDisplaying"`
	DisableFlushOnWrite         bool          `json:"disableFlushOnWrite"`
	Assertions                  bool          `json:"assertions"`
	LogLevel                    Level         `json:"logLevel"`
	DisplayLevel                Level         `json:"displayLevel"`
	DisplayHighlight            Highlight     `json:"displayHighlight"`
	Directory                   string        `json:"-"`
	MsgPrefix                   string        `json:"-"`
	LoggerName                  string        `json:"-"`
}

Config defines the configuration of a logger

func DefaultConfig 

func DefaultConfig() (Config, error)

DefaultConfig returns a logger configuration with default parameters

type Factory 

type Factory interface {
	// Make creates a new logger with name [name]
	Make(name string) (Logger, error)

	// MakeChain creates a new logger to log the events of chain [chainID]
	MakeChain(chainID string) (Logger, error)

	// MakeChainChild creates a new sublogger for a [name] module of a chain [chainId]
	MakeChainChild(chainID string, name string) (Logger, error)

	// SetLogLevels sets log levels for all loggers in factory with given logger name, level pairs.
	SetLogLevel(name string, level Level) error

	// SetDisplayLevels sets log display levels for all loggers in factory with given logger name, level pairs.
	SetDisplayLevel(name string, level Level) error

	// GetLogLevels returns all log levels in factory as name, level pairs
	GetLogLevel(name string) (Level, error)

	// GetDisplayLevels returns all log display levels in factory as name, level pairs
	GetDisplayLevel(name string) (Level, error)

	// GetLoggerNames returns the names of all logs created by this factory
	GetLoggerNames() []string

	// Close stops and clears all of a Factory's instantiated loggers
	Close()
}

Factory creates new instances of different types of Logger

func NewFactory 

func NewFactory(config Config) Factory

NewFactory returns a new instance of a Factory producing loggers configured with the values set in the [config] parameter

type Highlight added in v0.8.0 

type Highlight int

Highlight mode to apply to displayed logs 

const (
	Plain Highlight = iota
	Colors
)

Highlighting modes available

func ToHighlight added in v0.8.0 

func ToHighlight(h string, fd uintptr) (Highlight, error)

ToHighlight chooses a highlighting mode

func (*Highlight) MarshalJSON added in v1.5.0 

func (h *Highlight) MarshalJSON() ([]byte, error)

type Level 

type Level int
const (
	Off Level = iota
	Fatal
	Error
	Warn
	Info
	Trace
	Debug
	Verbo
)

func ToLevel 

func ToLevel(l string) (Level, error)

Inverse of Level.String()

func (Level) AlignedString added in v1.5.0 

func (l Level) AlignedString() string

String representation of this level as it will appear in log files and in logs displayed to screen. The returned value has length [alignedStringLen].

func (Level) Color 

func (l Level) Color() Color

func (Level) MarshalJSON added in v1.5.0 

func (l Level) MarshalJSON() ([]byte, error)

func (Level) String 

func (l Level) String() string

func (*Level) UnmarshalJSON added in v1.5.0 

func (l *Level) UnmarshalJSON(b []byte) error

type Log 

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

Log implements the Logger interface

func NewTestLog added in v0.8.0 

func NewTestLog(config Config) (*Log, error)

func (*Log) AssertDeferredNoError 

func (l *Log) AssertDeferredNoError(f func() error)

AssertDeferredNoError implements the Logger interface

func (*Log) AssertDeferredTrue 

func (l *Log) AssertDeferredTrue(f func() bool, format string, args ...interface{})

AssertDeferredTrue implements the Logger interface

func (*Log) AssertNoError 

func (l *Log) AssertNoError(err error)

AssertNoError implements the Logger interface

func (*Log) AssertTrue 

func (l *Log) AssertTrue(b bool, format string, args ...interface{})

AssertTrue implements the Logger interface

func (*Log) Debug 

func (l *Log) Debug(format string, args ...interface{})

Debug implements the Logger interface

func (*Log) Error 

func (l *Log) Error(format string, args ...interface{})

Error implements the Logger interface

func (*Log) Fatal 

func (l *Log) Fatal(format string, args ...interface{})

Fatal implements the Logger interface

func (*Log) GetDisplayLevel added in v1.5.0 

func (l *Log) GetDisplayLevel() Level

GetDisplayLevel implements the Logger interface

func (*Log) GetLogLevel added in v1.5.0 

func (l *Log) GetLogLevel() Level

GetLogLevel ...

func (*Log) Info 

func (l *Log) Info(format string, args ...interface{})

Info implements the Logger interface

func (*Log) RecoverAndExit added in v0.8.0 

func (l *Log) RecoverAndExit(f, exit func())

RecoverAndExit implements the Logger interface

func (*Log) RecoverAndPanic 

func (l *Log) RecoverAndPanic(f func())

RecoverAndPanic implements the Logger interface

func (*Log) SetContextualDisplayingEnabled 

func (l *Log) SetContextualDisplayingEnabled(enabled bool)

SetContextualDisplayingEnabled implements the Logger interface

func (*Log) SetDisplayLevel 

func (l *Log) SetDisplayLevel(lvl Level)

SetDisplayLevel implements the Logger interface

func (*Log) SetDisplayingEnabled 

func (l *Log) SetDisplayingEnabled(enabled bool)

SetDisplayingEnabled implements the Logger interface

func (*Log) SetLogLevel 

func (l *Log) SetLogLevel(lvl Level)

func (*Log) SetLoggingEnabled 

func (l *Log) SetLoggingEnabled(enabled bool)

SetLoggingEnabled implements the Logger interface

func (*Log) SetPrefix 

func (l *Log) SetPrefix(prefix string)

SetPrefix implements the Logger interface

func (*Log) Stop 

func (l *Log) Stop()

Stop implements the Logger interface

func (*Log) StopOnPanic 

func (l *Log) StopOnPanic()

StopOnPanic implements the Logger interface

func (*Log) Trace added in v1.4.9 

func (l *Log) Trace(format string, args ...interface{})

Trace implements the Logger interface

func (*Log) Verbo 

func (l *Log) Verbo(format string, args ...interface{})

Verbo implements the Logger interface

func (*Log) Warn 

func (l *Log) Warn(format string, args ...interface{})

Warn implements the Logger interface

func (*Log) Write 

func (l *Log) Write(p []byte) (int, error)

type Logger 

type Logger interface {
	io.Writer // For logging pre-formated messages

	// Log that a fatal error has occurred. The program should likely exit soon
	// after this is called
	Fatal(format string, args ...interface{})
	// Log that an error has occurred. The program should be able to recover
	// from this error
	Error(format string, args ...interface{})
	// Log that an event has occurred that may indicate a future error or
	// vulnerability
	Warn(format string, args ...interface{})
	// Log an event that may be useful for a user to see to measure the progress
	// of the protocol
	Info(format string, args ...interface{})
	// Log an event that may be useful for understanding the order of the
	// execution of the protocol
	Trace(format string, args ...interface{})
	// Log an event that may be useful for a programmer to see when debuging the
	// execution of the protocol
	Debug(format string, args ...interface{})
	// Log extremely detailed events that can be useful for inspecting every
	// aspect of the program
	Verbo(format string, args ...interface{})

	// If assertions are enabled, will result in a panic if err is non-nil
	AssertNoError(err error)
	// If assertions are enabled, will result in a panic if b is false
	AssertTrue(b bool, format string, args ...interface{})
	// If assertions are enabled, the function will be called and will result in
	// a panic the returned value is non-nil
	AssertDeferredNoError(f func() error)
	// If assertions are enabled, the function will be called and will result in
	//  a panic the returned value is false
	AssertDeferredTrue(f func() bool, format string, args ...interface{})

	// Recovers a panic, logs the error, and rethrows the panic.
	StopOnPanic()
	// If a function panics, this will log that panic and then re-panic ensuring
	// that the program logs the error before exiting.
	RecoverAndPanic(f func())

	// If a function panics, this will log that panic and then call the exit
	// function, ensuring that the program logs the error, recovers, and
	// executes the desired exit function
	RecoverAndExit(f, exit func())

	// Only events above or equal to the level set will be logged
	SetLogLevel(Level)
	// Only logged events above or equal to the level set will be logged
	SetDisplayLevel(Level)
	// Gets current LogLevel
	GetLogLevel() Level
	// Gets current DisplayLevel
	GetDisplayLevel() Level
	// Add a prefix to all logged messages
	SetPrefix(string)
	// Enable or disable logging
	SetLoggingEnabled(bool)
	// Enable or disable the display of logged events
	SetDisplayingEnabled(bool)
	// Enable or disable the display of contextual information for logged events
	SetContextualDisplayingEnabled(bool)

	// Stop this logger and write back all meta-data.
	Stop()
}

Logger defines the interface that is used to keep a record of all events that happen to the program

type NoFactory 

type NoFactory struct{}

func (NoFactory) Close 

func (NoFactory) Close()

func (NoFactory) GetDisplayLevel added in v1.5.0 

func (NoFactory) GetDisplayLevel(name string) (Level, error)

func (NoFactory) GetLogLevel added in v1.5.0 

func (NoFactory) GetLogLevel(name string) (Level, error)

func (NoFactory) GetLoggerNames added in v1.5.0 

func (NoFactory) GetLoggerNames() []string

func (NoFactory) Make 

func (NoFactory) Make(string) (Logger, error)

func (NoFactory) MakeChain 

func (NoFactory) MakeChain(string) (Logger, error)

func (NoFactory) MakeChainChild added in v1.4.8 

func (NoFactory) MakeChainChild(string, string) (Logger, error)

func (NoFactory) SetDisplayLevel added in v1.5.0 

func (NoFactory) SetDisplayLevel(name string, level Level) error

func (NoFactory) SetLogLevel added in v1.5.0 

func (NoFactory) SetLogLevel(name string, level Level) error

type NoIOWriter added in v0.8.0 

type NoIOWriter struct{}

NoIOWriter is a mock Writer that does not write to any underlying source

func (*NoIOWriter) Close added in v0.8.0 

func (nw *NoIOWriter) Close() error

func (*NoIOWriter) Flush added in v0.8.0 

func (nw *NoIOWriter) Flush() error

func (*NoIOWriter) Initialize added in v0.8.0 

func (nw *NoIOWriter) Initialize(Config) (int, error)

func (*NoIOWriter) Rotate added in v0.8.0 

func (nw *NoIOWriter) Rotate() error

func (*NoIOWriter) Write added in v0.8.0 

func (nw *NoIOWriter) Write(p []byte) (int, error)

func (*NoIOWriter) WriteString added in v0.8.0 

func (nw *NoIOWriter) WriteString(s string) (int, error)

type NoLog 

type NoLog struct{}

func (NoLog) AssertDeferredNoError 

func (NoLog) AssertDeferredNoError(f func() error)

func (NoLog) AssertDeferredTrue 

func (NoLog) AssertDeferredTrue(f func() bool, format string, args ...interface{})

func (NoLog) AssertNoError 

func (NoLog) AssertNoError(error)

func (NoLog) AssertTrue 

func (NoLog) AssertTrue(b bool, format string, args ...interface{})

func (NoLog) Debug 

func (NoLog) Debug(format string, args ...interface{})

func (NoLog) Error 

func (NoLog) Error(format string, args ...interface{})

func (NoLog) Fatal 

func (NoLog) Fatal(format string, args ...interface{})

func (NoLog) GetDisplayLevel added in v1.5.0 

func (NoLog) GetDisplayLevel() Level

GetDisplayLevel ...

func (NoLog) GetLogLevel added in v1.5.0 

func (NoLog) GetLogLevel() Level

GetLogLevel ...

func (NoLog) Info 

func (NoLog) Info(format string, args ...interface{})

func (NoLog) RecoverAndExit added in v0.8.0 

func (NoLog) RecoverAndExit(f, exit func())

func (NoLog) RecoverAndPanic 

func (NoLog) RecoverAndPanic(f func())

func (NoLog) SetContextualDisplayingEnabled 

func (NoLog) SetContextualDisplayingEnabled(bool)

func (NoLog) SetDisplayLevel 

func (NoLog) SetDisplayLevel(Level)

func (NoLog) SetDisplayingEnabled 

func (NoLog) SetDisplayingEnabled(bool)

func (NoLog) SetLogLevel 

func (NoLog) SetLogLevel(Level)

func (NoLog) SetLoggingEnabled 

func (NoLog) SetLoggingEnabled(bool)

func (NoLog) SetPrefix 

func (NoLog) SetPrefix(string)

SetPrefix ...

func (NoLog) Stop 

func (NoLog) Stop()

func (NoLog) StopOnPanic 

func (NoLog) StopOnPanic()

func (NoLog) Trace added in v1.4.9 

func (NoLog) Trace(format string, args ...interface{})

func (NoLog) Verbo 

func (NoLog) Verbo(format string, args ...interface{})

func (NoLog) Warn 

func (NoLog) Warn(format string, args ...interface{})

func (NoLog) Write 

func (NoLog) Write([]byte) (int, error)

type RotatingWriter added in v0.8.0 

type RotatingWriter interface {
	// Creates the log file if it doesn't exist or resume writing to it if it does
	Initialize(Config) (int, error)
	// Flushes the writer
	Flush() error
	// Writes [b] to the log file
	Write(b []byte) (int, error)
	// Writes [s] to the log file
	WriteString(s string) (int, error)
	// Closes the log file
	Close() error
	// Rotates the log files. Always keeps the current log in the same file.
	// Rotated log files are stored as by appending an integer to the log file name,
	// from 1 to the RotationSize defined in the configuration. 1 being the most
	// recently rotated log file.
	Rotate() error
}

RotatingWriter allows for rotating a stream writer

type RoutineID 

type RoutineID struct{}

RoutineID can print the current goroutine ID

func (RoutineID) String 

func (RoutineID) String() string

type Stacktrace 

type Stacktrace struct {
	Global bool
}

Stacktrace can print the current stacktrace

func (Stacktrace) String 

func (st Stacktrace) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.