Project

twirp

0.26
There's a lot of open issues
A long-lived project that still receives updates
Twirp is a simple RPC framework with protobuf service definitions. The Twirp gem provides native support for Ruby.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 2.2.3
>= 3.25, < 5.a
 Project Readme

Twirp-Ruby

Run Tests

Twirp is a protocol for routing and serialization of services defined in a .proto file, allowing easy implementation of RPC services with auto-generated clients in different languages.

The canonical implementation is in Golang. The Twirp-Ruby project is the official implementation in Ruby for both server and clients.

Install

Add gem "twirp" to your Gemfile, or install with gem install twirp.

To auto-generate Ruby code from a proto file, use the protoc plugin and the --ruby_out option (see Wiki page).

No backwards compatible breaking changes, between minor versions(1.10.0)

When upgrading from version 1.9.0 to 1.10.0, note that there is a breaking change in the Twirp::ClientResp#initialize method. The method now accepts keyword arguments. For more details, refer to this comparison and this issue.

Documentation

On the wiki.

Contributing

On the CONTRIBUTING file.

Releases and changes

See the releases page for latest information about released versions.