peridot/vendor/k8s.io/klog/v2/internal/serialize/keyvalues_slog.go

//go:build go1.21
// +build go1.21

/*
Copyright 2023 The Kubernetes Authors.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

package serialize

import (
	"bytes"
	"fmt"
	"log/slog"
	"strconv"

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

// KVFormat serializes one key/value pair into the provided buffer.
// A space gets inserted before the pair.
func (f Formatter) KVFormat(b *bytes.Buffer, k, v interface{}) {
	// This is the version without slog support. Must be kept in sync with
	// the version in keyvalues_slog.go.

	b.WriteByte(' ')
	// Keys are assumed to be well-formed according to
	// https://github.com/kubernetes/community/blob/master/contributors/devel/sig-instrumentation/migration-to-structured-logging.md#name-arguments
	// for the sake of performance. Keys with spaces,
	// special characters, etc. will break parsing.
	if sK, ok := k.(string); ok {
		// Avoid one allocation when the key is a string, which
		// normally it should be.
		b.WriteString(sK)
	} else {
		b.WriteString(fmt.Sprintf("%s", k))
	}

	// The type checks are sorted so that more frequently used ones
	// come first because that is then faster in the common
	// cases. In Kubernetes, ObjectRef (a Stringer) is more common
	// than plain strings
	// (https://github.com/kubernetes/kubernetes/pull/106594#issuecomment-975526235).
	//
	// slog.LogValuer does not need to be handled here because the handler will
	// already have resolved such special values to the final value for logging.
	switch v := v.(type) {
	case textWriter:
		writeTextWriterValue(b, v)
	case slog.Value:
		// This must come before fmt.Stringer because slog.Value implements
		// fmt.Stringer, but does not produce the output that we want.
		b.WriteByte('=')
		generateJSON(b, v)
	case fmt.Stringer:
		writeStringValue(b, StringerToString(v))
	case string:
		writeStringValue(b, v)
	case error:
		writeStringValue(b, ErrorToString(v))
	case logr.Marshaler:
		value := MarshalerToValue(v)
		// A marshaler that returns a string is useful for
		// delayed formatting of complex values. We treat this
		// case like a normal string. This is useful for
		// multi-line support.
		//
		// We could do this by recursively formatting a value,
		// but that comes with the risk of infinite recursion
		// if a marshaler returns itself. Instead we call it
		// only once and rely on it returning the intended
		// value directly.
		switch value := value.(type) {
		case string:
			writeStringValue(b, value)
		default:
			f.formatAny(b, value)
		}
	case slog.LogValuer:
		value := slog.AnyValue(v).Resolve()
		if value.Kind() == slog.KindString {
			writeStringValue(b, value.String())
		} else {
			b.WriteByte('=')
			generateJSON(b, value)
		}
	case []byte:
		// In https://github.com/kubernetes/klog/pull/237 it was decided
		// to format byte slices with "%+q". The advantages of that are:
		// - readable output if the bytes happen to be printable
		// - non-printable bytes get represented as unicode escape
		//   sequences (\uxxxx)
		//
		// The downsides are that we cannot use the faster
		// strconv.Quote here and that multi-line output is not
		// supported. If developers know that a byte array is
		// printable and they want multi-line output, they can
		// convert the value to string before logging it.
		b.WriteByte('=')
		b.WriteString(fmt.Sprintf("%+q", v))
	default:
		f.formatAny(b, v)
	}
}

// generateJSON has the same preference for plain strings as KVFormat.
// In contrast to KVFormat it always produces valid JSON with no line breaks.
func generateJSON(b *bytes.Buffer, v interface{}) {
	switch v := v.(type) {
	case slog.Value:
		switch v.Kind() {
		case slog.KindGroup:
			// Format as a JSON group. We must not involve f.AnyToStringHook (if there is any),
			// because there is no guarantee that it produces valid JSON.
			b.WriteByte('{')
			for i, attr := range v.Group() {
				if i > 0 {
					b.WriteByte(',')
				}
				b.WriteString(strconv.Quote(attr.Key))
				b.WriteByte(':')
				generateJSON(b, attr.Value)
			}
			b.WriteByte('}')
		case slog.KindLogValuer:
			generateJSON(b, v.Resolve())
		default:
			// Peel off the slog.Value wrapper and format the actual value.
			generateJSON(b, v.Any())
		}
	case fmt.Stringer:
		b.WriteString(strconv.Quote(StringerToString(v)))
	case logr.Marshaler:
		generateJSON(b, MarshalerToValue(v))
	case slog.LogValuer:
		generateJSON(b, slog.AnyValue(v).Resolve().Any())
	case string:
		b.WriteString(strconv.Quote(v))
	case error:
		b.WriteString(strconv.Quote(v.Error()))
	default:
		formatAsJSON(b, v)
	}
}