nuance 0.0.2

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,13 @@
+source 'https://rubygems.org'
+
+gemspec
+
+# group :development do
+#   gem "rspec"
+#   gem "yard"
+#   gem "rdoc"
+#   gem "bundler"
+#   gem "jeweler"
+#   gem "simplecov"
+#   gem "fakeweb"
+# end

data/Gemfile.lock

@@ -0,0 +1,60 @@
+PATH
+  remote: .
+  specs:
+    nuance (0.0.2)
+      celluloid (= 0.12.4)
+      faraday (= 0.8.4)
+      hashie (= 1.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    celluloid (0.12.4)
+      facter (>= 1.6.12)
+      timers (>= 1.0.0)
+    diff-lcs (1.1.3)
+    facter (1.7.1)
+    fakeweb (1.3.0)
+    faraday (0.8.4)
+      multipart-post (~> 1.1)
+    git (1.2.5)
+    hashie (1.2.0)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.8.0)
+    multi_json (1.7.7)
+    multipart-post (1.2.0)
+    rake (10.1.0)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.2)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    timers (1.1.0)
+    yard (0.8.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (= 1.3.5)
+  facter (= 1.7.1)
+  fakeweb (= 1.3.0)
+  jeweler (= 1.8.4)
+  nuance!
+  rdoc (= 3.12)
+  rspec (= 2.12.0)
+  simplecov (= 0.7.1)
+  yard (= 0.8.3)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Tropo, Inc
+
+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,42 @@
+nuance
+======
+
+A Ruby Gem for consuming the Nuance transcription and text to speech REST APIs. More details may be found at the [Nuance Mobile Develper](http://www.nuance.com/for-partners/by-solution/mobile-developer-program/index.htm) site.
+
+Installation
+------------
+
+```
+gem install nuance
+```
+
+Usage
+-----
+
+The languages supported may be found [here](http://dragonmobile.nuancemobiledeveloper.com/public/index.php?task=supportedLanguages). Here is an example:
+
+```ruby
+# blocking
+nuance_transcription = Nuance::Transcription.new({ :app_id  => ENV['NUANCE_APP_ID'],
+                                                   :app_key => ENV['NUANCE_APP_KEY'],
+                                                   :id      => '0' })
+result = nuance_transcription.transcribe({ :file_contents => File.open('spec/DT-202c.wav').read })
+if result.status == 200
+  puts result.body
+end
+
+# non-blocking
+nuance_transcription = Nuance::Transcription.new({ :app_id  => ENV['NUANCE_APP_ID'],
+                                                   :app_key => ENV['NUANCE_APP_KEY'],
+                                                   :id      => '0' })
+nuance_transcription.transcribe!(:file_contents => File.open('spec/DT-202c.wav').read) do |result| 
+  if result.status == 200
+    puts result.body
+  end
+end
+```
+Copyright
+---------
+
+Copyright (c) 2013 Tropo, Inc. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,42 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "nuance"
+  gem.homepage = "http://github.com/jsgoecke/nuance"
+  gem.license = "MIT"
+  gem.summary = "A Ruby Gem for consuming the Nuance transcription and text to speech REST APIs"
+  gem.description = "A Ruby Gem for consuming the Nuance transcription and text to speech REST APIs"
+  gem.email = "jason@goecke.net"
+  gem.authors = ["Jason Goecke"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.simplecov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/examples/transcribe.rb

@@ -0,0 +1,13 @@
+require 'nuance'
+
+# Blocking
+nuance = Nuance::Transcription.new({ :app_id  => ENV['NUANCE_APP_ID'],
+                                     :app_key => ENV['NUANCE_APP_KEY'],
+                                     :id      => '123' })
+
+p nuance.transcribe(:file_contents => File.open('DT-202c.wav').read)
+
+# Non-blocking
+nuance.transcribe!(:file_contents => File.open('DT-202c.wav').read) do |result|
+  p result
+end

data/lib/nuance.rb

@@ -0,0 +1,7 @@
+%w{
+  faraday
+  celluloid
+  hashie
+  nuance/transcription
+  nuance/text_to_speech
+  }.each { |lib| require lib }

data/lib/nuance/dictation-base64.cer

@@ -0,0 +1,30 @@
+-----BEGIN CERTIFICATE-----
+MIIFLTCCBBWgAwIBAgIDAcXvMA0GCSqGSIb3DQEBBQUAMEAxCzAJBgNVBAYTAlVT
+MRcwFQYDVQQKEw5HZW9UcnVzdCwgSW5jLjEYMBYGA1UEAxMPR2VvVHJ1c3QgU1NM
+IENBMB4XDTEyMTAyNDEzMTA0NFoXDTE0MTEyNjE0MTA1NVowgbkxKTAnBgNVBAUT
+IHk5Sk5Db3ZoUGJOQ2EvaUJNZE9jNGthWWhqNjhhSTliMQswCQYDVQQGEwJVUzEW
+MBQGA1UECBMNTWFzc2FjaHVzZXR0czEQMA4GA1UEBxMHUGVhYm9keTEjMCEGA1UE
+ChMaTnVhbmNlIENvbW11bmljYXRpb25zIEluYy4xETAPBgNVBAsTCE1vYmlsaXR5
+MR0wGwYDVQQDDBQqLm51YW5jZW1vYmlsaXR5Lm5ldDCCASIwDQYJKoZIhvcNAQEB
+BQADggEPADCCAQoCggEBAMV2moXwKA1tLUVmTdM5ZaVBr9a4I2OkTIjefNdFxtuH
+YBWKXA2eCDcy6pHk9V34HbGqAo1aEylJiXN90Y2uL43QdkAM9lPnRZRzynpPcKCh
+VODhWa8brXT1gVeoGlh9OXZE3RiK+rPHNUUfAOfGTg7bnXmiK6Bml58SExLpQxtI
+9Wy9tNoTWJ4v1L6bxK776qE12DvaxyFNFgJp5m0R7hQmMXeyQzSrylsjlfUcgKR/
+O1LSxnAq7Kv3ijUxA0gKu7elWYdXI71/zRdjvNr9dSekb19rP/rcoNZsGQvT3uuc
+JnJVdujLbmSBm9U/JWHjzOC5Yhoul4RogGX442wMmXsCAwEAAaOCAbQwggGwMB8G
+A1UdIwQYMBaAFEJ5VBthzVUrPmPVPEhX9Z/7Rc5KMA4GA1UdDwEB/wQEAwIEsDAd
+BgNVHSUEFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIwMwYDVR0RBCwwKoIUKi5udWFu
+Y2Vtb2JpbGl0eS5uZXSCEm51YW5jZW1vYmlsaXR5Lm5ldDA9BgNVHR8ENjA0MDKg
+MKAuhixodHRwOi8vZ3Rzc2wtY3JsLmdlb3RydXN0LmNvbS9jcmxzL2d0c3NsLmNy
+bDAdBgNVHQ4EFgQUNuyQCo6RJvAYlmfaaSZIVfPZpiMwDAYDVR0TAQH/BAIwADBv
+BggrBgEFBQcBAQRjMGEwKgYIKwYBBQUHMAGGHmh0dHA6Ly9ndHNzbC1vY3NwLmdl
+b3RydXN0LmNvbTAzBggrBgEFBQcwAoYnaHR0cDovL2d0c3NsLWFpYS5nZW90cnVz
+dC5jb20vZ3Rzc2wuY3J0MEwGA1UdIARFMEMwQQYKYIZIAYb4RQEHNjAzMDEGCCsG
+AQUFBwIBFiVodHRwOi8vd3d3Lmdlb3RydXN0LmNvbS9yZXNvdXJjZXMvY3BzMA0G
+CSqGSIb3DQEBBQUAA4IBAQBA81miz43odjvvarBucFDKfKbhrQAWrEQB+Avri97g
+ytN0xkfpdov0b/qLRNxm2oohqRKmKG0QdsVKfObWL1GoJrZo/YJc3IRcoBlZXUr2
+QGZShAmAV6nBXlPAcbp+ryfLWEGRPCc3rs1TLsGrExxsLW6QcnKdnaoTuR7rWfbD
+CnBoPFRnOgakXf1hxyNSSRgcx0oetFSL/jASD2bylRPU09eA9beZsOEcfGp4I7ON
++U77F36aRMgOfwE1JWiAjgcsUywHCfRo7084HtozrvUYmqgaxi2J5KQ6JOxsbOFS
+8hAxHOOsAqEUWOje7shQBTGW30FheDKjms7yUPuYh5me
+-----END CERTIFICATE-----

data/lib/nuance/text_to_speech.rb

@@ -0,0 +1,7 @@
+module Nuance
+  class TextToSpeech
+    def initialize(options={})
+      raise RuntimeError, 'Not implemented. Coming soon...'
+    end
+  end
+end

data/lib/nuance/transcription.rb

@@ -0,0 +1,156 @@
+module Nuance
+  class Transcription
+    include Celluloid
+    Celluloid.logger = nil
+
+    attr_reader :base_uri
+
+  ##
+  # Creates an ATTSpeech object
+  #
+  #  @param [Hash] args the options to intantiate with
+  #  @option args [String] :api_id the Nuance App API ID
+  #  @option args [String] :app_key the Nuance App Key
+  #  @option args [String] :id the Nuance id
+  #  @option args [String] :base_url the url for the Nuance API, default is 'https://api.att.com'
+  #
+  # @return [Object] an instance of Nuance::Transcription
+    def initialize(options={})
+      raise ArgumentError, ':app_id must be set' if !options[:app_id]
+      raise ArgumentError, ':app_key must be set' if !options[:app_key]
+      raise ArgumentError, ':id must be set' if !options[:id]
+
+      @base_uri = options[:base_uri] || 'https://dictation.nuancemobility.net'
+      @app_id   = options[:app_id] || ENV['NUANCE_APP_ID']
+      @app_key  = options[:app_key] || ENV['NUANCE_APP_KEY']
+      @id       = options[:id] || rand(100000000)
+      @resource = "/NMDPAsrCmdServlet/dictation?appId=#{@app_id}&appKey=#{@app_key}&id=#{@id}"
+      @logging  = options[:logging] || false
+
+      self
+    end
+
+    ##
+    # Allows you to send a file and return the transcription
+    #
+    # @param [String] file_contents to be processed
+    # @option args [String] :content_type the content type of the audio file to transcribe
+    # @option args [String] :accept_type the accept type of the audio file to transcribe
+    # @option args [String] :accept_topic the accept topic of the audio file to transcribe
+    # @option args [String] :lanugage the language of the audio file to transcribe
+    # @option args [String] :accept the accept of the audio file to transcribe
+    # @param [Block] block to be called when the transcription completes
+    #
+    # @return [Hash] the resulting response from the Nuance API
+    def transcribe(options={}, &block)
+      @content_type    = options[:content_type] || 'audio/x-wav;codec=pcm;bit=16;rate=8000'
+      @accept_topic    = options[:accept_topic] || 'Dictation'
+      @accept_language = options[:language]     || 'en_US'
+      @accept          = options[:accept]       || 'application/xml'
+
+      @ssl_verify = options[:ssl_verify] || true
+      raise ArgumentError, ':content_type must be valid'    if !content_type_valid?(options[:content_type])
+      raise ArgumentError, ':file_contents must be present' if !options[:file_contents]
+      raise ArgumentError, ':language must be valid'        if !language_valid?(options[:language])
+
+      create_connection
+
+      begin
+        response = @connection.post @resource,
+                   options[:file_contents],
+                   { :Content_Type         => @content_type,
+                     :Accept_Language      => @accept_language,
+                     :Accept_Topic         => @accept_topic,
+                     :Accept               => @accept,
+                     :Transfer_Encoding    => 'chunked' }
+        if response.status == 200
+          block.call process(response) if block_given?
+          process(response)
+        else
+          response
+        end
+      rescue => e
+        raise RuntimeError, e.to_s
+      end
+    end
+
+    private
+
+    ##
+    # Validate the content type
+    #
+    # @param [String] content_type
+    # @return [Boolean] if valid or not
+    def content_type_valid?(content_type)
+      valid_types = %w{ audio/x-wav;codec=pcm;bit=16;rate=8000
+                        audio/x-wav;codec=pcm;bit=16;rate=16000
+                        audio/x-speex;rate=8000
+                        audio/x-speex;rate=16000
+                        audio/amr
+                        audio/qcelp
+                        audio/evrc
+                      }
+      return true if valid_types.grep(/#{content_type}/).length > 0
+    end
+
+    ##
+    # Validate the language
+    #
+    # @param [String] language
+    # @return [Boolean] if valid or not
+    def language_valid?(language)
+      valid_types = %w{ en_AU
+                        en_GB
+                        en_US
+                        ar_EG
+                        ar_SA
+                        ar_AE
+                        zh_HK
+                        cs_CZ
+                        da_DK
+                        nl_NL
+                        fi_FI
+                        fr_CA
+                        fr_FR
+                        de_DE
+                        el_GR
+                        hu_HU
+                        id_ID
+                        it_IT
+                        ja_JP
+                        ko_KR
+                        ms_MY
+                        cn_MA
+                        zh_TW
+                        no_NO
+                        pl_PL
+                        pt_BR
+                        pt_PT
+                        ro_RO
+                        ru_RU
+                        sk_SK
+                        es_ES
+                        es_MX
+                        es_US
+                        sv_SE
+                        tr_TR
+                        vi_VN
+                      }
+      return true if valid_types.grep(/#{language}/).length > 0
+    end
+
+    ##
+    # Creates the Faraday connection object
+    def create_connection
+      @connection = Faraday.new(:url => @base_uri, :ssl => { :verify => @ssl_verify, :ca_file => 'lib/nuance/dictation-base64.cer' }) do |faraday|
+        faraday.adapter Faraday.default_adapter
+      end
+    end
+
+    private
+    
+    def process(response)
+      Hashie::Mash.new({ :status => 200, :body => response.body.split(/\r?\n/)[0] })
+    end
+  end
+end

data/nuance.gemspec

@@ -0,0 +1,84 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "nuance"
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jason Goecke"]
+  s.date = "2013-07-08"
+  s.description = "A Ruby Gem for consuming the Nuance transcription and text to speech REST APIs"
+  s.email = "jason@goecke.net"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".DS_Store",
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "examples/DT-202c.wav",
+    "examples/transcribe.rb",
+    "lib/nuance.rb",
+    "lib/nuance/dictation-base64.cer",
+    "lib/nuance/text_to_speech.rb",
+    "lib/nuance/transcription.rb",
+    "nuance.gemspec",
+    "spec/.DS_Store",
+    "spec/DT-202c.wav",
+    "spec/nuance-text_to_speech_spec.rb",
+    "spec/nuance-transcription_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/jsgoecke/nuance"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.23"
+  s.summary = "A Ruby Gem for consuming the Nuance transcription and text to speech REST APIs"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<nuance>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["= 2.12.0"])
+      s.add_development_dependency(%q<yard>, ["= 0.8.3"])
+      s.add_development_dependency(%q<rdoc>, ["= 3.12"])
+      s.add_development_dependency(%q<bundler>, ["= 1.3.5"])
+      s.add_development_dependency(%q<facter>, ["= 1.7.1"])
+      s.add_development_dependency(%q<jeweler>, ["= 1.8.4"])
+      s.add_development_dependency(%q<simplecov>, ["= 0.7.1"])
+      s.add_development_dependency(%q<fakeweb>, ["= 1.3.0"])
+    else
+      s.add_dependency(%q<nuance>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["= 2.12.0"])
+      s.add_dependency(%q<yard>, ["= 0.8.3"])
+      s.add_dependency(%q<rdoc>, ["= 3.12"])
+      s.add_dependency(%q<bundler>, ["= 1.3.5"])
+      s.add_dependency(%q<facter>, ["= 1.7.1"])
+      s.add_dependency(%q<jeweler>, ["= 1.8.4"])
+      s.add_dependency(%q<simplecov>, ["= 0.7.1"])
+      s.add_dependency(%q<fakeweb>, ["= 1.3.0"])
+    end
+  else
+    s.add_dependency(%q<nuance>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["= 2.12.0"])
+    s.add_dependency(%q<yard>, ["= 0.8.3"])
+    s.add_dependency(%q<rdoc>, ["= 3.12"])
+    s.add_dependency(%q<bundler>, ["= 1.3.5"])
+    s.add_dependency(%q<facter>, ["= 1.7.1"])
+    s.add_dependency(%q<jeweler>, ["= 1.8.4"])
+    s.add_dependency(%q<simplecov>, ["= 0.7.1"])
+    s.add_dependency(%q<fakeweb>, ["= 1.3.0"])
+  end
+end
+

data/spec/nuance-text_to_speech_spec.rb

@@ -0,0 +1,12 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Nuance::TextToSpeech do
+  it 'should raise a RuntimeError, since it is not implemented' do
+  	begin
+      Nuance::TextToSpeech.new
+    rescue => e
+      e.instance_of?(RuntimeError).should eql true
+      e.to_s.should eql "Not implemented. Coming soon..."
+    end
+  end
+end

data/spec/nuance-transcription_spec.rb

@@ -0,0 +1,211 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Nuance::Transcription do
+  before(:all) do
+    @options = { :app_id => 'abc', :app_key => '123', :id => '0' }
+    @transcription = "Hello World"
+  end
+
+  describe '#validations' do
+    it "should create a NuanceTranscription object" do
+      Nuance::Transcription.new(@options).class.should eql Nuance::Transcription
+    end
+
+    it 'should raise an ArgumentError if :app_key not specified' do
+      begin
+        options = { :app_id => 'foo' }
+        Nuance::Transcription.new(options)
+      rescue => e
+        e.to_s.should eql ":app_key must be set"
+      end
+    end
+
+    it 'should raise an ArgumentError if :app_id not specified' do
+      begin
+        options = { :app_key => 'foo' }
+        Nuance::Transcription.new(options)
+      rescue => e
+        e.to_s.should eql ":app_id must be set"
+      end
+    end
+
+    it 'should raise an ArgumentError if :id not specified' do
+      begin
+        options = { :app_id => 'foo', :app_key => 'bar' }
+        Nuance::Transcription.new(options)
+      rescue => e
+        e.to_s.should eql ':id must be set'
+      end
+    end
+
+    it 'should have the default base url set for Nuance' do
+      nuance = Nuance::Transcription.new(@options)
+      nuance.base_uri.should eql 'https://dictation.nuancemobility.net'
+    end
+
+    it 'should set a custom base url' do
+      @options.merge!({ :base_uri => 'https://foobar.com' })
+      nuance = Nuance::Transcription.new(@options)
+      nuance.base_uri.should eql 'https://foobar.com'
+    end
+  end
+
+  describe "#transcriptions" do
+      FakeWeb.register_uri(:post, %r|https://dictation.nuancemobility.net/NMDPAsrCmdServlet/dictation|,
+                                  :status => ['200', 'OK'],
+                                  :body   => 'Hello World')
+
+      describe '#validations' do
+        it 'should allow a valid content type' do
+          content_types = %w{ audio/x-wav;codec=pcm;bit=16;rate=8000
+                              audio/x-wav;codec=pcm;bit=16;rate=16000
+                              audio/x-speex;rate=8000
+                              audio/x-speex;rate=16000
+                              audio/amr
+                              audio/qcelp
+                              audio/evrc
+                            }
+          content_types.each do |type|
+            nuance_transcription = Nuance::Transcription.new({ :app_id  => @options[:app_id],
+                                                               :app_key => @options[:app_key],
+                                                               :id      => @options[:id] })
+            result = nuance_transcription.transcribe({ :file_contents => File.open('spec/DT-202c.wav').read,
+                                                       :content_type  => type })
+            result.status.should eql 200
+            result.body.should eql @transcription
+          end
+        end
+
+        it 'should raise an ArgumentError if not a valid content type' do
+          begin
+            nuance_transcription = Nuance::Transcription.new({ :app_id  => @options[:app_id],
+                                                               :app_key => @options[:app_key],
+                                                               :id      => @options[:id] })
+            nuance_transcription.transcribe({ :file_contents => File.open('spec/DT-202c.wav').read,
+                                              :content_type => 'audio/mp3' })
+          rescue => e
+            e.to_s.should eql ':content_type must be valid'
+          end
+        end
+
+        it 'should allow a valid language type' do
+          languages = %w{ en_AU
+                          en_GB
+                          en_US
+                          ar_EG
+                          ar_SA
+                          ar_AE
+                          zh_HK
+                          cs_CZ
+                          da_DK
+                          nl_NL
+                          fi_FI
+                          fr_CA
+                          fr_FR
+                          de_DE
+                          el_GR
+                          hu_HU
+                          id_ID
+                          it_IT
+                          ja_JP
+                          ko_KR
+                          ms_MY
+                          cn_MA
+                          zh_TW
+                          no_NO
+                          pl_PL
+                          pt_BR
+                          pt_PT
+                          ro_RO
+                          ru_RU
+                          sk_SK
+                          es_ES
+                          es_MX
+                          es_US
+                          sv_SE
+                          tr_TR
+                          vi_VN
+                        }
+          languages.each do |language|
+            nuance_transcription = Nuance::Transcription.new({ :app_id  => @options[:app_id],
+                                                               :app_key => @options[:app_key],
+                                                               :id      => @options[:id] })
+            result = nuance_transcription.transcribe({ :file_contents => File.open('spec/DT-202c.wav').read,
+                                                       :content_type  => 'audio/amr',
+                                                       :language      => language })
+            result.status.should eql 200
+            result.body.should eql @transcription
+          end
+        end
+
+        it 'should raise an ArgumentError if not a valid language' do
+          begin
+            nuance_transcription = Nuance::Transcription.new({ :app_id  => @options[:app_id],
+                                                               :app_key => @options[:app_key],
+                                                               :id      => @options[:id] })
+            nuance_transcription.transcribe({ :file_contents => File.open('spec/DT-202c.wav').read,
+                                              :language       => 'esperanto' })
+          rescue => e
+            e.to_s.should eql ':language must be valid'
+          end
+        end
+
+        it 'should raise an ArgumentError if no file contents provided' do
+          begin
+            nuance_transcription = Nuance::Transcription.new({ :app_id  => @options[:app_id],
+                                                               :app_key => @options[:app_key],
+                                                               :id      => @options[:id] })
+            nuance_transcription.transcribe
+          rescue => e
+            e.to_s.should eql ':file_contents must be present'
+          end
+        end
+      end
+
+      describe '#blocking call' do
+        it "should return a transcription" do
+          nuance_transcription = Nuance::Transcription.new({ :app_id     => @options[:app_id],
+                                                             :app_key    => @options[:app_key],
+                                                             :id         => @options[:id],
+                                                             :ssl_verify => false })
+          result = nuance_transcription.transcribe({ :file_contents => File.open('spec/DT-202c.wav').read })
+          result.status.should eql 200
+          result.body.should eql @transcription
+        end
+      end
+
+      describe '#non-blocking call' do
+        it "should return a Celluloid::Future object when processing an audio file" do
+          nuance_transcription = Nuance::Transcription.new({ :app_id  => @options[:app_id],
+                                                             :app_key => @options[:app_key],
+                                                             :id      => @options[:id] })
+          future = nuance_transcription.future(:transcribe, :file_contents => File.open('spec/DT-202c.wav').read)
+          future.instance_of?(Celluloid::Future).should eql true
+        end
+
+        it "should allow us to use a future to process an audio file" do
+          nuance_transcription = Nuance::Transcription.new({ :app_id  => @options[:app_id],
+                                                             :app_key => @options[:app_key],
+                                                             :id      => @options[:id] })
+          future = nuance_transcription.future(:transcribe, :file_contents => File.open('spec/DT-202c.wav').read)
+          future.value.status.should eql 200
+          future.value.body.should eql @transcription
+        end
+      end
+
+      describe '#non-blocking call with a block' do
+        it "should allow us to use a future to process an audio file and pass a block" do
+          nuance_transcription = Nuance::Transcription.new({ :app_id  => @options[:app_id],
+                                                             :app_key => @options[:app_key],
+                                                             :id      => @options[:id] })
+          result = nil
+          nuance_transcription.transcribe!(:file_contents => File.open('spec/DT-202c.wav').read) do |transcription| 
+            result = transcription
+          end
+          sleep 0.1
+          result.status.should eql 200
+          result.body.should eql @transcription
+        end
+      end
+    end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'fakeweb'
+require 'nuance'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+#FakeWeb.allow_net_connect = false
+
+RSpec.configure do |config|
+
+end

metadata

@@ -0,0 +1,217 @@
+--- !ruby/object:Gem::Specification
+name: nuance
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Jason Goecke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nuance
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.3
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+- !ruby/object:Gem::Dependency
+  name: facter
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.7.1
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+description: A Ruby Gem for consuming the Nuance transcription and text to speech
+  REST APIs
+email: jason@goecke.net
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- .DS_Store
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- examples/DT-202c.wav
+- examples/transcribe.rb
+- lib/nuance.rb
+- lib/nuance/dictation-base64.cer
+- lib/nuance/text_to_speech.rb
+- lib/nuance/transcription.rb
+- nuance.gemspec
+- spec/.DS_Store
+- spec/DT-202c.wav
+- spec/nuance-text_to_speech_spec.rb
+- spec/nuance-transcription_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/jsgoecke/nuance
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 808019071920198107
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: A Ruby Gem for consuming the Nuance transcription and text to speech REST
+  APIs
+test_files: []