Go support for Google's protocol buffers
Go to file
Joe Tsai 74b1460c5b encoding: add Format helper function and method
The Format function and MarshalOptions.Format method are helper
functions for directly obtaining the formatted string for a message
without having to deal with errors or convert a []byte to string.
It is only intended for human consumption (e.g., debugging or logging).

We also add a MarshalOptions.Multiline option to specify that the output
should use some default indentation in a multiline output.

This assists in the v1 to v2 migration where:
	protoV1.CompactTextString(m) => prototext.MarshalOptions{}.Format(m)
	protoV1.MarshalTextString(m) => prototext.Format(m)

At Google, there are approximately 10x more usages of MarshalTextString than
CompactTextString, so it makes sense that the top-level Format function
does multiline expansion by default.

Fixes #850

Change-Id: I149c9e190a6d99b985d3884df675499a3313e9b3
Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/213460
Reviewed-by: Damien Neil <dneil@google.com>
Reviewed-by: Herbie Ong <herbie@google.com>
2020-01-30 07:50:58 +00:00
cmd grpc: accept interface in NewClient functions 2020-01-28 18:09:59 +00:00
compiler/protogen reflect/protoregistry: add (*Types).Register{Message,Enum,Extension} 2019-10-31 16:23:42 +00:00
encoding encoding: add Format helper function and method 2020-01-30 07:50:58 +00:00
internal encoding: add Format helper function and method 2020-01-30 07:50:58 +00:00
proto encoding: add Format helper function and method 2020-01-30 07:50:58 +00:00
reflect runtime/protoiface: use more efficient options representation 2020-01-28 23:33:31 +00:00
runtime internal/impl: lazy extension decoding 2020-01-29 21:35:31 +00:00
testing encoding: add Format helper function and method 2020-01-30 07:50:58 +00:00
types all: add ProtoMethods method to protoreflect.Message 2020-01-21 21:05:54 +00:00
.gitignore internal/fuzz: add basic fuzzing target for Marshal/Unmarshal 2019-10-11 16:00:11 +00:00
.travis.yml .travis.yml: configure for OSX 2019-03-13 18:04:08 +00:00
AUTHORS
CONTRIBUTING.md
CONTRIBUTORS
go.mod all: remove APIv1 dependency 2020-01-09 18:06:30 +00:00
go.sum all: remove APIv1 dependency 2020-01-09 18:06:30 +00:00
integration_test.go all: update to go1.13 release 2019-09-06 18:27:08 +00:00
LICENSE
PATENTS
README.md
regenerate.bash internal/cmd/generate-protos: generate test for testdata 2019-03-11 19:40:53 +00:00
release.bash release.bash: add support for building release binaries 2019-08-21 01:15:26 +00:00
test.bash test.bash: add -failfast flag 2019-08-05 21:48:09 +00:00

Next Generation Go Protocol Buffers

WARNING: This repository is in active development. There are no guarantees about API stability. Breaking changes will occur until a stable release is made and announced.

This repository is for the development of the next major Go implementation of protocol buffers. This library makes breaking API changes relative to the existing Go protobuf library. Of particular note, this API aims to make protobuf reflection a first-class feature of the API and implements the protobuf ecosystem in terms of reflection.

Design Documents

List of relevant design documents:

Contributing

We appreciate community contributions. See CONTRIBUTING.md.

Reporting Issues

Issues regarding the new API can be filed at github.com/golang/protobuf. Please use a APIv2: prefix in the title to make it clear that the issue is regarding the new API work.