Sha256: 20f05139c4b2bf5ac45089994d55d044619375616dec35f1c4cdc5e3ca80a0e7

Contents?: true

Size: 1.37 KB

Versions: 7

Compression:

Stored size: 1.37 KB

Contents

thrift_client

A Thrift client wrapper that encapsulates some common failover behavior.

== License

Copyright 2009 Twitter, Inc. See included LICENSE file.

The public certificate for this gem is here[http://blog.evanweaver.com/files/evan_weaver-original-public_cert.pem].

== Features

* Transparent connection management
* Configurable failover and retry backoff
* Ruby 1.9 compatibility
* ThriftClient::Simple class, for working without generated bindings.

The Github source repository is {here}[http://github.com/fauna/thrift_client/]. Patches and contributions are very welcome.

== Usage

Instantiate a client:

  client = ThriftClient.new(CassandraRb::Client, '127.0.0.1:9160', :retries => 2)

You can then make calls to the server via the <tt>client</tt> instance as if was your internal Thrift client. The connection will be opened lazily and methods will be proxied through.

  client.get_string_list_property("keyspaces")

On failures, the client will try the remaining servers in the list before giving up. See ThriftClient for more.

== Installation

You need Ruby 1.8 or 1.9. If you have those, just run:

  sudo gem install thrift_client

== Contributing

To contribute changes:

1. Fork the project
2. make your change, adding tests
3. send a pull request to fauna and ryanking

== Reporting problems

The Github issue tracker is {here}[http://github.com/fauna/thrift_client/issues].

Version data entries

7 entries across 7 versions & 2 rubygems

Version Path
fl-thrift_client-0.4.2 README.rdoc
thrift_client-0.4.6 README.rdoc
thrift_client-0.4.5 README.rdoc
thrift_client-0.4.4 README.rdoc
thrift_client-0.4.3 README.rdoc
thrift_client-0.4.2 README.rdoc
thrift_client-0.4.1 README.rdoc