The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
lyuxuan 5856538706 cap max msg size to min(max_int, max_uint32) (#1598) 2017-10-24 10:20:54 -07:00
.github Create ISSUE_TEMPLATE 2017-05-30 20:03:09 -07:00
Documentation Create versioning and release policy document (#1583) 2017-10-17 14:02:34 -07:00
balancer Fix connectivity state transitions when dialing (#1596) 2017-10-23 14:06:33 -07:00
benchmark Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -07:00
codes go-generate pb.go files and check in Travis to make sure they don't change (#1426) 2017-08-17 16:00:51 -07:00
connectivity Add and use connectivity package for states (#1430) 2017-08-09 10:31:12 -07:00
credentials ClientHandshake should get the dialing endpoint as the authority (#1607) 2017-10-23 11:40:43 -07:00
examples Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -07:00
grpclb Update go_package declarations (#1593) 2017-10-23 13:43:21 -07:00
grpclog Fix missing and wrong license (#1422) 2017-08-04 13:46:18 -07:00
health go-generate pb.go files and check in Travis to make sure they don't change (#1426) 2017-08-17 16:00:51 -07:00
internal autofix license notice 2017-06-08 14:42:19 +02:00
interop Remove single-entry var blocks (#1589) 2017-10-18 09:59:23 -07: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 Fix misspells (#1531) 2017-09-20 14:55:57 -07:00
resolver Make passthrouth resolver the default instead of dns (#1606) 2017-10-20 12:03:44 -07:00
stats fix stats test race (#1560) 2017-10-04 14:30:12 -07:00
status status: Add WithDetails and Details functions (#1358) 2017-07-24 14:42:24 -07:00
stress Revert "Added localhost to net.Listen() calls to avoid macOS firewall dialog." (#1541) 2017-09-27 00:01:17 -07:00
tap Update ServerInHandle comments (#1437) 2017-08-14 10:05:02 -07:00
test ClientHandshake should get the dialing endpoint as the authority (#1607) 2017-10-23 11:40:43 -07:00
testdata Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
transport ClientHandshake should get the dialing endpoint as the authority (#1607) 2017-10-23 11:40:43 -07:00
.please-update balancer_test: possible ctx leak, cancel before break (#1479) 2017-08-28 08:51:54 -07:00
.travis.yml Re-add support for Go1.6 (#1603) 2017-10-20 12:05:20 -07: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 Run tests without -v (#1562) 2017-10-04 14:23:20 -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 Fix connectivity state transitions when dialing (#1596) 2017-10-23 14:06:33 -07:00
balancer_switching_test.go Register and use default balancers and resolvers (#1551) 2017-10-19 11:32:06 -07:00
balancer_test.go Register and use default balancers and resolvers (#1551) 2017-10-19 11:32:06 -07:00
balancer_v1_wrapper.go Register and use default balancers and resolvers (#1551) 2017-10-19 11:32:06 -07:00
call.go Add functions to ClientConn so it satisfies an interface for generated code (#1599) 2017-10-20 14:21:31 -07:00
call_test.go New implementation of roundrobin and pickfirst (#1506) 2017-10-02 09:22:57 -07:00
clientconn.go Fix connectivity state transitions when dialing (#1596) 2017-10-23 14:06:33 -07:00
clientconn_test.go Register and use default balancers and resolvers (#1551) 2017-10-19 11:32:06 -07:00
codec.go Remove single-entry var blocks (#1589) 2017-10-18 09:59:23 -07:00
codec_benchmark_test.go autofix license notice 2017-06-08 14:42:19 +02: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 implementation of roundrobin and pickfirst (#1506) 2017-10-02 09:22:57 -07:00
interceptor.go autofix license notice 2017-06-08 14:42:19 +02:00
picker_wrapper.go New implementation of roundrobin and pickfirst (#1506) 2017-10-02 09:22:57 -07:00
picker_wrapper_test.go fix misspell (#1592) 2017-10-19 09:34:07 -07:00
pickfirst.go Register and use default balancers and resolvers (#1551) 2017-10-19 11:32:06 -07: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 Fix parseTarget for unix socket address without scheme (#1611) 2017-10-23 16:34:03 -07: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 cap max msg size to min(max_int, max_uint32) (#1598) 2017-10-24 10:20:54 -07:00
rpc_util_test.go Remove buf copy when the compressor exist (#1427) 2017-08-25 12:26:38 -07:00
server.go cap max msg size to min(max_int, max_uint32) (#1598) 2017-10-24 10:20:54 -07: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 cap max msg size to min(max_int, max_uint32) (#1598) 2017-10-24 10:20:54 -07:00
service_config_test.go Parse ServiceConfig JSON string (#1515) 2017-10-19 12:09:19 -07:00
stream.go Add functions to ClientConn so it satisfies an interface for generated code (#1599) 2017-10-20 14:21:31 -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 Revert "Temporary disable staticcheck" (#1568) 2017-10-06 13:17:06 -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 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