win32-sapi 0.1.4

data/CHANGES

@@ -0,0 +1,20 @@
+== 0.1.4 - 29-Jul-2007
+* Added a Rakefile with tasks for installation and testing.
+* Removed the install.rb file. The Rakefile now handles installation.
+* Removed the doc/sapi5.txt file. It was merged into the README.
+* Some doc updates.
+
+== 0.1.3 - 9-Nov-2005
+* Fixed SpInProcRecognizer class name.
+
+== 0.1.2 - 17-Jun-2005
+* Added a gemspec.
+* Some minor updates to the README and test file.
+* Removed the doc/sapi5.rd file.  Made the doc/sapi5.txt file roc friendly.
+
+== 0.1.1 - 1-Mar-2005
+* Moved the 'examples' directory to the toplevel directory.
+* Made the CHANGES and README files rdoc friendly.
+
+== 0.1.0 - 12-Oct-2004
+* Initial release

data/MANIFEST

@@ -0,0 +1,8 @@
+* CHANGES
+* README
+* MANIFEST
+* Rakefile
+* win32-sapi.gemspec
+* examples/sapi5_test.rb
+* lib/win32/sapi5.rb
+* test/tc_sapi5.rb

data/README

@@ -0,0 +1,69 @@
+== Description
+   This is a Ruby interface to the Microsoft Speech API, 5.1
+	
+== Prerequisites
+   The Microsoft Speech API 5.1. It can be downloaded for free from 
+   http://www.microsoft.com/speech.
+   
+   Ruby 1.8.2 or later.
+   
+== Installation
+   rake test (optional)
+   rake install (non-gem) or rake install_gem (gem)
+	
+== Synopsis
+   require 'win32/sapi5'
+   include Win32
+	
+   v = SpVoice.new
+   v.Speak("Shall we play a game?")
+	
+== Constants
+SAPI5::VERSION
+	The current version of this package.
+	
+== Notes
+   This module is a simple interface to the Microsoft Speech API 5.1.  There
+   are interfaces to all of the Automation classes that this API consists of.
+   Each class is a subclass of the SAPI5 class, which is in turn a subclass
+   of WIN32OLE. With your object you can then call the available methods for
+   that particular Automation class.
+
+   This documentation won't offer the complete documentation for every method.
+   Instead, download the Microsoft Speech API 5.1 documentation (a .chm file)
+   and read the part that covers 'Automation'.
+	
+== Known Bugs
+   None known. Any bugs should be reported on the project page at
+   http://rubyforge.org/projects/win32utils.
+	
+== Acknowledgements
+   Thanks go to Jouke Visser for his Win32::SAPI5 Perl module, on which this
+   library is based.
+	
+== Support
+   The Microsoft SAPI 5.1 SDK is supported on news://microsoft.public.speech_tech.sdk
+	
+== Future Plans
+   Suggestions welcome.
+	
+== License
+   Ruby's
+	
+== Copyright
+   (C) 2003-2007 Daniel J. Berger
+   All Rights Reserved	
+	
+== Warranty
+   This package is provided "as is" and without any express or
+   implied warranties, including, without limitation, the implied
+   warranties of merchantability and fitness for a particular purpose.
+	
+== Author(s)
+   Daniel J. Berger
+   djberg96 at gmail dot com
+   imperator on IRC (irc.freenode.net)
+	
+   Park Heesob
+   phasis at nownuri dot net
+   phasis68 on IRC (irc.freenode.net)

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+
+desc "Install the win32-sapi package (non-gem)"
+task :install do
+   dest = File.join(Config::CONFIG['sitelibdir'], 'win32')
+   Dir.mkdir(dest) unless File.exists? dest
+   cp 'lib/win32/sapi5.rb', dest, :verbose => true
+end
+
+desc "Install the win32-sapi package as a gem"
+task :install_gem do
+   ruby 'win32-sapi.gemspec'
+   file = Dir["*.gem"].first
+   sh "gem install #{file}"
+end
+
+Rake::TestTask.new do |t|
+   t.libs << 'lib'
+   t.warning = true
+   t.test_files = FileList['test/tc*']
+end

data/lib/win32/sapi5.rb

@@ -0,0 +1,129 @@
+require "win32ole"
+
+# The Win32 module serves as a namespace only.
+module Win32
+
+   #--
+   # The values provided in the various initializers come from the Windows
+   # registry. Look in HKLM\Software\Classes\CLSID.
+   #++
+
+   # An abstract base class for the SAPI automation classes
+   class SAPI5 < WIN32OLE
+      VERSION = '0.1.4'
+   end
+   
+   class SpAudioFormat < SAPI5
+      def initialize
+         super("{9EF96870-E160-4792-820D-48CF0649E4EC}")
+      end
+   end
+   
+   class SpCustomStream < SAPI5
+      def initialize
+         super("{8DBEF13F-1948-4aa8-8CF0-048EEBED95D8}")
+      end
+   end
+
+   class SpFileStream < SAPI5
+      def initialize
+         super("{947812B3-2AE1-4644-BA86-9E90DED7EC91}")
+      end
+   end
+   
+   class SpInProcRecoContext < SAPI5
+      def initialize
+         super("{73AD6842-ACE0-45E8-A4DD-8795881A2C2A}")
+      end
+   end
+   
+   class SpInProcRecognizer < SAPI5
+      def initialize
+         super("{41B89B6B-9399-11D2-9623-00C04F8EE628}")
+      end
+   end
+   
+   class SpLexicon < SAPI5
+      def initialize
+         super("{0655E396-25D0-11D3-9C26-00C04F8EF87C}")
+      end
+   end
+   
+   class SpMemoryStream < SAPI5
+      def initialize
+         super("{5FB7EF7D-DFF4-468a-B6B7-2FCBD188F994}")
+      end
+   end
+   
+   class SpMMAudioIn < SAPI5
+      def initialize
+         super("{CF3D2E50-53F2-11D2-960C-00C04F8EE628}")
+      end
+   end
+   
+   class SpMMAudioOut < SAPI5
+      def initialize
+         super("{A8C680EB-3D32-11D2-9EE7-00C04F797396}")
+      end
+   end
+   
+   class SpObjectToken < SAPI5
+      def initialize
+         super("{EF411752-3736-4CB4-9C8C-8EF4CCB58EFE}")
+      end
+   end
+   
+   class SpObjectTokenCategory < SAPI5
+      def initialize
+         super("{A910187F-0C7A-45AC-92CC-59EDAFB77B53}")
+      end
+   end
+   
+   class SpPhoneConverter < SAPI5
+      def initialize
+         super("{9185F743-1143-4C28-86B5-BFF14F20E5C8}")
+      end
+   end
+   
+   class SpPhraseInfoBuilder < SAPI5
+      def initialize
+         super("{C23FC28D-C55F-4720-8B32-91F73C2BD5D1}")
+      end
+   end
+   
+   class SpSharedRecoContext < SAPI5
+      def initialize
+         super("{47206204-5ECA-11D2-960F-00C04F8EE628}")
+      end
+   end
+   
+   class SpSharedRecognizer < SAPI5
+      def initialize
+         super("{3BEE4890-4FE9-4A37-8C1E-5E7E12791C1F}")
+      end
+   end
+   
+   class SpTextSelectionInformation < SAPI5
+      def initialize
+         super("{0F92030A-CBFD-4AB8-A164-FF5985547FF6}")
+      end
+   end
+   
+   class SpUnCompressedLexicon < SAPI5
+      def initialize
+         super("{C9E37C15-DF92-4727-85D6-72E5EEB6995A}")
+      end
+   end
+      
+   class SpVoice < SAPI5
+      def initialize
+         super("{96749377-3391-11D2-9EE3-00C04F797396}")
+      end
+   end
+   
+   class SpWaveFormatEx < SAPI5
+      def initialize
+         super("{C79A574C-63BE-44b9-801F-283F87F898BE}")
+      end
+   end
+end

data/test/tc_sapi5.rb

@@ -0,0 +1,103 @@
+#############################################################################
+# tc_sapi5.rb
+#
+# Test suite for the sapi5 class.  For now, we're simply going to test that
+# the constructors work without incident.  There are simply too many methods
+# for me to test.  If the constructor works, the methods should be
+# available.
+#
+# I may eventually split each class into its own test file.
+#
+# You should run this test case via the 'rake test' Rake task.
+#############################################################################
+require "win32/sapi5"
+require "test/unit"
+include Win32
+
+class TC_Win32_SAPI5 < Test::Unit::TestCase
+   def setup
+   end
+   
+   def test_version
+      assert_equal("0.1.4", SAPI5::VERSION)
+   end
+   
+   def test_SpAudioFormat
+      assert_nothing_raised{ SpAudioFormat.new }
+   end
+   
+   def test_SpCustomStream
+      assert_nothing_raised{ SpCustomStream.new }
+   end
+   
+   def test_SpFileStream
+      assert_nothing_raised{ SpFileStream.new }
+   end
+   
+   def test_SpInProcRecoContext
+      assert_nothing_raised{ SpInProcRecoContext.new }
+   end
+   
+   def test_SpInProcRecognizer
+      assert_nothing_raised{ SpInProcRecognizer.new }
+   end
+   
+   def test_SpLexicon
+      assert_nothing_raised{ SpLexicon.new }
+   end
+   
+   def test_SpMemoryStream
+      assert_nothing_raised{ SpMemoryStream.new }
+   end
+   
+   def test_SpMMAudioIn
+      assert_nothing_raised{ SpMMAudioIn.new }
+   end
+   
+   def test_SpMMAudioOut
+      assert_nothing_raised{ SpMMAudioOut.new }
+   end
+   
+   def test_SpObjectToken
+      assert_nothing_raised{ SpObjectToken.new }
+   end
+   
+   def test_SpObjectTokenCategory
+      assert_nothing_raised{ SpObjectTokenCategory.new }
+   end
+   
+   def test_SpPhoneConverter
+      assert_nothing_raised{ SpPhoneConverter.new }
+   end
+   
+   def test_SpPhraseInfoBuilder
+      assert_nothing_raised{ SpPhraseInfoBuilder.new }
+   end
+   
+   def test_SpSharedRecoContext
+      assert_nothing_raised{ SpSharedRecoContext.new }
+   end
+   
+   def test_SpSharedRecognizer
+      assert_nothing_raised{ SpSharedRecognizer.new }
+   end
+   
+   def test_SpTextSelectionInformation
+      assert_nothing_raised{ SpTextSelectionInformation.new }
+   end
+   
+   def test_SpUnCompressedLexicon
+      assert_nothing_raised{ SpUnCompressedLexicon.new }
+   end
+   
+   def test_SpVoice
+      assert_nothing_raised{ SpVoice.new }
+   end
+   
+   def test_SpWaveFormatEx
+      assert_nothing_raised{ SpWaveFormatEx.new }
+   end
+   
+   def teardown
+   end
+end

data/win32-sapi.gemspec

@@ -0,0 +1,23 @@
+require "rubygems"
+
+spec = Gem::Specification.new do |gem|
+   gem.name        = "win32-sapi"
+   gem.version     = "0.1.4"
+   gem.author      = "Daniel J. Berger"
+   gem.email       = "djberg96@gmail.com"
+   gem.homepage    = "http://www.rubyforge.org/projects/win32utils"
+   gem.platform    = Gem::Platform::RUBY
+   gem.summary     = "An interface to the MS SAPI (Sound API) library."
+   gem.description = "An interface to the MS SAPI (Sound API) library."
+   gem.test_file   = "test/tc_sapi5.rb"
+   gem.has_rdoc    = true
+   gem.files = Dir['lib/win32/*.rb'] + Dir['[A-Z]*']  + Dir['test/*']
+   gem.files.reject! { |fn| fn.include? "CVS" }
+   gem.require_path = "lib"
+   gem.extra_rdoc_files = ['README', 'CHANGES', 'MANIFEST']
+end
+
+if $0 == __FILE__
+   Gem.manage_gems
+   Gem::Builder.new(spec).build
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.2
+specification_version: 1
+name: win32-sapi
+version: !ruby/object:Gem::Version 
+  version: 0.1.4
+date: 2007-07-30 00:00:00 -06:00
+summary: An interface to the MS SAPI (Sound API) library.
+require_paths: 
+- lib
+email: djberg96@gmail.com
+homepage: http://www.rubyforge.org/projects/win32utils
+rubyforge_project: 
+description: An interface to the MS SAPI (Sound API) library.
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Daniel J. Berger
+files: 
+- lib/win32/sapi5.rb
+- CHANGES
+- CVS
+- examples
+- lib
+- MANIFEST
+- Rakefile
+- README
+- test
+- win32-sapi.gemspec
+- test/CVS
+- test/tc_sapi5.rb
+test_files: 
+- test/tc_sapi5.rb
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+- CHANGES
+- MANIFEST
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+