commit | ae97035608a719c7a1c1c41bed0ae0744bdb0c6f | [log] [tgz] |
---|---|---|
author | Joe Tsai <joetsai@digital-static.net> | Mon Mar 29 11:20:59 2021 -0700 |
committer | GitHub <noreply@github.com> | Mon Mar 29 11:20:59 2021 -0700 |
tree | d5f27d9813f7fd9318cd2c502ffe08bed57c451b | |
parent | af940030a2b77f37337632168f18403433e21e61 [diff] |
all: deprecate the module (#1306) Use the new deprecation feature to mark this module as deprecated. See https://golang.org/issue/40357. Considerations: * google.golang.org/protobuf/cmd/protoc-gen-go@v1.25.0 and below used to generate a hard dependency on github.com/golang/protobuf, which would be frustrating since it would force an explicit dependency on a deprecated module. However, that is no longer the case in v1.26.0. * google.golang.org/protobuf and github.com/golang/protobuf have a cyclic dependency on each other. However, this should not be a problem since proposal 40357 only marks direct dependencies in the go.mod file, rather than all transitive dependencies in the go.sum file.
This module (github.com/golang/protobuf
) contains Go bindings for protocol buffers.
It has been superseded by the google.golang.org/protobuf
module, which contains an updated and simplified API, support for protobuf reflection, and many other improvements. We recommend that new code use the google.golang.org/protobuf
module.
Versions v1.4 and later of github.com/golang/protobuf
are implemented in terms of google.golang.org/protobuf
. Programs which use both modules must use at least version v1.4 of this one.
See the developer guide for protocol buffers in Go for a general guide for how to get started using protobufs in Go.
See release note documentation for more information about individual releases of this project.
See documentation for the next major revision for more information about the purpose, usage, and history of this project.
Summary of the packages provided by this module:
proto
: Package proto
provides functions operating on protobuf messages such as cloning, merging, and checking equality, as well as binary serialization and text serialization.jsonpb
: Package jsonpb
serializes protobuf messages as JSON.ptypes
: Package ptypes
provides helper functionality for protobuf well-known types.ptypes/any
: Package any
is the generated package for google/protobuf/any.proto
.ptypes/empty
: Package empty
is the generated package for google/protobuf/empty.proto
.ptypes/timestamp
: Package timestamp
is the generated package for google/protobuf/timestamp.proto
.ptypes/duration
: Package duration
is the generated package for google/protobuf/duration.proto
.ptypes/wrappers
: Package wrappers
is the generated package for google/protobuf/wrappers.proto
.ptypes/struct
: Package structpb
is the generated package for google/protobuf/struct.proto
.protoc-gen-go/descriptor
: Package descriptor
is the generated package for google/protobuf/descriptor.proto
.protoc-gen-go/plugin
: Package plugin
is the generated package for google/protobuf/compiler/plugin.proto
.protoc-gen-go
: The protoc-gen-go
binary is a protoc plugin to generate a Go protocol buffer package.The issue tracker for this project is located here.
Please report any issues with a sufficient description of the bug or feature request. Bug reports should ideally be accompanied by a minimal reproduction of the issue. Irreproducible bugs are difficult to diagnose and fix (and likely to be closed after some period of time). Bug reports must specify the version of the Go protocol buffer module and also the version of the protocol buffer toolchain being used.
This project is open-source and accepts contributions. See the contribution guide for more information.
This module and the generated code are expected to be stable over time. However, we reserve the right to make breaking changes without notice for the following reasons:
.proto
files. This includes declared constants, variables, functions, types, fields in structs, and methods on types. This may break attempts at injecting additional code on top of what is generated by protoc-gen-go
. Such practice is not supported by this project.generator
package, and all packages under internal
.Any breaking changes outside of these will be announced 6 months in advance to protobuf@googlegroups.com.