fraggle-synchrony 0.0.1

data/.autotest

@@ -0,0 +1,2 @@
+require 'autotest/bundler'
+require 'autotest/growl'

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+.rvmrc
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--format nested
+--color

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in fraggle-synchrony/.gemspec
+gemspec

data/README.md

@@ -0,0 +1,31 @@
+### Fraggle-synchrony
+
+This is a Fiber-aware wrapper for the Fraggle EM library, which provides
+an evented Ruby interface to [Doozer](https://github.com/ha/doozerd).
+
+**NOTE:** This only runs on Ruby 1.9.2 due to the underlying use of Fibers.
+
+Fraggle code can often become a bit of a spaghetti mess due to the
+reliance on callbacks - wrapping with Synchrony allows you to replace:
+
+    Fraggle.connect do |client|
+      client.rev do |rev|
+        client.get rev, "/path/to/thing"
+      end
+    end
+
+with
+
+    client = Fraggle.connect
+    rev = client.rev
+    client.get rev, "/path/to/thing"
+
+The full list of supported commands is: rev, set, get, del, stat
+
+wait is not supported - just use the standard aynch callback mechanism
+provided by Fraggle (a pseudo-blocking wait command makes no sense).
+
+All using Fibers ensuring the code is still fully asynchronous. Pretty
+awesome huh? (bear in mind 99% of the awesomeness is clearly due to Ilya
+Grigorik and his wonderful [em-synchrony](https://github.com/igrigorik/em-synchrony), not me :)
+

data/Rakefile

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'bundler/setup'
+Bundler.require(:default, :test)
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "**/*_spec.rb"
+  t.rspec_opts = ["--format", "documentation", "--colour"]
+end
+

data/fraggle-synchrony.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "fraggle-synchrony/version"
+
+Gem::Specification.new do |s|
+  s.name        = "fraggle-synchrony"
+  s.version     = Fraggle::Synchrony::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Steven Mohapi-Banks"]
+  s.email       = ["steven.mohapibanks@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{An em-synchrony wrapper for fraggle}
+  s.description = s.summary
+
+  s.rubyforge_project = "fraggle-synchrony"
+
+  s.add_dependency "fraggle"
+  s.add_dependency "em-synchrony"
+
+  s.add_development_dependency "rake", ">= 0.8.7"
+  s.add_development_dependency "rspec", ">= 2.0"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/fraggle-synchrony.rb

@@ -0,0 +1,10 @@
+require 'em-synchrony'
+begin
+  require 'fraggle'
+rescue LoadError => error
+  raise 'Missing fraggle-synchrony dependency: gem install fraggle'
+end
+
+require 'fraggle-synchrony/fraggle'
+require 'fraggle-synchrony/fraggle/client'
+

data/lib/fraggle-synchrony/fraggle.rb

@@ -0,0 +1,19 @@
+module Fraggle
+
+  class << self
+    alias :aconnect :connect
+  end
+
+  def self.connect(uri = nil)
+    f = Fiber.current
+
+    cb = proc { |client, err|
+      f.resume client || err
+    }
+    self.aconnect(uri, &cb)
+
+    response = Fiber.yield
+    raise response if response.is_a?(StandardError)
+    response
+  end
+end

data/lib/fraggle-synchrony/fraggle/client.rb

@@ -0,0 +1,23 @@
+module Fraggle
+  class Client
+
+    %w{rev set get del stat}.each do |cmd|
+      class_eval <<-CODE
+        alias :a#{cmd} :#{cmd}
+
+        def #{cmd}(*args)
+          f = Fiber.current
+          cb = proc { |e, err|
+            f.resume e || err
+          }
+          a#{cmd}(*args, &cb)
+
+          response = Fiber.yield
+          raise response if response.is_a?(StandardError)
+          response
+        end
+      CODE
+    end
+
+  end
+end

data/lib/fraggle-synchrony/version.rb

@@ -0,0 +1,5 @@
+module Fraggle
+  module Synchrony
+    VERSION = "0.0.1"
+  end
+end

data/spec/fraggle-synchrony/fraggle/client_spec.rb

@@ -0,0 +1,104 @@
+require 'spec_helper'
+
+describe Fraggle::Client do
+
+  it "should retrieve rev" do
+    EM.synchrony {
+      initialize_server(DoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      response = client.rev
+      response.should == 2
+      EM.stop
+    }
+  end
+
+  it "should trap an error from rev" do
+     EM.synchrony {
+      initialize_server(BadDoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      expect { 
+        client.rev 
+      }.to raise_error(Fraggle::Connection::ResponseError)
+      EM.stop
+    }
+  end
+
+  it "should set a value" do
+    EM.synchrony {
+      initialize_server(DoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      response = client.set(3, "/path", "value")
+      response.rev.should == 4
+      EM.stop
+    }
+  end
+
+  it "should trap an error from set" do
+     EM.synchrony {
+      initialize_server(BadDoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      expect { 
+        client.set(3, "/path", "value")
+      }.to raise_error(Fraggle::Connection::ResponseError)
+      EM.stop
+    }
+  end
+
+  it "should get a value" do
+    EM.synchrony {
+      initialize_server(DoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      response = client.get(5, "/path")
+      response.rev.should == 6
+      response.value.should == "VALUE"
+      EM.stop
+    }
+  end
+
+  it "should trap an error from get" do
+     EM.synchrony {
+      initialize_server(BadDoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      expect { 
+        client.get(2, "/path")
+      }.to raise_error(Fraggle::Connection::ResponseError)
+      EM.stop
+    }
+  end
+
+  it "should del a value" do
+    EM.synchrony {
+      initialize_server(DoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      response = client.del(7, "/path")
+      response.rev.should == 8
+      EM.stop
+    }
+  end
+
+  it "should trap an error from del" do
+     EM.synchrony {
+      initialize_server(BadDoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      expect { 
+        client.del(7, "/path")
+      }.to raise_error(Fraggle::Connection::ResponseError)
+      EM.stop
+    }
+  end
+
+  it "should returns stat" do
+    EM.synchrony {
+      initialize_server(DoozerConnection)
+      client = Fraggle.connect("doozer:?ca=127.0.0.1:9876")
+      response = client.stat(9, "/path")
+      response.rev.should == 10
+      response.value.should == "STAT"
+      EM.stop
+    }
+  end
+
+  def initialize_server(connection_class)
+    EM::start_server "127.0.0.1", 9876, connection_class
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,81 @@
+$:.unshift File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'fraggle-synchrony'
+require 'eventmachine'
+
+class DoozerConnection < EM::Connection
+  def receive_data(data)
+    request = Fraggle::Request.decode(data)
+    response = Fraggle::Response.new
+    response.tag = request.tag
+    __send__ :"__#{verb_to_s(request.verb)}__", request, response
+  end
+  def __ACCESS__(request, response)
+    send_response(response)
+  end
+  def __REV__(request, response)
+    response.rev = 2
+    send_response(response)
+  end
+  def __SET__(request, response)
+    response.rev = 4
+    send_response(response)
+  end
+  def __GET__(request, response)
+    response.rev = 6
+    response.value = "VALUE"
+    send_response(response)
+  end
+  def __DEL__(request, response)
+    response.rev = 8
+    send_response(response)
+  end
+  def __STAT__(request, response)
+    response.rev = 10
+    response.value = "STAT"
+    send_response(response)
+  end
+  def send_response(response)
+    data = response.encode
+    head = [data.length].pack("N")
+    send_data("#{head}#{data}")
+  end
+  def verb_to_s(verb)
+    {
+      1 => "GET",
+      2 => "SET",
+      3 => "DEL",
+      5 => "REV",
+      6 => "WAIT",
+      7 => "NOP",
+      9 => "WALK",
+      14 => "GETDIR",
+      16 => "STAT",
+      99 => "ACCESS"
+    }[verb]
+  end
+end
+
+class BadDoozerConnection < DoozerConnection
+  def __REV__(request, response)
+    response.rev = 2
+    response.err_code = Fraggle::Response::Err::OTHER
+    send_response(response)
+  end
+  def __SET__(request, response)
+    response.rev = 4
+    response.err_code = Fraggle::Response::Err::OTHER
+    send_response(response)
+  end
+  def __GET__(request, response)
+    response.rev = 6
+    response.err_code = Fraggle::Response::Err::OTHER
+    send_response(response)
+  end
+  def __DEL__(request, response)
+    response.rev = 8
+    response.err_code = Fraggle::Response::Err::OTHER
+    send_response(response)
+  end
+end
+

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: fraggle-synchrony
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Steven Mohapi-Banks
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-07-12 00:00:00.000000000 +01:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fraggle
+  requirement: &2153512440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2153512440
+- !ruby/object:Gem::Dependency
+  name: em-synchrony
+  requirement: &2153512020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2153512020
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2153511520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: *2153511520
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2153511020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: *2153511020
+description: An em-synchrony wrapper for fraggle
+email:
+- steven.mohapibanks@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .autotest
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- fraggle-synchrony.gemspec
+- lib/fraggle-synchrony.rb
+- lib/fraggle-synchrony/fraggle.rb
+- lib/fraggle-synchrony/fraggle/client.rb
+- lib/fraggle-synchrony/version.rb
+- spec/fraggle-synchrony/fraggle/client_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: fraggle-synchrony
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: An em-synchrony wrapper for fraggle
+test_files:
+- spec/fraggle-synchrony/fraggle/client_spec.rb
+- spec/spec_helper.rb