punchblock 0.7.1 → 0.7.2

data/spec/punchblock/component/tropo/ask_spec.rb

@@ -31,9 +31,19 @@ module Punchblock
           its(:timeout)         { should == 12000 }
         end
 
+        def grxml_doc(mode = :dtmf)
+          RubySpeech::GRXML.draw :mode => mode.to_s, :root => 'digits' do
+            rule id: 'digits' do
+              one_of do
+                0.upto(1) { |d| item { d.to_s } }
+              end
+            end
+          end
+        end
+
         describe Ask::Choices do
           describe "when not passing a grammar" do
-            subject { Ask::Choices.new :value => '[5 DIGITS]' }
+            subject { Ask::Choices.new :value => grxml_doc }
             its(:content_type) { should == 'application/grammar+grxml' }
           end
 
@@ -47,43 +57,30 @@ module Punchblock
             end
           end
 
-          describe 'with a GRXML grammar' do
-            subject { Ask::Choices.new :value => grxml, :content_type => 'application/grammar+grxml' }
-
-            let :grxml do
-              <<-GRXML
-<grammar xmlns="http://www.w3.org/2001/06/grammar" root="MAINRULE">
-  <rule id="MAINRULE">
-    <one-of>
-      <item>
-        <item repeat="0-1"> need a</item>
-        <item repeat="0-1"> i need a</item>
-          <one-of>
-            <item> clue </item>
-          </one-of>
-        <tag> out.concept = "clue";</tag>
-      </item>
-      <item>
-        <item repeat="0-1"> have an</item>
-        <item repeat="0-1"> i have an</item>
-          <one-of>
-            <item> answer </item>
-          </one-of>
-        <tag> out.concept = "answer";</tag>
-      </item>
-    </one-of>
-  </rule>
-</grammar>
-              GRXML
-            end
+        describe 'with a GRXML grammar' do
+          subject { Ask::Choices.new :value => grxml_doc, :content_type => 'application/grammar+grxml' }
 
-            let(:expected_message) { "<![CDATA[ #{grxml} ]]>" }
+          its(:content_type) { should == 'application/grammar+grxml' }
 
-            it "should wrap GRXML in CDATA" do
-              subject.child.to_xml.should == expected_message.strip
-            end
+          let(:expected_message) { "<![CDATA[ #{grxml_doc} ]]>" }
+
+          it "should wrap GRXML in CDATA" do
+            subject.child.to_xml.should == expected_message.strip
+          end
+
+          its(:value) { should == grxml_doc }
+
+          describe "comparison" do
+            let(:grammar2) { Ask::Choices.new :value => '<grammar xmlns="http://www.w3.org/2001/06/grammar" version="1.0" xml:lang="en-US" mode="dtmf" root="digits"><rule id="digits"><one-of><item>0</item><item>1</item></one-of></rule></grammar>' }
+            let(:grammar3) { Ask::Choices.new :value => grxml_doc }
+            let(:grammar4) { Ask::Choices.new :value => grxml_doc(:speech) }
+
+            it { should == grammar2 }
+            it { should == grammar3 }
+            it { should_not == grammar4 }
           end
         end
+      end
 
         describe "actions" do
           let(:mock_client) { mock 'Client' }

data/spec/punchblock/connection/xmpp_spec.rb

@@ -3,7 +3,8 @@ require 'spec_helper'
 module Punchblock
   module Connection
     describe XMPP do
-      let(:connection) { XMPP.new :username => '1@call.rayo.net', :password => 1 }
+      let(:options)     { { :root_domain => 'rayo.net' } }
+      let(:connection)  { XMPP.new({:username => '1@app.rayo.net', :password => 1}.merge(options)) }
 
       let(:mock_event_handler) { stub_everything 'Event Handler' }
 
@@ -13,6 +14,48 @@ module Punchblock
 
       subject { connection }
 
+      describe "rayo domains" do
+        context "with no domains specified, and a JID of 1@app.rayo.net" do
+          let(:options) { { :username => '1@app.rayo.net' } }
+
+          its(:root_domain)   { should == 'app.rayo.net' }
+          its(:calls_domain)   { should == 'calls.app.rayo.net' }
+          its(:mixers_domain)  { should == 'mixers.app.rayo.net' }
+        end
+
+        context "with only a rayo domain set" do
+          let(:options) { { :rayo_domain => 'rayo.org' } }
+
+          its(:root_domain)   { should == 'rayo.org' }
+          its(:calls_domain)   { should == 'calls.rayo.org' }
+          its(:mixers_domain)  { should == 'mixers.rayo.org' }
+        end
+
+        context "with only a root domain set" do
+          let(:options) { { :root_domain => 'rayo.org' } }
+
+          its(:root_domain)   { should == 'rayo.org' }
+          its(:calls_domain)   { should == 'calls.rayo.org' }
+          its(:mixers_domain)  { should == 'mixers.rayo.org' }
+        end
+
+        context "with a root domain and calls domain set" do
+          let(:options) { { :root_domain => 'rayo.org', :calls_domain => 'phone_calls.rayo.org' } }
+
+          its(:root_domain)   { should == 'rayo.org' }
+          its(:calls_domain)   { should == 'phone_calls.rayo.org' }
+          its(:mixers_domain)  { should == 'mixers.rayo.org' }
+        end
+
+        context "with a root domain and mixers domain set" do
+          let(:options) { { :root_domain => 'rayo.org', :mixers_domain => 'conferences.rayo.org' } }
+
+          its(:root_domain)   { should == 'rayo.org' }
+          its(:calls_domain)   { should == 'calls.rayo.org' }
+          its(:mixers_domain)  { should == 'conferences.rayo.org' }
+        end
+      end
+
       it 'should require a username and password to be passed in the options' do
         expect { XMPP.new :password => 1 }.to raise_error ArgumentError
         expect { XMPP.new :username => 1 }.to raise_error ArgumentError
@@ -84,7 +127,7 @@ module Punchblock
       it 'should send a "Chat" presence when ready' do
         client = connection.send :client
         client.expects(:write).once.with do |stanza|
-          stanza.to.should == 'call.rayo.net' &&
+          stanza.to.should == 'rayo.net' &&
             stanza.is_a?(Blather::Stanza::Presence::Status) &&
             stanza.chat?
         end
@@ -94,7 +137,7 @@ module Punchblock
       it 'should send a "Do Not Disturb" presence when not_ready' do
         client = connection.send :client
         client.expects(:write).once.with do |stanza|
-          stanza.to.should == 'call.rayo.net' &&
+          stanza.to.should == 'rayo.net' &&
             stanza.is_a?(Blather::Stanza::Presence::Status) &&
             stanza.dnd?
         end
@@ -200,6 +243,65 @@ module Punchblock
         its(:name)          { should == :item_not_found }
         its(:text)          { should == 'Could not find call [id=f6d437f4-1e18-457b-99f8-b5d853f50347]' }
       end
+
+      describe "#prep_command_for_execution" do
+        let(:stanza) { subject.prep_command_for_execution command }
+
+        context "with a dial command" do
+          let(:command)       { Command::Dial.new }
+          let(:expected_jid)  { 'rayo.net' }
+
+          it "should use the correct JID" do
+            stanza = subject.prep_command_for_execution command
+            stanza.to.should == expected_jid
+          end
+        end
+
+        context "with a call command" do
+          let(:command)       { Command::Answer.new.tap { |a| a.call_id = 'abc123' } }
+          let(:expected_jid)  { 'abc123@calls.rayo.net' }
+
+          it "should use the correct JID" do
+            stanza.to.should == expected_jid
+          end
+        end
+
+        context "with a call component" do
+          let(:command)       { Component::Output.new :call_id => 'abc123' }
+          let(:expected_jid)  { 'abc123@calls.rayo.net' }
+
+          it "should use the correct JID" do
+            stanza.to.should == expected_jid
+          end
+        end
+
+        context "with a call component command" do
+          let(:command)       { Component::Stop.new :call_id => 'abc123', :component_id => 'foobar' }
+          let(:expected_jid)  { 'abc123@calls.rayo.net/foobar' }
+
+          it "should use the correct JID" do
+            stanza.to.should == expected_jid
+          end
+        end
+
+        context "with a mixer component" do
+          let(:command)       { Component::Output.new :mixer_name => 'abc123' }
+          let(:expected_jid)  { 'abc123@mixers.rayo.net' }
+
+          it "should use the correct JID" do
+            stanza.to.should == expected_jid
+          end
+        end
+
+        context "with a mixer component command" do
+          let(:command)       { Component::Stop.new :mixer_name => 'abc123', :component_id => 'foobar' }
+          let(:expected_jid)  { 'abc123@mixers.rayo.net/foobar' }
+
+          it "should use the correct JID" do
+            stanza.to.should == expected_jid
+          end
+        end
+      end
     end # describe XMPP
   end # XMPP
 end # Punchblock

data/spec/punchblock/event/joined_spec.rb

@@ -8,7 +8,7 @@ module Punchblock
       end
 
       describe "from a stanza" do
-        let(:stanza) { '<joined xmlns="urn:xmpp:rayo:1" call-id="b" mixer-id="m" />' }
+        let(:stanza) { '<joined xmlns="urn:xmpp:rayo:1" call-id="b" mixer-name="m" />' }
 
         subject { RayoNode.import parse_stanza(stanza).root, '9f00061', '1' }
 
@@ -17,15 +17,15 @@ module Punchblock
         it_should_behave_like 'event'
 
         its(:other_call_id) { should == 'b' }
-        its(:mixer_id)      { should == 'm' }
+        its(:mixer_name)    { should == 'm' }
         its(:xmlns)         { should == 'urn:xmpp:rayo:1' }
       end
 
       describe "when setting options in initializer" do
-        subject { Joined.new :other_call_id => 'abc123', :mixer_id => 'blah' }
+        subject { Joined.new :other_call_id => 'abc123', :mixer_name => 'blah' }
 
         its(:other_call_id) { should == 'abc123' }
-        its(:mixer_id)      { should == 'blah' }
+        its(:mixer_name)    { should == 'blah' }
       end
     end
   end

data/spec/punchblock/event/unjoined_spec.rb

@@ -8,7 +8,7 @@ module Punchblock
       end
 
       describe "from a stanza" do
-        let(:stanza) { '<unjoined xmlns="urn:xmpp:rayo:1" call-id="b" mixer-id="m" />' }
+        let(:stanza) { '<unjoined xmlns="urn:xmpp:rayo:1" call-id="b" mixer-name="m" />' }
 
         subject { RayoNode.import parse_stanza(stanza).root, '9f00061', '1' }
 
@@ -17,15 +17,15 @@ module Punchblock
         it_should_behave_like 'event'
 
         its(:other_call_id) { should == 'b' }
-        its(:mixer_id)      { should == 'm' }
+        its(:mixer_name)    { should == 'm' }
         its(:xmlns)         { should == 'urn:xmpp:rayo:1' }
       end
 
       describe "when setting options in initializer" do
-        subject { Unjoined.new :other_call_id => 'abc123', :mixer_id => 'blah' }
+        subject { Unjoined.new :other_call_id => 'abc123', :mixer_name => 'blah' }
 
         its(:other_call_id) { should == 'abc123' }
-        its(:mixer_id)      { should == 'blah' }
+        its(:mixer_name)    { should == 'blah' }
       end
     end
   end

data/spec/punchblock/protocol_error_spec.rb

@@ -2,8 +2,39 @@ require 'spec_helper'
 
 module Punchblock
   describe ProtocolError do
-    subject { ProtocolError.new :item_not_found, 'Could not find call [id=f6d437f4-1e18-457b-99f8-b5d853f50347]', 'f6d437f4-1e18-457b-99f8-b5d853f50347', 'abc123' }
+    let(:name)          { :item_not_found }
+    let(:text)          { 'Could not find call [id=f6d437f4-1e18-457b-99f8-b5d853f50347]' }
+    let(:call_id)       { 'f6d437f4-1e18-457b-99f8-b5d853f50347' }
+    let(:component_id)  { 'abc123' }
+    subject { ProtocolError.new name, text, call_id, component_id }
 
     its(:inspect) { should == '#<Punchblock::ProtocolError: name=:item_not_found text="Could not find call [id=f6d437f4-1e18-457b-99f8-b5d853f50347]" call_id="f6d437f4-1e18-457b-99f8-b5d853f50347" component_id="abc123">' }
+
+    describe "comparison" do
+      context "with the same name, text, call ID and component ID" do
+        let(:comparison) { ProtocolError.new name, text, call_id, component_id }
+        it { should == comparison }
+      end
+
+      context "with a different name" do
+        let(:comparison) { ProtocolError.new :foo, text, call_id, component_id }
+        it { should_not == comparison }
+      end
+
+      context "with a different text" do
+        let(:comparison) { ProtocolError.new name, 'foo', call_id, component_id }
+        it { should_not == comparison }
+      end
+
+      context "with a different call ID" do
+        let(:comparison) { ProtocolError.new name, text, 'foo', component_id }
+        it { should_not == comparison }
+      end
+
+      context "with a different component ID" do
+        let(:comparison) { ProtocolError.new name, text, call_id, 'foo' }
+        it { should_not == comparison }
+      end
+    end
   end
 end

data/spec/punchblock/translator/asterisk/call_spec.rb

@@ -106,7 +106,7 @@ module Punchblock
           end
 
           context 'with an event for a known AGI command component' do
-            let(:mock_component_node) { mock 'Punchblock::Component::Asterisk::AGI::Command', :name => 'EXEC ANSWER' }
+            let(:mock_component_node) { mock 'Punchblock::Component::Asterisk::AGI::Command', :name => 'EXEC ANSWER', :params_array => [] }
             let :component do
               Component::Asterisk::AGICommand.new mock_component_node, subject.translator
             end
@@ -183,20 +183,34 @@ module Punchblock
             end
           end
 
-          context 'with a component' do
+          context 'with an AGI command component' do
             let :command do
               Punchblock::Component::Asterisk::AGI::Command.new :name => 'Answer'
             end
 
             let(:mock_action) { mock 'Component::Asterisk::AGI::Command', :id => 'foo' }
 
-            it 'should create a component actor and execute it asynchronously' do
+            it 'should create an AGI command component actor and execute it asynchronously' do
               Component::Asterisk::AGICommand.expects(:new).once.with(command, subject).returns mock_action
               mock_action.expects(:execute!).once
               subject.execute_command command
             end
           end
 
+          context 'with an Output component' do
+            let :command do
+              Punchblock::Component::Output.new
+            end
+
+            let(:mock_action) { mock 'Component::Asterisk::Output', :id => 'foo' }
+
+            it 'should create an AGI command component actor and execute it asynchronously' do
+              Component::Asterisk::Output.expects(:new).once.with(command, subject).returns mock_action
+              mock_action.expects(:execute!).once
+              subject.execute_command command
+            end
+          end
+
           context 'with a component command' do
             let(:component_id) { 'foobar' }
 

data/spec/punchblock/translator/asterisk/component/asterisk/agi_command_spec.rb

@@ -27,6 +27,23 @@ module Punchblock
                 mock_call.expects(:send_ami_action!).once.with(expected_action).returns(expected_action)
                 subject.execute
               end
+
+              context 'with some parameters' do
+                let(:params) { [1000, 'foo'] }
+
+                let :expected_action do
+                  RubyAMI::Action.new 'AGI', 'Channel' => channel, 'Command' => 'WAIT FOR DIGIT "1000" "foo"', 'CommandID' => component_id
+                end
+
+                let :command do
+                  Punchblock::Component::Asterisk::AGI::Command.new :name => 'WAIT FOR DIGIT', :params => params
+                end
+
+                it 'should send the appropriate RubyAMI::Action' do
+                  mock_call.expects(:send_ami_action!).once.with(expected_action).returns(expected_action)
+                  subject.execute
+                end
+              end
             end
 
             context 'when the AMI action completes' do

data/spec/punchblock/translator/asterisk/component/asterisk/output_spec.rb

@@ -0,0 +1,489 @@
+require 'spec_helper'
+
+module Punchblock
+  module Translator
+    class Asterisk
+      module Component
+        module Asterisk
+          describe Output do
+            let(:media_engine)    { nil }
+            let(:translator)      { Punchblock::Translator::Asterisk.new mock('AMI'), mock('Client'), media_engine }
+            let(:mock_call)       { mock 'Call', :translator => translator }
+            let(:command_options) { nil }
+
+            let :command do
+              Punchblock::Component::Output.new command_options
+            end
+
+            let :ssml_doc do
+              RubySpeech::SSML.draw do
+                say_as(:interpret_as => :cardinal) { 'FOO' }
+              end
+            end
+
+            let :command_options do
+              { :ssml => ssml_doc }
+            end
+
+            subject { Output.new command, mock_call }
+
+            describe '#execute' do
+              before { command.request! }
+
+              context 'with a media engine of :unimrcp' do
+                let(:media_engine) { :unimrcp }
+
+                let(:audio_filename) { 'http://foo.com/bar.mp3' }
+
+                let :ssml_doc do
+                  RubySpeech::SSML.draw do
+                    audio :src => audio_filename
+                    say_as(:interpret_as => :cardinal) { 'FOO' }
+                  end
+                end
+
+                let(:command_opts) { {} }
+
+                let :command_options do
+                  { :ssml => ssml_doc }.merge(command_opts)
+                end
+
+                def expect_mrcpsynth_with_options(options)
+                  mock_call.expects(:send_agi_action!).once.with do |*args|
+                    args[0].should == 'EXEC MRCPSynth'
+                    args[2].should match options
+                  end
+                end
+
+                it "should execute MRCPSynth" do
+                  mock_call.expects(:send_agi_action!).once.with 'EXEC MRCPSynth', ssml_doc.to_s.squish.gsub(/["\\]/) { |m| "\\#{m}" }, ''
+                  subject.execute
+                end
+
+                it 'should send a complete event when MRCPSynth completes' do
+                  def mock_call.send_agi_action!(*args, &block)
+                    block.call Punchblock::Component::Asterisk::AGI::Command::Complete::Success.new(:code => 200, :result => 1)
+                  end
+                  subject.execute
+                  command.complete_event(0.1).reason.should be_a Punchblock::Component::Output::Complete::Success
+                end
+
+                describe 'ssml' do
+                  context 'unset' do
+                    let(:command_opts) { { :ssml => nil } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'An SSML document is required.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'start-offset' do
+                  context 'unset' do
+                    let(:command_opts) { { :start_offset => nil } }
+                    it 'should not pass any options to MRCPSynth' do
+                      expect_mrcpsynth_with_options(//)
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :start_offset => 10 } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A start_offset value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'start-paused' do
+                  context 'false' do
+                    let(:command_opts) { { :start_paused => false } }
+                    it 'should not pass any options to MRCPSynth' do
+                      expect_mrcpsynth_with_options(//)
+                      subject.execute
+                    end
+                  end
+
+                  context 'true' do
+                    let(:command_opts) { { :start_paused => true } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A start_paused value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'repeat-interval' do
+                  context 'unset' do
+                    let(:command_opts) { { :repeat_interval => nil } }
+                    it 'should not pass any options to MRCPSynth' do
+                      expect_mrcpsynth_with_options(//)
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :repeat_interval => 10 } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A repeat_interval value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'repeat-times' do
+                  context 'unset' do
+                    let(:command_opts) { { :repeat_times => nil } }
+                    it 'should not pass any options to MRCPSynth' do
+                      expect_mrcpsynth_with_options(//)
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :repeat_times => 2 } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A repeat_times value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'max-time' do
+                  context 'unset' do
+                    let(:command_opts) { { :max_time => nil } }
+                    it 'should not pass any options to MRCPSynth' do
+                      expect_mrcpsynth_with_options(//)
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :max_time => 30 } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A max_time value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'voice' do
+                  context 'unset' do
+                    let(:command_opts) { { :voice => nil } }
+                    it 'should not pass the v option to MRCPSynth' do
+                      expect_mrcpsynth_with_options(//)
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :voice => 'alison' } }
+                    it 'should pass the v option to MRCPSynth' do
+                      expect_mrcpsynth_with_options(/v=alison/)
+                      subject.execute
+                    end
+                  end
+                end
+
+                describe 'interrupt_on' do
+                  context "set to nil" do
+                    let(:command_opts) { { :interrupt_on => nil } }
+                    it "should not pass the i option to MRCPSynth" do
+                      expect_mrcpsynth_with_options(//)
+                      subject.execute
+                    end
+                  end
+
+                  context "set to :any" do
+                    let(:command_opts) { { :interrupt_on => :any } }
+                    it "should pass the i option to MRCPSynth" do
+                      expect_mrcpsynth_with_options(/i=any/)
+                      subject.execute
+                    end
+                  end
+
+                  context "set to :dtmf" do
+                    let(:command_opts) { { :interrupt_on => :dtmf } }
+                    it "should pass the i option to MRCPSynth" do
+                      expect_mrcpsynth_with_options(/i=any/)
+                      subject.execute
+                    end
+                  end
+
+                  context "set to :speech" do
+                    let(:command_opts) { { :interrupt_on => :speech } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'An interrupt-on value of speech is unsupported.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+              end
+
+              context 'with a media engine of :asterisk' do
+                let(:media_engine) { :asterisk }
+
+                def expect_stream_file_with_options(options = nil)
+                  mock_call.expects(:send_agi_action!).once.with 'STREAM FILE', audio_filename, options do |*args|
+                    args[2].should == options
+                    subject.continue!
+                    true
+                  end
+                end
+
+                let(:audio_filename) { 'http://foo.com/bar.mp3' }
+
+                let :ssml_doc do
+                  RubySpeech::SSML.draw do
+                    audio :src => audio_filename
+                    say_as(:interpret_as => :cardinal) { 'FOO' }
+                  end
+                end
+
+                let(:command_opts) { {} }
+
+                let :command_options do
+                  { :ssml => ssml_doc }.merge(command_opts)
+                end
+
+                let :command do
+                  Punchblock::Component::Output.new command_options
+                end
+
+                describe 'ssml' do
+                  context 'unset' do
+                    let(:command_opts) { { :ssml => nil } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'An SSML document is required.'
+                      command.response(0.1).should == error
+                    end
+                  end
+
+                  context 'with a single audio SSML node' do
+                    let(:audio_filename) { 'http://foo.com/bar.mp3' }
+                    let :command_options do
+                      {
+                        :ssml => RubySpeech::SSML.draw { audio :src => audio_filename }
+                      }
+                    end
+
+                    it 'should playback the audio file using STREAM FILE' do
+                      expect_stream_file_with_options
+                      subject.execute
+                    end
+
+                    it 'should send a complete event when the file finishes playback' do
+                      def mock_call.send_agi_action!(*args, &block)
+                        block.call Punchblock::Component::Asterisk::AGI::Command::Complete::Success.new(:code => 200, :result => 1)
+                      end
+                      subject.execute
+                      command.complete_event(0.1).reason.should be_a Punchblock::Component::Output::Complete::Success
+                    end
+                  end
+
+                  context 'with multiple audio SSML nodes' do
+                    let(:audio_filename1) { 'http://foo.com/bar.mp3' }
+                    let(:audio_filename2) { 'http://foo.com/baz.mp3' }
+                    let :command_options do
+                      {
+                        :ssml => RubySpeech::SSML.draw do
+                          audio :src => audio_filename1
+                          audio :src => audio_filename2
+                        end
+                      }
+                    end
+
+                    it 'should playback each audio file using STREAM FILE' do
+                      latch = CountDownLatch.new 2
+                      mock_call.expects(:send_agi_action!).once.with 'STREAM FILE', audio_filename1, nil do
+                        subject.continue
+                        true
+                        latch.countdown!
+                      end
+                      mock_call.expects(:send_agi_action!).once.with 'STREAM FILE', audio_filename2, nil do
+                        subject.continue
+                        true
+                        latch.countdown!
+                      end
+                      subject.execute
+                      latch.wait 2
+                      sleep 0.1
+                    end
+
+                    it 'should send a complete event after the final file has finished playback' do
+                      def mock_call.send_agi_action!(*args, &block)
+                        block.call Punchblock::Component::Asterisk::AGI::Command::Complete::Success.new(:code => 200, :result => 1)
+                      end
+                      command.expects(:add_event).once.with do |e|
+                        e.reason.should be_a Punchblock::Component::Output::Complete::Success
+                      end
+                      subject.execute
+                    end
+                  end
+                end
+
+                describe 'start-offset' do
+                  context 'unset' do
+                    let(:command_opts) { { :start_offset => nil } }
+                    it 'should not pass any options to STREAM FILE' do
+                      expect_stream_file_with_options
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :start_offset => 10 } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A start_offset value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'start-paused' do
+                  context 'false' do
+                    let(:command_opts) { { :start_paused => false } }
+                    it 'should not pass any options to STREAM FILE' do
+                      expect_stream_file_with_options
+                      subject.execute
+                    end
+                  end
+
+                  context 'true' do
+                    let(:command_opts) { { :start_paused => true } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A start_paused value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'repeat-interval' do
+                  context 'unset' do
+                    let(:command_opts) { { :repeat_interval => nil } }
+                    it 'should not pass any options to STREAM FILE' do
+                      expect_stream_file_with_options
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :repeat_interval => 10 } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A repeat_interval value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'repeat-times' do
+                  context 'unset' do
+                    let(:command_opts) { { :repeat_times => nil } }
+                    it 'should not pass any options to STREAM FILE' do
+                      expect_stream_file_with_options
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :repeat_times => 2 } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A repeat_times value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'max-time' do
+                  context 'unset' do
+                    let(:command_opts) { { :max_time => nil } }
+                    it 'should not pass any options to STREAM FILE' do
+                      expect_stream_file_with_options
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :max_time => 30 } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A max_time value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'voice' do
+                  context 'unset' do
+                    let(:command_opts) { { :voice => nil } }
+                    it 'should not pass the v option to STREAM FILE' do
+                      expect_stream_file_with_options
+                      subject.execute
+                    end
+                  end
+
+                  context 'set' do
+                    let(:command_opts) { { :voice => 'alison' } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'A voice value is unsupported on Asterisk.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+
+                describe 'interrupt_on' do
+                  context "set to nil" do
+                    let(:command_opts) { { :interrupt_on => nil } }
+                    it "should not pass any digits to STREAM FILE" do
+                      expect_stream_file_with_options
+                      subject.execute
+                    end
+                  end
+
+                  context "set to :any" do
+                    let(:command_opts) { { :interrupt_on => :any } }
+                    it "should pass all digits to STREAM FILE" do
+                      expect_stream_file_with_options '0123456789*#'
+                      subject.execute
+                    end
+                  end
+
+                  context "set to :dtmf" do
+                    let(:command_opts) { { :interrupt_on => :dtmf } }
+                    it "should pass all digits to STREAM FILE" do
+                      expect_stream_file_with_options '0123456789*#'
+                      subject.execute
+                    end
+                  end
+
+                  context "set to :speech" do
+                    let(:command_opts) { { :interrupt_on => :speech } }
+                    it "should return an error and not execute any actions" do
+                      subject.execute
+                      error = ProtocolError.new 'option error', 'An interrupt-on value of speech is unsupported.'
+                      command.response(0.1).should == error
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end