The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
dfawley a7dba25a82 Speed up end to end tests by removing an unnecessary sleep (#1521) 2017-09-18 11:48:03 -07:00
.github Create ISSUE_TEMPLATE 2017-05-30 20:03:09 -07:00
Documentation Use `NewOutgoingContext ` in the metadata doc (#1425) 2017-08-04 13:14:02 -07:00
balancer Add new Resolver and Balancer APIs (gRFC L9) (#1408) 2017-08-31 10:59:09 -07:00
benchmark benchmark: add primitives benchmarks for informational purposes (#1501) 2017-09-11 10:49:50 -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 Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
examples Fix to avoid annoying firewall dialog on macOS (#1499) 2017-08-31 10:24:01 -07:00
grpclb Add leak goroutine checking to grpc/balancer tests (#1497) 2017-09-07 14:30:05 -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 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
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 deduplicate dns record in lookup (#1454) 2017-08-23 13:45:01 -07:00
peer autofix license notice 2017-06-08 14:42:19 +02:00
reflection Add new Resolver and Balancer APIs (gRFC L9) (#1408) 2017-08-31 10:59:09 -07:00
resolver Add new Resolver and Balancer APIs (gRFC L9) (#1408) 2017-08-31 10:59:09 -07:00
stats stats: add methods to allow setting grpc-trace-bin and grpc-tags-bin headers (#1404) 2017-08-24 10:00:40 -07:00
status status: Add WithDetails and Details functions (#1358) 2017-07-24 14:42:24 -07:00
stress 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
tap Update ServerInHandle comments (#1437) 2017-08-14 10:05:02 -07:00
test Speed up end to end tests by removing an unnecessary sleep (#1521) 2017-09-18 11:48:03 -07:00
testdata Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
transport Change quota version to uint32 instead on uint64 (#1517) 2017-09-14 17:40:38 -07:00
.please-update balancer_test: possible ctx leak, cancel before break (#1479) 2017-08-28 08:51:54 -07:00
.travis.yml Run Go1.9 and 386 on Travis (#1475) 2017-08-29 16:29:31 -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 Check "x/net/context" with `go vet` like "context" (#1490) 2017-08-29 15:40:57 -07:00
README.md Add -u to installation command (#1451) 2017-08-23 10:39:14 -07:00
backoff.go add license for some files (#1296) 2017-06-12 18:10:06 -07:00
backoff_test.go add license for some files (#1296) 2017-06-12 18:10:06 -07:00
balancer.go addrConn: change address to slice of address (#1376) 2017-08-21 12:27:04 -07:00
balancer_conn_wrappers.go Add new Resolver and Balancer APIs (gRFC L9) (#1408) 2017-08-31 10:59:09 -07:00
balancer_test.go Add leak goroutine checking to grpc/balancer tests (#1497) 2017-09-07 14:30:05 -07:00
balancer_v1_wrapper.go remove a debug print that causes deadlock (#1505) 2017-09-05 11:07:52 -07:00
call.go Add new Resolver and Balancer APIs (gRFC L9) (#1408) 2017-08-31 10:59:09 -07:00
call_test.go Add leak goroutine checking to grpc/balancer tests (#1497) 2017-09-07 14:30:05 -07:00
clientconn.go Add new Resolver and Balancer APIs (gRFC L9) (#1408) 2017-08-31 10:59:09 -07:00
clientconn_test.go Add leak goroutine checking to grpc/balancer tests (#1497) 2017-09-07 14:30:05 -07:00
codec.go add license for some files (#1296) 2017-06-12 18:10:06 -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 adjust import order (#1311) 2017-07-05 09:03:39 -07:00
go17.go adjust import order (#1311) 2017-07-05 09:03:39 -07:00
grpclb.go Fix deadline error on grpclb streams (#1511) 2017-09-14 15:03:22 -07:00
interceptor.go autofix license notice 2017-06-08 14:42:19 +02:00
proxy.go autofix license notice 2017-06-08 14:42:19 +02:00
proxy_test.go Add leak goroutine checking to grpc/balancer tests (#1497) 2017-09-07 14:30:05 -07:00
rpc_util.go Add new Resolver and Balancer APIs (gRFC L9) (#1408) 2017-08-31 10:59:09 -07:00
rpc_util_test.go Remove buf copy when the compressor exist (#1427) 2017-08-25 12:26:38 -07:00
server.go Dedicated goroutine for writing. (#1498) 2017-09-14 13:44:14 -07:00
server_test.go Add leak goroutine checking to grpc/balancer tests (#1497) 2017-09-07 14:30:05 -07:00
stream.go Dedicated goroutine for writing. (#1498) 2017-09-14 13:44:14 -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.sh: fix protoc installation (#1502) 2017-09-01 16:45:41 -07:00

README.md

gRPC-Go

Build Status GoDoc

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.

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