The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
Menghan Li 30fb59a430 documentation: Mark compresser and decompresser as deprecated (#1971) 2018-04-06 11:05:14 -07:00
.github Create ISSUE_TEMPLATE 2017-05-30 20:03:09 -07:00
Documentation Documentation: Fix broken link in rpc-errors.md (#1935) 2018-03-21 10:14:55 -07:00
balancer Notify parent ClientConn to re-resolve in grpclb (#1699) 2017-12-18 15:36:55 -08:00
benchmark Small spelling fixes (unknow -> unknown) (#1868) 2018-02-22 13:10:19 -08: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: Remove the enable_untrusted_alts flag (#1931) 2018-03-19 18:27:44 -07:00
encoding gzip: Add ability to set compression level (#1891) 2018-03-20 11:57:00 -07:00
examples routeguide: reimplement distance calculation 2018-03-22 12:52:22 +01:00
grpclb Add dial option to set balancer (#1697) 2017-12-18 15:35:42 -08: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: Update ALTS "New" APIs (#1921) 2018-03-19 09:07:54 -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 Mark old balancer and naming APIs as deprecated (#1951) 2018-04-05 13:12:31 -07:00
peer autofix license notice 2017-06-08 14:42:19 +02:00
reflection service reflection can lookup enum, enum val, oneof, and field symbols (#1910) 2018-03-21 16:49:57 -07:00
resolver resolver/manual: fix minor typo (#1960) 2018-04-02 10:01:29 -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 Export changes to OSS. (#1962) 2018-04-05 10:45:41 -07:00
testdata Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
transport Export changes to OSS. (#1962) 2018-04-05 10:45:41 -07:00
.travis.yml travis: add Go 1.10 and run vet there instead of 1.9 (#1913) 2018-03-16 08:47:14 -07:00
AUTHORS add AUTHORS and LICENSE 2017-06-08 14:37:28 +02:00
CONTRIBUTING.md Update CONTRIBUTING.md to CNCF CLA 2017-12-11 09:04:48 -08:00
LICENSE Make Apache 2.0 LICENSE file a verbatim copy (#1329) 2017-06-21 10:20:47 -07:00
Makefile reduce timeout for tests to 5m (7m for testrace) (#1635) 2017-10-31 14:07:09 -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 Notify parent ClientConn to re-resolve in grpclb (#1699) 2017-12-18 15:36:55 -08:00
balancer_switching_test.go internal: clean up deprecated Invoke() usage (#1966) 2018-04-05 14:09:56 -07:00
balancer_test.go internal: clean up deprecated Invoke() usage (#1966) 2018-04-05 14:09:56 -07:00
balancer_v1_wrapper.go grpc: fix deprecation comments to conform to standard (#1691) 2017-12-18 09:23:42 -08: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 Export changes to OSS. (#1962) 2018-04-05 10:45:41 -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
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 grpclb: cache SubConns for 10 seconds after it is removed from the backendlist (#1957) 2018-04-05 14:10:33 -07:00
grpclb_picker.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
grpclb_remote_balancer.go Add dial option to set balancer (#1697) 2017-12-18 15:35:42 -08:00
grpclb_util.go grpclb: cache SubConns for 10 seconds after it is removed from the backendlist (#1957) 2018-04-05 14:10:33 -07: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 addrConn: Report underlying connection error in RPC error (#1855) 2018-02-14 14:13:10 -08: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 Skip proxy_test in race mode (#1584) 2017-10-17 11:26:58 -07:00
resolver_conn_wrapper.go resolver: keep full unparsed target string if scheme in parsed target is not registered (#1943) 2018-03-27 13:58:27 -07:00
resolver_conn_wrapper_test.go resolver: keep full unparsed target string if scheme in parsed target is not registered (#1943) 2018-03-27 13:58:27 -07:00
rpc_util.go documentation: Mark compresser and decompresser as deprecated (#1971) 2018-04-06 11:05:14 -07:00
rpc_util_test.go gzip: Add ability to set compression level (#1891) 2018-03-20 11:57:00 -07:00
server.go server: add grpc.Method function for extracting method from context (#1961) 2018-04-02 13:08:04 -07:00
server_test.go Allow storing alternate transport.ServerStream implementations in context (#1904) 2018-03-20 17:02:32 -07:00
service_config.go Change parseTimeout to not handle non-second durations (#1706) 2017-12-05 10:04:04 -08:00
service_config_test.go Change parseTimeout to not handle non-second durations (#1706) 2017-12-05 10:04:04 -08:00
stream.go server: add grpc.Method function for extracting method from context (#1961) 2018-04-02 13:08:04 -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 Mark old balancer and naming APIs as deprecated (#1951) 2018-04-05 13:12:31 -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