adhearsion-ivr 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 748ecbe4414a38d5ff3b011feac37449447b150d
+  data.tar.gz: c15534a4e1395b758aefb698bed447875af832fd
+SHA512:
+  metadata.gz: 326c7fd91c2940d5335fd0942b54aaf6e4d00c057f50293de0ee9fd518313408a34363879e709341f2190a1420c2660803f94eebe3ee942cd095e8dc0dd69e6e
+  data.tar.gz: ae1d4057a6e2ad860833f31324aa14f14652866ca2876ba33d0d4e5c42d2acb4da584d40f6506ab1bc68511f1e948a3a0d2bb3218d78b1270976288f7207c0bf

data/.gitignore

@@ -0,0 +1,26 @@
+Gemfile.lock
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+
+# Editor files
+.*.sw*
+*~
+
+# OS Files
+.DS_Store

data/.rspec

@@ -0,0 +1,4 @@
+--format documentation
+--colour
+--tty
+--order random

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0
+  - jruby
+  - rbx-2.1.1
+  - ruby-head
+matrix:
+  allow_failures:
+    - rvm: rbx-2.1.1
+    - rvm: ruby-head
+notifications:
+  irc: "irc.freenode.org#adhearsion"

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+# [develop](https://github.com/adhearsion/adhearsion-ivr)
+
+# [v0.1.0](https://github.com/adhearsion/adhearsion-ivr/compare/2c7ff73f5d6471be23e291c7d6c7b61d0128e09a...0.1.0) - [2014-03-12](https://rubygems.org/gems/adhearsion-ivr/versions/0.1.0)
+  * Initial release

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Guardfile

@@ -0,0 +1,5 @@
+guard 'rspec', cmd: 'bundle exec rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec/" }
+end

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Adhearsion
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,134 @@
+adhearsion-ivr
+===============
+
+IVR building blocks for Adhearsion apps
+
+## Installing
+
+Simply add to your Gemfile like any other Adhearsion plugin:
+
+```Ruby
+gem 'adhearsion-ivr'
+```
+
+## Configuration
+
+Adhearsion IVR currently has no configurable options.
+
+## Examples
+
+A bare-bones example of creating a prompt. This menu has a single message, "Please enter a number 1 through 3."  By default, the caller has 3 attempts to enter any of 1, 2 or 3 (though the actual grammar is left as an exercise to the developer).  If 1 is pressed, the caller is sent to the OneController; if 2 is pressed the caller is sent to the TwoController; if 3 is pressed the caller hears a poor impersonation of the Three Stooges and is hung up.
+
+If the caller fails to provde input within 3 attempts, he hears a taunting message and is then transferred to a waiting kindergarten teacher.
+
+```Ruby
+class SimplePrompt < Adhearsion::IVRController
+  prompts << "Please enter a number 1 through 3"
+
+  on_complete do |result|
+    case result.nlsml.interpretations.first[:instance] # FIXME?
+    when 1
+      pass OneController
+    when 2
+      pass TwoController
+    when 3
+      say "Yuk yuk yuk"
+      hangup
+    end
+  end
+  
+  on_failure do
+    say "Sorry you failed kindergarten. Let us transfer you to our trained staff of kindergarten teachers."
+    dial 'sip:kindergarten_teachers@elementaryschool.com'
+  end
+  
+  def grammar
+    RubySpeech::GRXML.draw do
+      # ... put a valid GRXML grammar here
+    end
+  end
+end
+```
+
+An example with escalating prompts:
+
+```Ruby
+class EscalatedPrompt < Adhearsion::IVRController
+  prompts << "First attempt: enter a number"
+  prompts << "Second attempt: enter a number 1 through 3"
+  prompts << "Third attempt: enter a number 1 through 3. That would be the top row of your DTMF keypad. Don't get it wrong again."
+  prompts << "Fourth attempt: really? Was I not clear the first 3 times? Last chance, dunce."
+  
+  max_attempts 4
+ 
+  on_complete do |result|
+    case result.nlsml.interpretations.first[:instance] # FIXME?
+    when 1
+      pass OneController
+    when 2
+      pass TwoController
+    when 3
+      say "Yuk yuk yuk"
+      hangup
+    end
+  end
+  
+  on_failure do
+    say "Sorry you failed kindergarten. Let us transfer you to our trained staff of kindergarten teachers."
+    dial 'sip:kindergarten_teachers@elementaryschool.com'
+  end
+  
+  def grammar
+    RubySpeech::GRXML.draw do
+      # ... put a valid GRXML grammar here
+    end
+  end
+end
+```
+
+A slightly more involved example showing integration with I18n:
+
+```Ruby
+class I18nEscalatedPrompts < Adhearsion::IVRController
+  # Note that by deferring prompt resolution we can take advantage of per-call variables such as language selection
+  prompts << -> { t(:first_attempt) }
+  prompts << -> { t(:second_attempt) }
+  prompts << -> { t(:third_attempt) }
+  prompts << -> { [ t(:fourth_attempt), t(:this_is_your_final_attempt) ] }
+  # Future improvement: we could potentially also include the previous input
+  # in the re-prompts, but that isn't implemented now
+  
+  max_attempts 4
+ 
+  on_complete do |result|
+    case result.nlsml.interpretations.first[:instance] # FIXME?
+    when 1
+      pass OneController
+    when 2
+      pass TwoController
+    when 3
+      say "Yuk yuk yuk"
+      hangup
+    end
+  end
+  
+  on_failure do
+    say "Sorry you failed kindergarten. Let us transfer you to our trained staff of kindergarten teachers."
+    dial 'sip:kindergarten_teachers@elementaryschool.com'
+  end
+  
+  def grammar
+    RubySpeech::GRXML.draw do
+      # ... put a valid GRXML grammar here
+    end
+  end
+end
+```
+
+## Credits
+
+Copyright (C) 2014 The Adhearsion Foundation
+
+adhearsion-ivr is released under the [MIT license](http://opensource.org/licenses/MIT). Please see the [LICENSE](https://github.com/adhearsion/adhearsion-i18n/blob/master/LICENSE) file for details.
+
+adhearsion-ivr was created by [Ben Klang](https://twitter.com/bklang) with support from [Mojo Lingo](https://mojolingo.com) and their clients.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new :spec
+
+task default: :spec

data/adhearsion-ivr.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "adhearsion-ivr/version"
+
+Gem::Specification.new do |s|
+  s.name        = "adhearsion-ivr"
+  s.version     = AdhearsionIVR::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Ben Klang", "Ben Langfeld"]
+  s.email       = "dev@adhearsion.com"
+  s.homepage    = "http://adhearsion.com"
+  s.summary     = "IVR building blocks for Adhearsion applications"
+  s.description = "This provides a consistent way of implementing Interactive Voice Response prompts, including reprompting and error handling"
+
+  s.license = 'MIT'
+
+  s.required_ruby_version = '>= 1.9.3'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency 'adhearsion', ["~> 2.0"]
+  s.add_runtime_dependency 'adhearsion-asr', ["~> 1.0"]
+  s.add_runtime_dependency 'state_machine'
+
+  s.add_development_dependency %q<bundler>, ["~> 1.0"]
+  s.add_development_dependency %q<rspec>, ["~> 2.11"]
+  s.add_development_dependency %q<rake>, [">= 0"]
+  s.add_development_dependency %q<guard-rspec>
+  s.add_development_dependency %q<rb-fsevent>, ['~> 0.9']
+end

data/lib/adhearsion-ivr.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+
+%w{
+  version
+  plugin
+  ivr_controller
+}.each { |r| require "adhearsion-ivr/#{r}" }
+
+class AdhearsionIVR
+end

data/lib/adhearsion-ivr/ivr_controller.rb

@@ -0,0 +1,118 @@
+# encoding: utf-8
+
+require 'state_machine'
+require 'adhearsion-asr'
+
+module Adhearsion
+  class IVRController < Adhearsion::CallController
+    class << self
+      # list of prompts to be played to the caller.
+      # this should have one prompt for each attempt
+      # in case there are not enough prompts, the final prompt will be re-used until
+      # the max_attempts are exceeded.
+      def prompts
+        @prompts ||= []
+      end
+
+      # maximum number of attempts to prompt the caller for input
+      def max_attempts(num = nil)
+        if num
+          @max_attempts = num
+        else
+          @max_attempts || 3
+        end
+      end
+
+      # called when the caller successfully provides input
+      def on_complete(&block)
+        @completion_callback = block
+      end
+      attr_reader :completion_callback
+
+      # Called when the caller errors more than the number of allowed attempts
+      def on_failure(&block)
+        @failure_callback = block
+      end
+      attr_reader :failure_callback
+    end
+
+    state_machine initial: :prompting do
+      event(:match)    { transition prompting: :complete }
+      event(:reprompt) { transition input_error: :prompting }
+      event(:nomatch)  { transition prompting: :input_error }
+      event(:noinput)  { transition prompting: :input_error }
+      event(:failure)  { transition prompting: :failure, input_error: :failure }
+
+      after_transition :prompting => :input_error do |controller|
+        controller.increment_errors
+        if controller.continue?
+          controller.reprompt!
+        else
+          controller.failure!
+        end
+      end
+
+      after_transition any => :prompting do |controller|
+        controller.deliver_prompt
+      end
+
+      after_transition :prompting => :complete do |controller|
+        controller.completion_callback
+      end
+
+      after_transition any => :failure do |controller|
+        controller.failure_callback
+      end
+    end
+
+    def run
+      @errors = 0
+      deliver_prompt
+    end
+
+    def deliver_prompt
+      prompt = self.class.prompts[@errors] || self.class.prompts.last
+      prompt = instance_exec(&prompt) if prompt.respond_to? :call
+      logger.debug "Prompt: #{prompt.inspect}"
+
+      @result = ask prompt, grammar: grammar, mode: :voice
+      logger.debug "Got result #{@result.inspect}"
+      case @result.status
+      when :match
+        match!
+      when :stop
+        logger.info "Prompt was stopped forcibly. Exiting cleanly..."
+      when :hangup
+        logger.info "Call was hung up mid-prompt. Exiting controller flow..."
+        raise Adhearsion::Call::Hangup
+      when :nomatch
+        nomatch!
+      when :noinput
+        noinput!
+      else
+        raise "Unrecognized result status: #{@result.status}"
+      end
+      @result
+    end
+
+    def grammar
+      raise NotImplementedError, "You must override #grammar and provide a grammar"
+    end
+
+    def increment_errors
+      @errors += 1
+    end
+
+    def continue?
+      @errors < self.class.max_attempts
+    end
+
+    def completion_callback
+      instance_exec @result, &self.class.completion_callback if self.class.completion_callback
+    end
+
+    def failure_callback
+      instance_exec &self.class.failure_callback if self.class.failure_callback
+    end
+  end
+end

data/lib/adhearsion-ivr/plugin.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+
+class AdhearsionIVR::Plugin < Adhearsion::Plugin
+  init :ivr do
+    logger.info "Adhearsion IVR loaded"
+  end
+end

data/lib/adhearsion-ivr/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+class AdhearsionIVR
+  VERSION = '0.1.0'
+end

data/spec/adhearsion-ivr/ivr_controller_spec.rb

@@ -0,0 +1,411 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Adhearsion::IVRController do
+  describe "when we inherit from it" do
+
+    let(:call_id)     { SecureRandom.uuid }
+    let(:call)        { Adhearsion::Call.new }
+
+    let(:controller_class) do
+      expected_prompts = self.expected_prompts
+      apology_announcement = self.apology_announcement
+
+      Class.new(Adhearsion::IVRController) do
+        expected_prompts.each do |prompt|
+          prompts << prompt
+        end
+
+        on_complete do |result|
+          say "Let's go to #{result.utterance}"
+        end
+
+        on_failure do
+          say apology_announcement
+        end
+
+        def grammar
+          :some_grammar
+        end
+      end
+    end
+
+    subject(:controller) { controller_class.new call }
+
+    before do
+      double call, write_command: true, id: call_id
+
+      Adhearsion::Plugin.configure_plugins if Adhearsion::Plugin.respond_to?(:configure_plugins)
+      Adhearsion::Plugin.init_plugins
+    end
+
+    let(:expected_prompts) { [SecureRandom.uuid, SecureRandom.uuid, SecureRandom.uuid] }
+    let(:apology_announcement) { "Sorry, I couldn't understand where you would like to go. I'll put you through to a human." }
+
+    let(:expected_grammar) { :some_grammar }
+
+    let(:nlsml) do
+      RubySpeech::NLSML.draw do
+        interpretation confidence: 1 do
+          input 'Paris', mode: :voice
+          instance 'Paris'
+        end
+      end
+    end
+
+    let(:match_result) do
+      AdhearsionASR::Result.new.tap do |res|
+        res.status         = :match
+        res.mode           = :voice
+        res.confidence     = 1
+        res.utterance      = 'Paris'
+        res.interpretation = 'Paris'
+        res.nlsml          = nlsml
+      end
+    end
+
+    let(:noinput_result) do
+      AdhearsionASR::Result.new.tap do |res|
+        res.status = :noinput
+      end
+    end
+
+    context "when an utterance is received" do
+      before do
+        controller.should_receive(:ask).once.with(expected_prompts[0], grammar: expected_grammar, mode: :voice).and_return result
+      end
+
+      context "that is a match" do
+        let(:result) { match_result }
+
+        it "passes the Result object to the on_complete block" do
+          controller.should_receive(:say).once.with "Let's go to Paris"
+          controller.run
+        end
+      end
+
+      context "that is a noinput" do
+        let(:result) { noinput_result }
+
+        context "followed by a match" do
+          before do
+            controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return match_result
+          end
+
+          it "re-prompts using the next prompt, and then passes the second Result to the on_complete block" do
+            controller.should_receive(:say).once.with "Let's go to Paris"
+            controller.run
+          end
+        end
+
+        context "when there are not enough prompts available for all retries" do
+          let(:expected_prompts) { [SecureRandom.uuid, SecureRandom.uuid] }
+
+          before do
+            controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return result
+            controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return match_result
+          end
+
+          it "reuses the last prompt" do
+            controller.should_receive(:say).once.with "Let's go to Paris"
+            controller.run
+          end
+        end
+
+        context "until it hits the maximum number of attempts" do
+          context "using the default of 3 attempts" do
+            before do
+              controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return result
+              controller.should_receive(:ask).once.with(expected_prompts[2], grammar: expected_grammar, mode: :voice).and_return result
+            end
+
+            it "invokes the on_failure block" do
+              controller.should_receive(:say).once.with apology_announcement
+              controller.run
+            end
+          end
+
+          context "when that value is different from the default" do
+            let(:controller_class) do
+              expected_prompts = self.expected_prompts
+              apology_announcement = self.apology_announcement
+
+              Class.new(Adhearsion::IVRController) do
+                expected_prompts.each do |prompt|
+                  prompts << prompt
+                end
+
+                max_attempts 2
+
+                on_complete do |result|
+                  say "Let's go to #{result.utterance}"
+                end
+
+                on_failure do
+                  say apology_announcement
+                end
+
+                def grammar
+                  :some_grammar
+                end
+              end
+            end
+
+            before do
+              controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return result
+            end
+
+            it "invokes the on_failure block" do
+              controller.should_receive(:say).once.with apology_announcement
+              controller.run
+            end
+          end
+        end
+      end
+
+      context "that is a nomatch" do
+        let(:result) do
+          AdhearsionASR::Result.new.tap do |res|
+            res.status = :nomatch
+          end
+        end
+
+        context "followed by a match" do
+          before do
+            controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return match_result
+          end
+
+          it "re-prompts using the next prompt, and then passes the second Result to the on_complete block" do
+            controller.should_receive(:say).once.with "Let's go to Paris"
+            controller.run
+          end
+        end
+
+        context "when there are not enough prompts available for all retries" do
+          let(:expected_prompts) { [SecureRandom.uuid, SecureRandom.uuid] }
+
+          before do
+            controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return result
+            controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return match_result
+          end
+
+          it "reuses the last prompt" do
+            controller.should_receive(:say).once.with "Let's go to Paris"
+            controller.run
+          end
+        end
+
+        context "until it hits the maximum number of attempts" do
+          context "using the default of 3 attempts" do
+            before do
+              controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return result
+              controller.should_receive(:ask).once.with(expected_prompts[2], grammar: expected_grammar, mode: :voice).and_return result
+            end
+
+            it "invokes the on_failure block" do
+              controller.should_receive(:say).once.with apology_announcement
+              controller.run
+            end
+          end
+
+          context "when that value is different from the default" do
+            let(:controller_class) do
+              expected_prompts = self.expected_prompts
+              apology_announcement = self.apology_announcement
+
+              Class.new(Adhearsion::IVRController) do
+                expected_prompts.each do |prompt|
+                  prompts << prompt
+                end
+
+                max_attempts 2
+
+                on_complete do |result|
+                  say "Let's go to #{result.utterance}"
+                end
+
+                on_failure do
+                  say apology_announcement
+                end
+
+                def grammar
+                  :some_grammar
+                end
+              end
+            end
+
+            before do
+              controller.should_receive(:ask).once.with(expected_prompts[1], grammar: expected_grammar, mode: :voice).and_return result
+            end
+
+            it "invokes the on_failure block" do
+              controller.should_receive(:say).once.with apology_announcement
+              controller.run
+            end
+          end
+        end
+      end
+
+      context "that is a hangup" do
+        let(:controller_class) do
+          expected_prompts = self.expected_prompts
+
+          Class.new(Adhearsion::IVRController) do
+            expected_prompts.each do |prompt|
+              prompts << prompt
+            end
+
+            on_complete do |result|
+              raise "Got complete"
+            end
+
+            on_failure do
+              raise "Got failure"
+            end
+
+            def grammar
+              :some_grammar
+            end
+          end
+        end
+
+        let(:result) do
+          AdhearsionASR::Result.new.tap do |res|
+            res.status = :hangup
+          end
+        end
+
+        it "raises Adhearsion::Call::Hangup" do
+          expect { controller.run }.to raise_error(Adhearsion::Call::Hangup)
+        end
+      end
+
+      context "that is a stop" do
+        let(:controller_class) do
+          expected_prompts = self.expected_prompts
+
+          Class.new(Adhearsion::IVRController) do
+            expected_prompts.each do |prompt|
+              prompts << prompt
+            end
+
+            on_complete do |result|
+              raise "Got complete"
+            end
+
+            on_failure do
+              raise "Got failure"
+            end
+
+            def grammar
+              :some_grammar
+            end
+          end
+        end
+
+        let(:result) do
+          AdhearsionASR::Result.new.tap do |res|
+            res.status = :stop
+          end
+        end
+
+        it "falls through silently" do
+          controller.run
+        end
+      end
+    end
+
+    context "when the prompts are callable" do
+      let(:controller_class) do
+        Class.new(Adhearsion::IVRController) do
+          prompts << -> { thing }
+
+          on_complete do |result|
+          end
+
+          on_failure do
+          end
+
+          def grammar
+            :some_grammar
+          end
+
+          def thing
+            @things ||= %w{one two three}
+            @things.shift
+          end
+        end
+      end
+
+      it "should evaluate the prompt repeatedly in the context of the controller instance" do
+        controller.should_receive(:ask).once.with('one', grammar: expected_grammar, mode: :voice).and_return noinput_result
+        controller.should_receive(:ask).once.with('two', grammar: expected_grammar, mode: :voice).and_return noinput_result
+        controller.should_receive(:ask).once.with('three', grammar: expected_grammar, mode: :voice).and_return noinput_result
+        controller.run
+      end
+    end
+
+    context "when no grammar is provided" do
+      let(:controller_class) do
+        Class.new(Adhearsion::IVRController) do
+          prompts << "Hello"
+
+          on_complete do |result|
+          end
+
+          on_failure do
+          end
+        end
+      end
+
+      it "should raise NotImplementedError" do
+        expect { controller.run }.to raise_error(NotImplementedError)
+      end
+    end
+
+    context "when no complete callback is provided" do
+      let(:controller_class) do
+        Class.new(Adhearsion::IVRController) do
+          prompts << "Hello"
+
+          def grammar
+            :some_grammar
+          end
+        end
+      end
+
+      it "should simply return the result" do
+        controller.should_receive(:ask).once.with('Hello', grammar: expected_grammar, mode: :voice).and_return match_result
+        controller.run.should be(match_result)
+      end
+    end
+
+    context "when no complete callback is provided" do
+      let(:controller_class) do
+        Class.new(Adhearsion::IVRController) do
+          prompts << "Hello"
+
+          def grammar
+            :some_grammar
+          end
+        end
+      end
+
+      it "should simply return the last result" do
+        controller.should_receive(:ask).once.with('Hello', grammar: expected_grammar, mode: :voice).and_return noinput_result
+        controller.should_receive(:ask).once.with('Hello', grammar: expected_grammar, mode: :voice).and_return noinput_result
+        controller.should_receive(:ask).once.with('Hello', grammar: expected_grammar, mode: :voice).and_return noinput_result
+        controller.run.should be(noinput_result)
+      end
+    end
+
+    context "when the call is dead" do
+      before { call.terminate }
+
+      it "executing the controller should raise Adhearsion::Call::Hangup" do
+        expect { subject.run }.to raise_error Adhearsion::Call::Hangup
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require 'adhearsion'
+require 'adhearsion-ivr'
+
+RSpec.configure do |config|
+  config.color_enabled = true
+  config.tty = true
+
+  config.mock_with :rspec
+  config.filter_run :focus => true
+  config.run_all_when_everything_filtered = true
+
+  config.backtrace_clean_patterns = [/rspec/]
+
+  config.before do
+    Punchblock.stub new_request_id: 'foo'
+
+    Adhearsion::Logging.start Adhearsion::Logging.default_appenders, :trace, Adhearsion.config.platform.logging.formatter
+  end
+end

metadata

@@ -0,0 +1,175 @@
+--- !ruby/object:Gem::Specification
+name: adhearsion-ivr
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ben Klang
+- Ben Langfeld
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: adhearsion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: adhearsion-asr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: state_machine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.11'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rb-fsevent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: This provides a consistent way of implementing Interactive Voice Response
+  prompts, including reprompting and error handling
+email: dev@adhearsion.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- adhearsion-ivr.gemspec
+- lib/adhearsion-ivr.rb
+- lib/adhearsion-ivr/ivr_controller.rb
+- lib/adhearsion-ivr/plugin.rb
+- lib/adhearsion-ivr/version.rb
+- spec/adhearsion-ivr/ivr_controller_spec.rb
+- spec/spec_helper.rb
+homepage: http://adhearsion.com
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: IVR building blocks for Adhearsion applications
+test_files:
+- spec/adhearsion-ivr/ivr_controller_spec.rb
+- spec/spec_helper.rb