The Go language implementation of gRPC. HTTP/2 based RPC
Go to file
Sean Harger 956d689a24 Use Type() method for OAuth tokens instead of accessing TokenType field. (#1537)
This covers the case where the TokenType field is empty, and thus
calling the Type() method will return "Bearer".
2017-09-25 11:38:05 -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 primivites benchmark for Unlocking via defer vs. inline (#1534) 2017-09-21 12:46:03 -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 Use Type() method for OAuth tokens instead of accessing TokenType field. (#1537) 2017-09-25 11:38:05 -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 Use Type() method for OAuth tokens instead of accessing TokenType field. (#1537) 2017-09-25 11:38:05 -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 Fix misspells (#1531) 2017-09-20 14:55:57 -07:00
resolver Add new Resolver and Balancer APIs (gRFC L9) (#1408) 2017-08-31 10:59:09 -07:00
stats Fix misspells (#1531) 2017-09-20 14:55:57 -07:00
status status: Add WithDetails and Details functions (#1358) 2017-07-24 14:42:24 -07:00
stress Fix misspells (#1531) 2017-09-20 14:55:57 -07:00
tap Update ServerInHandle comments (#1437) 2017-08-14 10:05:02 -07:00
test Fix misspells (#1531) 2017-09-20 14:55:57 -07:00
testdata Add testdata package and unify testdata to only one dir (#1297) 2017-07-25 10:24:45 -07:00
transport Fix misspells (#1531) 2017-09-20 14:55:57 -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 Fix misspells (#1531) 2017-09-20 14:55:57 -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 Fix format error on travis (#1527) 2017-09-20 09:30:13 -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 Fix misspells (#1531) 2017-09-20 14:55:57 -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: set PATH to force downloaded binaries to be run (#1529) 2017-09-20 11:19:09 -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