combi 0.0.3

data/lib/combi/service_bus.rb

@@ -0,0 +1,31 @@
+module Combi
+  class ServiceBus
+    class << self
+      @@buses = {}
+
+      def for(kind, options = {})
+        @@buses[kind] ||= init_for(kind, options)
+      end
+
+      def init_for(kind, options)
+        require 'combi/buses/bus'
+
+        case kind
+        when :in_process
+          require 'combi/buses/in_process'
+          Combi::InProcess.new(options)
+        when :queue
+          require 'combi/buses/queue'
+          Combi::Queue.new(options)
+        when :web_socket
+          require 'combi/buses/web_socket'
+          Combi::WebSocket.new(options)
+        when :http
+          require 'combi/buses/http'
+          Combi::Http.new(options)
+        end
+      end
+    end
+
+  end
+end

data/lib/combi/version.rb

@@ -0,0 +1,3 @@
+module Combi
+  VERSION = '0.0.3'
+end

data/spec/integration/multi_bus_spec.rb

@@ -0,0 +1,140 @@
+require 'spec_helper'
+
+require 'combi/service_bus'
+require 'combi/buses/in_process'
+
+describe "in a multi bus environment" do
+  include EventedSpec::SpecHelper
+
+  Given(:boring_salutation_service) do
+    Module.new do
+      def actions; [:say_hello]; end
+      def do_it(params); "Hello #{params['who']}"; end
+    end
+  end
+
+  Given(:composed_service_class) do
+    Class.new do
+      include Combi::Service
+
+      def initialize(other_client)
+        @other_client = other_client
+      end
+
+      def actions; [:repeat_with_me]; end
+
+      def do_it(params)
+        defer = EventMachine::DefaultDeferrable.new
+        EM.synchrony do
+          req = @other_client.request(:say_hello, :do_it, params, timeout: 3)
+          service_result = EM::Synchrony.sync req
+          defer.succeed(service_result*2)
+        end
+        defer
+      end
+    end
+  end
+
+  Given(:amqp_config) do
+    {
+      :host      => "127.0.0.1",
+      :port      => RabbitmqServer.instance.port,
+      :user      => "admin",
+      :pass      => RabbitmqServer::PASSWORD,
+      :vhost     => "/",
+      :ssl       => false,
+      :heartbeat => 0,
+      :frame_max => 131072
+    }
+  end
+
+  Given(:handler) { double('handler', on_open: nil) }
+  Given(:server_port_socket) { 9292 + rand(30000) }
+  Given(:socket_client_options) do
+    { remote_api: "ws://localhost:#{server_port_socket}/",
+      handler: handler }
+  end
+  Given(:server_port_http) { 9292 + rand(30000) }
+  Given(:http_client_options) do
+    { remote_api: "http://localhost:#{server_port_http}/" }
+  end
+
+  before(:all) {
+    RabbitmqServer.instance.stop! if ENV['CLEAN']
+    RabbitmqServer.instance.start!
+  }
+
+  after(:all) {
+    RabbitmqServer.instance.stop! if ENV['CLEAN']
+  }
+
+  Given(:options) { {timeout: 3} }
+
+  Given(:service_for_main_bus) { main_bus_provider.add_service composed_service_class.new(internal_bus_consumer) }
+  Given(:service_for_internal_bus)   { internal_bus_provider.add_service boring_salutation_service }
+  When(:params) { { who: 'world' } }
+  When(:expected_result) { "Hello worldHello world" }
+
+  Given(:in_process_provider) { Combi::ServiceBus.init_for(:in_process, {}) }
+  Given(:in_process_consumer) { in_process_provider }
+  Given(:http_provider)       { Combi::ServiceBus.init_for(:http, {} ) }
+  Given(:http_consumer)       { Combi::ServiceBus.init_for(:http, http_client_options) }
+  Given(:queue_provider)      { Combi::ServiceBus.init_for(:queue, { amqp_config: amqp_config } ) }
+  Given(:queue_consumer)      { Combi::ServiceBus.init_for(:queue, { amqp_config: amqp_config } ) }
+  Given(:socket_provider)     { Combi::ServiceBus.init_for(:web_socket, {} ) }
+  Given(:socket_consumer)     { Combi::ServiceBus.init_for(:web_socket, socket_client_options) }
+
+  BUSES = %w{in_process socket http queue}
+
+  BUSES.each do |main|
+    BUSES.each do |internal|
+      context "#{internal} inside #{main}" do
+        Given(:main_bus_provider)     { send "#{main}_provider" }
+        Given(:main_bus_consumer)     { send "#{main}_consumer" }
+        Given(:internal_bus_provider) { send "#{internal}_provider" }
+        Given(:internal_bus_consumer) { send "#{internal}_consumer" }
+
+        Given("#{main}_server".to_sym) do
+          if main == 'http'
+            start_web_server main_bus_provider, server_port_http
+          end
+          if main == 'socket'
+            start_em_websocket_server main_bus_provider, server_port_socket
+          end
+        end
+        Given("#{internal}_server".to_sym) do
+          if internal == 'http'
+            start_web_server internal_bus_provider, server_port_http
+          end
+          if internal == 'socket'
+            start_em_websocket_server internal_bus_provider, server_port_socket
+          end
+        end
+
+        Then do
+          em do
+            service_for_main_bus
+            service_for_internal_bus
+            main_bus_provider.start!
+            internal_bus_provider.start!
+            send("#{main}_server")
+            send("#{internal}_server")
+            main_bus_consumer.start!
+            internal_bus_consumer.start!
+
+            EM.synchrony do
+              service_result = EM::Synchrony.sync main_bus_consumer.request(:repeat_with_me, :do_it, params, options)
+              service_result.should eq expected_result
+              done
+              main_bus_provider.stop!
+              internal_bus_provider.stop!
+              main_bus_consumer.stop!
+              internal_bus_consumer.stop!
+            end
+          end
+        end
+      end
+    end
+  end
+
+end

data/spec/lib/combi/buses/bus_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe 'Combi::Bus' do
+  context 'registers services' do
+    Given(:subject) { Combi::Bus.new({}) }
+
+    context 'via instances' do
+      Given(:service_class) { Class.new{include Combi::Service} }
+      Given(:service_definition) { service_class.new }
+      When { subject.add_service service_definition }
+      Then { subject.services == [service_definition] }
+    end
+
+    context 'via modules' do
+      Given(:service_definition) { Module.new }
+      When { subject.add_service service_definition }
+      Then { subject.services.length == 1 }
+       And { Combi::Service === subject.services[0] }
+       And { service_definition === subject.services[0] }
+    end
+  end
+end

data/spec/lib/combi/buses/http_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+require 'combi/service_bus'
+require 'combi/buses/http'
+
+describe 'Combi::Http' do
+  include EventedSpec::SpecHelper
+
+  context 'can be instantiated via ServiceBus' do
+    When(:bus) { Combi::ServiceBus.init_for(:http, {}) }
+    Then { Combi::Http === bus }
+  end
+  Given(:server_port) { 9292 + rand(30000) }
+  Given(:client_options) { { remote_api: "http://localhost:#{server_port}/" } }
+  Given(:provider) { Combi::ServiceBus.init_for(:http, {} ) }
+  Given(:consumer) { Combi::ServiceBus.init_for(:http, client_options) }
+  Given(:prepare) do
+    provider.start!
+    start_web_server provider, server_port
+    consumer.start!
+  end
+
+  it_behaves_like 'standard_bus'
+
+end

data/spec/lib/combi/buses/in_process_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+require 'combi/service_bus'
+require 'combi/buses/in_process'
+
+describe 'Combi::InProcess' do
+  include EventedSpec::SpecHelper
+
+  context 'can be instanitated via ServiceBus' do
+    When(:bus) { Combi::ServiceBus.init_for(:in_process, {}) }
+    Then { Combi::InProcess === bus }
+  end
+
+  Given(:subject) { Combi::ServiceBus.init_for(:in_process, {}) }
+  Given(:provider) { subject }
+  Given(:consumer) { subject }
+  Given(:prepare) do
+    provider.start!
+    consumer.start!
+  end
+
+  it_behaves_like 'standard_bus'
+
+end

data/spec/lib/combi/buses/queue_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+require 'combi/service_bus'
+require 'combi/buses/queue'
+
+describe 'Combi::Queue' do
+  include EventedSpec::SpecHelper
+
+  context 'can be instanitated via ServiceBus' do
+    When(:bus) { Combi::ServiceBus.init_for(:queue, {init_queue: false}) }
+    Then { Combi::Queue === bus }
+  end
+
+  Given(:amqp_config) do
+    {
+      :host      => "127.0.0.1",
+      :port      => RabbitmqServer.instance.port,
+      :user      => "admin",
+      :pass      => RabbitmqServer::PASSWORD,
+      :vhost     => "/",
+      :ssl       => false,
+      :heartbeat => 0,
+      :frame_max => 131072
+    }
+  end
+  Given(:provider) { Combi::ServiceBus.init_for(:queue, { amqp_config: amqp_config } ) }
+  Given(:consumer) { Combi::ServiceBus.init_for(:queue, { amqp_config: amqp_config } ) }
+  Given(:prepare) do
+    provider.start!
+    consumer.start!
+    true
+  end
+
+  it_behaves_like 'standard_bus' do
+    before(:all) do
+      RabbitmqServer.instance.stop! if ENV['CLEAN']
+      RabbitmqServer.instance.start!
+    end
+    after(:all) { RabbitmqServer.instance.stop! if ENV['CLEAN'] }
+  end
+end

data/spec/lib/combi/buses/web_socket_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+require 'combi/service_bus'
+require 'combi/buses/web_socket'
+
+describe 'Combi::WebSocket' do
+  include EventedSpec::SpecHelper
+
+  context 'can be instanitated via ServiceBus' do
+    When(:bus) { Combi::ServiceBus.init_for(:web_socket, {}) }
+    Then { Combi::WebSocket === bus }
+  end
+  Given(:handler) do
+    Class.new do
+      def on_open; end
+    end.new
+  end
+
+  Given(:server_port) { 9292 + rand(30000) }
+  Given(:client_options) do
+    { remote_api: "ws://localhost:#{server_port}/",
+      handler: handler }
+  end
+  Given(:provider) { Combi::ServiceBus.init_for(:web_socket, {} )}
+  Given(:consumer) { Combi::ServiceBus.init_for(:web_socket, client_options) }
+  Given(:prepare) do
+    provider.start!
+    start_em_websocket_server provider, server_port
+    consumer.start!
+  end
+
+  it_behaves_like 'standard_bus'
+
+end

data/spec/lib/combi/service_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+describe 'Combi::Service' do
+  Given(:subject_class) { Class.new{include Combi::Service} }
+  Given(:subject) { subject_class.new }
+
+  describe '#setup' do
+    Given(:context) { {foo: 'bar', one: 1} }
+    Given!("setup methods are stubbed") do
+      subject.stub(:setup_context).and_call_original
+      subject.stub(:setup_services).and_call_original
+      subject.stub(:register_actions).and_call_original
+    end
+    Given(:the_bus) { double "the bus" }
+    When { subject.setup the_bus, context }
+    context 'sets up the context' do
+      Then { subject.should have_received :setup_context }
+    end
+    context 'allows the service to setup itself' do
+      Then { subject.should have_received :setup_services }
+    end
+    context 'registers the advertised actions' do
+      Then { subject.should have_received :register_actions }
+    end
+    context 'always includes the service_bus in the context' do
+      Then { subject.service_bus == the_bus }
+    end
+  end
+
+  describe '#setup_context' do
+    context 'creates accessors for keys in the context' do
+      Given(:context) { {foo: 'bar', one: 1} }
+      When { subject.setup_context context }
+      Then { subject.respond_to? :foo }
+       And { subject.respond_to? :one}
+       And { subject.foo == 'bar' }
+       And { subject.one == 1 }
+     end
+  end
+end

data/spec/shared_examples/standard_bus.rb

@@ -0,0 +1,62 @@
+require "em-synchrony"
+
+shared_examples_for "standard_bus" do
+
+  Given(:slow_service) do
+    Module.new do
+      def actions; [:sleep]; end
+      def do_it(params)
+        sleep params['time']
+      end
+    end
+  end
+
+  Given(:boring_salutation_service) do
+    Module.new do
+      def actions; [:say_hello]; end
+      def do_it(params)
+        "Hello #{params['who']}"
+      end
+    end
+  end
+
+  Given(:finalize) do
+    provider.stop!
+    consumer.stop!
+  end
+
+  context 'can invoke services' do
+    When(:service) { provider.add_service boring_salutation_service }
+    When(:params) { { who: 'world' } }
+    Then do
+      em do
+        prepare
+        EM.synchrony do
+          service_result = EM::Synchrony.sync consumer.request(:say_hello, :do_it, params, { timeout: 2 })
+          service_result.should eq "Hello world"
+          done
+          finalize
+        end
+      end
+    end
+  end
+
+  context 'raises Timeout::Error when the response is slow' do
+    Given(:time_base) { 0.01 }
+    When(:params) { { time: time_base*4 } }
+    When(:service) { provider.add_service slow_service }
+    Then do
+      em do
+        prepare
+        EM.synchrony do
+          expect do
+            service_result = EM::Synchrony.sync consumer.request(:sleep, :do_it, params, { timeout: time_base/2.0 })
+            raise Kernel.const_get(service_result.message) if service_result.is_a? Exception
+          end.to raise_error Timeout::Error
+          done(time_base) #timeout response must came before this timeout
+        end
+        finalize
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end
+
+require 'rspec-given'
+require 'evented-spec'
+Dir["./spec/support/**/*.rb"].sort.each {|f| require f}
+Dir["./spec/shared_examples/**/*.rb"].sort.each {|f| require f}