262 lines
7.5 KiB
Go
262 lines
7.5 KiB
Go
// Copyright 2019 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 msgfmt implements a text marshaler combining the desirable features
|
|
// of both the JSON and proto text formats.
|
|
// It is optimized for human readability and has no associated deserializer.
|
|
package msgfmt
|
|
|
|
import (
|
|
"bytes"
|
|
"fmt"
|
|
"reflect"
|
|
"sort"
|
|
"strconv"
|
|
"strings"
|
|
"time"
|
|
|
|
"google.golang.org/protobuf/encoding/protowire"
|
|
"google.golang.org/protobuf/internal/detrand"
|
|
"google.golang.org/protobuf/internal/genid"
|
|
"google.golang.org/protobuf/internal/order"
|
|
"google.golang.org/protobuf/proto"
|
|
"google.golang.org/protobuf/reflect/protoreflect"
|
|
"google.golang.org/protobuf/reflect/protoregistry"
|
|
)
|
|
|
|
// Format returns a formatted string for the message.
|
|
func Format(m proto.Message) string {
|
|
return string(appendMessage(nil, m.ProtoReflect()))
|
|
}
|
|
|
|
// FormatValue returns a formatted string for an arbitrary value.
|
|
func FormatValue(v protoreflect.Value, fd protoreflect.FieldDescriptor) string {
|
|
return string(appendValue(nil, v, fd))
|
|
}
|
|
|
|
func appendValue(b []byte, v protoreflect.Value, fd protoreflect.FieldDescriptor) []byte {
|
|
switch v := v.Interface().(type) {
|
|
case nil:
|
|
return append(b, "<invalid>"...)
|
|
case bool, int32, int64, uint32, uint64, float32, float64:
|
|
return append(b, fmt.Sprint(v)...)
|
|
case string:
|
|
return append(b, strconv.Quote(string(v))...)
|
|
case []byte:
|
|
return append(b, strconv.Quote(string(v))...)
|
|
case protoreflect.EnumNumber:
|
|
return appendEnum(b, v, fd)
|
|
case protoreflect.Message:
|
|
return appendMessage(b, v)
|
|
case protoreflect.List:
|
|
return appendList(b, v, fd)
|
|
case protoreflect.Map:
|
|
return appendMap(b, v, fd)
|
|
default:
|
|
panic(fmt.Sprintf("invalid type: %T", v))
|
|
}
|
|
}
|
|
|
|
func appendEnum(b []byte, v protoreflect.EnumNumber, fd protoreflect.FieldDescriptor) []byte {
|
|
if fd != nil {
|
|
if ev := fd.Enum().Values().ByNumber(v); ev != nil {
|
|
return append(b, ev.Name()...)
|
|
}
|
|
}
|
|
return strconv.AppendInt(b, int64(v), 10)
|
|
}
|
|
|
|
func appendMessage(b []byte, m protoreflect.Message) []byte {
|
|
if b2 := appendKnownMessage(b, m); b2 != nil {
|
|
return b2
|
|
}
|
|
|
|
b = append(b, '{')
|
|
order.RangeFields(m, order.IndexNameFieldOrder, func(fd protoreflect.FieldDescriptor, v protoreflect.Value) bool {
|
|
b = append(b, fd.TextName()...)
|
|
b = append(b, ':')
|
|
b = appendValue(b, v, fd)
|
|
b = append(b, delim()...)
|
|
return true
|
|
})
|
|
b = appendUnknown(b, m.GetUnknown())
|
|
b = bytes.TrimRight(b, delim())
|
|
b = append(b, '}')
|
|
return b
|
|
}
|
|
|
|
var protocmpMessageType = reflect.TypeOf(map[string]any(nil))
|
|
|
|
func appendKnownMessage(b []byte, m protoreflect.Message) []byte {
|
|
md := m.Descriptor()
|
|
fds := md.Fields()
|
|
switch md.FullName() {
|
|
case genid.Any_message_fullname:
|
|
var msgVal protoreflect.Message
|
|
url := m.Get(fds.ByNumber(genid.Any_TypeUrl_field_number)).String()
|
|
if v := reflect.ValueOf(m); v.Type().ConvertibleTo(protocmpMessageType) {
|
|
// For protocmp.Message, directly obtain the sub-message value
|
|
// which is stored in structured form, rather than as raw bytes.
|
|
m2 := v.Convert(protocmpMessageType).Interface().(map[string]any)
|
|
v, ok := m2[string(genid.Any_Value_field_name)].(proto.Message)
|
|
if !ok {
|
|
return nil
|
|
}
|
|
msgVal = v.ProtoReflect()
|
|
} else {
|
|
val := m.Get(fds.ByNumber(genid.Any_Value_field_number)).Bytes()
|
|
mt, err := protoregistry.GlobalTypes.FindMessageByURL(url)
|
|
if err != nil {
|
|
return nil
|
|
}
|
|
msgVal = mt.New()
|
|
err = proto.UnmarshalOptions{AllowPartial: true}.Unmarshal(val, msgVal.Interface())
|
|
if err != nil {
|
|
return nil
|
|
}
|
|
}
|
|
|
|
b = append(b, '{')
|
|
b = append(b, "["+url+"]"...)
|
|
b = append(b, ':')
|
|
b = appendMessage(b, msgVal)
|
|
b = append(b, '}')
|
|
return b
|
|
|
|
case genid.Timestamp_message_fullname:
|
|
secs := m.Get(fds.ByNumber(genid.Timestamp_Seconds_field_number)).Int()
|
|
nanos := m.Get(fds.ByNumber(genid.Timestamp_Nanos_field_number)).Int()
|
|
if nanos < 0 || nanos >= 1e9 {
|
|
return nil
|
|
}
|
|
t := time.Unix(secs, nanos).UTC()
|
|
x := t.Format("2006-01-02T15:04:05.000000000") // RFC 3339
|
|
x = strings.TrimSuffix(x, "000")
|
|
x = strings.TrimSuffix(x, "000")
|
|
x = strings.TrimSuffix(x, ".000")
|
|
return append(b, x+"Z"...)
|
|
|
|
case genid.Duration_message_fullname:
|
|
sign := ""
|
|
secs := m.Get(fds.ByNumber(genid.Duration_Seconds_field_number)).Int()
|
|
nanos := m.Get(fds.ByNumber(genid.Duration_Nanos_field_number)).Int()
|
|
if nanos <= -1e9 || nanos >= 1e9 || (secs > 0 && nanos < 0) || (secs < 0 && nanos > 0) {
|
|
return nil
|
|
}
|
|
if secs < 0 || nanos < 0 {
|
|
sign, secs, nanos = "-", -1*secs, -1*nanos
|
|
}
|
|
x := fmt.Sprintf("%s%d.%09d", sign, secs, nanos)
|
|
x = strings.TrimSuffix(x, "000")
|
|
x = strings.TrimSuffix(x, "000")
|
|
x = strings.TrimSuffix(x, ".000")
|
|
return append(b, x+"s"...)
|
|
|
|
case genid.BoolValue_message_fullname,
|
|
genid.Int32Value_message_fullname,
|
|
genid.Int64Value_message_fullname,
|
|
genid.UInt32Value_message_fullname,
|
|
genid.UInt64Value_message_fullname,
|
|
genid.FloatValue_message_fullname,
|
|
genid.DoubleValue_message_fullname,
|
|
genid.StringValue_message_fullname,
|
|
genid.BytesValue_message_fullname:
|
|
fd := fds.ByNumber(genid.WrapperValue_Value_field_number)
|
|
return appendValue(b, m.Get(fd), fd)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func appendUnknown(b []byte, raw protoreflect.RawFields) []byte {
|
|
rs := make(map[protoreflect.FieldNumber][]protoreflect.RawFields)
|
|
for len(raw) > 0 {
|
|
num, _, n := protowire.ConsumeField(raw)
|
|
rs[num] = append(rs[num], raw[:n])
|
|
raw = raw[n:]
|
|
}
|
|
|
|
var ns []protoreflect.FieldNumber
|
|
for n := range rs {
|
|
ns = append(ns, n)
|
|
}
|
|
sort.Slice(ns, func(i, j int) bool { return ns[i] < ns[j] })
|
|
|
|
for _, n := range ns {
|
|
var leftBracket, rightBracket string
|
|
if len(rs[n]) > 1 {
|
|
leftBracket, rightBracket = "[", "]"
|
|
}
|
|
|
|
b = strconv.AppendInt(b, int64(n), 10)
|
|
b = append(b, ':')
|
|
b = append(b, leftBracket...)
|
|
for _, r := range rs[n] {
|
|
num, typ, n := protowire.ConsumeTag(r)
|
|
r = r[n:]
|
|
switch typ {
|
|
case protowire.VarintType:
|
|
v, _ := protowire.ConsumeVarint(r)
|
|
b = strconv.AppendInt(b, int64(v), 10)
|
|
case protowire.Fixed32Type:
|
|
v, _ := protowire.ConsumeFixed32(r)
|
|
b = append(b, fmt.Sprintf("0x%08x", v)...)
|
|
case protowire.Fixed64Type:
|
|
v, _ := protowire.ConsumeFixed64(r)
|
|
b = append(b, fmt.Sprintf("0x%016x", v)...)
|
|
case protowire.BytesType:
|
|
v, _ := protowire.ConsumeBytes(r)
|
|
b = strconv.AppendQuote(b, string(v))
|
|
case protowire.StartGroupType:
|
|
v, _ := protowire.ConsumeGroup(num, r)
|
|
b = append(b, '{')
|
|
b = appendUnknown(b, v)
|
|
b = bytes.TrimRight(b, delim())
|
|
b = append(b, '}')
|
|
default:
|
|
panic(fmt.Sprintf("invalid type: %v", typ))
|
|
}
|
|
b = append(b, delim()...)
|
|
}
|
|
b = bytes.TrimRight(b, delim())
|
|
b = append(b, rightBracket...)
|
|
b = append(b, delim()...)
|
|
}
|
|
return b
|
|
}
|
|
|
|
func appendList(b []byte, v protoreflect.List, fd protoreflect.FieldDescriptor) []byte {
|
|
b = append(b, '[')
|
|
for i := 0; i < v.Len(); i++ {
|
|
b = appendValue(b, v.Get(i), fd)
|
|
b = append(b, delim()...)
|
|
}
|
|
b = bytes.TrimRight(b, delim())
|
|
b = append(b, ']')
|
|
return b
|
|
}
|
|
|
|
func appendMap(b []byte, v protoreflect.Map, fd protoreflect.FieldDescriptor) []byte {
|
|
b = append(b, '{')
|
|
order.RangeEntries(v, order.GenericKeyOrder, func(k protoreflect.MapKey, v protoreflect.Value) bool {
|
|
b = appendValue(b, k.Value(), fd.MapKey())
|
|
b = append(b, ':')
|
|
b = appendValue(b, v, fd.MapValue())
|
|
b = append(b, delim()...)
|
|
return true
|
|
})
|
|
b = bytes.TrimRight(b, delim())
|
|
b = append(b, '}')
|
|
return b
|
|
}
|
|
|
|
func delim() string {
|
|
// Deliberately introduce instability into the message string to
|
|
// discourage users from depending on it.
|
|
if detrand.Bool() {
|
|
return " "
|
|
}
|
|
return ", "
|
|
}
|