The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
Menghan Li 14a6be430b Add grpc.Version string and use it in the UA (#1144) 2017-03-24 11:29:02 -07:00
Documentation Update gomock-example.md 2016-12-15 14:19:28 -08:00
benchmark get rid of extra payload local variable 2017-02-09 16:16:18 -08:00
codes Run stringer on codes.Code 2015-03-24 10:15:18 -07:00
credentials Use tls.Config.Clone() for go1.8 2017-02-21 12:03:28 -08:00
examples lint update and test fix 2017-03-08 11:35:54 -08:00
grpclb Don't return an error from dial if the balancer returns no initial servers (#1112) 2017-03-21 11:35:53 -07:00
grpclog Use InfoDepth/FatalDepth in glogger.go 2016-11-29 12:51:42 -08:00
health pb.go file update 2016-10-28 12:37:56 -07:00
internal Remove test-only methods from grpc package. 2016-02-25 13:30:19 -08:00
interop Merge pull request #1022 from ncteisen/http_interop 2017-02-10 15:46:57 -08:00
keepalive Support max age(#1119) 2017-03-23 10:49:38 -07:00
metadata fix issue #1056 and #1050 2017-02-13 17:37:53 -08:00
naming Fix some small comments 2016-05-26 15:11:33 -07:00
peer test peer addr 2016-01-06 19:04:19 -08:00
reflection fix FileContainingExtension in server reflection 2017-02-09 21:12:29 -05:00
stats Change stats APIs (#1030) 2017-01-09 17:11:32 -08:00
stress Wait until all rpcs are done instead of a hard stop. 2016-12-28 11:59:08 -08:00
tap Support transport tap 2016-11-03 14:21:24 -07:00
test Upon observing timeout on rpc context, the client should send a RST_STREAM to the server before freeing the quota for more rpcs to be created. 2017-03-13 17:09:45 -07:00
testdata Updating the test SSL certs. 2015-11-11 14:50:21 -08:00
transport Add grpc.Version string and use it in the UA (#1144) 2017-03-24 11:29:02 -07:00
.travis.yml remove support for go1.5 (#1132) 2017-03-23 20:52:49 -07:00
CONTRIBUTING.md Add instructions to CONTRIBUTING.md 2016-03-24 13:55:06 -07:00
LICENSE grpc-go initial commit 2015-02-05 17:14:05 -08:00
Makefile Add comment for proto in Makefile 2016-06-09 14:40:28 -07:00
PATENTS Fix remaining instances of gRPC spelling. 2016-06-02 18:00:07 -07:00
README.md remove support for go1.5 (#1132) 2017-03-23 20:52:49 -07:00
backoff.go Removed the unused named return parameter of `BackoffConfig`'s `backoff` method. 2016-10-11 03:42:29 +09:00
backoff_test.go Revert "added two new testcases for backoff.go" 2016-08-09 14:17:02 -07:00
balancer.go grpclb: Support DropRequest 2016-10-18 18:08:32 -07:00
balancer_test.go Add TestOneConnectionRemoval 2016-08-16 15:48:05 -07:00
call.go Client should have a check on maximum size of received message size. 2017-03-09 16:58:23 -08:00
call_test.go fix wrong context when handling stats 2016-11-08 18:17:14 -08:00
clientconn.go Add grpc.Version string and use it in the UA (#1144) 2017-03-24 11:29:02 -07:00
clientconn_test.go Don't return an error from dial if the balancer returns no initial servers (#1112) 2017-03-21 11:35:53 -07:00
codegen.sh FIX: use /usr/bin/env bash in shebang 2016-12-17 20:45:30 +01:00
coverage.sh FIX: use /usr/bin/env bash in shebang 2016-12-17 20:45:30 +01:00
doc.go fix the grpc website url 2016-02-19 11:56:12 -08:00
interceptor.go Support client side interceptor 2016-08-26 13:50:38 -07:00
rpc_util.go Add grpc.Version string and use it in the UA (#1144) 2017-03-24 11:29:02 -07:00
rpc_util_test.go Add package stats, and export stats on server side. 2016-11-07 15:16:52 -08:00
server.go Rest of the implementation 2017-03-10 17:30:46 -08:00
server_test.go relax the checking on error string 2017-03-02 15:21:41 -08:00
stream.go Client should have a check on maximum size of received message size. 2017-03-09 16:58:23 -08:00
trace.go Fix golint errors 2016-06-01 16:40:26 -07:00

README.md

#gRPC-Go

Build Status GoDoc

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 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 google.golang.org/grpc

Prerequisites

This requires Go 1.6 or later.

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.

Status

GA

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