README
¶
go-protoparser 
go-protoparser is a yet another Go package which parses a Protocol Buffer file (proto3).
- Conforms to the exactly official spec.
- Undergone rigorous testing. The parser can parses all examples of the official spec well.
- Easy to use the parser. You can just call the Parse function and receive the Proto struct.
- If you don't care about the order of body elements, consider to use the unordered.Proto struct.
- Or if you want to use the visitor pattern, use the Visitor struct.
Installation
go get github.com/yoheimuta/go-protoparser
Example
A Protocol Buffer file versioned 3 which is an example of the official reference.
syntax = "proto3";
// An example of the official reference
// See https://developers.google.com/protocol-buffers/docs/reference/proto3-spec#proto_file
package examplepb;
import public "other.proto";
option java_package = "com.example.foo";
enum EnumAllowingAlias {
option allow_alias = true;
UNKNOWN = 0;
STARTED = 1;
RUNNING = 2 [(custom_option) = "hello world"];
}
message outer {
option (my_option).a = true;
message inner { // Level 2
int64 ival = 1;
}
repeated inner inner_message = 2;
EnumAllowingAlias enum_field =3;
map<int32, string> my_map = 4;
}
The Parsed result is a Go typed struct. The below output is encoded to JSON for simplicity.
{
"Syntax": {
"ProtobufVersion": "proto3",
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 0,
"Line": 1,
"Column": 1
}
}
},
"ProtoBody": [
{
"Name": "examplepb",
"Comments": [
{
"Raw": "// An example of the official reference",
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 19,
"Line": 2,
"Column": 1
}
}
},
{
"Raw": "// See https://developers.google.com/protocol-buffers/docs/reference/proto3-spec#proto_file",
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 59,
"Line": 3,
"Column": 1
}
}
}
],
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 151,
"Line": 4,
"Column": 1
}
}
},
{
"Modifier": 1,
"Location": "\"other.proto\"",
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 170,
"Line": 5,
"Column": 1
}
}
},
{
"OptionName": "java_package",
"Constant": "\"com.example.foo\"",
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 199,
"Line": 6,
"Column": 1
}
}
},
{
"EnumName": "EnumAllowingAlias",
"EnumBody": [
{
"OptionName": "allow_alias",
"Constant": "true",
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 269,
"Line": 8,
"Column": 5
}
}
},
{
"Ident": "UNKNOWN",
"Number": "0",
"EnumValueOptions": null,
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 300,
"Line": 9,
"Column": 5
}
}
},
{
"Ident": "STARTED",
"Number": "1",
"EnumValueOptions": null,
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 317,
"Line": 10,
"Column": 5
}
}
},
{
"Ident": "RUNNING",
"Number": "2",
"EnumValueOptions": [
{
"OptionName": "(custom_option)",
"Constant": "\"hello world\""
}
],
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 334,
"Line": 11,
"Column": 5
}
}
}
],
"Comments": null,
"InlineComment": null,
"InlineCommentBehindLeftCurly": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 240,
"Line": 7,
"Column": 1
}
}
},
{
"MessageName": "outer",
"MessageBody": [
{
"OptionName": "(my_option).a",
"Constant": "true",
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 403,
"Line": 14,
"Column": 5
}
}
},
{
"MessageName": "inner",
"MessageBody": [
{
"IsRepeated": false,
"Type": "int64",
"FieldName": "ival",
"FieldNumber": "1",
"FieldOptions": null,
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 471,
"Line": 16,
"Column": 7
}
}
}
],
"Comments": null,
"InlineComment": null,
"InlineCommentBehindLeftCurly": {
"Raw": "// Level 2",
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 454,
"Line": 15,
"Column": 23
}
}
},
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 436,
"Line": 15,
"Column": 5
}
}
},
{
"IsRepeated": true,
"Type": "inner",
"FieldName": "inner_message",
"FieldNumber": "2",
"FieldOptions": null,
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 497,
"Line": 18,
"Column": 5
}
}
},
{
"IsRepeated": false,
"Type": "EnumAllowingAlias",
"FieldName": "enum_field",
"FieldNumber": "3",
"FieldOptions": null,
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 535,
"Line": 19,
"Column": 5
}
}
},
{
"KeyType": "int32",
"Type": "string",
"MapName": "my_map",
"FieldNumber": "4",
"FieldOptions": null,
"Comments": null,
"InlineComment": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 572,
"Line": 20,
"Column": 5
}
}
}
],
"Comments": null,
"InlineComment": null,
"InlineCommentBehindLeftCurly": null,
"Meta": {
"Pos": {
"Filename": "simple.proto",
"Offset": 383,
"Line": 13,
"Column": 1
}
}
}
],
"Meta": {
"Filename": "simple.proto"
}
}
Usage
See also _example/dump.
func run() int {
flag.Parse()
reader, err := os.Open(*proto)
if err != nil {
fmt.Fprintf(os.Stderr, "failed to open %s, err %v\n", *proto, err)
return 1
}
defer reader.Close()
got, err := protoparser.Parse(reader)
if err != nil {
fmt.Fprintf(os.Stderr, "failed to parse, err %v\n", err)
return 1
}
gotJSON, err := json.MarshalIndent(got, "", " ")
if err != nil {
fmt.Fprintf(os.Stderr, "failed to marshal, err %v\n", err)
}
fmt.Print(string(gotJSON))
return 0
}
func main() {
os.Exit(run())
}
Users
Motivation
There exists the similar protobuf parser packages in Go.
For example, https://github.com/emicklei/proto is good and flexible, but the visitor pattern is not easy to use. It can be sufficient for most parsing situations to just return a parsing result well-typed value. This is easier to use.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type Option ¶
type Option func(*ParseConfig)
Option is an option for ParseConfig.
func WithFilename ¶
WithFilename is an option to set filename to the Position.
func WithPermissive ¶
WithPermissive is an option to allow the permissive parsing rather than the just documented spec.
type ParseConfig ¶
type ParseConfig struct {
// contains filtered or unexported fields
}
ParseConfig is a config for parser.
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.