BERTRPC is a Ruby BERT-RPC client library.
Ruby
Latest commit c78721e Aug 11, 2014 @tmm1 tmm1 Merge pull request #11 from github/configurable-connect-timeout
Configurable connect timeout
Permalink
Failed to load latest commit information.
lib default connect_timeout off Aug 10, 2014
test add ReadError test Feb 24, 2010
.document
.gitignore Initial commit to bertrpc. May 19, 2009
History.txt bertrpc 1.3.1 May 25, 2012
LICENSE Initial commit to bertrpc. May 19, 2009
README.md Remove use of gemcutter.org from installation Feb 4, 2013
Rakefile better dep spec for bert; cleanup Rakefile Nov 28, 2009
VERSION bertrpc 1.3.1 May 25, 2012
bertrpc.gemspec bertrpc 1.3.1 May 25, 2012

README.md

BERTRPC

By Tom Preston-Werner (tom@mojombo.com)

BERT-RPC client library for Ruby. Makes it ridiculously simple to interface with BERT-RPC servers.

See the full BERT-RPC specification at bert-rpc.org.

This library currently only supports the following BERT-RPC features:

  • call requests
  • cast requests

BERTRPC was developed for GitHub and is currently in production use performing millions of RPC requests every day. The stability and performance have been exemplary.

Installation

$ gem install bertrpc

Examples

Require the library and create a service:

require 'bertrpc'
svc = BERTRPC::Service.new('localhost', 9999)

Make a call:

svc.call.calc.add(1, 2)
# => 3

The underlying BERT-RPC transaction of the above call is:

-> {call, calc, add, [1, 2]}
<- {reply, 3}

Make a cast:

svc.cast.stats.incr
# => nil

The underlying BERT-RPC transaction of the above cast is:

-> {cast, stats, incr, []}
<- {noreply}

Documentation

Creating a service:

# No timeout
svc = BERTRPC::Service.new('localhost', 9999)

# 10s socket read timeout, raises BERTRPC::ReadTimeoutError
svc = BERTRPC::Service.new('localhost', 9999, 10)

Copyright

Copyright (c) 2009 Tom Preston-Werner. See LICENSE for details.