adhearsion 2.4.0.beta3 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a21555092db2b8678e869cbf61fe9d365c6ba61f
-  data.tar.gz: 118c8bdbf5dedcf3c52287175ba13637b5b711c6
+  metadata.gz: 61315b79e7d1320dea8413e2b5c26f9b1c953551
+  data.tar.gz: 2935a1722a541274a596fb2a35d5e3e5b7d05a23
 SHA512:
-  metadata.gz: d1b0b67df4b8b76a4f77e724dcc7b2523c719d37bb6eed73a7adaf3bbb90db792de9d69cbd09b0f860221605125092684756d84430c176c8aa5bff072ff476cd
-  data.tar.gz: e5c9deb98506f8ce27a1185b89ffe17eb474f79432dc697436566897d1c5b839007eaf0231fa08d8e243c514907b2572b42d6fa3f4f5079f8da4ae6ccdda67e2
+  metadata.gz: d4210b4cae9891cc1f5f2e6ecca89e7e4b0f371287d0726f3a876b99910e35b887758d1f5ab6e59a2afca1c58c9e270cb4377c531c55d4d79e1c9454773319af
+  data.tar.gz: 8302e6d6500220edd4892b557f79b1c5fcdcaa1d68771a3bb6db2f7094f36912c349c9f297adaeef8b4ba572aa0dadddf2fc2121c09e1dd592d20bff843d625d

data/CHANGELOG.md

@@ -1,6 +1,6 @@
 # [develop](https://github.com/adhearsion/adhearsion)
 
-# [2.4.0.beta3](https://github.com/adhearsion/adhearsion/compare/v2.3.5...v2.4.0.beta3) - [2013-08-27](https://rubygems.org/gems/adhearsion/versions/2.4.0.beta3)
+# [2.4.0](https://github.com/adhearsion/adhearsion/compare/v2.3.5...v2.4.0) - [2013-08-29](https://rubygems.org/gems/adhearsion/versions/2.4.0)
   * Deprecation: Ruby 1.9.2 support is deprecated and will be dropped in a future version of Adhearsion
   * Deprecation: Some media options from Punchblock config are now overriden by other core config, and will eventually be removed.
   * Deprecation: Core implementations of `CallController#ask` and `#menu` are deprecated, and will be replaced in future with those in [adhearsion-asr](http://github.com/adhearsion/adhearsion-asr). See http://adhearsion.com/docs/common_problems#toc_3 for details.
@@ -13,6 +13,7 @@
   * Feature: Add `#originate` method to console as alias for `Adhearsion::OutboundCall.originate`
   * Feature: Allow the console to be disabled using `--no-console`
   * Feature: Add CLI commands to generate hooks for a plugin to register on [ahnhub.com](http://www.ahnhub.com)
+  * Feature: Add `#say_characters` method and an async cousin, `#say_characters!`
   * Bugfix: Removed unnecessary Mocha reference from generated plugin
   * Bugfix: Call loggers are deleted after a call finishes, fixing a memory leak
   * Bugfix: A menu definition's block context is now available

data/adhearsion.gemspec

@@ -29,7 +29,7 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'jruby-openssl' if RUBY_PLATFORM == 'java'
   s.add_runtime_dependency 'logging', ["~> 1.8"]
   s.add_runtime_dependency 'pry'
-  s.add_runtime_dependency 'punchblock', ["~> 2.0.0.beta1"]
+  s.add_runtime_dependency 'punchblock', ["~> 2.0"]
   s.add_runtime_dependency 'rake'
   s.add_runtime_dependency 'ruby_speech', ["~> 2.0"]
   s.add_runtime_dependency 'thor', "~> 0.18.0"

data/lib/adhearsion/call_controller/output.rb

@@ -38,6 +38,36 @@ module Adhearsion
       end
       alias :speak! :say!
 
+
+      # Speak characters using text-to-speech (TTS)
+      #
+      # @example Speak 'abc123' as 'ay bee cee one two three'
+      #   say_characters('abc123')
+      #
+      # @param [String, #to_s] characters The string of characters to be spoken
+      # @param [Hash] options A set of options for output
+      #
+      # @raises [PlaybackError] if the given argument could not be played
+      #
+      def say_characters(characters, options = {})
+        player.play_ssml output_formatter.ssml_for_characters(characters), options
+        true
+      end
+
+      # Speak characters using text-to-speech (TTS) and return as soon as it begins
+      #
+      # @example Speak 'abc123' as 'ay bee cee one two three'
+      #   say_characters!('abc123')
+      #
+      # @param [String, #to_s] characters The string of characters to be spoken
+      # @param [Hash] options A set of options for output
+      #
+      # @raises [PlaybackError] if the given argument could not be played
+      #
+      def say_characters!(characters, options = {})
+        async_player.play_ssml output_formatter.ssml_for_characters(characters), options
+      end
+
       #
       # Plays the specified sound file names. This method will handle Time/DateTime objects (e.g. Time.now),
       # Fixnums (e.g. 1000), Strings which are valid Fixnums (e.g "123"), and direct sound files. To specify how the Date/Time objects are said
@@ -219,7 +249,7 @@ module Adhearsion
       # @raises [PlaybackError] if (one of) the given argument(s) could not be played
       #
       def interruptible_play(*outputs)
-        options = process_output_options outputs 
+        options = process_output_options outputs
         outputs.find do |output|
           digit = stream_file output, '0123456789#*', options
           return digit if digit

data/lib/adhearsion/call_controller/output/formatter.rb

@@ -88,6 +88,12 @@ module Adhearsion
             audio(:src => argument) { fallback }
           end
         end
+
+        def ssml_for_characters(argument)
+          RubySpeech::SSML.draw do
+            say_as(interpret_as: 'characters') { string argument.to_s }
+          end
+        end
       end
     end
   end

data/lib/adhearsion/cli_commands/plugin_command.rb

@@ -24,8 +24,8 @@ module Adhearsion
 
       desc "create_ahnhub_hooks", "Creates ahnhub hooks for both a rubygem and github repo"
       def create_ahnhub_hooks
-        create_github_hooks
-        create_rubygem_hooks
+        create_github_hook
+        create_rubygem_hook
       end
 
       protected

data/lib/adhearsion/version.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
 
 module Adhearsion
-  VERSION = '2.4.0.beta3'
+  VERSION = '2.4.0'
 end

data/spec/adhearsion/call_controller/output_spec.rb

@@ -925,6 +925,62 @@ module Adhearsion
           subject.method(:speak!).should be == subject.method(:say!)
         end
       end
+
+      describe "#say_characters" do
+        context "with a string" do
+          let :ssml do
+            RubySpeech::SSML.draw do
+              say_as(interpret_as: 'characters') { "1234#abc" }
+            end
+          end
+
+          it 'plays the correct ssml' do
+            expect_ssml_output ssml
+            subject.say_characters('1234#abc').should be true
+          end
+        end
+
+        context "with a numeric" do
+          let :ssml do
+            RubySpeech::SSML.draw do
+              say_as(interpret_as: 'characters') { "1234" }
+            end
+          end
+
+          it 'plays the correct ssml' do
+            expect_ssml_output ssml
+            subject.say_characters(1234).should be true
+          end
+        end
+      end
+
+      describe "#say_characters!" do
+        context "with a string" do
+          let :ssml do
+            RubySpeech::SSML.draw do
+              say_as(interpret_as: 'characters') { "1234#abc" }
+            end
+          end
+
+          it 'plays the correct ssml' do
+            expect_async_ssml_output ssml
+            subject.say_characters!('1234#abc').should be_a Punchblock::Component::Output
+          end
+        end
+
+        context "with a numeric" do
+          let :ssml do
+            RubySpeech::SSML.draw do
+              say_as(interpret_as: 'characters') { "1234" }
+            end
+          end
+
+          it 'plays the correct ssml' do
+            expect_async_ssml_output ssml
+            subject.say_characters!(1234).should be_a Punchblock::Component::Output
+          end
+        end
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: adhearsion
 version: !ruby/object:Gem::Version
-  version: 2.4.0.beta3
+  version: 2.4.0
 platform: ruby
 authors:
 - Jay Phillips
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-27 00:00:00.000000000 Z
+date: 2013-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -179,14 +179,14 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.0.0.beta1
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.0.0.beta1
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -571,9 +571,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>'
+  - - '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.0.3