Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yarpc/yarpc-go
A message passing platform for Go
https://github.com/yarpc/yarpc-go
go grpc message-passing microservices protobuf rpc thrift yarpc
Last synced: 3 months ago
JSON representation
A message passing platform for Go
- Host: GitHub
- URL: https://github.com/yarpc/yarpc-go
- Owner: yarpc
- License: mit
- Created: 2016-01-26T00:04:14.000Z (almost 9 years ago)
- Default Branch: dev
- Last Pushed: 2024-05-31T14:03:56.000Z (5 months ago)
- Last Synced: 2024-07-23T04:43:36.357Z (4 months ago)
- Topics: go, grpc, message-passing, microservices, protobuf, rpc, thrift, yarpc
- Language: Go
- Homepage:
- Size: 13.7 MB
- Stars: 400
- Watchers: 27
- Forks: 101
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-go - yarpc - message passing platform for Go (Message brokers)
- awesome-grpc - yarpc - A message passing platform for Go, including support for gRPC (Language-Specific / Go)
README
# yarpc [![GoDoc][doc-img]][doc] [![GitHub release][release-img]][release] [![Mit License][mit-img]][mit] [![Build Status][ci-img]][ci] [![Coverage Status][cov-img]][cov]
A message passing platform for Go that lets you:
* Write servers and clients with various encodings, including [JSON](http://www.json.org/), [Thrift](https://thrift.apache.org/), and [Protobuf](https://developers.google.com/protocol-buffers/).
* Expose servers over many transports simultaneously, including [HTTP/1.1](https://www.w3.org/Protocols/rfc2616/rfc2616.html), [gRPC](https://grpc.io/), and [TChannel](https://github.com/uber/tchannel).
* Migrate outbound calls between transports without any code changes using config.
## Installation
We recommend locking to [SemVer](http://semver.org/) range `^1` using [Glide](https://github.com/Masterminds/glide):
```
glide get 'go.uber.org/yarpc#^1'
```
## Stability
This library is `v1` and follows [SemVer](http://semver.org/) strictly.
No breaking changes will be made to exported APIs before `v2.0.0` with the
**exception of experimental packages**.
Experimental packages reside within packages named `x`, and are *not stable*. This means their
APIs can break at any time. The intention here is to validate these APIs and iterate on them
by working closely with internal customers. Once stable, their contents will be moved out of
the containing `x` package and their APIs will be locked.
[doc-img]: http://img.shields.io/badge/GoDoc-Reference-blue.svg
[doc]: https://godoc.org/go.uber.org/yarpc
[release-img]: https://img.shields.io/github/release/yarpc/yarpc-go.svg
[release]: https://github.com/yarpc/yarpc-go/releases
[mit-img]: http://img.shields.io/badge/License-MIT-blue.svg
[mit]: https://github.com/yarpc/yarpc-go/blob/master/LICENSE
[ci-img]: https://badge.buildkite.com/f7d8e675c4d5ee4f5c4e4c2e33ca03c5be9bde22b186750538.svg?branch=master
[ci]: https://buildkite.com/uberopensource/yarpc-go
[cov-img]: https://codecov.io/gh/yarpc/yarpc-go/branch/master/graph/badge.svg
[cov]: https://codecov.io/gh/yarpc/yarpc-go/branch/master
## Development
### Setup
To start developing with yarpc-go, run the following command to setup your environment:
```
cd $GOPATH/src
git clone https://github.com/yarpc/yarpc-go.git go.uber.org/yarpc
make
```
### Running Tests
To run tests into a pre-configured docker container, run the following command:
```
make test
```
To run tests locally, run the following command:
```
SUPPRESS_DOCKER=1 make test
```
Happy development!