ruby_speech 2.1.0-java

data/spec/ruby_speech/ssml/prosody_spec.rb

@@ -0,0 +1,309 @@
+require 'spec_helper'
+
+module RubySpeech
+  module SSML
+    describe Prosody do
+      its(:name) { should == 'prosody' }
+
+      describe "setting options in initializers" do
+        subject { Prosody.new :pitch => :medium, :contour => "something", :range => '20Hz', :rate => 2, :duration => 10.seconds, :volume => :loud }
+
+        its(:pitch)     { should == :medium }
+        its(:contour)   { should == 'something' }
+        its(:range)     { should == '20Hz' }
+        its(:rate)      { should == 2 }
+        its(:duration)  { should == 10.seconds }
+        its(:volume)    { should == :loud }
+      end
+
+      it 'registers itself' do
+        Element.class_from_registration(:prosody).should == Prosody
+      end
+
+      describe "from a document" do
+        let(:document) { '<prosody pitch="medium" contour="something" range="20Hz" rate="2" duration="10" volume="loud"/>' }
+
+        subject { Element.import document }
+
+        it { should be_instance_of Prosody }
+
+        its(:pitch)     { should == :medium }
+        its(:contour)   { should == 'something' }
+        its(:range)     { should == '20Hz' }
+        its(:rate)      { should == 2 }
+        its(:duration)  { should == 10.seconds }
+        its(:volume)    { should == :loud }
+      end
+
+      describe "#pitch" do
+        context "with a pre-defined value" do
+          before { subject.pitch = :medium }
+
+          its(:pitch) { should == :medium }
+
+          it "with a valid value" do
+            lambda { subject.pitch = :'x-low' }.should_not raise_error
+            lambda { subject.pitch = :low }.should_not raise_error
+            lambda { subject.pitch = :medium }.should_not raise_error
+            lambda { subject.pitch = :high }.should_not raise_error
+            lambda { subject.pitch = :'x-high' }.should_not raise_error
+            lambda { subject.pitch = :default }.should_not raise_error
+          end
+
+          it "with an invalid value" do
+            lambda { subject.pitch = :something }.should raise_error(ArgumentError, "You must specify a valid pitch (\"[positive-number]Hz\", :\"x-low\", :low, :medium, :high, :\"x-high\", :default)")
+          end
+        end
+
+        context "with a Hertz value" do
+          describe "with a valid value" do
+            before { subject.pitch = '440Hz' }
+
+            its(:pitch) { should == '440Hz' }
+          end
+
+          it "with a negative value" do
+            lambda { subject.pitch = "-100Hz" }.should raise_error(ArgumentError, "You must specify a valid pitch (\"[positive-number]Hz\", :\"x-low\", :low, :medium, :high, :\"x-high\", :default)")
+          end
+
+          it "when missing 'hz'" do
+            lambda { subject.pitch = "440" }.should raise_error(ArgumentError, "You must specify a valid pitch (\"[positive-number]Hz\", :\"x-low\", :low, :medium, :high, :\"x-high\", :default)")
+          end
+        end
+      end
+
+      describe "#contour" do
+        before { subject.contour = "blah" }
+
+        its(:contour) { should == "blah" }
+      end
+
+      describe "#range" do
+        context "with a pre-defined value" do
+          before { subject.range = :medium }
+
+          its(:range) { should == :medium }
+
+          it "with a valid value" do
+            lambda { subject.range = :'x-low' }.should_not raise_error
+            lambda { subject.range = :low }.should_not raise_error
+            lambda { subject.range = :medium }.should_not raise_error
+            lambda { subject.range = :high }.should_not raise_error
+            lambda { subject.range = :'x-high' }.should_not raise_error
+            lambda { subject.range = :default }.should_not raise_error
+          end
+
+          it "with an invalid value" do
+            lambda { subject.range = :something }.should raise_error(ArgumentError, "You must specify a valid range (\"[positive-number]Hz\", :\"x-low\", :low, :medium, :high, :\"x-high\", :default)")
+          end
+        end
+
+        context "with a Hertz value" do
+          describe "with a valid value" do
+            before { subject.range = '440Hz' }
+
+            its(:range) { should == '440Hz' }
+          end
+
+          it "with a negative value" do
+            lambda { subject.range = "-100Hz" }.should raise_error(ArgumentError, "You must specify a valid range (\"[positive-number]Hz\", :\"x-low\", :low, :medium, :high, :\"x-high\", :default)")
+          end
+
+          it "when missing 'hz'" do
+            lambda { subject.range = "440" }.should raise_error(ArgumentError, "You must specify a valid range (\"[positive-number]Hz\", :\"x-low\", :low, :medium, :high, :\"x-high\", :default)")
+          end
+        end
+      end
+
+      describe "#rate" do
+        context "with a pre-defined value" do
+          before { subject.rate = :medium }
+
+          its(:rate) { should == :medium }
+
+          it "with a valid value" do
+            lambda { subject.rate = :'x-slow' }.should_not raise_error
+            lambda { subject.rate = :slow }.should_not raise_error
+            lambda { subject.rate = :medium }.should_not raise_error
+            lambda { subject.rate = :fast }.should_not raise_error
+            lambda { subject.rate = :'x-fast' }.should_not raise_error
+            lambda { subject.rate = :default }.should_not raise_error
+          end
+
+          it "with an invalid value" do
+            lambda { subject.rate = :something }.should raise_error(ArgumentError, "You must specify a valid rate ([positive-number](multiplier), :\"x-slow\", :slow, :medium, :fast, :\"x-fast\", :default)")
+          end
+        end
+
+        context "with a multiplier value" do
+          describe "with a valid value" do
+            before { subject.rate = 1.5 }
+
+            its(:rate) { should == 1.5 }
+          end
+
+          it "with a negative value" do
+            lambda { subject.rate = -100 }.should raise_error(ArgumentError, "You must specify a valid rate ([positive-number](multiplier), :\"x-slow\", :slow, :medium, :fast, :\"x-fast\", :default)")
+          end
+        end
+      end
+
+      describe "#duration" do
+        context "with a valid value" do
+          before { subject.duration = 3.seconds }
+
+          its(:duration) { should == 3.seconds }
+        end
+
+        context "with a negative value" do
+          it do
+            lambda { subject.duration = -3.seconds }.should raise_error(ArgumentError, "You must specify a valid duration (positive float value in seconds)")
+          end
+        end
+
+        context "with an invalid value" do
+          it do
+            lambda { subject.duration = 'blah' }.should raise_error(ArgumentError, "You must specify a valid duration (positive float value in seconds)")
+          end
+        end
+      end
+
+      describe "#volume" do
+        context "with a pre-defined value" do
+          before { subject.volume = :medium }
+
+          its(:volume) { should == :medium }
+
+          it "with a valid value" do
+            lambda { subject.volume = :silent }.should_not raise_error
+            lambda { subject.volume = :'x-soft' }.should_not raise_error
+            lambda { subject.volume = :soft }.should_not raise_error
+            lambda { subject.volume = :medium }.should_not raise_error
+            lambda { subject.volume = :loud }.should_not raise_error
+            lambda { subject.volume = :'x-loud' }.should_not raise_error
+            lambda { subject.volume = :default }.should_not raise_error
+          end
+
+          it "with an invalid value" do
+            lambda { subject.volume = :something }.should raise_error(ArgumentError, "You must specify a valid volume ([positive-number](0.0 -> 100.0), :silent, :\"x-soft\", :soft, :medium, :loud, :\"x-loud\", :default)")
+          end
+        end
+
+        context "with a multiplier" do
+          describe "with a valid value" do
+            before { subject.volume = 1.5 }
+
+            its(:volume) { should == 1.5 }
+          end
+
+          it "with a negative value" do
+            lambda { subject.volume = -1.5 }.should raise_error(ArgumentError, "You must specify a valid volume ([positive-number](0.0 -> 100.0), :silent, :\"x-soft\", :soft, :medium, :loud, :\"x-loud\", :default)")
+            lambda { subject.volume = 100.5 }.should raise_error(ArgumentError, "You must specify a valid volume ([positive-number](0.0 -> 100.0), :silent, :\"x-soft\", :soft, :medium, :loud, :\"x-loud\", :default)")
+          end
+        end
+      end
+
+      describe "comparing objects" do
+        it "should be equal if the content, strength and base uri are the same" do
+          Prosody.new(:pitch => :medium, :contour => "something", :range => '20Hz', :rate => 2, :duration => 10.seconds, :volume => :loud, :content => "Hello there").should == Prosody.new(:pitch => :medium, :contour => "something", :range => '20Hz', :rate => 2, :duration => 10.seconds, :volume => :loud, :content => "Hello there")
+        end
+
+        describe "when the content is different" do
+          it "should not be equal" do
+            Prosody.new(:content => "Hello").should_not == Prosody.new(:content => "Hello there")
+          end
+        end
+
+        describe "when the pitch is different" do
+          it "should not be equal" do
+            Prosody.new(:pitch => :medium).should_not == Prosody.new(:pitch => :high)
+          end
+        end
+
+        describe "when the contour is different" do
+          it "should not be equal" do
+            Prosody.new(:contour => 'foo').should_not == Prosody.new(:contour => 'bar')
+          end
+        end
+
+        describe "when the range is different" do
+          it "should not be equal" do
+            Prosody.new(:range => '20Hz').should_not == Prosody.new(:range => '30Hz')
+          end
+        end
+
+        describe "when the rate is different" do
+          it "should not be equal" do
+            Prosody.new(:rate => 2).should_not == Prosody.new(:rate => 3)
+          end
+        end
+
+        describe "when the duration is different" do
+          it "should not be equal" do
+            Prosody.new(:duration => 10.seconds).should_not == Prosody.new(:duration => 20.seconds)
+          end
+        end
+
+        describe "when the volume is different" do
+          it "should not be equal" do
+            Prosody.new(:volume => :loud).should_not == Prosody.new(:volume => :soft)
+          end
+        end
+      end
+
+      describe "<<" do
+        it "should accept String" do
+          lambda { subject << 'anything' }.should_not raise_error
+        end
+
+        it "should accept Audio" do
+          lambda { subject << Audio.new }.should_not raise_error
+        end
+
+        it "should accept Break" do
+          lambda { subject << Break.new }.should_not raise_error
+        end
+
+        it "should accept Emphasis" do
+          lambda { subject << Emphasis.new }.should_not raise_error
+        end
+
+        it "should accept Mark" do
+          lambda { subject << Mark.new }.should_not raise_error
+        end
+
+        it "should accept P" do
+          lambda { subject << P.new }.should_not raise_error
+        end
+
+        it "should accept Phoneme" do
+          lambda { subject << Phoneme.new }.should_not raise_error
+        end
+
+        it "should accept Prosody" do
+          lambda { subject << Prosody.new }.should_not raise_error
+        end
+
+        it "should accept S" do
+          lambda { subject << S.new }.should_not raise_error
+        end
+
+        it "should accept SayAs" do
+          lambda { subject << SayAs.new(:interpret_as => :foo) }.should_not raise_error
+        end
+
+        it "should accept Sub" do
+          lambda { subject << Sub.new }.should_not raise_error
+        end
+
+        it "should accept Voice" do
+          lambda { subject << Voice.new }.should_not raise_error
+        end
+
+        it "should raise InvalidChildError with non-acceptable objects" do
+          lambda { subject << 1 }.should raise_error(InvalidChildError, "A Prosody can only accept String, Audio, Break, Emphasis, Mark, P, Phoneme, Prosody, SayAs, Sub, S, Voice as children")
+        end
+      end
+    end # Prosody
+  end # SSML
+end # RubySpeech

data/spec/ruby_speech/ssml/s_spec.rb

@@ -0,0 +1,92 @@
+require 'spec_helper'
+
+module RubySpeech
+  module SSML
+    describe S do
+      its(:name) { should == 's' }
+
+      describe "setting options in initializers" do
+        subject { S.new :language => 'jp' }
+
+        its(:language) { should == 'jp' }
+      end
+
+      it 'registers itself' do
+        Element.class_from_registration(:s).should == S
+      end
+
+      describe "from a document" do
+        let(:document) { '<s>foo</s>' }
+
+        subject { Element.import document }
+
+        it { should be_instance_of S }
+        its(:content) { should == 'foo' }
+      end
+
+      describe "comparing objects" do
+        it "should be equal if the content and language are the same" do
+          S.new(:language => 'jp', :content => "Hello there").should == S.new(:language => 'jp', :content => "Hello there")
+        end
+
+        describe "when the content is different" do
+          it "should not be equal" do
+            S.new(:content => "Hello").should_not == S.new(:content => "Hello there")
+          end
+        end
+
+        describe "when the language is different" do
+          it "should not be equal" do
+            S.new(:language => 'jp').should_not == S.new(:language => 'en')
+          end
+        end
+      end
+
+      describe "<<" do
+        it "should accept String" do
+          lambda { subject << 'anything' }.should_not raise_error
+        end
+
+        it "should accept Audio" do
+          lambda { subject << Audio.new }.should_not raise_error
+        end
+
+        it "should accept Break" do
+          lambda { subject << Break.new }.should_not raise_error
+        end
+
+        it "should accept Emphasis" do
+          lambda { subject << Emphasis.new }.should_not raise_error
+        end
+
+        it "should accept Mark" do
+          lambda { subject << Mark.new }.should_not raise_error
+        end
+
+        it "should accept Phoneme" do
+          lambda { subject << Phoneme.new }.should_not raise_error
+        end
+
+        it "should accept Prosody" do
+          lambda { subject << Prosody.new }.should_not raise_error
+        end
+
+        it "should accept SayAs" do
+          lambda { subject << SayAs.new(:interpret_as => :foo) }.should_not raise_error
+        end
+
+        it "should accept Sub" do
+          lambda { subject << Sub.new }.should_not raise_error
+        end
+
+        it "should accept Voice" do
+          lambda { subject << Voice.new }.should_not raise_error
+        end
+
+        it "should raise InvalidChildError with non-acceptable objects" do
+          lambda { subject << 1 }.should raise_error(InvalidChildError, "An S can only accept String, Audio, Break, Emphasis, Mark, Phoneme, Prosody, SayAs, Sub, Voice as children")
+        end
+      end
+    end # S
+  end # SSML
+end # RubySpeech

data/spec/ruby_speech/ssml/say_as_spec.rb

@@ -0,0 +1,71 @@
+require 'spec_helper'
+
+module RubySpeech
+  module SSML
+    describe SayAs do
+      subject { SayAs.new :interpret_as => 'one', :format => 'two', :detail => 'three' }
+
+      its(:name) { should == 'say-as' }
+
+      its(:interpret_as) { should == 'one' }
+      its(:format)       { should == 'two' }
+      its(:detail)       { should == 'three' }
+
+      it 'registers itself' do
+        Element.class_from_registration(:'say-as').should == SayAs
+      end
+
+      describe "from a document" do
+        let(:document) { '<say-as interpret-as="one" format="two" detail="three"/>' }
+
+        subject { Element.import document }
+
+        it { should be_instance_of SayAs }
+
+        its(:interpret_as) { should == 'one' }
+        its(:format)       { should == 'two' }
+        its(:detail)       { should == 'three' }
+      end
+
+      describe "comparing objects" do
+        it "should be equal if the content, interpret_as, format, age, variant, name are the same" do
+          SayAs.new(:interpret_as => 'jp', :format => 'foo', :detail => 'bar', :content => "hello").should == SayAs.new(:interpret_as => 'jp', :format => 'foo', :detail => 'bar', :content => "hello")
+        end
+
+        describe "when the content is different" do
+          it "should not be equal" do
+            SayAs.new(:interpret_as => 'jp', :content => "Hello").should_not == SayAs.new(:interpret_as => 'jp', :content => "Hello there")
+          end
+        end
+
+        describe "when the interpret_as is different" do
+          it "should not be equal" do
+            SayAs.new(:interpret_as => "Hello").should_not == SayAs.new(:interpret_as => "Hello there")
+          end
+        end
+
+        describe "when the format is different" do
+          it "should not be equal" do
+            SayAs.new(:interpret_as => 'jp', :format => 'foo').should_not == SayAs.new(:interpret_as => 'jp', :format => 'bar')
+          end
+        end
+
+        describe "when the detail is different" do
+          it "should not be equal" do
+            SayAs.new(:interpret_as => 'jp', :detail => 'foo').should_not == SayAs.new(:interpret_as => 'jp', :detail => 'bar')
+          end
+        end
+      end
+
+      describe "<<" do
+        it "should accept String" do
+          lambda { subject << 'anything' }.should_not raise_error
+        end
+
+        it "should raise InvalidChildError with non-acceptable objects" do
+          lambda { subject << Voice.new }.should raise_error(InvalidChildError, "A SayAs can only accept Strings as children")
+        end
+      end
+    end # SayAs
+  end # SSML
+end # RubySpeech

data/spec/ruby_speech/ssml/speak_spec.rb

@@ -0,0 +1,166 @@
+require 'spec_helper'
+
+module RubySpeech
+  module SSML
+    describe Speak do
+      it { should be_a_valid_ssml_document }
+
+      its(:name) { should == 'speak' }
+      its(:language) { should == 'en-US' }
+
+      describe "setting options in initializers" do
+        subject { Speak.new :language => 'jp', :base_uri => 'blah' }
+
+        its(:language) { should == 'jp' }
+        its(:base_uri) { should == 'blah' }
+      end
+
+      it 'registers itself' do
+        Element.class_from_registration(:speak).should == Speak
+      end
+
+      describe "from a document" do
+        let(:document) { '<speak xmlns="http://www.w3.org/2001/10/synthesis" version="1.0" xml:lang="jp" xml:base="blah"/>' }
+
+        subject { Element.import document }
+
+        it { should be_instance_of Speak }
+
+        its(:language) { should == 'jp' }
+        its(:base_uri) { should == 'blah' }
+      end
+
+      describe "#language" do
+        before { subject.language = 'jp' }
+
+        its(:language) { should == 'jp' }
+      end
+
+      describe "#base_uri" do
+        before { subject.base_uri = 'blah' }
+
+        its(:base_uri) { should == 'blah' }
+      end
+
+      describe "comparing objects" do
+        it "should be equal if the content, language and base uri are the same" do
+          Speak.new(:language => 'en-GB', :base_uri => 'blah', :content => "Hello there").should == Speak.new(:language => 'en-GB', :base_uri => 'blah', :content => "Hello there")
+        end
+
+        describe "when the content is different" do
+          it "should not be equal" do
+            Speak.new(:content => "Hello").should_not == Speak.new(:content => "Hello there")
+          end
+        end
+
+        describe "when the language is different" do
+          it "should not be equal" do
+            Speak.new(:language => 'en-US').should_not == Speak.new(:language => 'en-GB')
+          end
+        end
+
+        describe "when the base URI is different" do
+          it "should not be equal" do
+            Speak.new(:base_uri => 'foo').should_not == Speak.new(:base_uri => 'bar')
+          end
+        end
+
+        describe "when the children are different" do
+          it "should not be equal" do
+            s1 = Speak.new
+            s1 << SayAs.new(:interpret_as => 'date')
+            s2 = Speak.new
+            s2 << SayAs.new(:interpret_as => 'time')
+
+            s1.should_not == s2
+          end
+        end
+      end
+
+      it "should allow creating child SSML elements" do
+        s = Speak.new
+        s.voice :gender => :male, :content => 'Hello'
+        expected_s = Speak.new
+        expected_s << Voice.new(:gender => :male, :content => 'Hello')
+        s.should == expected_s
+      end
+
+      describe "<<" do
+        it "should accept String" do
+          lambda { subject << 'anything' }.should_not raise_error
+        end
+
+        it "should accept Audio" do
+          lambda { subject << Audio.new }.should_not raise_error
+        end
+
+        it "should accept Break" do
+          lambda { subject << Break.new }.should_not raise_error
+        end
+
+        it "should accept Emphasis" do
+          lambda { subject << Emphasis.new }.should_not raise_error
+        end
+
+        it "should accept Mark" do
+          lambda { subject << Mark.new }.should_not raise_error
+        end
+
+        it "should accept P" do
+          lambda { subject << P.new }.should_not raise_error
+        end
+
+        it "should accept Phoneme" do
+          lambda { subject << Phoneme.new }.should_not raise_error
+        end
+
+        it "should accept Prosody" do
+          lambda { subject << Prosody.new }.should_not raise_error
+        end
+
+        it "should accept SayAs" do
+          lambda { subject << SayAs.new(:interpret_as => :foo) }.should_not raise_error
+        end
+
+        it "should accept Sub" do
+          lambda { subject << Sub.new }.should_not raise_error
+        end
+
+        it "should accept S" do
+          lambda { subject << S.new }.should_not raise_error
+        end
+
+        it "should accept Voice" do
+          lambda { subject << Voice.new }.should_not raise_error
+        end
+
+        it "should raise InvalidChildError with non-acceptable objects" do
+          lambda { subject << 1 }.should raise_error(InvalidChildError, "A Speak can only accept String, Audio, Break, Emphasis, Mark, P, Phoneme, Prosody, SayAs, Sub, S, Voice as children")
+        end
+      end
+
+      describe "#to_doc" do
+        it "should create an XML document from the grammar" do
+          subject.to_doc.should == subject.document
+        end
+      end
+
+      it "should allow concatenation" do
+        speak1 = Speak.new
+        speak1 << Voice.new(:name => 'frank', :content => "Hi, I'm Frank")
+        speak2 = Speak.new
+        speak2 << "Hello there"
+        speak2 << Voice.new(:name => 'millie', :content => "Hi, I'm Millie")
+
+        expected_concat = Speak.new
+        expected_concat << Voice.new(:name => 'frank', :content => "Hi, I'm Frank")
+        expected_concat << "Hello there"
+        expected_concat << Voice.new(:name => 'millie', :content => "Hi, I'm Millie")
+
+        concat = (speak1 + speak2)
+        concat.should == expected_concat
+        concat.to_s.should_not include('default')
+      end
+    end # Speak
+  end # SSML
+end # RubySpeech

data/spec/ruby_speech/ssml/sub_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+module RubySpeech
+  module SSML
+    describe Sub do
+      its(:name) { should == 'sub' }
+
+      describe "setting options in initializers" do
+        subject { Sub.new :alias => 'foo' }
+
+        its(:alias) { should == 'foo' }
+      end
+
+      it 'registers itself' do
+        Element.class_from_registration(:sub).should == Sub
+      end
+
+      describe "from a document" do
+        let(:document) { '<sub alias="foo"/>' }
+
+        subject { Element.import document }
+
+        it { should be_instance_of Sub }
+
+        its(:alias) { should == 'foo' }
+      end
+
+      describe "comparing objects" do
+        it "should be equal if the content and alias are the same" do
+          Sub.new(:alias => 'jp', :content => "Hello there").should == Sub.new(:alias => 'jp', :content => "Hello there")
+        end
+
+        describe "when the content is different" do
+          it "should not be equal" do
+            Sub.new(:content => "Hello").should_not == Sub.new(:content => "Hello there")
+          end
+        end
+
+        describe "when the alias is different" do
+          it "should not be equal" do
+            Sub.new(:alias => 'jp').should_not == Sub.new(:alias => 'en')
+          end
+        end
+      end
+
+      describe "<<" do
+        it "should accept String" do
+          lambda { subject << 'anything' }.should_not raise_error
+        end
+
+        it "should raise InvalidChildError with non-acceptable objects" do
+          lambda { subject << Voice.new }.should raise_error(InvalidChildError, "A Sub can only accept Strings as children")
+        end
+      end
+    end # Desc
+  end # SSML
+end # RubySpeech