The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
lyuxuan be077907e2
make load balancing policy name string case-insensitive (#1708)
2017-12-04 14:03:22 -08:00
.github Create ISSUE_TEMPLATE 2017-05-30 20:03:09 -07:00
Documentation Add proper support for 'identity' encoding type (#1664) 2017-11-17 09:24:54 -08:00
balancer make load balancing policy name string case-insensitive (#1708) 2017-12-04 14:03:22 -08:00
benchmark Add context benchmarks (#1610) 2017-11-07 10:20:24 -08:00
codes update code_string.go for new stringer changes (#1674) 2017-11-14 15:20:10 -08:00
connectivity Add and use connectivity package for states (#1430) 2017-08-09 10:31:12 -07:00
credentials server: apply deadline to new connections until all handshaking is completed (#1646) 2017-11-03 13:53:17 -07:00
encoding Add proper support for 'identity' encoding type (#1664) 2017-11-17 09:24:54 -08:00
examples Add protoc command to example/readme (#1653) 2017-11-06 14:58:18 -08:00
grpclb New grpclb implementation (#1558) 2017-11-27 11:16:26 -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 Implement transparent retries for gRFC A6 (#1597) 2017-11-06 13:45:11 -08:00
interop *: replace deprecated grpc.Errorf calls with status.Errorf (#1651) 2017-11-06 10:24:20 -08:00
keepalive autofix license notice 2017-06-08 14:42:19 +02:00
metadata stats: add methods to allow setting grpc-trace-bin and grpc-tags-bin headers (#1404) 2017-08-24 10:00:40 -07:00
naming Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -07:00
peer autofix license notice 2017-06-08 14:42:19 +02:00
reflection *: replace deprecated grpc.Errorf calls with status.Errorf (#1651) 2017-11-06 10:24:20 -08:00
resolver Add comments to ClientConn/SubConn interfaces to indicate new methods may be added (#1680) 2017-12-01 13:25:57 -08:00
stats *: replace deprecated grpc.Errorf calls with status.Errorf (#1651) 2017-11-06 10:24:20 -08:00
status status: Add WithDetails and Details functions (#1358) 2017-07-24 14:42:24 -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 switch balancer based on service config info (#1670) 2017-11-17 11:11:05 -08:00
testdata Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
transport client: backoff before reconnecting if an HTTP2 server preface was not received (#1648) 2017-12-01 09:55:42 -08:00
.please-update balancer_test: possible ctx leak, cancel before break (#1479) 2017-08-28 08:51:54 -07:00
.travis.yml travis: fix GOARCH=386 and add misspell check (#1658) 2017-11-08 13:40:05 -08:00
AUTHORS add AUTHORS and LICENSE 2017-06-08 14:37:28 +02:00
CONTRIBUTING.md Update CONTRIBUTING.md 2017-05-30 20:06:49 -07: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 Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -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 New implementation of roundrobin and pickfirst (#1506) 2017-10-02 09:22:57 -07:00
balancer_conn_wrappers.go Eliminate data race in ccBalancerWrapper (#1688) 2017-11-28 14:41:43 -08:00
balancer_switching_test.go switch balancer based on service config info (#1670) 2017-11-17 11:11:05 -08:00
balancer_test.go Register and use default balancers and resolvers (#1551) 2017-10-19 11:32:06 -07:00
balancer_v1_wrapper.go balancer: reduce chattiness (#1608) 2017-10-25 11:01:53 -07:00
call.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
call_test.go New implementation of roundrobin and pickfirst (#1506) 2017-10-02 09:22:57 -07:00
clientconn.go make load balancing policy name string case-insensitive (#1708) 2017-12-04 14:03:22 -08:00
clientconn_test.go client: backoff before reconnecting if an HTTP2 server preface was not received (#1648) 2017-12-01 09:55:42 -08:00
codec.go protoCodec: avoid buffer allocations if proto.Marshaler/Unmarshaler (#1689) 2017-12-01 15:32:05 -08:00
codec_benchmark_test.go codec_benchmark_test: fix racy unmarshal behavior and make some cleanups (#1642) 2017-11-02 13:42:21 -07:00
codec_test.go autofix license notice 2017-06-08 14:42:19 +02: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 Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -07:00
go17.go Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -07:00
grpclb.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
grpclb_picker.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
grpclb_remote_balancer.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
interceptor.go autofix license notice 2017-06-08 14:42:19 +02:00
picker_wrapper.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
picker_wrapper_test.go fix misspell (#1592) 2017-10-19 09:34:07 -07:00
pickfirst.go switch balancer based on service config info (#1670) 2017-11-17 11:11:05 -08:00
pickfirst_test.go Fix connectivity state transitions when dialing (#1596) 2017-10-23 14:06:33 -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 Re-resolve target when one connection becomes TransientFailure (#1679) 2017-11-28 13:16:53 -08:00
resolver_conn_wrapper_test.go Fix parseTarget for unix socket address without scheme (#1611) 2017-10-23 16:34:03 -07:00
rpc_util.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
rpc_util_test.go Remove buf copy when the compressor exist (#1427) 2017-08-25 12:26:38 -07:00
server.go Add proper support for 'identity' encoding type (#1664) 2017-11-17 09:24:54 -08:00
server_test.go Serve() should not return error on Stop() or GracefulStop() (#1485) 2017-10-18 15:27:24 -07:00
service_config.go fix max msg size type issues on different arch (#1623) 2017-10-26 13:30:15 -07:00
service_config_test.go Add proper support for 'identity' encoding type (#1664) 2017-11-17 09:24:54 -08:00
stream.go New grpclb implementation (#1558) 2017-11-27 11:16:26 -08:00
trace.go Truncate payload trace string, and turn trace off by default (#1509) 2017-09-08 11:13:41 -07:00
vet.sh client: backoff before reconnecting if an HTTP2 server preface was not received (#1648) 2017-12-01 09:55:42 -08: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 as of the next gRPC-Go release (1.8).

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