clilog

Documentation

Index

• Variables
• func MarshalKeyvals(keyvals ...interface{}) ([]byte, error)
• type Encoder
  • func NewEncoder(w io.Writer) *Encoder
  • func (enc *Encoder) EncodeKeyval(_, value interface{}) error
  • func (enc *Encoder) EncodeKeyvals(keyvals ...interface{}) error
  • func (enc *Encoder) EndRecord() error
  • func (enc *Encoder) Reset()
• type Logger
  • func New(w io.Writer) Logger
• type MarshalerError
  • func (e *MarshalerError) Error() string

Variables

var ErrUnsupportedKeyType = errors.New("unsupported key type")

ErrUnsupportedKeyType is returned by Encoder methods if a key has an unsupported type.

var ErrUnsupportedValueType = errors.New("unsupported value type")

ErrUnsupportedValueType is returned by Encoder methods if a value has an unsupported type.

Functions

func MarshalKeyvals

func MarshalKeyvals(keyvals ...interface{}) ([]byte, error)

MarshalKeyvals returns the clilog encoding of keyvals, a variadic sequence of alternating keys and values.

Types

type Encoder

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

An Encoder writes clilog data to an output stream.

func NewEncoder

func NewEncoder(w io.Writer) *Encoder

NewEncoder returns a new clilog Encoder that writes to w.

func (*Encoder) EncodeKeyval

func (enc *Encoder) EncodeKeyval(_, value interface{}) error

EncodeKeyval writes the clilog encoding of key and value to the stream. A single space is written before the second and subsequent keys in a record. Nothing is written if a non-nil error is returned.

func (*Encoder) EncodeKeyvals

func (enc *Encoder) EncodeKeyvals(keyvals ...interface{}) error

EncodeKeyvals writes the logfmt encoding of keyvals to the stream. Keyvals is a variadic sequence of alternating keys and values. Keys of unsupported type are skipped along with their corresponding value. Values of unsupported type or that cause a MarshalerError are replaced by their error but do not cause EncodeKeyvals to return an error. If a non-nil error is returned some key/value pairs may not have be written.

func (*Encoder) EndRecord

func (enc *Encoder) EndRecord() error

EndRecord ends the log record.

func (*Encoder) Reset

func (enc *Encoder) Reset()

Reset resets the Encoder to the beginning of a new record.

type Logger

type Logger interface {
	Log(keyvals ...interface{}) error
}

Logger interface compatible with go-kit/logger.

func New

func New(w io.Writer) Logger

New returns a logger that encodes keyvals to the Writer in CLI friendly format. Each log event produces no more than one call to w.Write. The passed Writer must be safe for concurrent use by multiple goroutines if the returned Logger will be used concurrently.

type MarshalerError

type MarshalerError struct {
	Type reflect.Type
	Err  error
}

MarshalerError represents an error encountered while marshaling a value.

func (*MarshalerError) Error

func (e *MarshalerError) Error() string