Documentation
¶
Index ¶
- func AllEnums(f *descriptor.FileDescriptorProto) []*descriptor.EnumDescriptorProto
- func AllMessages(f *descriptor.FileDescriptorProto) []*descriptor.DescriptorProto
- func CountElem(symbolPath string) int
- func FieldTypeName(f *descriptor.FieldDescriptorProto_Type) string
- func PackageName(f *descriptor.FileDescriptorProto) string
- func ReadJSONFile(path string) (*plugin.CodeGeneratorRequest, error)
- func TrimElem(symbolPath string, n int) string
- type ASTNamedNode
- type ASTNode
- type Resolver
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AllEnums ¶
func AllEnums(f *descriptor.FileDescriptorProto) []*descriptor.EnumDescriptorProto
AllEnums returnes a list of all the enum type nodes in f, including nested ones.
func AllMessages ¶
func AllMessages(f *descriptor.FileDescriptorProto) []*descriptor.DescriptorProto
AllMessages returns a list of all the message type nodes in f, including nested ones.
func CountElem ¶
CountElem returns the number of elements that the symbol path contains.
CountElem("a.b.c") == 3
CountElem(".a.b.c") == 3
CountElem("a.b.c.d") == 4
CountElem("a") == 1
CountElem(".") == 0
CountElem("") == 0
func FieldTypeName ¶
func FieldTypeName(f *descriptor.FieldDescriptorProto_Type) string
FieldTypeName returns the protobuf-syntax name for the given field type. It panics on errors (e.g. zero value).
func PackageName ¶
func PackageName(f *descriptor.FileDescriptorProto) string
PackageName returns the package name of the given file, which is either the result of f.GetPackage (a package set explicitly by the user) or the name of the file.
func ReadJSONFile ¶
func ReadJSONFile(path string) (*plugin.CodeGeneratorRequest, error)
ReadJSONFile opens and unmarshals the JSON dump file from the protoc-gen-json plugin, returning any error that occurs.
func TrimElem ¶
TrimElem returns the given symbol path with at max N elements trimmed off the left (outermost) side.
TrimElem("a.b.c", 1) == "b.c"
TrimElem(".a.b.c", 1) == "b.c"
TrimElem(".a.b.c", -1) == ".a.b"
Extreme cases won't panic, either:
TrimElem("a.b.c", 1000) == ""
TrimElem(".a.b.c", 1000) == ""
TrimElem("a.b.c", -1000) == ""
TrimElem(".a.b.c", -1000) == ""
Types ¶
type ASTNamedNode ¶
type ASTNamedNode interface {
GetName() string
}
ASTNamedNode is a type from the descriptor package that can return its name string. These include (but are not limited to):
*descriptor.DescriptorProto *descriptor.EnumDescriptorProto *descriptor.ServiceDescriptorProto *descriptor.FieldDescriptorProto
type Resolver ¶
type Resolver struct {
// contains filtered or unexported fields
}
Resolver handles the resolution of symbol names to their respective files (it answers the question "which file was this symbol defined in?").
func NewResolver ¶
func NewResolver(f []*descriptor.FileDescriptorProto) *Resolver
NewResolver returns a new symbol resolver for the given files.
func (*Resolver) Resolve ¶
func (r *Resolver) Resolve(symbolPath string, relative ASTNode) (ASTNode, *descriptor.FileDescriptorProto)
Resolve resolves the named symbol into its actual AST node and the file that node is inside of. Example symbolPath strings are:
Sym pkg.Sym foo.bar.pkg.Sym .foo.bar.pkg.Sym
Relative symbol paths like:
Sym pkg.Sym foo.bar.Pkg.Sym
Are resolved according to the protobuf language doc:
"Packages and Name Resolution" - https://developers.google.com/protocol-buffers/docs/proto#packages
As all relative symbol paths in protobuf follow C++ style scoping rules, the path can only be resolved reliably whilst knowing the AST node that resolution is relative to. If the relative node is nil and the symbol path is not fully-qualified, a panic will occur.
For example in the pseudo-code:
package pkg;
message Foo {
...
}
message Bar {
message Foo {
...
}
Foo this = 1;
}
Resolution of the message field pkg.Bar.this must be done *relative* to the AST node for pkg.Bar, because pkg.Bar.thi sis of type pkg.Bar.Foo, not pkg.Foo.
TODO(slimsag): relative symbol path resolution is not yet implemented and as such will always panic.
Source Files