xref: /aosp_15_r20/external/golang-protobuf/reflect/protodesc/proto.go (revision 1c12ee1efe575feb122dbf939ff15148a3b3e8f2)
1*1c12ee1eSDan Willemsen// Copyright 2019 The Go Authors. All rights reserved.
2*1c12ee1eSDan Willemsen// Use of this source code is governed by a BSD-style
3*1c12ee1eSDan Willemsen// license that can be found in the LICENSE file.
4*1c12ee1eSDan Willemsen
5*1c12ee1eSDan Willemsenpackage protodesc
6*1c12ee1eSDan Willemsen
7*1c12ee1eSDan Willemsenimport (
8*1c12ee1eSDan Willemsen	"fmt"
9*1c12ee1eSDan Willemsen	"strings"
10*1c12ee1eSDan Willemsen
11*1c12ee1eSDan Willemsen	"google.golang.org/protobuf/internal/encoding/defval"
12*1c12ee1eSDan Willemsen	"google.golang.org/protobuf/internal/strs"
13*1c12ee1eSDan Willemsen	"google.golang.org/protobuf/proto"
14*1c12ee1eSDan Willemsen	"google.golang.org/protobuf/reflect/protoreflect"
15*1c12ee1eSDan Willemsen
16*1c12ee1eSDan Willemsen	"google.golang.org/protobuf/types/descriptorpb"
17*1c12ee1eSDan Willemsen)
18*1c12ee1eSDan Willemsen
19*1c12ee1eSDan Willemsen// ToFileDescriptorProto copies a protoreflect.FileDescriptor into a
20*1c12ee1eSDan Willemsen// google.protobuf.FileDescriptorProto message.
21*1c12ee1eSDan Willemsenfunc ToFileDescriptorProto(file protoreflect.FileDescriptor) *descriptorpb.FileDescriptorProto {
22*1c12ee1eSDan Willemsen	p := &descriptorpb.FileDescriptorProto{
23*1c12ee1eSDan Willemsen		Name:    proto.String(file.Path()),
24*1c12ee1eSDan Willemsen		Options: proto.Clone(file.Options()).(*descriptorpb.FileOptions),
25*1c12ee1eSDan Willemsen	}
26*1c12ee1eSDan Willemsen	if file.Package() != "" {
27*1c12ee1eSDan Willemsen		p.Package = proto.String(string(file.Package()))
28*1c12ee1eSDan Willemsen	}
29*1c12ee1eSDan Willemsen	for i, imports := 0, file.Imports(); i < imports.Len(); i++ {
30*1c12ee1eSDan Willemsen		imp := imports.Get(i)
31*1c12ee1eSDan Willemsen		p.Dependency = append(p.Dependency, imp.Path())
32*1c12ee1eSDan Willemsen		if imp.IsPublic {
33*1c12ee1eSDan Willemsen			p.PublicDependency = append(p.PublicDependency, int32(i))
34*1c12ee1eSDan Willemsen		}
35*1c12ee1eSDan Willemsen		if imp.IsWeak {
36*1c12ee1eSDan Willemsen			p.WeakDependency = append(p.WeakDependency, int32(i))
37*1c12ee1eSDan Willemsen		}
38*1c12ee1eSDan Willemsen	}
39*1c12ee1eSDan Willemsen	for i, locs := 0, file.SourceLocations(); i < locs.Len(); i++ {
40*1c12ee1eSDan Willemsen		loc := locs.Get(i)
41*1c12ee1eSDan Willemsen		l := &descriptorpb.SourceCodeInfo_Location{}
42*1c12ee1eSDan Willemsen		l.Path = append(l.Path, loc.Path...)
43*1c12ee1eSDan Willemsen		if loc.StartLine == loc.EndLine {
44*1c12ee1eSDan Willemsen			l.Span = []int32{int32(loc.StartLine), int32(loc.StartColumn), int32(loc.EndColumn)}
45*1c12ee1eSDan Willemsen		} else {
46*1c12ee1eSDan Willemsen			l.Span = []int32{int32(loc.StartLine), int32(loc.StartColumn), int32(loc.EndLine), int32(loc.EndColumn)}
47*1c12ee1eSDan Willemsen		}
48*1c12ee1eSDan Willemsen		l.LeadingDetachedComments = append([]string(nil), loc.LeadingDetachedComments...)
49*1c12ee1eSDan Willemsen		if loc.LeadingComments != "" {
50*1c12ee1eSDan Willemsen			l.LeadingComments = proto.String(loc.LeadingComments)
51*1c12ee1eSDan Willemsen		}
52*1c12ee1eSDan Willemsen		if loc.TrailingComments != "" {
53*1c12ee1eSDan Willemsen			l.TrailingComments = proto.String(loc.TrailingComments)
54*1c12ee1eSDan Willemsen		}
55*1c12ee1eSDan Willemsen		if p.SourceCodeInfo == nil {
56*1c12ee1eSDan Willemsen			p.SourceCodeInfo = &descriptorpb.SourceCodeInfo{}
57*1c12ee1eSDan Willemsen		}
58*1c12ee1eSDan Willemsen		p.SourceCodeInfo.Location = append(p.SourceCodeInfo.Location, l)
59*1c12ee1eSDan Willemsen
60*1c12ee1eSDan Willemsen	}
61*1c12ee1eSDan Willemsen	for i, messages := 0, file.Messages(); i < messages.Len(); i++ {
62*1c12ee1eSDan Willemsen		p.MessageType = append(p.MessageType, ToDescriptorProto(messages.Get(i)))
63*1c12ee1eSDan Willemsen	}
64*1c12ee1eSDan Willemsen	for i, enums := 0, file.Enums(); i < enums.Len(); i++ {
65*1c12ee1eSDan Willemsen		p.EnumType = append(p.EnumType, ToEnumDescriptorProto(enums.Get(i)))
66*1c12ee1eSDan Willemsen	}
67*1c12ee1eSDan Willemsen	for i, services := 0, file.Services(); i < services.Len(); i++ {
68*1c12ee1eSDan Willemsen		p.Service = append(p.Service, ToServiceDescriptorProto(services.Get(i)))
69*1c12ee1eSDan Willemsen	}
70*1c12ee1eSDan Willemsen	for i, exts := 0, file.Extensions(); i < exts.Len(); i++ {
71*1c12ee1eSDan Willemsen		p.Extension = append(p.Extension, ToFieldDescriptorProto(exts.Get(i)))
72*1c12ee1eSDan Willemsen	}
73*1c12ee1eSDan Willemsen	if syntax := file.Syntax(); syntax != protoreflect.Proto2 {
74*1c12ee1eSDan Willemsen		p.Syntax = proto.String(file.Syntax().String())
75*1c12ee1eSDan Willemsen	}
76*1c12ee1eSDan Willemsen	return p
77*1c12ee1eSDan Willemsen}
78*1c12ee1eSDan Willemsen
79*1c12ee1eSDan Willemsen// ToDescriptorProto copies a protoreflect.MessageDescriptor into a
80*1c12ee1eSDan Willemsen// google.protobuf.DescriptorProto message.
81*1c12ee1eSDan Willemsenfunc ToDescriptorProto(message protoreflect.MessageDescriptor) *descriptorpb.DescriptorProto {
82*1c12ee1eSDan Willemsen	p := &descriptorpb.DescriptorProto{
83*1c12ee1eSDan Willemsen		Name:    proto.String(string(message.Name())),
84*1c12ee1eSDan Willemsen		Options: proto.Clone(message.Options()).(*descriptorpb.MessageOptions),
85*1c12ee1eSDan Willemsen	}
86*1c12ee1eSDan Willemsen	for i, fields := 0, message.Fields(); i < fields.Len(); i++ {
87*1c12ee1eSDan Willemsen		p.Field = append(p.Field, ToFieldDescriptorProto(fields.Get(i)))
88*1c12ee1eSDan Willemsen	}
89*1c12ee1eSDan Willemsen	for i, exts := 0, message.Extensions(); i < exts.Len(); i++ {
90*1c12ee1eSDan Willemsen		p.Extension = append(p.Extension, ToFieldDescriptorProto(exts.Get(i)))
91*1c12ee1eSDan Willemsen	}
92*1c12ee1eSDan Willemsen	for i, messages := 0, message.Messages(); i < messages.Len(); i++ {
93*1c12ee1eSDan Willemsen		p.NestedType = append(p.NestedType, ToDescriptorProto(messages.Get(i)))
94*1c12ee1eSDan Willemsen	}
95*1c12ee1eSDan Willemsen	for i, enums := 0, message.Enums(); i < enums.Len(); i++ {
96*1c12ee1eSDan Willemsen		p.EnumType = append(p.EnumType, ToEnumDescriptorProto(enums.Get(i)))
97*1c12ee1eSDan Willemsen	}
98*1c12ee1eSDan Willemsen	for i, xranges := 0, message.ExtensionRanges(); i < xranges.Len(); i++ {
99*1c12ee1eSDan Willemsen		xrange := xranges.Get(i)
100*1c12ee1eSDan Willemsen		p.ExtensionRange = append(p.ExtensionRange, &descriptorpb.DescriptorProto_ExtensionRange{
101*1c12ee1eSDan Willemsen			Start:   proto.Int32(int32(xrange[0])),
102*1c12ee1eSDan Willemsen			End:     proto.Int32(int32(xrange[1])),
103*1c12ee1eSDan Willemsen			Options: proto.Clone(message.ExtensionRangeOptions(i)).(*descriptorpb.ExtensionRangeOptions),
104*1c12ee1eSDan Willemsen		})
105*1c12ee1eSDan Willemsen	}
106*1c12ee1eSDan Willemsen	for i, oneofs := 0, message.Oneofs(); i < oneofs.Len(); i++ {
107*1c12ee1eSDan Willemsen		p.OneofDecl = append(p.OneofDecl, ToOneofDescriptorProto(oneofs.Get(i)))
108*1c12ee1eSDan Willemsen	}
109*1c12ee1eSDan Willemsen	for i, ranges := 0, message.ReservedRanges(); i < ranges.Len(); i++ {
110*1c12ee1eSDan Willemsen		rrange := ranges.Get(i)
111*1c12ee1eSDan Willemsen		p.ReservedRange = append(p.ReservedRange, &descriptorpb.DescriptorProto_ReservedRange{
112*1c12ee1eSDan Willemsen			Start: proto.Int32(int32(rrange[0])),
113*1c12ee1eSDan Willemsen			End:   proto.Int32(int32(rrange[1])),
114*1c12ee1eSDan Willemsen		})
115*1c12ee1eSDan Willemsen	}
116*1c12ee1eSDan Willemsen	for i, names := 0, message.ReservedNames(); i < names.Len(); i++ {
117*1c12ee1eSDan Willemsen		p.ReservedName = append(p.ReservedName, string(names.Get(i)))
118*1c12ee1eSDan Willemsen	}
119*1c12ee1eSDan Willemsen	return p
120*1c12ee1eSDan Willemsen}
121*1c12ee1eSDan Willemsen
122*1c12ee1eSDan Willemsen// ToFieldDescriptorProto copies a protoreflect.FieldDescriptor into a
123*1c12ee1eSDan Willemsen// google.protobuf.FieldDescriptorProto message.
124*1c12ee1eSDan Willemsenfunc ToFieldDescriptorProto(field protoreflect.FieldDescriptor) *descriptorpb.FieldDescriptorProto {
125*1c12ee1eSDan Willemsen	p := &descriptorpb.FieldDescriptorProto{
126*1c12ee1eSDan Willemsen		Name:    proto.String(string(field.Name())),
127*1c12ee1eSDan Willemsen		Number:  proto.Int32(int32(field.Number())),
128*1c12ee1eSDan Willemsen		Label:   descriptorpb.FieldDescriptorProto_Label(field.Cardinality()).Enum(),
129*1c12ee1eSDan Willemsen		Options: proto.Clone(field.Options()).(*descriptorpb.FieldOptions),
130*1c12ee1eSDan Willemsen	}
131*1c12ee1eSDan Willemsen	if field.IsExtension() {
132*1c12ee1eSDan Willemsen		p.Extendee = fullNameOf(field.ContainingMessage())
133*1c12ee1eSDan Willemsen	}
134*1c12ee1eSDan Willemsen	if field.Kind().IsValid() {
135*1c12ee1eSDan Willemsen		p.Type = descriptorpb.FieldDescriptorProto_Type(field.Kind()).Enum()
136*1c12ee1eSDan Willemsen	}
137*1c12ee1eSDan Willemsen	if field.Enum() != nil {
138*1c12ee1eSDan Willemsen		p.TypeName = fullNameOf(field.Enum())
139*1c12ee1eSDan Willemsen	}
140*1c12ee1eSDan Willemsen	if field.Message() != nil {
141*1c12ee1eSDan Willemsen		p.TypeName = fullNameOf(field.Message())
142*1c12ee1eSDan Willemsen	}
143*1c12ee1eSDan Willemsen	if field.HasJSONName() {
144*1c12ee1eSDan Willemsen		// A bug in older versions of protoc would always populate the
145*1c12ee1eSDan Willemsen		// "json_name" option for extensions when it is meaningless.
146*1c12ee1eSDan Willemsen		// When it did so, it would always use the camel-cased field name.
147*1c12ee1eSDan Willemsen		if field.IsExtension() {
148*1c12ee1eSDan Willemsen			p.JsonName = proto.String(strs.JSONCamelCase(string(field.Name())))
149*1c12ee1eSDan Willemsen		} else {
150*1c12ee1eSDan Willemsen			p.JsonName = proto.String(field.JSONName())
151*1c12ee1eSDan Willemsen		}
152*1c12ee1eSDan Willemsen	}
153*1c12ee1eSDan Willemsen	if field.Syntax() == protoreflect.Proto3 && field.HasOptionalKeyword() {
154*1c12ee1eSDan Willemsen		p.Proto3Optional = proto.Bool(true)
155*1c12ee1eSDan Willemsen	}
156*1c12ee1eSDan Willemsen	if field.HasDefault() {
157*1c12ee1eSDan Willemsen		def, err := defval.Marshal(field.Default(), field.DefaultEnumValue(), field.Kind(), defval.Descriptor)
158*1c12ee1eSDan Willemsen		if err != nil && field.DefaultEnumValue() != nil {
159*1c12ee1eSDan Willemsen			def = string(field.DefaultEnumValue().Name()) // occurs for unresolved enum values
160*1c12ee1eSDan Willemsen		} else if err != nil {
161*1c12ee1eSDan Willemsen			panic(fmt.Sprintf("%v: %v", field.FullName(), err))
162*1c12ee1eSDan Willemsen		}
163*1c12ee1eSDan Willemsen		p.DefaultValue = proto.String(def)
164*1c12ee1eSDan Willemsen	}
165*1c12ee1eSDan Willemsen	if oneof := field.ContainingOneof(); oneof != nil {
166*1c12ee1eSDan Willemsen		p.OneofIndex = proto.Int32(int32(oneof.Index()))
167*1c12ee1eSDan Willemsen	}
168*1c12ee1eSDan Willemsen	return p
169*1c12ee1eSDan Willemsen}
170*1c12ee1eSDan Willemsen
171*1c12ee1eSDan Willemsen// ToOneofDescriptorProto copies a protoreflect.OneofDescriptor into a
172*1c12ee1eSDan Willemsen// google.protobuf.OneofDescriptorProto message.
173*1c12ee1eSDan Willemsenfunc ToOneofDescriptorProto(oneof protoreflect.OneofDescriptor) *descriptorpb.OneofDescriptorProto {
174*1c12ee1eSDan Willemsen	return &descriptorpb.OneofDescriptorProto{
175*1c12ee1eSDan Willemsen		Name:    proto.String(string(oneof.Name())),
176*1c12ee1eSDan Willemsen		Options: proto.Clone(oneof.Options()).(*descriptorpb.OneofOptions),
177*1c12ee1eSDan Willemsen	}
178*1c12ee1eSDan Willemsen}
179*1c12ee1eSDan Willemsen
180*1c12ee1eSDan Willemsen// ToEnumDescriptorProto copies a protoreflect.EnumDescriptor into a
181*1c12ee1eSDan Willemsen// google.protobuf.EnumDescriptorProto message.
182*1c12ee1eSDan Willemsenfunc ToEnumDescriptorProto(enum protoreflect.EnumDescriptor) *descriptorpb.EnumDescriptorProto {
183*1c12ee1eSDan Willemsen	p := &descriptorpb.EnumDescriptorProto{
184*1c12ee1eSDan Willemsen		Name:    proto.String(string(enum.Name())),
185*1c12ee1eSDan Willemsen		Options: proto.Clone(enum.Options()).(*descriptorpb.EnumOptions),
186*1c12ee1eSDan Willemsen	}
187*1c12ee1eSDan Willemsen	for i, values := 0, enum.Values(); i < values.Len(); i++ {
188*1c12ee1eSDan Willemsen		p.Value = append(p.Value, ToEnumValueDescriptorProto(values.Get(i)))
189*1c12ee1eSDan Willemsen	}
190*1c12ee1eSDan Willemsen	for i, ranges := 0, enum.ReservedRanges(); i < ranges.Len(); i++ {
191*1c12ee1eSDan Willemsen		rrange := ranges.Get(i)
192*1c12ee1eSDan Willemsen		p.ReservedRange = append(p.ReservedRange, &descriptorpb.EnumDescriptorProto_EnumReservedRange{
193*1c12ee1eSDan Willemsen			Start: proto.Int32(int32(rrange[0])),
194*1c12ee1eSDan Willemsen			End:   proto.Int32(int32(rrange[1])),
195*1c12ee1eSDan Willemsen		})
196*1c12ee1eSDan Willemsen	}
197*1c12ee1eSDan Willemsen	for i, names := 0, enum.ReservedNames(); i < names.Len(); i++ {
198*1c12ee1eSDan Willemsen		p.ReservedName = append(p.ReservedName, string(names.Get(i)))
199*1c12ee1eSDan Willemsen	}
200*1c12ee1eSDan Willemsen	return p
201*1c12ee1eSDan Willemsen}
202*1c12ee1eSDan Willemsen
203*1c12ee1eSDan Willemsen// ToEnumValueDescriptorProto copies a protoreflect.EnumValueDescriptor into a
204*1c12ee1eSDan Willemsen// google.protobuf.EnumValueDescriptorProto message.
205*1c12ee1eSDan Willemsenfunc ToEnumValueDescriptorProto(value protoreflect.EnumValueDescriptor) *descriptorpb.EnumValueDescriptorProto {
206*1c12ee1eSDan Willemsen	return &descriptorpb.EnumValueDescriptorProto{
207*1c12ee1eSDan Willemsen		Name:    proto.String(string(value.Name())),
208*1c12ee1eSDan Willemsen		Number:  proto.Int32(int32(value.Number())),
209*1c12ee1eSDan Willemsen		Options: proto.Clone(value.Options()).(*descriptorpb.EnumValueOptions),
210*1c12ee1eSDan Willemsen	}
211*1c12ee1eSDan Willemsen}
212*1c12ee1eSDan Willemsen
213*1c12ee1eSDan Willemsen// ToServiceDescriptorProto copies a protoreflect.ServiceDescriptor into a
214*1c12ee1eSDan Willemsen// google.protobuf.ServiceDescriptorProto message.
215*1c12ee1eSDan Willemsenfunc ToServiceDescriptorProto(service protoreflect.ServiceDescriptor) *descriptorpb.ServiceDescriptorProto {
216*1c12ee1eSDan Willemsen	p := &descriptorpb.ServiceDescriptorProto{
217*1c12ee1eSDan Willemsen		Name:    proto.String(string(service.Name())),
218*1c12ee1eSDan Willemsen		Options: proto.Clone(service.Options()).(*descriptorpb.ServiceOptions),
219*1c12ee1eSDan Willemsen	}
220*1c12ee1eSDan Willemsen	for i, methods := 0, service.Methods(); i < methods.Len(); i++ {
221*1c12ee1eSDan Willemsen		p.Method = append(p.Method, ToMethodDescriptorProto(methods.Get(i)))
222*1c12ee1eSDan Willemsen	}
223*1c12ee1eSDan Willemsen	return p
224*1c12ee1eSDan Willemsen}
225*1c12ee1eSDan Willemsen
226*1c12ee1eSDan Willemsen// ToMethodDescriptorProto copies a protoreflect.MethodDescriptor into a
227*1c12ee1eSDan Willemsen// google.protobuf.MethodDescriptorProto message.
228*1c12ee1eSDan Willemsenfunc ToMethodDescriptorProto(method protoreflect.MethodDescriptor) *descriptorpb.MethodDescriptorProto {
229*1c12ee1eSDan Willemsen	p := &descriptorpb.MethodDescriptorProto{
230*1c12ee1eSDan Willemsen		Name:       proto.String(string(method.Name())),
231*1c12ee1eSDan Willemsen		InputType:  fullNameOf(method.Input()),
232*1c12ee1eSDan Willemsen		OutputType: fullNameOf(method.Output()),
233*1c12ee1eSDan Willemsen		Options:    proto.Clone(method.Options()).(*descriptorpb.MethodOptions),
234*1c12ee1eSDan Willemsen	}
235*1c12ee1eSDan Willemsen	if method.IsStreamingClient() {
236*1c12ee1eSDan Willemsen		p.ClientStreaming = proto.Bool(true)
237*1c12ee1eSDan Willemsen	}
238*1c12ee1eSDan Willemsen	if method.IsStreamingServer() {
239*1c12ee1eSDan Willemsen		p.ServerStreaming = proto.Bool(true)
240*1c12ee1eSDan Willemsen	}
241*1c12ee1eSDan Willemsen	return p
242*1c12ee1eSDan Willemsen}
243*1c12ee1eSDan Willemsen
244*1c12ee1eSDan Willemsenfunc fullNameOf(d protoreflect.Descriptor) *string {
245*1c12ee1eSDan Willemsen	if d == nil {
246*1c12ee1eSDan Willemsen		return nil
247*1c12ee1eSDan Willemsen	}
248*1c12ee1eSDan Willemsen	if strings.HasPrefix(string(d.FullName()), unknownPrefix) {
249*1c12ee1eSDan Willemsen		return proto.String(string(d.FullName()[len(unknownPrefix):]))
250*1c12ee1eSDan Willemsen	}
251*1c12ee1eSDan Willemsen	return proto.String("." + string(d.FullName()))
252*1c12ee1eSDan Willemsen}
253