haredo 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1585745834668ad5a1db7ceade69f55cad742453
+  data.tar.gz: adf26761a2a995d47f3e3d7d5c11453fc78b65cd
+SHA512:
+  metadata.gz: 20b36a13ae81dc1c33636d786da3c3248e3071faf9d5a55cede56b9c63ba7bf9165be0d2f13d0cc2e3d32126c2f6c5cb53e6109eb41dd74b9195003cbc895141
+  data.tar.gz: dbe8eff27818b3ef38fa3687bfc20df928ba4e2e88edc85c7c789c0eeef4b7e8d1ec8b34cf03315c8d806ae8eb43c261943df9134b51d6ac31463c11f04c4d1b

data/README.md

@@ -0,0 +1,93 @@
+# HareDo
+
+## About
+
+An easy-to-use framework for quickly creating client/server applications in Ruby
+over RabbitMQ. The RabbitMQ terminology uses metaophors of publishers and
+consumers. This framework -- which is a very thin wrapper on top of
+[Bunny](http://rubybunny.info/) -- slightly modifies the semantics and provides
+an intuitive framework for easily and quickly implementing network services and
+clients to use them.
+
+## How It Works
+
+Here is a complete example -- the following plugin/program (included in
+<tt>src/examples/service.rb</tt>) create a simple network service that takes a
+number and add one, along with a client that uses it:
+
+```ruby
+#!/usr/bin/env ruby
+
+# Simple service
+class Service < HareDo::Service
+
+  def initialize(name)
+    super
+    connect($rabbitmq_username, $rabbitmq_password, $rabbitmq_host)
+  end
+
+  def serve(msg)
+    headers  = msg.properties.headers
+    reply_to = msg.properties.reply_to
+
+    data = headers['i'].to_i + 1
+    send(reply_to, data.to_s, { :rc => 1 })
+  end
+
+end # class Server
+
+def dump_message(msg)
+  puts 'Headers:'
+  msg.properties.each do |k,v|
+    puts "    #{k}: #{v}"
+  end
+  
+  puts "Data: #{msg.data}"
+end
+
+client = HareDo::Client.new()
+client.connect($rabbitmq_username, $rabbitmq_password, $rabbitmq_host)
+service = Service.new($haredo_test_queue)
+
+service.run(false)
+
+1.upto(10) do |i|
+  client.send($haredo_test_queue, 'data', { :i => i })
+  msg = @client.receive()
+
+  dump_message msg
+      
+  puts msg.data.to_i == i + 1
+end
+```
+
+The server runs in non-blocking mode. The client makes 10 calls sending 10
+monotonically increasing integer values, waits for the response (using a
+blocking timeout) after each call and checks the results.
+
+## Installation
+
+You can install directly from the command line via Ruby gems as follows:
+
+    gem install haredo
+
+## Building from Source
+
+This project uses CMake. To build the gem:
+
+    cmake .
+    make gem
+
+The resultant gem will be generated in the <tt>pkg</tt> directory.
+
+To build on Debian/Ubuntu:
+
+    fakeroot debian/rules clean
+    dpkg-buildpackage -b -uc -us
+
+The resulting binary package will be created in the parent directory.
+
+## License
+
+Copyright information is located in the COPYING file. The software license is
+located in the LICENSE file.

data/src/lib/haredo/peer.rb

@@ -0,0 +1,119 @@
+require "bunny"
+require 'haredo/version'
+
+module HareDo
+
+class Message
+
+  attr_reader :info, :properties, :data
+
+  def initialize(info=nil, properties=nil, data=nil)
+    @info       = info
+    @properties = properties
+    @data       = data
+  end
+
+end
+
+class Node
+
+  attr_reader :queue
+
+  def initialize()
+    
+  end
+
+  def connect(user, password, host='localhost', port='5672')
+    @cnx = Bunny.new("amqp://#{user}:#{password}@#{host}:#{port}")
+
+    @cnx.start()
+
+    @channel  = @cnx.create_channel()
+
+    return true
+  end
+
+  def disconnect()
+    @cnx.close()
+  end
+
+  def send(to, data, headers = {}, from=nil)
+
+    if from.nil?
+      from = @queue.name if @queue
+    end
+
+    @exchange.publish( data, 
+                       :routing_key => to, 
+                       :headers     => headers,
+                       :reply_to    => from )
+  end
+
+end # class Node
+
+class Client < Node
+
+  attr_reader :queue
+
+  def initialize()
+    super
+  end
+
+  def connect(user, password, host='localhost', port='5672')
+    super
+
+    @queue = @channel.queue( '', :auto_delete => true, 
+                             :arguments => { "x-message-ttl" => 1000 } )
+
+    @exchange = @channel.default_exchange()
+  end
+
+  def disconnect()
+    @queue.delete() if @queue
+    super
+  end
+
+  def receive(timeout = 1.0)
+    now = Time::now.to_f
+
+    while true
+      delivery_info, properties, payload = @queue.pop()
+      
+      if delivery_info != nil
+        return Message.new(delivery_info, properties, payload)
+      end
+      
+      if (Time::now.to_f - now) > timeout
+        return Message.new()
+      end
+      
+      sleep 0.001
+    end    
+  end
+
+end # class Client
+
+class Service < Node
+
+  def initialize(name)
+    super()
+
+    @queue_name = name
+  end
+
+  def createQueue()
+    return @channel.queue(@queue_name, :auto_delete => true, :exclusive => true)
+  end
+
+  def run(block = true)
+    @queue    = createQueue()
+    @exchange = @channel.default_exchange()
+
+    queue.subscribe(:block => block) do |info, props, data|
+      serve Message.new(info, props, data)
+    end
+  end
+
+end # class Service
+
+end # module HareDo

data/src/lib/haredo/version.rb

@@ -0,0 +1,5 @@
+module HareDo
+
+VERSION = '0.0.1-1'
+
+end # module HareDo

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: haredo
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Mike Owens
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-19 00:00:00.000000000 Z
+dependencies: []
+description: 
+email: mikeowens@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- src/lib/haredo/peer.rb
+- src/lib/haredo/version.rb
+- README.md
+homepage: https://github.com/mikeowens/haredo
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- src/lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: A simple client/server framework using RabbitMQ
+test_files: []