The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
apolcyn b519e3d28d interop: set dns as default scheme in interop client (#2165)
this is to allow use of grpclb-in-DNS in the interop client
2018-06-20 12:19:01 -07:00
.github Create ISSUE_TEMPLATE 2017-05-30 20:03:09 -07:00
Documentation Documentation: create doc describing grpc-go's log levels and their usages (#2033) 2018-06-11 09:31:41 -07:00
balancer Don't log grpclb server ending connection as error (#2162) 2018-06-19 14:54:40 -07:00
benchmark internal: Update proto generated code (#2133) 2018-06-08 17:54:26 -07:00
channelz channelz: move APIs to internal except channelz service (#2157) 2018-06-18 17:59:08 -07:00
codes codes: fix: marshal/unmarshal a Code to JSON fails (#2116) 2018-06-01 10:56:55 -07:00
connectivity Add and use connectivity package for states (#1430) 2017-08-09 10:31:12 -07:00
credentials internal: Update proto generated code (#2133) 2018-06-08 17:54:26 -07:00
encoding Revert "Less mem (#1987)" (#2049) 2018-05-03 11:37:59 -07:00
examples internal: Update proto generated code (#2133) 2018-06-08 17:54:26 -07:00
grpclb internal: Update proto generated code (#2133) 2018-06-08 17:54:26 -07:00
grpclog Fix "deprecated" function godoc comments to match standard formatting (#2027) 2018-05-02 08:52:49 -07:00
health internal: Update proto generated code (#2133) 2018-06-08 17:54:26 -07:00
internal channelz: move APIs to internal except channelz service (#2157) 2018-06-18 17:59:08 -07:00
interop interop: set dns as default scheme in interop client (#2165) 2018-06-20 12:19:01 -07:00
keepalive autofix license notice 2017-06-08 14:42:19 +02:00
metadata Fix "deprecated" function godoc comments to match standard formatting (#2027) 2018-05-02 08:52:49 -07:00
naming Fix typos (#1994) 2018-04-16 10:03:02 -07:00
peer autofix license notice 2017-06-08 14:42:19 +02:00
reflection internal: Update proto generated code (#2133) 2018-06-08 17:54:26 -07:00
resolver internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
stats internal: Update proto generated code (#2133) 2018-06-08 17:54:26 -07:00
status status: Introduce FromContextError convenience function (#2057) 2018-05-10 09:54:36 -07:00
stress internal: Update proto generated code (#2133) 2018-06-08 17:54:26 -07:00
tap Update ServerInHandle comments (#1437) 2017-08-14 10:05:02 -07:00
test channelz: move APIs to internal except channelz service (#2157) 2018-06-18 17:59:08 -07:00
testdata Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
transport channelz: move APIs to internal except channelz service (#2157) 2018-06-18 17:59:08 -07:00
.travis.yml travis: skip vet install for 386 (#2018) 2018-04-24 13:20:09 -07:00
AUTHORS add AUTHORS and LICENSE 2017-06-08 14:37:28 +02:00
CONTRIBUTING.md documentation: add instructions for running tests locally (#2006) 2018-04-19 17:17:21 -07:00
LICENSE Make Apache 2.0 LICENSE file a verbatim copy (#1329) 2017-06-21 10:20:47 -07:00
Makefile documentation: add instructions for running tests locally (#2006) 2018-04-19 17:17:21 -07:00
README.md Correct Go 1.6 support policy (#1934) 2018-03-21 10:03:08 -07:00
backoff.go internal: move backoff to internal (#2141) 2018-06-13 16:07:37 -07:00
balancer.go Mark old balancer and naming APIs as deprecated (#1951) 2018-04-05 13:12:31 -07:00
balancer_conn_wrappers.go Fix typos (#1994) 2018-04-16 10:03:02 -07:00
balancer_switching_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
balancer_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
balancer_v1_wrapper.go Split grpclb out of top level grpc package (#2107) 2018-06-05 09:54:12 -07:00
call.go client: fix interceptors after recent cleanup (#2046) 2018-05-03 09:00:38 -07:00
call_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
clientconn.go channelz: move APIs to internal except channelz service (#2157) 2018-06-18 17:59:08 -07:00
clientconn_test.go internal: move backoff to internal (#2141) 2018-06-13 16:07:37 -07:00
codec.go encoding: Introduce new method for registering and choosing codecs (#1813) 2018-01-23 11:39:40 -08:00
codec_test.go encoding: Introduce new method for registering and choosing codecs (#1813) 2018-01-23 11:39:40 -08:00
codegen.sh FIX: use /usr/bin/env bash in shebang 2016-12-17 20:45:30 +01:00
doc.go Fix missing and wrong license (#1422) 2017-08-04 13:46:18 -07:00
envconfig.go stickiness: add stickiness support (#1969) 2018-04-24 10:37:52 -07:00
go16.go server: Convert all non-status errors to codes.Unknown (#1881) 2018-03-08 13:46:26 -08:00
go17.go server: Convert all non-status errors to codes.Unknown (#1881) 2018-03-08 13:46:26 -08:00
interceptor.go server: Convert all non-status errors to codes.Unknown (#1881) 2018-03-08 13:46:26 -08:00
picker_wrapper.go channelz: move APIs to internal except channelz service (#2157) 2018-06-18 17:59:08 -07:00
picker_wrapper_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
pickfirst.go Add dial option to set balancer (#1697) 2017-12-18 15:35:42 -08:00
pickfirst_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
proxy.go Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -07:00
proxy_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
resolver_conn_wrapper.go resolver_conn_wrapper.go: fix minor typo (#2135) 2018-06-08 15:37:41 -07:00
resolver_conn_wrapper_test.go go vet: fix composite literal uses unkeyed fields (#2005) 2018-04-19 17:16:53 -07:00
rpc_util.go internal: move version to a separate file (#2080) 2018-05-16 10:32:41 -07:00
rpc_util_test.go split encode into three functions (#2058) 2018-05-11 13:47:10 -07:00
server.go channelz: move APIs to internal except channelz service (#2157) 2018-06-18 17:59:08 -07:00
server_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
service_config.go Fix "deprecated" function godoc comments to match standard formatting (#2027) 2018-05-02 08:52:49 -07:00
service_config_test.go Change parseTimeout to not handle non-second durations (#1706) 2017-12-05 10:04:04 -08:00
stickiness_linkedmap.go stickiness: limit the max count of stickiness keys (#2021) 2018-05-21 17:10:29 -07:00
stickiness_linkedmap_test.go stickiness: limit the max count of stickiness keys (#2021) 2018-05-21 17:10:29 -07:00
stickiness_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
stream.go channelz: move APIs to internal except channelz service (#2157) 2018-06-18 17:59:08 -07:00
trace.go Truncate payload trace string, and turn trace off by default (#1509) 2017-09-08 11:13:41 -07:00
version.go Change version to 1.14.0-dev (#2163) 2018-06-19 17:32:50 -07:00
vet.sh internal/grpcrand: New package for concurrency-safe randoms (#2106) 2018-05-29 09:06:35 -07:00

README.md

gRPC-Go

Build Status GoDoc GoReportCard

The Go implementation of gRPC: A high performance, open source, general RPC framework that puts mobile and HTTP/2 first. For more information see the gRPC Quick Start: Go guide.

Installation

To install this package, you need to install Go and setup your Go workspace on your computer. The simplest way to install the library is to run:

$ go get -u google.golang.org/grpc

Prerequisites

This requires Go 1.6 or later. Go 1.7 will be required soon.

Constraints

The grpc package should only depend on standard Go packages and a small number of exceptions. If your contribution introduces new dependencies which are NOT in the list, you need a discussion with gRPC-Go authors and consultants.

Documentation

See API documentation for package and API descriptions and find examples in the examples directory.

Performance

See the current benchmarks for some of the languages supported in this dashboard.

Status

General Availability Google Cloud Platform Launch Stages.

FAQ

Compiling error, undefined: grpc.SupportPackageIsVersion

Please update proto package, gRPC package and rebuild the proto files:

  • go get -u github.com/golang/protobuf/{proto,protoc-gen-go}
  • go get -u google.golang.org/grpc
  • protoc --go_out=plugins=grpc:. *.proto