The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
Menghan Li 1687ce5770 ClientHandshake should get the dialing endpoint as the authority (#1607) 2017-10-23 11:40:43 -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 Register and use default balancers and resolvers (#1551) 2017-10-19 11:32:06 -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 Fix goroutine leak in grpclb_test (#1595) 2017-10-19 15:16:16 -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 Register and use default balancers and resolvers (#1551) 2017-10-19 11:32:06 -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 ClientHandshake should get the dialing endpoint as the authority (#1607) 2017-10-23 11:40:43 -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 New implementation of roundrobin and pickfirst (#1506) 2017-10-02 09:22:57 -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 ClientHandshake should get the dialing endpoint as the authority (#1607) 2017-10-23 11:40:43 -07:00
resolver_conn_wrapper_test.go Make resolver Build() take a target struct (#1567) 2017-10-09 16:33:58 -07:00
rpc_util.go Add functions to ClientConn so it satisfies an interface for generated code (#1599) 2017-10-20 14:21:31 -07:00
rpc_util_test.go Remove buf copy when the compressor exist (#1427) 2017-08-25 12:26:38 -07:00
server.go Serve() should not return error on Stop() or GracefulStop() (#1485) 2017-10-18 15:27:24 -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 Parse ServiceConfig JSON string (#1515) 2017-10-19 12:09:19 -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