The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
dfawley fc37cf1364 server: export ServerTransportStreamFromContext for unary interceptors to control headers/trailers (#2019) 2018-04-26 17:38:15 -07:00
.github Create ISSUE_TEMPLATE 2017-05-30 20:03:09 -07:00
Documentation stickiness: add stickiness support (#1969) 2018-04-24 10:37:52 -07:00
balancer Fix typos (#1994) 2018-04-16 10:03:02 -07:00
benchmark Stage 2: Channelz metric collection (#1909) 2018-04-23 11:22:25 -07:00
channelz Stage 2: Channelz metric collection (#1909) 2018-04-23 11:22:25 -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 credentials/alts: Add ServiceOption for server-side ALTS creation (#2009) 2018-04-23 11:11:20 -07:00
encoding Various simplifications (gosimple) 2018-04-15 15:32:33 +02:00
examples Fix typos (#2020) 2018-04-24 16:09:35 -07:00
grpclb grpclb: fix issues caused by caching SubConns (#1977) 2018-04-10 14:23:07 -07:00
grpclog Fix missing and wrong license (#1422) 2017-08-04 13:46:18 -07:00
health *: replace deprecated grpc.Errorf calls with status.Errorf (#1651) 2017-11-06 10:24:20 -08:00
internal status: add Code convenience function (#1754) 2017-12-18 15:00:50 -08:00
interop credentials/alts: Add ServiceOption for server-side ALTS creation (#2009) 2018-04-23 11:11:20 -07:00
keepalive autofix license notice 2017-06-08 14:42:19 +02:00
metadata metadata: Add Get, Set, and Append methods to metadata.MD (#1940) 2018-04-04 09:11:19 -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 reflection: regenerate pb.go file after typo fix (#2002) 2018-04-17 09:46:15 -07:00
resolver dns resolver: create rand seed at init time (#2007) 2018-04-26 15:10:23 -07:00
stats stats: add BeginTime to stats.End (#1907) 2018-03-12 09:16:36 -07:00
status status: remove redundant import (#1947) 2018-03-30 13:35:21 -07:00
stress *: replace deprecated grpc.Errorf calls with status.Errorf (#1651) 2017-11-06 10:24:20 -08:00
tap Update ServerInHandle comments (#1437) 2017-08-14 10:05:02 -07:00
test Fix typos (#2020) 2018-04-24 16:09:35 -07:00
testdata Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
transport Fix typos (#2020) 2018-04-24 16:09:35 -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 race when using both client-side default CallOptions and per-call CallOptions (#1948) 2018-03-29 10:34:29 -07:00
call_test.go internal: clean up deprecated Invoke() usage (#1966) 2018-04-05 14:09:56 -07:00
clientconn.go stickiness: add stickiness support (#1969) 2018-04-24 10:37:52 -07:00
clientconn_test.go Fix Test: Update the deadline since small deadlines are prone to flakes on Travis. (#1932) 2018-03-20 16:46:10 -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 Remove redundant return statements (gosimple) 2018-04-15 12:43:34 +02: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 Fix typos (#1994) 2018-04-16 10:03:02 -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 Fix typos (#1994) 2018-04-16 10:03:02 -07:00
rpc_util_test.go clientconn: add support for unix network in DialContext. (#1883) 2018-04-09 11:12:34 -07:00
server.go server: export ServerTransportStreamFromContext for unary interceptors to control headers/trailers (#2019) 2018-04-26 17:38:15 -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 stickiness: add stickiness support (#1969) 2018-04-24 10:37:52 -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 Stage 2: Channelz metric collection (#1909) 2018-04-23 11:22:25 -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 vet: disallow importing "unsafe" (#2024) 2018-04-26 14:24:26 -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