logutils

Documentation

Index

• Constants
• Variables
• func HaveDebugTag(tag string) bool
• func SetupVerboseLog(log Log, isVerbose bool)
• type DebugFunc
  • func Debug(tag string) DebugFunc
• type Log
• type LogLevel
• type MockLog
  • func NewMockLog() *MockLog
  • func (m *MockLog) Child(name string) Log
  • func (m *MockLog) Errorf(format string, args ...any)
  • func (m *MockLog) Fatalf(format string, args ...any)
  • func (m *MockLog) Infof(format string, args ...any)
  • func (m *MockLog) Panicf(format string, args ...any)
  • func (m *MockLog) SetLevel(level LogLevel)
  • func (m *MockLog) Warnf(format string, args ...any)
• type StderrLog
  • func NewStderrLog(name string) *StderrLog
  • func (sl StderrLog) Child(name string) Log
  • func (sl StderrLog) Debugf(format string, args ...any)
  • func (sl StderrLog) Errorf(format string, args ...any)
  • func (sl StderrLog) Fatalf(format string, args ...any)
  • func (sl StderrLog) Infof(format string, args ...any)
  • func (sl StderrLog) Panicf(format string, args ...any)
  • func (sl *StderrLog) SetLevel(level LogLevel)
  • func (sl StderrLog) Warnf(format string, args ...any)

Constants

const (
	DebugKeyAutogenExclude     = "autogen_exclude" // Debugs a filter excluding autogenerated source code.
	DebugKeyBinSalt            = "bin_salt"
	DebugKeyConfigReader       = "config_reader"
	DebugKeyEmpty              = ""
	DebugKeyEnabledLinters     = "enabled_linters"
	DebugKeyEnv                = "env" // Debugs `go env` command.
	DebugKeyExcludeRules       = "exclude_rules"
	DebugKeyExec               = "exec"
	DebugKeyFilenameUnadjuster = "filename_unadjuster"
	DebugKeyForbidigo          = "forbidigo"
	DebugKeyGoEnv              = "goenv"
	DebugKeyLinter             = "linter"
	DebugKeyLintersContext     = "linters_context"
	DebugKeyLintersDB          = "lintersdb"
	DebugKeyLintersOutput      = "linters_output"
	DebugKeyLoader             = "loader" // Debugs packages loading (including `go/packages` internal debugging).
	DebugKeyMaxFromLinter      = "max_from_linter"
	DebugKeyMaxSameIssues      = "max_same_issues"
	DebugKeyPkgCache           = "pkgcache"
	DebugKeyRunner             = "runner"
	DebugKeySeverityRules      = "severity_rules"
	DebugKeySkipDirs           = "skip_dirs"
	DebugKeySourceCode         = "source_code"
	DebugKeyStopwatch          = "stopwatch"
	DebugKeyTabPrinter         = "tab_printer"
	DebugKeyTest               = "test"
	DebugKeyTextPrinter        = "text_printer"
)

const (
	DebugKeyGoAnalysis = "goanalysis"

	DebugKeyGoAnalysisAnalyze     = DebugKeyGoAnalysis + "/analyze"
	DebugKeyGoAnalysisIssuesCache = DebugKeyGoAnalysis + "/issues/cache"
	DebugKeyGoAnalysisMemory      = DebugKeyGoAnalysis + "/memory"

	DebugKeyGoAnalysisFacts        = DebugKeyGoAnalysis + "/facts"
	DebugKeyGoAnalysisFactsCache   = DebugKeyGoAnalysisFacts + "/cache"
	DebugKeyGoAnalysisFactsExport  = DebugKeyGoAnalysisFacts + "/export"
	DebugKeyGoAnalysisFactsInherit = DebugKeyGoAnalysisFacts + "/inherit"
)

const (
	DebugKeyGoCritic  = "gocritic"  // Debugs `go-critic` linter.
	DebugKeyMegacheck = "megacheck" // Debugs `staticcheck` related linters.
	DebugKeyNolint    = "nolint"    // Debugs a filter excluding issues by `//nolint` comments.
	DebugKeyRevive    = "revive"    // Debugs `revive` linter.
)

Variables

var StdErr = colorable.NewColorableStderr()

var StdOut = color.Output // https://github.com/golangci/golangci-lint/issues/14

Functions

func HaveDebugTag

func HaveDebugTag(tag string) bool

func SetupVerboseLog

func SetupVerboseLog(log Log, isVerbose bool)

Types

type DebugFunc

type DebugFunc func(format string, args ...any)

func Debug

func Debug(tag string) DebugFunc

type Log

type Log interface {
	Fatalf(format string, args ...any)
	Panicf(format string, args ...any)
	Errorf(format string, args ...any)
	Warnf(format string, args ...any)
	Infof(format string, args ...any)

	Child(name string) Log
	SetLevel(level LogLevel)
}

type LogLevel

type LogLevel int

const (
	// LogLevelDebug Debug messages, write to debug logs only by logutils.Debug.
	LogLevelDebug LogLevel = 0

	// LogLevelInfo Information messages, don't write too many messages,
	// only useful ones: they are shown when running with -v.
	LogLevelInfo LogLevel = 1

	// LogLevelWarn Hidden errors: non-critical errors: work can be continued, no need to fail whole program;
	// tests will crash if any warning occurred.
	LogLevelWarn LogLevel = 2

	// LogLevelError Only not hidden from user errors: whole program failing, usually
	// error logging happens in 1-2 places: in the "main" function.
	LogLevelError LogLevel = 3
)

type MockLog

type MockLog struct {
	mock.Mock
}

func NewMockLog

func NewMockLog() *MockLog

func (*MockLog) Child

func (m *MockLog) Child(name string) Log

func (*MockLog) Errorf

func (m *MockLog) Errorf(format string, args ...any)

func (*MockLog) Fatalf

func (m *MockLog) Fatalf(format string, args ...any)

func (*MockLog) Infof

func (m *MockLog) Infof(format string, args ...any)

func (*MockLog) Panicf

func (m *MockLog) Panicf(format string, args ...any)

func (*MockLog) SetLevel

func (m *MockLog) SetLevel(level LogLevel)

func (*MockLog) Warnf

func (m *MockLog) Warnf(format string, args ...any)

type StderrLog

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

func NewStderrLog

func NewStderrLog(name string) *StderrLog

func (StderrLog) Child

func (sl StderrLog) Child(name string) Log

func (StderrLog) Debugf

func (sl StderrLog) Debugf(format string, args ...any)

func (StderrLog) Errorf

func (sl StderrLog) Errorf(format string, args ...any)

func (StderrLog) Fatalf

func (sl StderrLog) Fatalf(format string, args ...any)

func (StderrLog) Infof

func (sl StderrLog) Infof(format string, args ...any)

func (StderrLog) Panicf

func (sl StderrLog) Panicf(format string, args ...any)

func (*StderrLog) SetLevel

func (sl *StderrLog) SetLevel(level LogLevel)

func (StderrLog) Warnf

func (sl StderrLog) Warnf(format string, args ...any)