https://github.com/dekz/serf-client

Serf RPC client for Ruby
https://github.com/dekz/serf-client

Last synced: 25 days ago
JSON representation

Serf RPC client for Ruby

• Host: GitHub
• URL: https://github.com/dekz/serf-client
• Owner: dekz
• License: mit
• Created: 2014-03-31T12:40:24.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2014-03-31T12:46:45.000Z (almost 11 years ago)
• Last Synced: 2024-11-29T08:35:15.719Z (about 2 months ago)
• Language: Ruby
• Size: 129 KB
• Stars: 6
• Watchers: 6
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Serf::Client

[Serf](http://serfdom.io) Client RPC for Ruby.  

This is raw, new and guaranteed to be full of bugs.

## Installation

Add this line to your application's Gemfile:

    gem 'serf-client'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install serf-client

## Usage

```ruby

    

    require 'serf/client'

    client = Serf::Client.connect address: '127.0.0.1', port: 7373

    

    # Listen for stream events

    client.stream 'user:deploy' do |resp|

      puts "USER:: #{resp.body}"

    end

    

    # Trigger a new user-event in Serf asynchronously

    client.event 'deploy'

    

    # Block till your async is performed

    client.event('deploy').value

    

    # This monitors absolutely everything

    client.monitor do |resp|

      puts "===> #{resp}"

    end

    # Listen to anything, respond with a message to all queries

    client.stream '*' do |resp|

      # Not everything returned by '*' has a body

      if body = resp.body

        puts "*** #{body}"

        v = body['ID']

        client.respond v, 'Response from serf-client' if v

      end

    end

```

Implemented:  

    handshake

    event

    force-leave

    members

    stream

    monitor

    stop

    leave

Not yet implemented:  

    auth

    query

    respond

    join

## Contributing

1. Fork it ( http://github.com/dekz/serf-client/fork )

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Add some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create new Pull Request