open-vault/vendor/google.golang.org/grpc/README.md

46 lines
2 KiB
Markdown
Raw Normal View History

2017-04-17 15:17:06 +00:00
# gRPC-Go
2016-08-19 15:03:53 +00:00
2017-10-27 19:06:04 +00:00
[![Build Status](https://travis-ci.org/grpc/grpc-go.svg)](https://travis-ci.org/grpc/grpc-go) [![GoDoc](https://godoc.org/google.golang.org/grpc?status.svg)](https://godoc.org/google.golang.org/grpc) [![GoReportCard](https://goreportcard.com/badge/grpc/grpc-go)](https://goreportcard.com/report/github.com/grpc/grpc-go)
2016-08-19 15:03:53 +00:00
2017-07-18 14:15:54 +00:00
The Go implementation of [gRPC](https://grpc.io/): A high performance, open source, general RPC framework that puts mobile and HTTP/2 first. For more information see the [gRPC Quick Start: Go](https://grpc.io/docs/quickstart/go.html) guide.
2016-08-19 15:03:53 +00:00
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:
```
2017-09-05 22:06:47 +00:00
$ go get -u google.golang.org/grpc
2016-08-19 15:03:53 +00:00
```
Prerequisites
-------------
This requires Go 1.6 or later. Go 1.7 will be required soon.
2016-11-16 23:22:54 +00:00
2016-08-19 15:03:53 +00:00
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](http://godoc.org/google.golang.org/grpc?imports), you need a discussion with gRPC-Go authors and consultants.
Documentation
-------------
See [API documentation](https://godoc.org/google.golang.org/grpc) for package and API descriptions and find examples in the [examples directory](examples/).
2017-05-24 13:34:59 +00:00
Performance
-----------
See the current benchmarks for some of the languages supported in [this dashboard](https://performance-dot-grpc-testing.appspot.com/explore?dashboard=5652536396611584&widget=490377658&container=1286539696).
2016-08-19 15:03:53 +00:00
Status
------
2017-05-24 13:34:59 +00:00
General Availability [Google Cloud Platform Launch Stages](https://cloud.google.com/terms/launch-stages).
2016-08-19 15:03:53 +00:00
2016-11-16 23:22:54 +00:00
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`