102 lines
2.5 KiB
Go
102 lines
2.5 KiB
Go
// Copyright 2022 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package slog
|
|
|
|
import (
|
|
"fmt"
|
|
"time"
|
|
)
|
|
|
|
// An Attr is a key-value pair.
|
|
type Attr struct {
|
|
Key string
|
|
Value Value
|
|
}
|
|
|
|
// String returns an Attr for a string value.
|
|
func String(key, value string) Attr {
|
|
return Attr{key, StringValue(value)}
|
|
}
|
|
|
|
// Int64 returns an Attr for an int64.
|
|
func Int64(key string, value int64) Attr {
|
|
return Attr{key, Int64Value(value)}
|
|
}
|
|
|
|
// Int converts an int to an int64 and returns
|
|
// an Attr with that value.
|
|
func Int(key string, value int) Attr {
|
|
return Int64(key, int64(value))
|
|
}
|
|
|
|
// Uint64 returns an Attr for a uint64.
|
|
func Uint64(key string, v uint64) Attr {
|
|
return Attr{key, Uint64Value(v)}
|
|
}
|
|
|
|
// Float64 returns an Attr for a floating-point number.
|
|
func Float64(key string, v float64) Attr {
|
|
return Attr{key, Float64Value(v)}
|
|
}
|
|
|
|
// Bool returns an Attr for a bool.
|
|
func Bool(key string, v bool) Attr {
|
|
return Attr{key, BoolValue(v)}
|
|
}
|
|
|
|
// Time returns an Attr for a time.Time.
|
|
// It discards the monotonic portion.
|
|
func Time(key string, v time.Time) Attr {
|
|
return Attr{key, TimeValue(v)}
|
|
}
|
|
|
|
// Duration returns an Attr for a time.Duration.
|
|
func Duration(key string, v time.Duration) Attr {
|
|
return Attr{key, DurationValue(v)}
|
|
}
|
|
|
|
// Group returns an Attr for a Group Value.
|
|
// The first argument is the key; the remaining arguments
|
|
// are converted to Attrs as in [Logger.Log].
|
|
//
|
|
// Use Group to collect several key-value pairs under a single
|
|
// key on a log line, or as the result of LogValue
|
|
// in order to log a single value as multiple Attrs.
|
|
func Group(key string, args ...any) Attr {
|
|
return Attr{key, GroupValue(argsToAttrSlice(args)...)}
|
|
}
|
|
|
|
func argsToAttrSlice(args []any) []Attr {
|
|
var (
|
|
attr Attr
|
|
attrs []Attr
|
|
)
|
|
for len(args) > 0 {
|
|
attr, args = argsToAttr(args)
|
|
attrs = append(attrs, attr)
|
|
}
|
|
return attrs
|
|
}
|
|
|
|
// Any returns an Attr for the supplied value.
|
|
// See [Value.AnyValue] for how values are treated.
|
|
func Any(key string, value any) Attr {
|
|
return Attr{key, AnyValue(value)}
|
|
}
|
|
|
|
// Equal reports whether a and b have equal keys and values.
|
|
func (a Attr) Equal(b Attr) bool {
|
|
return a.Key == b.Key && a.Value.Equal(b.Value)
|
|
}
|
|
|
|
func (a Attr) String() string {
|
|
return fmt.Sprintf("%s=%s", a.Key, a.Value)
|
|
}
|
|
|
|
// isEmpty reports whether a has an empty key and a nil value.
|
|
// That can be written as Attr{} or Any("", nil).
|
|
func (a Attr) isEmpty() bool {
|
|
return a.Key == "" && a.Value.num == 0 && a.Value.any == nil
|
|
}
|