espeak-ruby 1.0.0 → 1.0.1

data/README.md

@@ -1,7 +1,7 @@
 espeak-ruby
 ===========
 
-espeak-ruby is a small Ruby API for utilizing [espeak](http://espeak.sourceforge.net) and [lame](http://lame.sourceforge.net/) to create Text-To-Speech mp3 files.
+espeak-ruby is a small Ruby API for utilizing [espeak](http://espeak.sourceforge.net) and [lame](http://lame.sourceforge.net/) to create Text-To-Speech mp3 files. It can also just speak (without saving).
 See the [live demo](http://rors.org/demos/espeak-ruby).
 
 Install
@@ -13,17 +13,31 @@ Add _espeak-ruby_ to Gemfile
 gem "espeak-ruby", require: "espeak"
 ```
 
-Example
--------
+Examples
+--------
+
+First you need to include ESpeak module to access espeak API
+
+```ruby
+include ESpeak
+```
+
+Then use it like this:
 
 ```ruby
 # Speaks "YO!"
-speech = ESpeak::Speech.new("YO!")
+speech = Speech.new("YO!")
 speech.speak # invokes espeak
   
 # Creates hello-de.mp3 file
-speech = ESpeak::Speech.new("Hallo Welt", voice: "de")
+speech = Speech.new("Hallo Welt", voice: "de")
 speech.save("hello-de.mp3") # invokes espeak + lame
+
+# Lists voices
+Voice.all.map { |v| v.language } # ["af", "bs", "ca", "cs", "cy", "da", "de", "el", "en", "en-sc", "en-uk", "en-uk-north", "en-uk-rp", "en-uk-wmids", "en-us", "en-wi", "eo", "es", "es-la", "fi", "fr", "fr-be", "grc", "hi", "hr", "hu", "hy", "hy", "id", "is", "it", "jbo", "ka", "kn", "ku", "la", "lv", "mk", "ml", "nci", "nl", "no", "pap", "pl", "pt", "pt-pt", "ro", "ru", "sk", "sq", "sr", "sv", "sw", "ta", "tr", "vi", "zh", "zh-yue"]
+
+# Find particular voice 
+Voice.find_by_language('en') #<ESpeak::Voice:0x007fe1d3806be8 @language="en", @name="default", @gender="M", @file="default">
 ```
 
 Features
@@ -40,7 +54,7 @@ Currently only subset of espeak features is supported.
 These are default values, and they can be easily overridden:
 
 ```ruby
-ESpeak::Speech.new("Zdravo svete", voice: "sr", pitch: 90, speed: 200).speak
+Speech.new("Zdravo svete", voice: "sr", pitch: 90, speed: 200).speak
 ```
 
 Requirements

data/lib/espeak.rb

@@ -1,3 +1,4 @@
 module ESpeak
   autoload :Speech, 'espeak/speech'
+  autoload :Voice,  'espeak/voice'
 end

data/lib/espeak/speech.rb

@@ -59,9 +59,6 @@ module ESpeak
       "lame -V2 - #{filename} #{'--quiet' if options[:quiet] == true}"
     end
 
-    def execute_system_command(filename, options)
-     end
-
     def symbolize_keys(hash)
       hash.inject({}) do |options, (key, value)|
         options[(key.to_sym rescue key) || key] = value

data/lib/espeak/voice.rb

@@ -0,0 +1,29 @@
+require 'csv'
+
+module ESpeak
+  class Voice
+    attr_reader :language, :name, :gender, :file
+    def initialize(attributes)
+      @language = attributes[:language]
+      @name     = attributes[:name]
+      @gender   = attributes[:gender]
+      @file     = attributes[:file]
+    end
+
+    def self.all
+      voices = []
+      CSV.parse(espeak_voices, headers: :first_row, col_sep: ' ') do |row|
+        voices << Voice.new(language: row[1], gender: row[2], name: row[3], file: row[4] )
+      end
+      voices
+    end
+
+    def self.find_by_language(lang)
+      all.find { |v| v.language == lang.to_s }
+    end
+
+    def self.espeak_voices
+      `espeak --voices`
+    end
+  end
+end

data/test/cases/voice_test.rb

@@ -0,0 +1,21 @@
+require "test_helper"
+
+class VoiceTest < Test::Unit::TestCase
+  include ESpeak
+
+  def setup
+    voices_file = File.read("test/fixtures/voices.txt")
+    Voice.expects(:espeak_voices).returns(voices_file)
+  end
+
+  def test_all
+    all_voices = Voice.all
+    assert all_voices.size > 0
+    assert %w(M F).include?(all_voices.first.gender)
+  end
+
+  def test_find_by_language
+    voice = Voice.find_by_language('en')
+    assert_equal 'en', voice.language
+  end
+end

data/test/fixtures/voices.txt

@@ -0,0 +1,60 @@
+Pty Language Age/Gender VoiceName       File        Other Langs
+ 5  af             M  afrikaans         af          
+ 5  bs             M  bosnian           bs          
+ 5  ca             M  catalan           ca          
+ 5  cs             M  czech             cs          
+ 5  cy             M  welsh-test        cy          
+ 5  da             M  danish            da          
+ 5  de             M  german            de          
+ 5  el             M  greek             el          
+ 5  en             M  default           default     
+ 5  en-sc          M  en-scottish       en/en-sc    (en 4)
+ 2  en-uk          M  english           en/en       (en 2)
+ 5  en-uk-north    M  lancashire        en/en-n     (en-uk 3)
+ 5  en-uk-rp       M  english_rp        en/en-rp    (en-uk 4)
+ 5  en-uk-wmids    M  english_wmids     en/en-wm    
+ 2  en-us          M  english-us        en/en-us    (en-r 5)(en 3)
+ 5  en-wi          M  en-westindies     en/en-wi    (en-uk 4)
+ 5  eo             M  esperanto         eo          
+ 5  es             M  spanish           es          
+ 5  es-la          M  spanish-latin-american es-la       (es-mx 6)
+ 5  fi             M  finnish           fi          
+ 5  fr             M  french            fr          
+ 5  fr-be          M  french (Belgium)  fr-be       
+ 5  grc            M  greek-ancient     test/grc    
+ 5  hi             M  hindi-test        hi          
+ 5  hr             M  croatian          hr          (hbs 5)
+ 5  hu             M  hungarian         hu          
+ 5  hy             M  armenian          hy          
+ 5  hy             M  armenian-west     hy-west     
+ 5  id             M  indonesian-test   id          
+ 5  is             M  icelandic-test    is          
+ 5  it             M  italian           it          
+ 5  jbo               lojban            test/jbo    
+ 5  ka                georgian-test     ka          
+ 5  kn                kannada           kn          
+ 5  ku             M  kurdish           ku          
+ 5  la             M  latin             la          
+ 5  lv             M  latvian           lv          
+ 5  mk             M  macedonian-test   mk          
+ 5  ml             M  malayalam         ml          
+ 5  nci            M  nahuatl - classical test/nci    
+ 5  nl             M  dutch-test        nl          
+ 5  no             M  norwegian         no          (nb 5)
+ 5  pap               papiamento-test   test/pap    
+ 5  pl             M  polish            pl          
+ 5  pt             M  brazil            pt          (pt-br 5)
+ 5  pt-pt          M  portugal          pt-pt       
+ 5  ro             M  romanian          ro          
+ 5  ru             M  russian_test      ru          
+ 5  sk             M  slovak            sk          
+ 5  sq             M  albanian          sq          
+ 5  sr             M  serbian           sr          
+ 5  sv             M  swedish           sv          
+ 5  sw             M  swahihi-test      sw          
+ 5  ta             M  tamil             ta          
+ 5  tr             M  turkish           tr          
+ 5  vi             M  vietnam           vi          
+ 5  zh             M  Mandarin          zh          
+ 5  zh-yue         M  cantonese         zh-yue      (yue 5)(zhy 5)
+

data/test/test_helper.rb

@@ -1,3 +1,4 @@
 require 'rubygems'
 require 'test/unit'
+require 'mocha/setup'
 require 'espeak'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: espeak-ruby
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-12 00:00:00.000000000 Z
+date: 2013-01-16 00:00:00.000000000 Z
 dependencies: []
 description: espeak-ruby is small Ruby API for utilizing ‘espeak’ and ‘lame’ to create
   Text-To-Speech mp3 files
@@ -20,9 +20,11 @@ extra_rdoc_files: []
 files:
 - Rakefile
 - lib/espeak/speech.rb
+- lib/espeak/voice.rb
 - lib/espeak.rb
-- lib/hash_ext.rb
 - test/cases/speech_test.rb
+- test/cases/voice_test.rb
+- test/fixtures/voices.txt
 - test/test_helper.rb
 - README.md
 homepage: http://github.com/dejan/espeak-ruby

data/lib/hash_ext.rb

@@ -1,9 +0,0 @@
-# from ActiveSupport
-class Hash
-
-  end
-
-  def symbolize_keys!
-    self.replace(self.symbolize_keys)
-  end
-end