synapse-core 0.4.0 → 0.5.1

data/test/command/wiring_test.rb

@@ -4,7 +4,7 @@ module Synapse
   module Command
 
     class WiringCommandHandlerTest < Test::Unit::TestCase
-      def test_handle
+      should 'pass the command to the correct wire' do
         handler = ExampleWiringCommandHandler.new
         unit = Object.new
 
@@ -31,7 +31,7 @@ module Synapse
         end
       end
 
-      def test_subscribe
+      should 'subscribe handler to the command bus for each wired command type' do
         handler = ExampleWiringCommandHandler.new
         bus = Object.new
 
@@ -41,7 +41,7 @@ module Synapse
         handler.subscribe bus
       end
 
-      def test_unsubscribe
+      should 'unsubscribe handler from the command bus for each wired command type' do
         handler = ExampleWiringCommandHandler.new
         bus = Object.new
 

data/test/common/concurrency/identifier_lock_test.rb

@@ -2,18 +2,7 @@ require 'test_helper'
 
 module Synapse
   class IdentifierLockTest < Test::Unit::TestCase
-    def test_disposal
-      lock = IdentifierLock.new
-      identifier = 'some_id'
-
-      lock.obtain_lock identifier
-      lock.release_lock identifier
-
-      identifiers = lock.instance_variable_get :@identifiers
-      refute identifiers.has_key? identifier
-    end
-
-    def test_owned?
+    should 'indicate whether the current thread holds a lock' do
       lock = IdentifierLock.new
       identifier = 'some_id'
 
@@ -26,7 +15,7 @@ module Synapse
       refute lock.owned? identifier
     end
 
-    def test_release_lock
+    should 'raise an exception when a thread releases a lock it does not own' do
       lock = IdentifierLock.new
       assert_raise ThreadError do
         lock.release_lock 'derp'

data/test/common/concurrency/public_lock_test.rb

@@ -2,7 +2,7 @@ require 'test_helper'
 
 module Synapse
   class PublicLockTest < Test::Unit::TestCase
-    def test_lock_raises
+    should 'raise an exception when a thread tries to obtain a lock twice' do
       @lock = PublicLock.new
       @lock.lock
 
@@ -11,7 +11,7 @@ module Synapse
       end
     end
 
-    def test_lock_removes_waiting
+    should 'properly manage its list of waiting threads' do
       @lock = PublicLock.new
       @lock.lock
 
@@ -30,7 +30,7 @@ module Synapse
       end
     end
 
-    def test_synchronize
+    should 'synchronize the execution of a block' do
       @lock = PublicLock.new
 
       refute @lock.owned?
@@ -45,7 +45,7 @@ module Synapse
       refute @lock.owned_by? Thread.current
     end
 
-    def test_unlock_raises
+    should 'raise an exception when a thread releases a lock it does not own' do
       @lock = PublicLock.new
 
       assert_raise ThreadError do
@@ -53,7 +53,7 @@ module Synapse
       end
     end
 
-    def test_try_lock
+    should 'provide a non-blocking lock attempt' do
       @lock = PublicLock.new
 
       t = Thread.new do
@@ -71,7 +71,7 @@ module Synapse
       t.wakeup
     end
 
-    def test_try_lock_raises
+    should 'raise an exception when a thread tries to obtain a non-blocking lock twice' do
       @lock = PublicLock.new
       @lock.try_lock
 

data/test/{duplication_test.rb → common/duplication_test.rb}

@@ -7,7 +7,7 @@ module Synapse
       @message = Message.build
     end
 
-    def test_record
+    should 'raise an exception when a message is recorded more than once' do
       refute @recorder.recorded? @message
 
       @recorder.record @message
@@ -18,14 +18,14 @@ module Synapse
       end
     end
 
-    def test_forget
+    should 'be able to forget a message' do
       @recorder.record @message
       @recorder.forget @message
 
       refute @recorder.recorded? @message
     end
 
-    def test_forget_older_than
+    should 'be able to forget messages recorded before a certain time' do
       @recorder.record @message
 
       threshold = 60 * 20 # 20 minutes

data/test/configuration/component/command_bus/async_command_bus_test.rb

@@ -0,0 +1,36 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class AsynchronousCommandBusDefinitionFactoryTest < Test::Unit::TestCase
+      def setup
+        @container = Container.new
+        @builder = ContainerBuilder.new @container
+        @builder.unit_factory
+      end
+
+      should 'build with sensible defaults' do
+        @builder.async_command_bus
+
+        command_bus = @container.resolve :command_bus
+        assert command_bus.is_a? Command::AsynchronousCommandBus
+
+        thread_pool = command_bus.thread_pool
+        assert_equal 4, thread_pool.min
+        assert_equal 4, thread_pool.max
+      end
+
+      should 'build with a custom thread pool size' do
+        @builder.async_command_bus do
+          use_threads 2, 8
+        end
+
+        command_bus = @container.resolve :command_bus
+
+        thread_pool = command_bus.thread_pool
+        assert_equal 2, thread_pool.min
+        assert_equal 8, thread_pool.max
+      end
+    end
+  end
+end

data/test/configuration/component/command_bus/simple_command_bus_test.rb

@@ -0,0 +1,57 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class SimpleCommandBusDefinitionFactoryTest < Test::Unit::TestCase
+      def setup
+        @container = Container.new
+        @builder = ContainerBuilder.new @container
+      end
+
+      should 'build with sensible defaults' do
+        @builder.unit_factory
+        @builder.simple_command_bus
+
+        command_bus = @container.resolve :command_bus
+        assert command_bus.is_a? Command::SimpleCommandBus
+      end
+
+      should 'build with an alternate unit of work factory' do
+        @builder.unit_factory :alt_unit_factory
+        @builder.simple_command_bus do
+          use_unit_factory :alt_unit_factory
+        end
+
+        command_bus = @container.resolve :command_bus
+      end
+
+      should 'build and register tagged command handlers' do
+        handler_a = Object.new
+        handler_b = Object.new
+
+        @builder.definition :first_handler do
+          tag :command_handler
+          use_instance handler_a
+        end
+
+        @builder.definition :second_handler do
+          tag :alt_command_handler
+          use_instance handler_b
+        end
+
+        @builder.unit_factory
+        @builder.simple_command_bus
+
+        @builder.simple_command_bus :alt_command_bus do
+          use_handler_tag :alt_command_handler
+        end
+
+        mock(handler_a).subscribe(is_a(Command::SimpleCommandBus))
+        command_bus = @container.resolve :command_bus
+
+        mock(handler_b).subscribe(is_a(Command::SimpleCommandBus))
+        command_bus = @container.resolve :alt_command_bus
+      end
+    end
+  end
+end

data/test/configuration/component/event_bus/simple_event_bus_test.rb

@@ -0,0 +1,58 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class SimpleEventBusDefinitionBuilderTest < Test::Unit::TestCase
+      def setup
+        @container = Container.new
+        @builder = ContainerBuilder.new @container
+      end
+
+      should 'build with sensible defaults' do
+        @builder.simple_event_bus
+
+        factory = @container.resolve :event_bus
+        assert factory.is_a? EventBus::SimpleEventBus
+      end
+
+      should 'build and subscribe tagged event listeners' do
+        @builder.definition :first_listener do
+          tag :event_listener
+          use_factory do
+            TestEventListener.new
+          end
+        end
+
+        @builder.definition :second_listener do
+          tag :alt_event_listener
+          use_factory do
+            TestAltEventListener.new
+          end
+        end
+
+        # Defaults
+        @builder.simple_event_bus
+
+        event_bus = @container.resolve :event_bus
+        assert event_bus.subscribed? @container.resolve :first_listener
+        refute event_bus.subscribed? @container.resolve :second_listener
+
+        # Customized
+        @builder.simple_event_bus :alt_event_bus do
+          use_listener_tag :alt_event_listener
+        end
+
+        event_bus = @container.resolve :alt_event_bus
+        refute event_bus.subscribed? @container.resolve :first_listener
+        assert event_bus.subscribed? @container.resolve :second_listener
+      end
+    end
+
+    class TestEventListener
+      include EventBus::WiringEventListener
+    end
+    class TestAltEventListener
+      include EventBus::WiringEventListener
+    end
+  end
+end

data/test/configuration/component/serialization/converter_factory_test.rb

@@ -0,0 +1,48 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class ConverterFactoryDefinitionBuilderTest < Test::Unit::TestCase
+      def setup
+        @container = Container.new
+        @builder = ContainerBuilder.new @container
+      end
+
+      should 'build with sensible defaults' do
+        @builder.converter_factory
+
+        factory = @container.resolve :converter_factory
+        assert factory.is_a? Serialization::ConverterFactory
+      end
+
+      should 'build and register tagged converters' do
+        @builder.definition :json2object_converter do
+          tag :converter, :alt_converter
+          use_factory do
+            Serialization::JsonToObjectConverter.new
+          end
+        end
+        @builder.definition :json2object_alt_converter do
+          tag :alt_converter
+          use_factory do
+            Serialization::JsonToObjectConverter.new
+          end
+        end
+
+        # Defaults
+        @builder.converter_factory
+
+        factory = @container.resolve :converter_factory
+        factory.converters.at(0).is_a? Serialization::JsonToObjectConverter
+
+        # Customized
+        @builder.converter_factory :alt_factory do
+          use_converter_tag :alt_converter
+        end
+
+        factory = @container.resolve :alt_factory
+        factory.converters.at(0).is_a? Serialization::JsonToObjectConverter
+      end
+    end
+  end
+end

data/test/configuration/component/serialization/serializer_test.rb

@@ -0,0 +1,78 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class SerializerDefinitionBuilderTest < Test::Unit::TestCase
+      def setup
+        @container = Container.new
+        @builder = ContainerBuilder.new @container
+      end
+
+      should 'build with an alternate converter factory' do
+        @builder.converter_factory :alt_converter_factory
+        @builder.serializer do
+          use_converter_factory :alt_converter_factory
+        end
+
+        serializer = @container.resolve :serializer
+        converter_factory = @container.resolve :alt_converter_factory
+        assert_same converter_factory, serializer.converter_factory
+      end
+
+      should 'build with AttributeSerializer' do
+        @builder.converter_factory
+        @builder.serializer do
+          use_attribute
+        end
+
+        serializer = @container.resolve :serializer
+        assert serializer.is_a? Serialization::AttributeSerializer
+      end
+
+      should 'build with MarshalSerializer' do
+        @builder.converter_factory
+        @builder.serializer do
+          use_marshal
+        end
+
+        serializer = @container.resolve :serializer
+        assert serializer.is_a? Serialization::MarshalSerializer
+      end
+
+      should 'build with OxSerializer' do
+        skip 'Ox not supported on JRuby' if defined? JRUBY_VERSION
+
+        serialize_options = { :circular => true }
+
+        @builder.converter_factory
+        @builder.serializer do
+          use_ox
+          use_serialize_options serialize_options
+        end
+
+        serializer = @container.resolve :serializer
+        assert serializer.is_a? Serialization::OxSerializer
+        assert_equal serialize_options, serializer.serialize_options
+      end
+
+      should 'build with OjSerializer' do
+        skip 'Oj not supported on JRuby' if defined? JRUBY_VERSION
+
+        serialize_options = { :indent => 2, :circular => true }
+        deserialize_options = { :symbol_keys => true }
+
+        @builder.converter_factory
+        @builder.serializer do
+          use_oj
+          use_serialize_options serialize_options
+          use_deserialize_options deserialize_options
+        end
+
+        serializer = @container.resolve :serializer
+        assert serializer.is_a? Serialization::OjSerializer
+        assert_equal serialize_options, serializer.serialize_options
+        assert_equal deserialize_options, serializer.deserialize_options
+      end
+    end
+  end
+end

data/test/configuration/component/uow/unit_factory_test.rb

@@ -0,0 +1,46 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class UnitOfWorkFactoryDefinitionBuilderTest < Test::Unit::TestCase
+      def setup
+        @container = Container.new
+        @builder = ContainerBuilder.new @container
+      end
+
+      should 'build with sensible defaults' do
+        @builder.factory :transaction_manager do
+          UnitOfWork::TransactionManager.new
+        end
+        @builder.unit_factory
+
+        factory = @container.resolve :unit_factory
+        assert factory.is_a? UnitOfWork::UnitOfWorkFactory
+        assert factory.transaction_manager
+      end
+
+      should 'build with an alternate transaction manager' do
+        @builder.factory :alt_tx_manager do
+          UnitOfWork::TransactionManager.new
+        end
+        @builder.unit_factory do
+          use_transaction_manager :alt_tx_manager
+        end
+
+        factory = @container.resolve :unit_factory
+        assert factory.transaction_manager
+      end
+
+      should 'build with an alternate unit of work provider' do
+        @builder.factory :alt_unit_provider do
+          UnitOfWork::UnitOfWorkProvider.new
+        end
+        @builder.unit_factory do
+          use_unit_provider :alt_unit_provider
+        end
+
+        @container.resolve :unit_factory
+      end
+    end
+  end
+end

data/test/configuration/container_builder_test.rb

@@ -0,0 +1,47 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class ContainerBuilderTest < Test::Unit::TestCase
+      def setup
+        # Backup any existing initializers
+        @initializers = ContainerBuilder.initializers
+        ContainerBuilder.initializers = nil
+
+        # Create a container that will be built
+        @container = Container.new
+      end
+
+      def teardown
+        # Restore any existing initializers
+        ContainerBuilder.initializers = @initializers
+      end
+
+      def test_initializers
+        ContainerBuilder.initializer do
+          definition :test_definition do
+            tag :derp
+          end
+        end
+
+        builder = ContainerBuilder.new @container
+
+        assert @container.registered? :test_definition
+      end
+
+      def test_factory
+        builder = ContainerBuilder.new @container
+        builder.build_with do
+          factory :derp_service, :tag => [:first_tag, :nth_tag] do
+            123
+          end
+        end
+
+        assert @container.registered? :derp_service
+        assert_equal 123, @container.resolve(:derp_service)
+        assert_equal [123], @container.resolve_tagged(:first_tag)
+        assert_equal [123], @container.resolve_tagged(:nth_tag)
+      end
+    end
+  end
+end

data/test/configuration/container_test.rb

@@ -0,0 +1,88 @@
+require 'test_helper'
+require 'configuration/fixtures/dependent'
+
+module Synapse
+  module Configuration
+    class ContainerTest < Test::Unit::TestCase
+
+      should 'inject services into a Dependent object' do
+        container = Container.new
+
+        service_a = Object.new
+        service_b = Object.new
+
+        DefinitionBuilder.build container, :service_a do
+          use_instance service_a
+        end
+
+        DefinitionBuilder.build container, :service_b do
+          use_instance service_b
+        end
+
+        dependent = ExampleDependent.new
+        container.inject_into dependent
+
+        assert_same service_a, dependent.service_a
+        assert_same service_b, dependent.some_service
+      end
+
+      should 'not attempt to inject services into a non-Dependent object' do
+        container = Container.new
+        object = Object.new
+
+        container.inject_into object
+      end
+
+      should 'resolve a service from a definition by its identifier' do
+        reference = Object.new
+        container = Container.new
+
+        DefinitionBuilder.build container, :some_service do
+          use_instance reference
+        end
+
+        assert_same reference, container.resolve(:some_service)
+      end
+
+      should 'resolve a service from a definition by its tag' do
+        container = Container.new
+        some_service = Object.new
+        some_other_service = Object.new
+
+        DefinitionBuilder.build container, :some_service do
+          tag :some_tag
+          use_instance some_service
+        end
+
+        DefinitionBuilder.build container, :some_other_service do
+          tag :some_other_tag
+          use_instance some_other_service
+        end
+
+        # Do it breh
+        tagged = container.resolve_tagged :some_tag
+        assert tagged.include? some_service
+      end
+
+      should 'support optional service resolution' do
+        container = Container.new
+
+        assert_nil container.resolve :some_service, true
+        assert_raise ConfigurationError do
+          container.resolve :some_service
+        end
+      end
+
+      should 'log when a definition is replaced' do
+        logger = Logging.logger[Container]
+
+        mock(logger).info(anything)
+
+        container = Container.new
+        container.register :some_service, Object.new
+        container.register :some_service, Object.new
+      end
+
+    end
+  end
+end