loggercheck

README

loggercheck

Description

A linter checks the odd number of key and value pairs for common logger libraries:

• kitlog
• klog
• logr
• zap

Badges

Install

go install github.com/timonwong/loggercheck/cmd/loggercheck

Usage

loggercheck: Checks key valur pairs for common logger libraries (kitlog,logr,klog,zap).

Usage: loggercheck [-flag] [package]


Flags:
  -V    print version and exit
  -all
        no effect (deprecated)
  -c int
        display offending line with this many lines of context (default -1)
  -cpuprofile string
        write CPU profile to this file
  -debug string
        debug flags, any subset of "fpstv"
  -disable value
        comma-separated list of disabled logger checker (kitlog,klog,logr,zap) (default kitlog)
  -fix
        apply all suggested fixes
  -flags
        print analyzer flags in JSON
  -json
        emit JSON output
  -memprofile string
        write memory profile to this file
  -requirestringkey
        require all logging keys to be inlined constant strings
  -rulefile string
        path to a file contains a list of rules
  -source
        no effect (deprecated)
  -tags string
        no effect (deprecated)
  -test
        indicates whether test files should be analyzed, too (default true)
  -trace string
        write trace log to this file
  -v    no effect (deprecated)

Example

package a

import (
	"context"
	"fmt"

	"github.com/go-logr/logr"
)

func Example() {
	log := logr.Discard()
	log = log.WithValues("key")                              
	log.Info("message", "key1", "value1", "key2", "value2", "key3") 
	log.Error(fmt.Errorf("error"), "message", "key1", "value1", "key2")
	log.Error(fmt.Errorf("error"), "message", "key1", "value1", "key2", "value2")

	var log2 logr.Logger
	log2 = log
	log2.Info("message", "key1") 

	log3 := logr.FromContextOrDiscard(context.TODO())
	log3.Error(fmt.Errorf("error"), "message", "key1")
}

a.go:12:23: odd number of arguments passed as key-value pairs for logging
a.go:13:22: odd number of arguments passed as key-value pairs for logging
a.go:14:44: odd number of arguments passed as key-value pairs for logging
a.go:19:23: odd number of arguments passed as key-value pairs for logging
a.go:22:45: odd number of arguments passed as key-value pairs for logging

Documentation

Index

• Constants
• func NewAnalyzer(opts ...Option) *analysis.Analyzer
• type Option
  • func WithDisable(disable []string) Option
  • func WithNoPrintflike(noPrintfLike bool) Option
  • func WithRequireStringKey(requireStringKey bool) Option
  • func WithRules(customRules []string) Option

Constants

const Doc = `Checks key valur pairs for common logger libraries (kitlog,klog,logr,zap).`

Functions

func NewAnalyzer

func NewAnalyzer(opts ...Option) *analysis.Analyzer

Types

type Option

type Option func(*loggercheck)

func WithDisable

func WithDisable(disable []string) Option

func WithNoPrintflike

func WithNoPrintflike(noPrintfLike bool) Option

func WithRequireStringKey

func WithRequireStringKey(requireStringKey bool) Option

func WithRules

func WithRules(customRules []string) Option