protoc-gen-go-json

command module
v0.0.0-...-224a169 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 15, 2019 License: MIT Imports: 10 Imported by: 0

README

protoc-gen-go-json

This is a plugin for the Google Protocol Buffers compiler protoc that generates code to implement json.Marshaler and json.Unmarshaler using jsonpb.

This enables Go-generated protobuf messages to be embedded directly within other structs and encoded with the standard JSON library, since the standard encoding/json library can't encode certain protobuf messages such as those that contain oneof fields.

Install

go get github.com/l-vitaly/protoc-gen-go-json

Also required:

Usage

Define your messages like normal:

syntax = "proto3";

message Request {
  oneof kind {
    string name = 1;
    int32  code = 2;
  }
}

The example message purposely uses a oneof since this won't work by default with encoding/json. Next, generate the code:

protoc --go_out=. --go-json_out=. request.proto

Your output should contain a file request.pb.json.go which contains the implementation of json.Marshal/Unmarshal for all your message types. You can then encode your messages using standard encoding/json:

import "encoding/json"

// Marshal
bs, err := json.Marshal(&Request{
  Kind: &Kind_Name{
    Name: "alice",
  },
}

// Unmarshal
var result Request
json.Unmarshal(bs, &result)
Options

The generator supports options you can specify via the command-line:

  • enums_as_ints - Render enums as integers instead of strings.
  • emit_defaults - Render fields with zero values.
  • orig_name - Use original (.proto file) name for fields.
  • allow_unknown_fields - Allow messages to contain unknown fields.

These can be set as part of the --go-json_out value:

protoc --go-json_out=emit_defaults:.

You can specify multiple using a ,:

protoc --go-json_out=enums_as_ints,emit_defaults:.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL