The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
Menghan Li a338994886
binarylog: implement env variable config parsing (#2299)
2018-09-26 13:03:54 -07:00
.github Add lock.yml for locking closed, stale PRs/issues (#2331) 2018-09-25 14:15:54 -07:00
Documentation Revert stickiness (#2175) 2018-06-26 10:02:54 -07:00
balancer credentials: support google default creds (#2315) 2018-09-25 13:17:25 -07:00
benchmark Remove shadowing of built-ins (#2290) 2018-09-05 09:05:40 -07:00
channelz channelz: channel tracing (#2262) 2018-09-12 11:15:32 -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 credentials: support google default creds (#2315) 2018-09-25 13:17:25 -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
grpclog Fix "deprecated" function godoc comments to match standard formatting (#2027) 2018-05-02 08:52:49 -07:00
health health: update pb.go and add watch method (#2263) 2018-08-15 15:32:29 -07:00
internal binarylog: implement env variable config parsing (#2299) 2018-09-26 13:03:54 -07:00
interop credentials: support google default creds (#2315) 2018-09-25 13:17:25 -07:00
keepalive autofix license notice 2017-06-08 14:42:19 +02:00
metadata Remove shadowing of built-ins (#2290) 2018-09-05 09:05:40 -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 go generate: update proto files (#2236) 2018-07-25 11:40:12 -07:00
resolver resolver/dns: support custom dns authority (#2265) 2018-09-25 10:45:03 -07:00
stats Remove unused symbols (#2287) 2018-09-05 12:29:02 -07:00
status Transport refactor (#2305) 2018-09-20 15:45:40 -07:00
stress go generate: update proto files (#2236) 2018-07-25 11:40:12 -07:00
tap Update ServerInHandle comments (#1437) 2017-08-14 10:05:02 -07:00
test credentials: support google default creds (#2315) 2018-09-25 13:17:25 -07:00
testdata testdata: get test assets related to package root instead of GOPATH (#2272) 2018-08-22 09:00:39 -07:00
.travis.yml Travis/Makefile/vet cleanups (#2283) 2018-09-04 15:10:01 -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 Transport refactor (#2305) 2018-09-20 15:45:40 -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 Remove unused symbols (#2287) 2018-09-05 12:29:02 -07:00
balancer_conn_wrappers.go credentials: support google default creds (#2315) 2018-09-25 13:17:25 -07:00
balancer_switching_test.go internal: move leakcheck to internal/ (#2129) 2018-06-07 16:57:56 -07:00
balancer_test.go Remove unused symbols (#2287) 2018-09-05 12:29:02 -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: Implement gRFC A6: configurable client-side retry support (#2111) 2018-06-27 16:18:41 -07:00
call_test.go transport: move to internal to make room for new, public transport API (#2212) 2018-07-11 11:22:45 -07:00
clientconn.go credentials: support google default creds (#2315) 2018-09-25 13:17:25 -07:00
clientconn_test.go internal: fix race between cancel and shutdown 2018-09-24 10:46:24 -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
dialoptions.go credentials: support google default creds (#2315) 2018-09-25 13:17:25 -07:00
doc.go Fix missing and wrong license (#1422) 2017-08-04 13:46:18 -07:00
go.mod Initial go.mod module definition and corresponding Travis/vet.sh changes (#2281) 2018-08-31 12:58:30 -07:00
go.sum Initial go.mod module definition and corresponding Travis/vet.sh changes (#2281) 2018-08-31 12:58:30 -07:00
go16.go transport: eliminate StreamError; use status errors instead (#2239) 2018-07-26 10:30:58 -07:00
go17.go transport: eliminate StreamError; use status errors instead (#2239) 2018-07-26 10:30:58 -07:00
install_gae.sh testing: upgrade appengine sdk to version 1.9.68 (#2311) 2018-09-18 10:42:17 -07:00
interceptor.go server: Convert all non-status errors to codes.Unknown (#1881) 2018-03-08 13:46:26 -08:00
picker_wrapper.go transport: move to internal to make room for new, public transport API (#2212) 2018-07-11 11:22:45 -07:00
picker_wrapper_test.go transport: move to internal to make room for new, public transport API (#2212) 2018-07-11 11:22:45 -07:00
pickfirst.go channelz: channel tracing (#2262) 2018-09-12 11:15:32 -07: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 channelz: channel tracing (#2262) 2018-09-12 11:15:32 -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 Check error when calling compressor.Compress (#2274) 2018-09-14 08:57:13 -07:00
rpc_util_test.go transport: eliminate StreamError; use status errors instead (#2239) 2018-07-26 10:30:58 -07:00
server.go test: add go 1.11 to travis and remove go 1.7 (#2278) 2018-08-27 13:31:20 -07:00
server_test.go transport: move to internal to make room for new, public transport API (#2212) 2018-07-11 11:22:45 -07:00
service_config.go client: Implement gRFC A6: configurable client-side retry support (#2111) 2018-06-27 16:18:41 -07:00
service_config_test.go Change parseTimeout to not handle non-second durations (#1706) 2017-12-05 10:04:04 -08:00
stream.go stream: never return errors from CloseSend (#2312) 2018-09-19 08:44:26 -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.16.0-dev (#2303) 2018-09-11 11:35:35 -07:00
vet.sh internal: fix various problems in transport_test.go 2018-09-24 10:46:24 -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