The Go language implementation of gRPC. HTTP/2 based RPC
Clone or download
Pull request Compare This branch is 320 commits behind grpc:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
Documentation
balancer
benchmark
codes
connectivity
credentials
encoding
examples
grpclb
grpclog
health
internal
interop
keepalive
metadata
naming
peer
reflection
resolver
stats
status
stress
tap
test
testdata
transport
.please-update
.travis.yml
AUTHORS
CONTRIBUTING.md
LICENSE
Makefile
README.md
backoff.go
backoff_test.go
balancer.go
balancer_conn_wrappers.go
balancer_switching_test.go
balancer_test.go
balancer_v1_wrapper.go
call.go
call_test.go
clientconn.go
clientconn_test.go
codec.go
codec_benchmark_test.go
codec_test.go
codegen.sh
doc.go
go16.go
go17.go
grpclb.go
grpclb_picker.go
grpclb_remote_balancer.go
interceptor.go
picker_wrapper.go
picker_wrapper_test.go
pickfirst.go
pickfirst_test.go
proxy.go
proxy_test.go
resolver_conn_wrapper.go
resolver_conn_wrapper_test.go
rpc_util.go
rpc_util_test.go
server.go
server_test.go
service_config.go
service_config_test.go
stream.go
trace.go
vet.sh

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