The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
lyuxuan a36eb4675a
regenerate *.pb.go files due to proto-gen-go update (#2070)
2018-05-11 18:57:54 -07:00
.github Create ISSUE_TEMPLATE 2017-05-30 20:03:09 -07:00
Documentation Documentation: Add initial documentation on concurrency (#2034) 2018-05-10 13:08:19 -07:00
balancer Fix typos (#1994) 2018-04-16 10:03:02 -07:00
benchmark regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
channelz regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
codes update const order (#1770) 2018-01-04 15:44:29 -08:00
connectivity Add and use connectivity package for states (#1430) 2017-08-09 10:31:12 -07:00
credentials Add AuthInfoFromContext utility API (#2062) 2018-05-11 14:16:43 -07:00
encoding Revert "Less mem (#1987)" (#2049) 2018-05-03 11:37:59 -07:00
examples regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
grpclb regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
grpclog Fix "deprecated" function godoc comments to match standard formatting (#2027) 2018-05-02 08:52:49 -07:00
health regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
internal Revert "Less mem (#1987)" (#2049) 2018-05-03 11:37:59 -07:00
interop regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -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 regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
resolver client: introduce WithDisableServiceConfig DialOption (#2010) 2018-05-08 10:28:26 -07:00
stats regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
status status: Introduce FromContextError convenience function (#2057) 2018-05-10 09:54:36 -07:00
stress regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
tap Update ServerInHandle comments (#1437) 2017-08-14 10:05:02 -07:00
test regenerate *.pb.go files due to proto-gen-go update (#2070) 2018-05-11 18:57:54 -07:00
testdata Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
transport transport: respect http2 setting SETTINGS_HEADER_TABLE_SIZE (#2045) 2018-05-11 14:58:26 -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 Remove single-entry var blocks (#1589) 2017-10-18 09:59:23 -07:00
backoff_test.go add license for some files (#1296) 2017-06-12 18:10:06 -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: clean up deprecated Invoke() usage (#1966) 2018-04-05 14:09:56 -07:00
balancer_test.go Fix typos (#1994) 2018-04-16 10:03:02 -07:00
balancer_v1_wrapper.go Remove redundant return statements (gosimple) 2018-04-15 12:43:34 +02:00
call.go client: fix interceptors after recent cleanup (#2046) 2018-05-03 09:00:38 -07:00
call_test.go split encode into three functions (#2058) 2018-05-11 13:47:10 -07:00
clientconn.go client: introduce WithDisableServiceConfig DialOption (#2010) 2018-05-08 10:28:26 -07:00
clientconn_test.go client: introduce WithDisableServiceConfig DialOption (#2010) 2018-05-08 10:28:26 -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
grpclb.go Fix "deprecated" function godoc comments to match standard formatting (#2027) 2018-05-02 08:52:49 -07:00
grpclb_picker.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
grpclb_remote_balancer.go grpclb: fix issues caused by caching SubConns (#1977) 2018-04-10 14:23:07 -07:00
grpclb_util.go Remove redundant return statements (gosimple) 2018-04-15 12:43:34 +02:00
grpclb_util_test.go grpclb: cache SubConns for 10 seconds after it is removed from the backendlist (#1957) 2018-04-05 14:10:33 -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 stickiness: avoid using unsafe (#2023) 2018-04-25 10:01:33 -07:00
picker_wrapper_test.go fix misspell (#1592) 2017-10-19 09:34:07 -07:00
pickfirst.go Add dial option to set balancer (#1697) 2017-12-18 15:35:42 -08:00
pickfirst_test.go internal: clean up deprecated Invoke() usage (#1966) 2018-04-05 14:09:56 -07:00
proxy.go Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -07:00
proxy_test.go Simplify make() (gosimple) 2018-04-15 15:32:33 +02:00
resolver_conn_wrapper.go client: introduce WithDisableServiceConfig DialOption (#2010) 2018-05-08 10:28:26 -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 split encode into three functions (#2058) 2018-05-11 13:47:10 -07:00
rpc_util_test.go split encode into three functions (#2058) 2018-05-11 13:47:10 -07:00
server.go split encode into three functions (#2058) 2018-05-11 13:47:10 -07:00
server_test.go server: export ServerTransportStreamFromContext for unary interceptors to control headers/trailers (#2019) 2018-04-26 17:38:15 -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_test.go stickiness: add stickiness support (#1969) 2018-04-24 10:37:52 -07:00
stream.go split encode into three functions (#2058) 2018-05-11 13:47:10 -07:00
trace.go Truncate payload trace string, and turn trace off by default (#1509) 2017-09-08 11:13:41 -07:00
vet.sh internal: vet.sh quits when it sees macosx (#2048) 2018-05-02 16:47:25 -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