concurrent-ruby 0.2.0 → 0.2.1

data/spec/concurrent/reactor/drb_async_demux_spec.rb

@@ -1,196 +1,196 @@
-require 'spec_helper'
-require 'faker'
-
-module Concurrent
-  class Reactor
-
-    describe DRbAsyncDemux, not_on_travis: true do
-
-      subject{ DRbAsyncDemux.new }
-
-      after(:each) do
-        DRb.stop_service
-      end
-
-      def post_event(demux, event, *args)
-        there = DRbObject.new_with_uri(DRbAsyncDemux::DEFAULT_URI)
-        there.send(event, *args)
-      end
-
-      context '#initialize' do
-
-        it 'sets the initial state to :stopped' do
-          subject.should_not be_running
-        end
-
-        it 'uses the given URI' do
-          uri = 'druby://concurrent-ruby.com:4242'
-          demux = DRbAsyncDemux.new(uri: uri)
-          demux.uri.should eq uri
-        end
-
-        it 'uses the default URI when none given' do
-          demux = DRbAsyncDemux.new
-          demux.uri.should eq DRbAsyncDemux::DEFAULT_URI
-        end
-
-        it 'uses the given ACL' do
-          acl = %w[deny all]
-          ACL.should_receive(:new).with(acl).and_return(acl)
-          demux = DRbAsyncDemux.new(acl: acl)
-          demux.acl.should eq acl
-        end
-
-        it 'uses the default ACL when given' do
-          acl = DRbAsyncDemux::DEFAULT_ACL
-          ACL.should_receive(:new).with(acl).and_return(acl)
-          demux = DRbAsyncDemux.new
-          demux.acl.should eq acl
-        end
-      end
-
-      context '#run' do
-
-        it 'raises an exception if already runed' do
-          subject.run
-
-          lambda {
-            subject.run
-          }.should raise_error(StandardError)
-        end
-
-        it 'installs the ACL' do
-          acl = %w[deny all]
-          ACL.should_receive(:new).once.with(acl).and_return(acl)
-          DRb.should_receive(:install_acl).once.with(acl)
-          demux = DRbAsyncDemux.new(acl: acl)
-          reactor = Concurrent::Reactor.new(demux)
-          Thread.new{ reactor.run }
-          sleep(0.1)
-          reactor.stop
-        end
-
-        it 'runs DRb' do
-          uri = DRbAsyncDemux::DEFAULT_URI
-          DRb.should_receive(:start_service).with(uri, anything())
-          demux = DRbAsyncDemux.new(uri: uri)
-          reactor = Concurrent::Reactor.new(demux)
-          Thread.new{ reactor.run }
-          sleep(0.1)
-          reactor.stop
-        end
-      end
-
-      context '#stop' do
-
-        it 'stops DRb' do
-          DRb.should_receive(:stop_service).at_least(1).times
-          subject.run
-          sleep(0.1)
-          subject.stop
-        end
-      end
-
-      context '#running?' do
-
-        it 'returns false when stopped' do
-          subject.run
-          sleep(0.1)
-          subject.stop
-          sleep(0.1)
-          subject.should_not be_running
-        end
-
-        it 'returns true when running' do
-          subject.run
-          sleep(0.1)
-          subject.should be_running
-        end
-      end
-
-      context '#set_reactor' do
-
-        it 'raises an exception when given an invalid reactor' do
-          lambda {
-            subject.set_reactor(Concurrent::Reactor.new)
-          }.should_not raise_error
-
-          lambda {
-            subject.set_reactor('bogus')
-          }.should raise_error(ArgumentError)
-        end
-      end
-
-      context 'event handling' do
-
-        it 'should post events to the reactor' do
-          demux = subject
-          reactor = Concurrent::Reactor.new(demux)
-          reactor.add_handler(:foo){ nil }
-          reactor.should_receive(:handle).with(:foo, 1,2,3).and_return([:ok, nil])
-
-          Thread.new { reactor.run }
-          sleep(0.1)
-
-          post_event(demux, :foo, 1, 2, 3)
-
-          reactor.stop
-          sleep(0.1)
-        end
-      end
-
-      specify 'integration', not_on_travis: true do
-
-        # server
-        demux = Concurrent::Reactor::DRbAsyncDemux.new
-        reactor = Concurrent::Reactor.new(demux)
-
-        reactor.add_handler(:echo) {|message| message }
-        reactor.add_handler(:error) {|message| raise StandardError.new(message) }
-        reactor.add_handler(:unknown) {|message| message }
-        reactor.add_handler(:abend) {|message| message }
-
-        t = Thread.new { reactor.run }
-        sleep(0.1)
-
-        # client
-        there = DRbObject.new_with_uri(DRbAsyncDemux::DEFAULT_URI)
-
-        # test :ok
-        10.times do
-          message = Faker::Company.bs
-          echo = there.echo(message)
-          echo.should eq message
-        end
-
-        # test :ex
-        lambda {
-          echo = there.error('error')
-        }.should raise_error(StandardError, 'error')
-
-        # test :noop
-        lambda {
-          echo = there.bogus('bogus')
-        }.should raise_error(NoMethodError)
-
-        # test unknown respone code
-        reactor.should_receive(:handle).with(:unknown).and_return([:unknown, nil])
-        lambda {
-          echo = there.unknown
-        }.should raise_error(DRb::DRbError)
-
-        # test handler error
-        reactor.should_receive(:handle).with(:abend).and_raise(ArgumentError)
-        lambda {
-          echo = there.abend
-        }.should raise_error(DRb::DRbRemoteError)
-
-        # cleanup
-        reactor.stop
-        sleep(0.1)
-        Thread.kill(t)
-        sleep(0.1)
-      end
-    end
-  end
-end
+require 'spec_helper'
+require 'faker'
+
+module Concurrent
+  class Reactor
+
+    describe DRbAsyncDemux, not_on_travis: true do
+
+      subject{ DRbAsyncDemux.new }
+
+      after(:each) do
+        DRb.stop_service
+      end
+
+      def post_event(demux, event, *args)
+        there = DRbObject.new_with_uri(DRbAsyncDemux::DEFAULT_URI)
+        there.send(event, *args)
+      end
+
+      context '#initialize' do
+
+        it 'sets the initial state to :stopped' do
+          subject.should_not be_running
+        end
+
+        it 'uses the given URI' do
+          uri = 'druby://concurrent-ruby.com:4242'
+          demux = DRbAsyncDemux.new(uri: uri)
+          demux.uri.should eq uri
+        end
+
+        it 'uses the default URI when none given' do
+          demux = DRbAsyncDemux.new
+          demux.uri.should eq DRbAsyncDemux::DEFAULT_URI
+        end
+
+        it 'uses the given ACL' do
+          acl = %w[deny all]
+          ACL.should_receive(:new).with(acl).and_return(acl)
+          demux = DRbAsyncDemux.new(acl: acl)
+          demux.acl.should eq acl
+        end
+
+        it 'uses the default ACL when given' do
+          acl = DRbAsyncDemux::DEFAULT_ACL
+          ACL.should_receive(:new).with(acl).and_return(acl)
+          demux = DRbAsyncDemux.new
+          demux.acl.should eq acl
+        end
+      end
+
+      context '#run' do
+
+        it 'raises an exception if already runed' do
+          subject.run
+
+          lambda {
+            subject.run
+          }.should raise_error(StandardError)
+        end
+
+        it 'installs the ACL' do
+          acl = %w[deny all]
+          ACL.should_receive(:new).once.with(acl).and_return(acl)
+          DRb.should_receive(:install_acl).once.with(acl)
+          demux = DRbAsyncDemux.new(acl: acl)
+          reactor = Concurrent::Reactor.new(demux)
+          Thread.new{ reactor.run }
+          sleep(0.1)
+          reactor.stop
+        end
+
+        it 'runs DRb' do
+          uri = DRbAsyncDemux::DEFAULT_URI
+          DRb.should_receive(:start_service).with(uri, anything())
+          demux = DRbAsyncDemux.new(uri: uri)
+          reactor = Concurrent::Reactor.new(demux)
+          Thread.new{ reactor.run }
+          sleep(0.1)
+          reactor.stop
+        end
+      end
+
+      context '#stop' do
+
+        it 'stops DRb' do
+          DRb.should_receive(:stop_service).at_least(1).times
+          subject.run
+          sleep(0.1)
+          subject.stop
+        end
+      end
+
+      context '#running?' do
+
+        it 'returns false when stopped' do
+          subject.run
+          sleep(0.1)
+          subject.stop
+          sleep(0.1)
+          subject.should_not be_running
+        end
+
+        it 'returns true when running' do
+          subject.run
+          sleep(0.1)
+          subject.should be_running
+        end
+      end
+
+      context '#set_reactor' do
+
+        it 'raises an exception when given an invalid reactor' do
+          lambda {
+            subject.set_reactor(Concurrent::Reactor.new)
+          }.should_not raise_error
+
+          lambda {
+            subject.set_reactor('bogus')
+          }.should raise_error(ArgumentError)
+        end
+      end
+
+      context 'event handling' do
+
+        it 'should post events to the reactor' do
+          demux = subject
+          reactor = Concurrent::Reactor.new(demux)
+          reactor.add_handler(:foo){ nil }
+          reactor.should_receive(:handle).with(:foo, 1,2,3).and_return([:ok, nil])
+
+          Thread.new { reactor.run }
+          sleep(0.1)
+
+          post_event(demux, :foo, 1, 2, 3)
+
+          reactor.stop
+          sleep(0.1)
+        end
+      end
+
+      specify 'integration', not_on_travis: true do
+
+        # server
+        demux = Concurrent::Reactor::DRbAsyncDemux.new
+        reactor = Concurrent::Reactor.new(demux)
+
+        reactor.add_handler(:echo) {|message| message }
+        reactor.add_handler(:error) {|message| raise StandardError.new(message) }
+        reactor.add_handler(:unknown) {|message| message }
+        reactor.add_handler(:abend) {|message| message }
+
+        t = Thread.new { reactor.run }
+        sleep(0.1)
+
+        # client
+        there = DRbObject.new_with_uri(DRbAsyncDemux::DEFAULT_URI)
+
+        # test :ok
+        10.times do
+          message = Faker::Company.bs
+          echo = there.echo(message)
+          echo.should eq message
+        end
+
+        # test :ex
+        lambda {
+          echo = there.error('error')
+        }.should raise_error(StandardError, 'error')
+
+        # test :noop
+        lambda {
+          echo = there.bogus('bogus')
+        }.should raise_error(NoMethodError)
+
+        # test unknown respone code
+        reactor.should_receive(:handle).with(:unknown).and_return([:unknown, nil])
+        lambda {
+          echo = there.unknown
+        }.should raise_error(DRb::DRbError)
+
+        # test handler error
+        reactor.should_receive(:handle).with(:abend).and_raise(ArgumentError)
+        lambda {
+          echo = there.abend
+        }.should raise_error(DRb::DRbRemoteError)
+
+        # cleanup
+        reactor.stop
+        sleep(0.1)
+        Thread.kill(t)
+        sleep(0.1)
+      end
+    end
+  end
+end

data/spec/concurrent/reactor/tcp_sync_demux_spec.rb

@@ -1,410 +1,410 @@
-require 'spec_helper'
-require 'faker'
-
-module Concurrent
-  class Reactor
-
-    describe TcpSyncDemux, not_on_travis: true do
-
-      subject do
-        @subject = TcpSyncDemux.new(port: 2000 + rand(8000))
-      end
-
-      after(:each) do
-        @subject.stop unless @subject.nil?
-      end
-
-      context '#initialize' do
-
-        it 'sets the initial state to :stopped' do
-          subject.should_not be_running
-        end
-
-        it 'raises an exception if already runed' do
-          subject.run
-
-          lambda {
-            subject.run
-          }.should raise_error(StandardError)
-        end
-
-        it 'uses the given host' do
-          demux = TcpSyncDemux.new(host: 'www.foobar.com')
-          demux.host.should eq 'www.foobar.com'
-          demux.stop
-        end
-
-        it 'uses the default host when none is given' do
-          demux = TcpSyncDemux.new
-          demux.host.should eq TcpSyncDemux::DEFAULT_HOST
-          demux.stop
-        end
-
-        it 'uses the given port' do
-          demux = TcpSyncDemux.new(port: 4242)
-          demux.port.should eq 4242
-          demux.stop
-        end
-
-        it 'uses the default port when none is given' do
-          demux = TcpSyncDemux.new
-          demux.port.should eq TcpSyncDemux::DEFAULT_PORT
-          demux.stop
-        end
-
-        it 'uses the given ACL' do
-          acl = %w[deny all]
-          ACL.should_receive(:new).with(acl).and_return(acl)
-          demux = TcpSyncDemux.new(acl: acl)
-          demux.acl.should eq acl
-          demux.stop
-        end
-
-        it 'uses the default ACL when given' do
-          acl = TcpSyncDemux::DEFAULT_ACL
-          ACL.should_receive(:new).with(acl).and_return(acl)
-          demux = TcpSyncDemux.new
-          demux.acl.should eq acl
-          demux.stop
-        end
-      end
-
-      context '#run' do
-
-        it 'creates a new TCP server' do
-          TCPServer.should_receive(:new).with(TcpSyncDemux::DEFAULT_HOST, anything())
-          subject.run
-        end
-
-        it 'returns true on success' do
-          TCPServer.stub(:new).with(TcpSyncDemux::DEFAULT_HOST, anything())
-          subject.run.should be_true
-        end
-
-        it 'returns false on failure' do
-          TCPServer.stub(:new).with(TcpSyncDemux::DEFAULT_HOST, anything()) \
-            .and_raise(StandardError)
-          subject.run.should be_false
-        end
-
-        it 'raises an exception when already running' do
-          subject.run
-          lambda {
-            subject.run
-          }.should raise_error
-        end
-      end
-
-      context '#stop' do
-
-        let(:server){ double('tcp server') }
-        let(:socket){ double('tcp socket') }
-
-        before(:each) do
-          socket.stub(:close).with(no_args())
-          server.stub(:close).with(no_args())
-          subject.run
-          subject.instance_variable_set(:@socket, socket)
-          subject.instance_variable_set(:@server, server)
-        end
-
-        it 'immediately returns true when not running' do
-          socket.should_not_receive(:close)
-          server.should_not_receive(:close)
-          demux = TcpSyncDemux.new
-          demux.stop.should be_true
-        end
-
-        it 'closes the socket' do
-          socket.should_receive(:close).with(no_args())
-          subject.stop
-        end
-
-        it 'closes the TCP server' do
-          server.should_receive(:close).with(no_args())
-          subject.stop
-        end
-
-        it 'is supresses socket close exceptions' do
-          socket.should_receive(:close).and_raise(SocketError)
-          lambda {
-            subject.stop
-          }.should_not raise_error
-        end
-
-        it 'supresses server close exceptions' do
-          server.should_receive(:close).and_raise(SocketError)
-          lambda {
-            subject.stop
-          }.should_not raise_error
-        end
-      end
-
-      context '#running?' do
-
-        it 'returns false when stopped' do
-          subject.run
-          sleep(0.1)
-          subject.stop
-          sleep(0.1)
-          subject.should_not be_running
-        end
-
-        it 'returns true when running' do
-          subject.run
-          sleep(0.1)
-          subject.should be_running
-        end
-      end
-
-      context '#reset' do
-
-        it 'closes the demux' do
-          subject.should_receive(:run).exactly(2).times.and_return(true)
-          subject.run
-          sleep(0.1)
-          subject.reset
-        end
-
-        it 'starts the demux' do
-          # add one call to #stop for the :after clause
-          subject.should_receive(:stop).exactly(2).times.and_return(true)
-          sleep(0.1)
-          subject.reset
-        end
-      end
-
-      context '#accept' do
-
-        let!(:event){ :echo }
-        let!(:message){ 'hello world' }
-
-        def setup_demux
-          @demux = TcpSyncDemux.new(host: 'localhost', port: 5555, acl: %w[allow all])
-          @demux.run
-        end
-
-        def send_event_message
-          there = TCPSocket.open('localhost', 5555)
-          @thread = Thread.new do
-            there.puts(@demux.format_message(event, message))
-          end
-
-          @expected = nil
-          Timeout::timeout(2) do
-            @expected = @demux.accept
-          end
-          @thread.join(1)
-        end
-
-        after(:each) do
-          @demux.stop unless @demux.nil?
-          Thread.kill(@thread) unless @thread.nil?
-          @expected = @demux = @thread = nil
-        end
-
-        it 'returns a correct EventContext object' do
-          setup_demux
-          send_event_message
-          @expected.should be_a(EventContext)
-          @expected.event.should eq :echo
-          @expected.args.should eq ['hello world']
-          @expected.callback.should be_nil
-        end
-
-        it 'returns nil on exception' do
-          setup_demux
-          @demux.should_receive(:get_message).with(any_args()).and_raise(StandardError)
-          send_event_message
-          @expected.should be_nil
-        end
-
-        it 'returns nil if the ACL rejects the client' do
-          acl = double('acl')
-          acl.should_receive(:allow_socket?).with(anything()).and_return(false)
-          ACL.should_receive(:new).with(anything()).and_return(acl)
-          setup_demux
-          send_event_message
-          @expected.should be_nil
-        end
-
-        it 'resets the demux on exception' do
-          setup_demux
-          @demux.should_receive(:get_message).with(any_args()).and_raise(StandardError)
-          @demux.should_receive(:reset).with(no_args())
-          send_event_message
-        end
-      end
-
-      context '#respond' do
-
-        it 'returns nil if the socket is nil' do
-          subject.stop
-          subject.respond(:ok, 'foo').should be_nil
-        end
-
-        it 'puts a message on the socket' do
-          socket = double('tcp socket')
-          socket.should_receive(:puts).with("ok\r\necho\r\n\r\n")
-          subject.instance_variable_set(:@socket, socket)
-          subject.respond(:ok, 'echo')
-        end
-
-        it 'resets the demux on exception' do
-          socket = double('tcp socket')
-          socket.should_receive(:puts).and_raise(SocketError)
-          subject.instance_variable_set(:@socket, socket)
-          subject.should_receive(:reset)
-          subject.respond(:ok, 'echo')
-        end
-      end
-
-      context '#format_message' do
-
-        it 'raises an exception when the event is nil' do
-          lambda {
-            subject.format_message(nil)
-          }.should raise_error(ArgumentError)
-
-          lambda {
-            TcpSyncDemux.format_message(nil)
-          }.should raise_error(ArgumentError)
-        end
-
-        it 'raises an exception when the event is an empty string' do
-          lambda {
-            subject.format_message('  ')
-          }.should raise_error(ArgumentError)
-
-          lambda {
-            TcpSyncDemux.format_message('   ')
-          }.should raise_error(ArgumentError)
-        end
-
-        it 'creates a message with no arguments' do
-          message = subject.format_message(:echo)
-          message.should eq "echo\r\n\r\n"
-
-          message = TcpSyncDemux.format_message('echo')
-          message.should eq "echo\r\n\r\n"
-        end
-
-        it 'creates a message with arguments' do
-          message = subject.format_message(:echo, 'hello', 'world')
-          message.should eq "echo\r\nhello\r\nworld\r\n\r\n"
-
-          message = TcpSyncDemux.format_message('echo', 'hello', 'world')
-          message.should eq "echo\r\nhello\r\nworld\r\n\r\n"
-        end
-      end
-
-      context '#parse_message' do
-
-        it 'accepts the message as a string' do
-          message = subject.parse_message("echo\r\nhello world\r\n\r\n")
-          message.should_not eq [nil, nil]
-        end
-
-        it 'accepts the message as an array of lines' do
-          message = subject.parse_message(%w[echo hello world])
-          message.should_not eq [nil, nil]
-        end
-
-        it 'recognizes an event name beginning with a colon' do
-          message = subject.parse_message(":echo\r\nhello world\r\n\r\n")
-          message.first.should eq :echo
-
-          message = TcpSyncDemux.parse_message(%w[:echo hello world])
-          message.first.should eq :echo
-        end
-
-        it 'recognizes an event name without a beginning colon' do
-          message = subject.parse_message(%w[echo hello world])
-          message.first.should eq :echo
-
-          message = TcpSyncDemux.parse_message("echo\r\nhello world\r\n\r\n")
-          message.first.should eq :echo
-        end
-
-        it 'parses a message without arguments' do
-          message = subject.parse_message("echo\r\n\r\n")
-          message.first.should eq :echo
-
-          message = TcpSyncDemux.parse_message(%w[echo])
-          message.first.should eq :echo
-        end
-
-        it 'parses a message with arguments' do
-          message = subject.parse_message(%w[echo hello world])
-          message.last.should eq %w[hello world]
-
-          message = TcpSyncDemux.parse_message("echo\r\nhello world\r\n\r\n")
-          message.last.should eq ['hello world']
-        end
-
-        it 'returns nil for a malformed message' do
-          message = subject.parse_message(nil)
-          message.should eq [nil, []]
-
-          message = subject.parse_message('    ')
-          message.should eq [nil, []]
-        end
-      end
-
-      specify 'integration', not_on_travis: true do
-
-        # server
-        demux = Concurrent::Reactor::TcpSyncDemux.new
-        reactor = Concurrent::Reactor.new(demux)
-
-        reactor.add_handler(:echo) {|*args| args.first }
-        reactor.add_handler(:error) {|*args| raise StandardError.new(args.first) }
-        reactor.add_handler(:unknown) {|*args| args.first }
-        reactor.add_handler(:abend) {|*args| args.first }
-
-        t = Thread.new { reactor.run }
-        sleep(0.1)
-
-        # client
-        there = TCPSocket.open(TcpSyncDemux::DEFAULT_HOST, TcpSyncDemux::DEFAULT_PORT)
-
-        # test :ok
-        10.times do
-          message = Faker::Company.bs
-          there.puts(Concurrent::Reactor::TcpSyncDemux.format_message(:echo, message))
-          result, echo = Concurrent::Reactor::TcpSyncDemux.get_message(there)
-          result.should eq :ok
-          echo.first.should eq message
-        end
-
-        # test :ex
-        there.puts(Concurrent::Reactor::TcpSyncDemux.format_message(:error, 'error'))
-        result, echo = Concurrent::Reactor::TcpSyncDemux.get_message(there)
-        result.should eq :ex
-        echo.first.should eq 'error'
-
-        # test :noop
-        there.puts(Concurrent::Reactor::TcpSyncDemux.format_message(:bogus, 'bogus'))
-        result, echo = Concurrent::Reactor::TcpSyncDemux.get_message(there)
-        result.should eq :noop
-        echo.first.should =~ /bogus/
-
-        # test handler error
-        ex = ArgumentError.new('abend')
-        ec = Reactor::EventContext.new(:abend, [])
-        Reactor::EventContext.should_receive(:new).with(:abend, []).and_return(ec)
-        reactor.should_receive(:handle_event).with(ec).and_raise(ex)
-        there.puts(Concurrent::Reactor::TcpSyncDemux.format_message(:abend))
-        result, echo = Concurrent::Reactor::TcpSyncDemux.get_message(there)
-        result.should eq :abend
-        echo.first.should eq 'abend'
-
-        #cleanup
-        reactor.stop
-        sleep(0.1)
-        Thread.kill(t)
-        sleep(0.1)
-      end
-    end
-  end
-end
+require 'spec_helper'
+require 'faker'
+
+module Concurrent
+  class Reactor
+
+    describe TcpSyncDemux, not_on_travis: true do
+
+      subject do
+        @subject = TcpSyncDemux.new(port: 2000 + rand(8000))
+      end
+
+      after(:each) do
+        @subject.stop unless @subject.nil?
+      end
+
+      context '#initialize' do
+
+        it 'sets the initial state to :stopped' do
+          subject.should_not be_running
+        end
+
+        it 'raises an exception if already runed' do
+          subject.run
+
+          lambda {
+            subject.run
+          }.should raise_error(StandardError)
+        end
+
+        it 'uses the given host' do
+          demux = TcpSyncDemux.new(host: 'www.foobar.com')
+          demux.host.should eq 'www.foobar.com'
+          demux.stop
+        end
+
+        it 'uses the default host when none is given' do
+          demux = TcpSyncDemux.new
+          demux.host.should eq TcpSyncDemux::DEFAULT_HOST
+          demux.stop
+        end
+
+        it 'uses the given port' do
+          demux = TcpSyncDemux.new(port: 4242)
+          demux.port.should eq 4242
+          demux.stop
+        end
+
+        it 'uses the default port when none is given' do
+          demux = TcpSyncDemux.new
+          demux.port.should eq TcpSyncDemux::DEFAULT_PORT
+          demux.stop
+        end
+
+        it 'uses the given ACL' do
+          acl = %w[deny all]
+          ACL.should_receive(:new).with(acl).and_return(acl)
+          demux = TcpSyncDemux.new(acl: acl)
+          demux.acl.should eq acl
+          demux.stop
+        end
+
+        it 'uses the default ACL when given' do
+          acl = TcpSyncDemux::DEFAULT_ACL
+          ACL.should_receive(:new).with(acl).and_return(acl)
+          demux = TcpSyncDemux.new
+          demux.acl.should eq acl
+          demux.stop
+        end
+      end
+
+      context '#run' do
+
+        it 'creates a new TCP server' do
+          TCPServer.should_receive(:new).with(TcpSyncDemux::DEFAULT_HOST, anything())
+          subject.run
+        end
+
+        it 'returns true on success' do
+          TCPServer.stub(:new).with(TcpSyncDemux::DEFAULT_HOST, anything())
+          subject.run.should be_true
+        end
+
+        it 'returns false on failure' do
+          TCPServer.stub(:new).with(TcpSyncDemux::DEFAULT_HOST, anything()) \
+            .and_raise(StandardError)
+          subject.run.should be_false
+        end
+
+        it 'raises an exception when already running' do
+          subject.run
+          lambda {
+            subject.run
+          }.should raise_error
+        end
+      end
+
+      context '#stop' do
+
+        let(:server){ double('tcp server') }
+        let(:socket){ double('tcp socket') }
+
+        before(:each) do
+          socket.stub(:close).with(no_args())
+          server.stub(:close).with(no_args())
+          subject.run
+          subject.instance_variable_set(:@socket, socket)
+          subject.instance_variable_set(:@server, server)
+        end
+
+        it 'immediately returns true when not running' do
+          socket.should_not_receive(:close)
+          server.should_not_receive(:close)
+          demux = TcpSyncDemux.new
+          demux.stop.should be_true
+        end
+
+        it 'closes the socket' do
+          socket.should_receive(:close).with(no_args())
+          subject.stop
+        end
+
+        it 'closes the TCP server' do
+          server.should_receive(:close).with(no_args())
+          subject.stop
+        end
+
+        it 'is supresses socket close exceptions' do
+          socket.should_receive(:close).and_raise(SocketError)
+          lambda {
+            subject.stop
+          }.should_not raise_error
+        end
+
+        it 'supresses server close exceptions' do
+          server.should_receive(:close).and_raise(SocketError)
+          lambda {
+            subject.stop
+          }.should_not raise_error
+        end
+      end
+
+      context '#running?' do
+
+        it 'returns false when stopped' do
+          subject.run
+          sleep(0.1)
+          subject.stop
+          sleep(0.1)
+          subject.should_not be_running
+        end
+
+        it 'returns true when running' do
+          subject.run
+          sleep(0.1)
+          subject.should be_running
+        end
+      end
+
+      context '#reset' do
+
+        it 'closes the demux' do
+          subject.should_receive(:run).exactly(2).times.and_return(true)
+          subject.run
+          sleep(0.1)
+          subject.reset
+        end
+
+        it 'starts the demux' do
+          # add one call to #stop for the :after clause
+          subject.should_receive(:stop).exactly(2).times.and_return(true)
+          sleep(0.1)
+          subject.reset
+        end
+      end
+
+      context '#accept' do
+
+        let!(:event){ :echo }
+        let!(:message){ 'hello world' }
+
+        def setup_demux
+          @demux = TcpSyncDemux.new(host: 'localhost', port: 5555, acl: %w[allow all])
+          @demux.run
+        end
+
+        def send_event_message
+          there = TCPSocket.open('localhost', 5555)
+          @thread = Thread.new do
+            there.puts(@demux.format_message(event, message))
+          end
+
+          @expected = nil
+          Timeout::timeout(2) do
+            @expected = @demux.accept
+          end
+          @thread.join(1)
+        end
+
+        after(:each) do
+          @demux.stop unless @demux.nil?
+          Thread.kill(@thread) unless @thread.nil?
+          @expected = @demux = @thread = nil
+        end
+
+        it 'returns a correct EventContext object' do
+          setup_demux
+          send_event_message
+          @expected.should be_a(EventContext)
+          @expected.event.should eq :echo
+          @expected.args.should eq ['hello world']
+          @expected.callback.should be_nil
+        end
+
+        it 'returns nil on exception' do
+          setup_demux
+          @demux.should_receive(:get_message).with(any_args()).and_raise(StandardError)
+          send_event_message
+          @expected.should be_nil
+        end
+
+        it 'returns nil if the ACL rejects the client' do
+          acl = double('acl')
+          acl.should_receive(:allow_socket?).with(anything()).and_return(false)
+          ACL.should_receive(:new).with(anything()).and_return(acl)
+          setup_demux
+          send_event_message
+          @expected.should be_nil
+        end
+
+        it 'resets the demux on exception' do
+          setup_demux
+          @demux.should_receive(:get_message).with(any_args()).and_raise(StandardError)
+          @demux.should_receive(:reset).with(no_args())
+          send_event_message
+        end
+      end
+
+      context '#respond' do
+
+        it 'returns nil if the socket is nil' do
+          subject.stop
+          subject.respond(:ok, 'foo').should be_nil
+        end
+
+        it 'puts a message on the socket' do
+          socket = double('tcp socket')
+          socket.should_receive(:puts).with("ok\r\necho\r\n\r\n")
+          subject.instance_variable_set(:@socket, socket)
+          subject.respond(:ok, 'echo')
+        end
+
+        it 'resets the demux on exception' do
+          socket = double('tcp socket')
+          socket.should_receive(:puts).and_raise(SocketError)
+          subject.instance_variable_set(:@socket, socket)
+          subject.should_receive(:reset)
+          subject.respond(:ok, 'echo')
+        end
+      end
+
+      context '#format_message' do
+
+        it 'raises an exception when the event is nil' do
+          lambda {
+            subject.format_message(nil)
+          }.should raise_error(ArgumentError)
+
+          lambda {
+            TcpSyncDemux.format_message(nil)
+          }.should raise_error(ArgumentError)
+        end
+
+        it 'raises an exception when the event is an empty string' do
+          lambda {
+            subject.format_message('  ')
+          }.should raise_error(ArgumentError)
+
+          lambda {
+            TcpSyncDemux.format_message('   ')
+          }.should raise_error(ArgumentError)
+        end
+
+        it 'creates a message with no arguments' do
+          message = subject.format_message(:echo)
+          message.should eq "echo\r\n\r\n"
+
+          message = TcpSyncDemux.format_message('echo')
+          message.should eq "echo\r\n\r\n"
+        end
+
+        it 'creates a message with arguments' do
+          message = subject.format_message(:echo, 'hello', 'world')
+          message.should eq "echo\r\nhello\r\nworld\r\n\r\n"
+
+          message = TcpSyncDemux.format_message('echo', 'hello', 'world')
+          message.should eq "echo\r\nhello\r\nworld\r\n\r\n"
+        end
+      end
+
+      context '#parse_message' do
+
+        it 'accepts the message as a string' do
+          message = subject.parse_message("echo\r\nhello world\r\n\r\n")
+          message.should_not eq [nil, nil]
+        end
+
+        it 'accepts the message as an array of lines' do
+          message = subject.parse_message(%w[echo hello world])
+          message.should_not eq [nil, nil]
+        end
+
+        it 'recognizes an event name beginning with a colon' do
+          message = subject.parse_message(":echo\r\nhello world\r\n\r\n")
+          message.first.should eq :echo
+
+          message = TcpSyncDemux.parse_message(%w[:echo hello world])
+          message.first.should eq :echo
+        end
+
+        it 'recognizes an event name without a beginning colon' do
+          message = subject.parse_message(%w[echo hello world])
+          message.first.should eq :echo
+
+          message = TcpSyncDemux.parse_message("echo\r\nhello world\r\n\r\n")
+          message.first.should eq :echo
+        end
+
+        it 'parses a message without arguments' do
+          message = subject.parse_message("echo\r\n\r\n")
+          message.first.should eq :echo
+
+          message = TcpSyncDemux.parse_message(%w[echo])
+          message.first.should eq :echo
+        end
+
+        it 'parses a message with arguments' do
+          message = subject.parse_message(%w[echo hello world])
+          message.last.should eq %w[hello world]
+
+          message = TcpSyncDemux.parse_message("echo\r\nhello world\r\n\r\n")
+          message.last.should eq ['hello world']
+        end
+
+        it 'returns nil for a malformed message' do
+          message = subject.parse_message(nil)
+          message.should eq [nil, []]
+
+          message = subject.parse_message('    ')
+          message.should eq [nil, []]
+        end
+      end
+
+      specify 'integration', not_on_travis: true do
+
+        # server
+        demux = Concurrent::Reactor::TcpSyncDemux.new
+        reactor = Concurrent::Reactor.new(demux)
+
+        reactor.add_handler(:echo) {|*args| args.first }
+        reactor.add_handler(:error) {|*args| raise StandardError.new(args.first) }
+        reactor.add_handler(:unknown) {|*args| args.first }
+        reactor.add_handler(:abend) {|*args| args.first }
+
+        t = Thread.new { reactor.run }
+        sleep(0.1)
+
+        # client
+        there = TCPSocket.open(TcpSyncDemux::DEFAULT_HOST, TcpSyncDemux::DEFAULT_PORT)
+
+        # test :ok
+        10.times do
+          message = Faker::Company.bs
+          there.puts(Concurrent::Reactor::TcpSyncDemux.format_message(:echo, message))
+          result, echo = Concurrent::Reactor::TcpSyncDemux.get_message(there)
+          result.should eq :ok
+          echo.first.should eq message
+        end
+
+        # test :ex
+        there.puts(Concurrent::Reactor::TcpSyncDemux.format_message(:error, 'error'))
+        result, echo = Concurrent::Reactor::TcpSyncDemux.get_message(there)
+        result.should eq :ex
+        echo.first.should eq 'error'
+
+        # test :noop
+        there.puts(Concurrent::Reactor::TcpSyncDemux.format_message(:bogus, 'bogus'))
+        result, echo = Concurrent::Reactor::TcpSyncDemux.get_message(there)
+        result.should eq :noop
+        echo.first.should =~ /bogus/
+
+        # test handler error
+        ex = ArgumentError.new('abend')
+        ec = Reactor::EventContext.new(:abend, [])
+        Reactor::EventContext.should_receive(:new).with(:abend, []).and_return(ec)
+        reactor.should_receive(:handle_event).with(ec).and_raise(ex)
+        there.puts(Concurrent::Reactor::TcpSyncDemux.format_message(:abend))
+        result, echo = Concurrent::Reactor::TcpSyncDemux.get_message(there)
+        result.should eq :abend
+        echo.first.should eq 'abend'
+
+        #cleanup
+        reactor.stop
+        sleep(0.1)
+        Thread.kill(t)
+        sleep(0.1)
+      end
+    end
+  end
+end