voice_vault 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9390ead1be0a849d1b4b37fa5f0c201808dd7403
+  data.tar.gz: 54ad45c4a5e9408b8bb71ce9cac2250b71da1d44
+SHA512:
+  metadata.gz: 3b5691111aaecd17ef7a6ac73639a65f624354dc5a72615e7922db22f53e370c8f87e3f6abc27fd2dbf2f7e53df69010692041ff5a42f0b050117a8dc6673f77
+  data.tar.gz: df0734e4e3860d1b05f5cb45595334234c76e3d854169cd3ce96a5ff8d66e9315600719c95f4948cf893c3db46d8b5d00020f117a7f956a00b9c4b9bbd45dccc

data/.gitignore

@@ -0,0 +1,3 @@
+Gemfile.lock
+example/config.yml
+pkg/*.gem

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+gemspec
+
+gem 'rspec', '~> 3.0.0'
+gem 'rspec-its'
+gem 'webmock'
+gem 'vcr'

data/README.md

@@ -0,0 +1,13 @@
+# VoiceVault.com API wrapper
+
+## License
+
+(The MIT License)
+
+Copyright © 2014 Bernard Potocki
+
+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/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new do |t|
+  t.rspec_opts = ["-c", "-f progress"]
+  t.pattern = 'spec/**/*_spec.rb'
+end
+
+task default: :spec

data/example/config.yml.example

@@ -0,0 +1,5 @@
+VIGO_APP_ID: app_id
+VIGO_CREDENTIAL_ID: credential_id
+VIGO_CREDENTIAL_PWD: credental_password
+VIGO_SERVER_URL: server_id
+CONFIGURATION_ID: 4-digit configuration_id

data/example/create.rb

@@ -0,0 +1,49 @@
+require_relative '../lib/voice_vault.rb'
+require 'tempfile'
+require 'yaml'
+
+# Input your registration details here (from your self-registration welcome email)
+config = YAML.load_file('config.yml')
+
+server_url = config['VIGO_SERVER_URL']
+credential_id = config['VIGO_CREDENTIAL_ID']
+credential_password = config['VIGO_CREDENTIAL_PWD']
+app_id = config['VIGO_APP_ID']
+configuration_id = config['CONFIGURATION_ID']
+
+# Create new connection for given credentials
+connection = VoiceVault::Connection.new(server_url, credential_id, credential_password)
+
+# Attempt to register a new claimant
+claimant = VoiceVault::Claimant.create(connection, app_id)
+puts "Registered claimant id: #{claimant.id}"
+
+# Start a new dialogue for the claimant
+dialogue = VoiceVault::Dialogue.create(claimant, configuration_id, reference: 'Ruby REST API sample')
+puts "Started dialogue id: #{dialogue.id}"
+
+begin
+  next_prompt = dialogue.prompt
+
+  puts "Requested input: #{next_prompt}."
+  puts "Recording in 3 seconds..."
+  sleep 3
+
+  file = Tempfile.new ["voice_vault", ".wav"]
+
+  system("rec -c 1 --endian little -r 8k -b 16 -V1 #{file.path} trim 0 00:05")
+
+  # Submit the recorded audio file to the new dialogue
+  result = dialogue.submit_phrase file, 'LittleEndian'
+
+  # Poll until processing completes.
+  until result != "TooManyUnprocessedPhrases"
+    sleep 1
+    result = dialogue.update_status
+  end
+  puts dialogue.last_sqm_decision unless dialogue.last_sqm_decision == "NotSet"
+end while dialogue.status == "Started"
+
+# Print the final status of the dialogue
+puts "Dialogue completed. Status = #{dialogue.status}"
+puts "Reason: #{dialogue.failure_reason}" if dialogue.status == "Failed"

data/example/verify.rb

@@ -0,0 +1,58 @@
+require_relative '../lib/voice_vault.rb'
+require 'tempfile'
+require 'yaml'
+
+unless ARGV.size == 1
+  puts("Usage: ruby #{__FILE__} claimant_id")
+  exit
+end
+
+claimant_id = ARGV[0]
+
+# Input your registration details here (from your self-registration welcome email)
+config = YAML.load_file('config.yml')
+
+server_url = config['VIGO_SERVER_URL']
+credential_id = config['VIGO_CREDENTIAL_ID']
+credential_password = config['VIGO_CREDENTIAL_PWD']
+configuration_id = config['CONFIGURATION_ID']
+
+# Create new connection for given credentials
+connection = VoiceVault::Connection.new(server_url, credential_id, credential_password)
+
+# Attempt to register a new claimant
+claimant = VoiceVault::Claimant.new(claimant_id, connection)
+puts "Registered claimant id: #{claimant.id}"
+
+# Start a new dialogue for the claimant
+dialogue = VoiceVault::Dialogue.create(claimant, configuration_id, reference: 'Ruby REST API sample')
+puts "Started dialogue id: #{dialogue.id}"
+
+begin
+  next_prompt = dialogue.prompt
+
+  puts "Requested input: #{next_prompt}."
+  puts "Recording in 3 seconds..."
+  sleep 3
+
+  file = Tempfile.new ["voice_vault", ".wav"]
+
+  system("rec -c 1 --endian little -r 8k -b 16 -V1 #{file.path} trim 0 00:05")
+
+  # Submit the recorded audio file to the new dialogue
+  result = dialogue.submit_phrase file, 'LittleEndian'
+
+  # Poll until processing completes.
+  until result != "TooManyUnprocessedPhrases"
+    sleep 1
+    result = dialogue.update_status
+  end
+  puts dialogue.last_sqm_decision unless dialogue.last_sqm_decision == "NotSet"
+end while dialogue.status == "Started"
+
+# Print the final status of the dialogue
+puts "Dialogue completed. Status = #{dialogue.status}"
+case dialogue.status
+  when 'Failed' then puts "Reason: #{dialogue.failure_reason}"
+  when 'Succeeded' then puts "Verification decission: #{dialogue.verification_decision}"
+end

data/lib/voice_vault.rb

@@ -0,0 +1,9 @@
+module VoiceVault
+  class Error < StandardError; end
+
+  ROOT = File.expand_path(File.dirname(__FILE__))
+
+  autoload :Claimant,    "#{ROOT}/voice_vault/claimant"
+  autoload :Connection,  "#{ROOT}/voice_vault/connection"
+  autoload :Dialogue,    "#{ROOT}/voice_vault/dialogue"
+end

data/lib/voice_vault/claimant.rb

@@ -0,0 +1,38 @@
+module VoiceVault
+  class Claimant
+
+    # Register a new "claimant" to be enrolled within VoiceVault Fusion
+    # The organisation unit ID (GUID) representing the customer for this instance
+    # In email from VoiceVault it's named "VIGO_APP_ID"
+    def self.create(connection, app_id)
+      params = {
+        organisation_unit: app_id
+      }
+      result = connection.post "RegisterClaimant.ashx", params
+
+      raise VoiceVault::Error.new("Failed to register claimant: #{result["message"]}") if result["status_code"] != "0"
+
+      new(result["claimant_id"], connection)
+    end
+
+    attr_reader :id, :connection
+
+    def initialize(id, connection)
+      @id = id
+      @connection = connection
+    end
+
+    # Remove all data from VoiceVault servers
+    def destroy
+      params = {
+        claimant_id: @id
+      }
+      result = @connection.post "DeleteClaiamant.ashx", params
+
+      raise VoiceVault::Error.new("Failed to register claimant: #{result["message"]}") if result["status_code"] != "0"
+
+      result["request_status"]
+    end
+
+  end
+end

data/lib/voice_vault/connection.rb

@@ -0,0 +1,73 @@
+require "net/http"
+require "uri"
+require "rexml/document"
+
+module VoiceVault
+  class Connection
+    include REXML
+
+    FORM_BOUNDARY = "AaB03x"
+
+    attr_reader :server_url, :creds
+
+    # Instantiate the API helper
+    def initialize server_url, credential_id, credential_password
+      @server_url = server_url
+      @default_params = {"username" => credential_id, "password" => credential_password}
+    end
+
+    # Takes care of the HTTP POST to the VoiceVault Fusion REST API
+    # Taken directly from VoiceVault example.
+    def post page, params = {}
+      # Set up our HTTP request
+      uri = URI::join(@server_url, page)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      request = Net::HTTP::Post.new(uri.request_uri)
+
+      # Add our credentials to the parameters before we construct the form
+      params.update @default_params
+
+      # If we have audio, we need to construct the multipart form by hand.
+      # Note: gems such as "multipart" or "rest_client" can greatly simplify this process
+      if audio_file = params.delete(:audio_file)
+        post_body = []
+
+        params.each do |k, v|
+          post_body << "--#{FORM_BOUNDARY}\r\n"
+          post_body << "Content-Disposition: form-data; name=\"#{k}\"\r\n\r\n#{v}\r\n"
+        end
+
+        post_body << "--#{FORM_BOUNDARY}\r\n"
+        post_body << "Content-Disposition: form-data; name=\"utterance\"; filename=\"audio.wav\"\r\n"
+        post_body << "Content-Type: audio/wav\r\n\r\n"
+        post_body << audio_file.read
+        post_body << "\r\n--#{FORM_BOUNDARY}--\r\n"
+
+        request.content_type = "multipart/form-data, boundary=#{FORM_BOUNDARY}"
+        request.body = post_body.join
+      else
+        # Much simpler if we're not doing a multipart submission!
+        request.set_form_data(params)
+      end
+
+      # Do the actual HTTP post
+      begin
+        response = http.request(request)
+
+        # And parse the XML response into a hash
+        response_xml = Document.new(response.body)
+        hash = {}
+        response_xml.elements.each("response_info/*") do |e|
+          hash[e.name()] = e.text
+        end
+
+        # Return the populated hash
+        hash
+      rescue => e
+        raise VoiceVault::Error.new(e.message)
+      end
+    end
+
+  end
+end

data/lib/voice_vault/dialogue.rb

@@ -0,0 +1,90 @@
+module VoiceVault
+  class Dialogue
+
+    # Begin a new enrollment or verification dialogue
+    def self.create claimant, configuration_id, opts = {}
+      params = {
+        configuration_id: configuration_id,
+        claimant_id: claimant.id,
+        external_ref: opts[:reference],
+        language: opts[:language] || 'EnglishUnitedStates'
+      }
+      result = claimant.connection.post "StartDialogue.ashx", params
+
+      raise VoiceVault::Error.new("Failed to start dialogue: #{result["message"]}") if result["status_code"] != "0"
+
+      new(result["dialogue_id"], claimant, prompt: result["prompt_hint"])
+    end
+
+    attr_reader :id, :connection, :prompt, :status, :failure_reason, :last_sqm_decision, :verification_decision
+
+    def initialize(id, claimant, opts = {})
+      @id = id
+      @claimant = claimant
+      @connection = claimant.connection
+      @prompt = opts[:prompt]
+      @status = opts[:status] || "Started"
+    end
+
+    # Submit audio VoiceVault servers
+    # Supported formats are: 'SmallEndian', 'BigEndian', 'ALaw' and 'MuLaw'
+    def submit_phrase file, format, opts = {}
+      params = {
+        dialogue_id: @id,
+        prompt: opts[:prompt] || @prompt,
+        format: format,
+        audio_file: file
+      }
+      result = @connection.post "SubmitPhrase.ashx", params
+
+      handle_result(result)
+    end
+
+    # Retrieve the status of a dialogue
+    def update_status
+      params = {
+        dialogue_id: @id
+      }
+      result = @connection.post "GetDialogueSummary.ashx", params
+
+      handle_result(result)
+    end
+
+    # Destroy current dialogue - especially important during enrollment dialogues as
+    # only one can be active at the same time.
+    def destroy
+      params = {
+        dialogue_id: @id
+      }
+      result = @connection.post "AbortDialogue.ashx", params
+
+      handle_result(result)
+    end
+
+    # Informs VoiceVault servers that current conversation should be used for
+    # improving claimant pattern.
+    def adapt
+      params = {
+        claimant_id: @claimant.id,
+        dialogue_id: @id
+      }
+      result = @connection.post "AdaptClaiamant.ashx", params
+
+      handle_result(result)
+    end
+
+    private
+
+    def handle_result(result)
+      raise VoiceVault::Error.new("Failed to get dialogue summary: #{result["message"]}") if result["status_code"] != "0"
+      @status = result["dialogue_status"]
+      @prompt = result["prompt_hint"]
+      @failure_reason = result["failure_reason"]
+      @last_sqm_decision = result["last_sqm_decision"]
+      @verification_decision = result["verification_decision"]
+
+      result["request_status"]
+    end
+
+  end
+end

data/lib/voice_vault/version.rb

@@ -0,0 +1,3 @@
+module VoiceVault
+  VERSION = '0.1.0'
+end

data/spec/claimant_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe VoiceVault::Claimant, vcr: { cassette_name: 'claimant', record: :new_episodes, match_requests_on: [:method, :uri, :body] } do
+  let(:connection) { VoiceVault::Connection.new(server_url, credential_id, credential_password) }
+  subject { VoiceVault::Claimant.create(connection, app_id) }
+
+  its(:class) { is_expected.to eql(VoiceVault::Claimant) }
+  its(:id) { is_expected.to eql('73c32c2b-c4b2-47ac-94d3-539b0ac838fc') }
+  its(:connection) { eql(connection) }
+
+  context "#create" do
+    it "should raise exception on invalid app id" do
+      expect{ VoiceVault::Claimant.create(connection, "invalid") }.to raise_error(VoiceVault::Error, "Failed to register claimant: Value cannot be null.\nParameter name: organisation_unit")
+    end
+    it "should raise exception on invalid server_url" do
+      connection = VoiceVault::Connection.new("http://invalid.com", credential_id, credential_password)
+      expect{ VoiceVault::Claimant.create(connection, app_id) }.to raise_error(VoiceVault::Error, "SSL_connect returned=1 errno=0 state=SSLv2/v3 read server hello A: unknown protocol")
+    end
+    it "should raise exception on invalid credential_id" do
+      connection = VoiceVault::Connection.new(server_url, "invalid_id", credential_password)
+      expect{ VoiceVault::Claimant.create(connection, app_id) }.to raise_error(VoiceVault::Error, "Failed to register claimant: Error delegating to SOAP service")
+    end
+    it "should raise exception on invalid credential_id" do
+      connection = VoiceVault::Connection.new(server_url, credential_id, "invalid_password")
+      expect{ VoiceVault::Claimant.create(connection, app_id) }.to raise_error(VoiceVault::Error, "Failed to register claimant: Error delegating to SOAP service")
+    end
+  end
+end

data/spec/dialogue_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe VoiceVault::Dialogue, vcr: { cassette_name: 'dialogue', record: :new_episodes, match_requests_on: [:method, :uri, :body] } do
+  let(:connection) { VoiceVault::Connection.new(server_url, credential_id, credential_password) }
+  let(:claimant) { VoiceVault::Claimant.create(connection, app_id) }
+  subject { VoiceVault::Dialogue.create(claimant, configuration_id) }
+
+  its(:class) { is_expected.to eql(VoiceVault::Dialogue) }
+  its(:id) { is_expected.to eql('c19156b8-829b-ab71-b92a-177e49a3c22f') }
+  its(:connection) { is_expected.to eql(connection) }
+  its(:prompt) { is_expected.to eql('2459') }
+  its(:status) { is_expected.to eql('Started') }
+  its(:failure_reason) { is_expected.to be_nil }
+  its(:last_sqm_decision) { is_expected.to be_nil }
+  its(:verification_decision) { is_expected.to be_nil }
+
+  it "#update_status should return status" do
+    expect(subject.update_status).to eql("OK")
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+require 'rspec'
+require 'rspec/its'
+require 'vcr'
+
+require 'voice_vault'
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
+
+RSpec.configure do |c|
+  c.extend VCR::RSpec::Macros
+end
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/vcr_cassettes'
+  c.hook_into :webmock
+  c.configure_rspec_metadata!
+end

data/spec/support/config.rb

@@ -0,0 +1,5 @@
+def server_url; ENV['VIGO_SERVER_URL'] || 'https://example.org/'; end
+def credential_id; ENV['VIGO_CREDENTIAL_ID'] || 'fake_credential_id'; end
+def credential_password; ENV['VIGO_CREDENTIAL_PWD'] || 'fake_credential_password'; end
+def app_id; ENV['VIGO_APP_ID'] || 'fake_app_id'; end
+def configuration_id; ENV['VIGO_CONFIGURATION_ID'] || 'fake_configuration_id'; end

data/spec/vcr_cassettes/claimant.yml

@@ -0,0 +1,186 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://invalid.voicevault.net/RestApi000/RegisterClaimant.ashx
+    body:
+      encoding: US-ASCII
+      string: organisation_unit=fake_app_id&username=fake_credential_id&password=fake_credential_password
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/xml; charset=utf-8
+      Vary:
+      - Accept-Encoding
+      Server:
+      - Microsoft-IIS/8.0
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Fri, 13 Jun 2014 10:42:23 GMT
+      Content-Length:
+      - '300'
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" encoding="ISO-8859-1"?>
+        <response_info xmlns="http://www.voicevault.com">
+        <status_code>0</status_code>
+        <message>success</message>
+        <claimant_id>73c32c2b-c4b2-47ac-94d3-539b0ac838fc</claimant_id>
+        </response_info>
+    http_version:
+  recorded_at: Fri, 13 Jun 2014 10:42:21 GMT
+- request:
+    method: post
+    uri: https://invalid.voicevault.net/RestApi000/RegisterClaimant.ashx
+    body:
+      encoding: US-ASCII
+      string: organisation_unit=invalid&username=fake_credential_id&password=fake_credential_password
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/xml; charset=utf-8
+      Vary:
+      - Accept-Encoding
+      Server:
+      - Microsoft-IIS/8.0
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Fri, 13 Jun 2014 10:42:23 GMT
+      Content-Length:
+      - '309'
+    body:
+      encoding: UTF-8
+      string: "<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?>\n<response_info xmlns=\"http://www.voicevault.com\">\n<status_code>2</status_code>\n<message>Value
+        cannot be null.\r\nParameter name: organisation_unit</message>\n<claimant_id>(null)</claimant_id>\n</response_info>\n"
+    http_version:
+  recorded_at: Fri, 13 Jun 2014 10:42:22 GMT
+- request:
+    method: post
+    uri: https://invalid.voicevault.net/RestApi000/RegisterClaimant.ashx
+    body:
+      encoding: US-ASCII
+      string: organisation_unit=fake_app_id&username=invalid_id&password=fake_credential_password
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/xml; charset=utf-8
+      Vary:
+      - Accept-Encoding
+      Server:
+      - Microsoft-IIS/8.0
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Fri, 13 Jun 2014 10:42:23 GMT
+      Content-Length:
+      - '289'
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" encoding="ISO-8859-1"?>
+        <response_info xmlns="http://www.voicevault.com">
+        <status_code>1</status_code>
+        <message>Error delegating to SOAP service</message>
+        <claimant_id>(null)</claimant_id>
+        </response_info>
+    http_version:
+  recorded_at: Fri, 13 Jun 2014 10:42:24 GMT
+- request:
+    method: post
+    uri: https://invalid.voicevault.net/RestApi000/RegisterClaimant.ashx
+    body:
+      encoding: US-ASCII
+      string: organisation_unit=fake_app_id&username=fake_credential_id&password=invalid_password
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/xml; charset=utf-8
+      Vary:
+      - Accept-Encoding
+      Server:
+      - Microsoft-IIS/8.0
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Fri, 13 Jun 2014 10:43:36 GMT
+      Content-Length:
+      - '289'
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" encoding="ISO-8859-1"?>
+        <response_info xmlns="http://www.voicevault.com">
+        <status_code>1</status_code>
+        <message>Error delegating to SOAP service</message>
+        <claimant_id>(null)</claimant_id>
+        </response_info>
+    http_version:
+  recorded_at: Fri, 13 Jun 2014 10:43:37 GMT
+recorded_with: VCR 2.9.2

data/spec/vcr_cassettes/dialogue.yml

@@ -0,0 +1,151 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://invalid.voicevault.net/RestApi000/RegisterClaimant.ashx
+    body:
+      encoding: US-ASCII
+      string: organisation_unit=fake_app_id&username=fake_credential_id&password=fake_credential_password
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/xml; charset=utf-8
+      Vary:
+      - Accept-Encoding
+      Server:
+      - Microsoft-IIS/8.0
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Fri, 13 Jun 2014 10:42:23 GMT
+      Content-Length:
+      - '300'
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" encoding="ISO-8859-1"?>
+        <response_info xmlns="http://www.voicevault.com">
+        <status_code>0</status_code>
+        <message>success</message>
+        <claimant_id>73c32c2b-c4b2-47ac-94d3-539b0ac838fc</claimant_id>
+        </response_info>
+    http_version:
+  recorded_at: Fri, 13 Jun 2014 10:42:21 GMT
+- request:
+    method: post
+    uri: https://invalid.voicevault.net/RestApi000/StartDialogue.ashx
+    body:
+      encoding: US-ASCII
+      string: configuration_id=fake_configuration_id&claimant_id=73c32c2b-c4b2-47ac-94d3-539b0ac838fc&external_ref&language=EnglishUnitedStates&username=fake_credential_id&password=fake_credential_password
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/xml; charset=utf-8
+      Vary:
+      - Accept-Encoding
+      Server:
+      - Microsoft-IIS/8.0
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Fri, 13 Jun 2014 10:59:45 GMT
+      Content-Length:
+      - '336'
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" encoding="ISO-8859-1"?>
+        <response_info xmlns="http://www.voicevault.com">
+        <status_code>0</status_code>
+        <message>success</message>
+        <dialogue_id>c19156b8-829b-ab71-b92a-177e49a3c22f</dialogue_id>
+        <prompt_hint>2459</prompt_hint>
+        <process_type>Enrol</process_type>
+        </response_info>
+    http_version:
+  recorded_at: Fri, 13 Jun 2014 10:59:46 GMT
+- request:
+    method: post
+    uri: https://invalid.voicevault.net/RestApi000/GetDialogueSummary.ashx
+    body:
+      encoding: US-ASCII
+      string: dialogue_id=c19156b8-829b-ab71-b92a-177e49a3c22f&username=fake_credential_id&password=fake_credential_password
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Content-Type:
+      - application/x-www-form-urlencoded
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Cache-Control:
+      - private
+      Content-Type:
+      - text/xml; charset=utf-8
+      Vary:
+      - Accept-Encoding
+      Server:
+      - Microsoft-IIS/8.0
+      X-Aspnet-Version:
+      - 4.0.30319
+      X-Powered-By:
+      - ASP.NET
+      Date:
+      - Fri, 13 Jun 2014 11:10:14 GMT
+      Content-Length:
+      - '375'
+    body:
+      encoding: UTF-8
+      string: |
+        <?xml version="1.0" encoding="ISO-8859-1"?>
+        <response_info xmlns="http://www.voicevault.com">
+        <status_code>0</status_code>
+        <message>success</message>
+        <dialogue_status>Started</dialogue_status>
+        <failure_reason>NotSet</failure_reason>
+        <request_status>OK</request_status>
+        <prompt_hint>2459</prompt_hint>
+        <last_sqm_decision>NotSet</last_sqm_decision>
+        <verification_decision>NotApplicable</verification_decision>
+        </response_info>
+    http_version:
+  recorded_at: Fri, 13 Jun 2014 11:10:15 GMT
+recorded_with: VCR 2.9.2

data/voice_vault.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "voice_vault/version"
+
+Gem::Specification.new do |s|
+  s.name        = "voice_vault"
+  s.version     = VoiceVault::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Bernard Potocki"]
+  s.email       = ["bernard.potocki@imanel.org"]
+  s.homepage    = "http://github.com/rebased/voice_vault-ruby"
+  s.summary     = %q{Wrapper around VoiceVault.com API}
+  s.description = %q{Wrapper around VoiceVault.com API}
+
+  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"]
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification
+name: voice_vault
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Bernard Potocki
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-13 00:00:00.000000000 Z
+dependencies: []
+description: Wrapper around VoiceVault.com API
+email:
+- bernard.potocki@imanel.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- Rakefile
+- example/config.yml.example
+- example/create.rb
+- example/verify.rb
+- lib/voice_vault.rb
+- lib/voice_vault/claimant.rb
+- lib/voice_vault/connection.rb
+- lib/voice_vault/dialogue.rb
+- lib/voice_vault/version.rb
+- spec/claimant_spec.rb
+- spec/dialogue_spec.rb
+- spec/spec_helper.rb
+- spec/support/config.rb
+- spec/vcr_cassettes/claimant.yml
+- spec/vcr_cassettes/dialogue.yml
+- voice_vault.gemspec
+homepage: http://github.com/rebased/voice_vault-ruby
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Wrapper around VoiceVault.com API
+test_files:
+- spec/claimant_spec.rb
+- spec/dialogue_spec.rb
+- spec/spec_helper.rb
+- spec/support/config.rb
+- spec/vcr_cassettes/claimant.yml
+- spec/vcr_cassettes/dialogue.yml