mac-say 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: e6eda8a2384074e1bb34ecd7a88da75657720e9a
-  data.tar.gz: fcc81dc4096ee88460cba904653218b4b0e0e916
+SHA256:
+  metadata.gz: 7fbd8952d1388b8784f78db4baf677ccb88da4219377fd2b268a0d843b3cb04a
+  data.tar.gz: f0e497209c8b6f9b5e3e29d3b2adcab49c5376e2a6c9613375dbe66dd0aa1af6
 SHA512:
-  metadata.gz: fdf2b718734f76ef1c4918d1ad2858e0022e61dea79abe39bb38bb65f5ef8c234c5adc0cdf86d238b4b10a0732acbb76f7ad52a327c7cd32636beaa800daa957
-  data.tar.gz: e11e7500d77c929c337caaa97bcd14d147de4e847f3e971bf1bc62b055fbe09bd94daefeba54bf923976a74dc28547c0627307e12139d348e26f9f23c1ac273b
+  metadata.gz: efac1b9b152281063b8540cab4d88e7561f405a3edf560409b808b061f0b410fe6bad88b3db857bb6eff83b070a0280d1220e6920e9852e6f26fb3a4881d36ca
+  data.tar.gz: 4de62bb491c7bb0fdd6c8311b5d7cf2d905a78c0fe0a1479ee3a7d32e8926028960e1714a191e7c5d6b8a8a63f406a4d526f2bf41e27bbdacf93a365daf590cb

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2017 Serge Bedzhyk
+Copyright (c) 2022 Serge Bedzhyk
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -203,17 +203,21 @@ rescue Mac::Say::UnknownVoiceAttribute => e
 end
 ```
 
-## Installing & Updating MacOS TTS Voices
+## Installing & Updating MacOS TTS Voices (MacOS 12.2+)
 
-Open `System Preferences` using Spotlight / Alfred / Dock and follow text or visual instructions:
+Open `System Preferences` using  Menu / Spotlight / Alfred / Dock and follow text or visual instructions:
 
 ```
-System Preferences → Accessibility → Speech → System Voice →
+System Preferences → Accessibility → Spoken Content → System Voice →
 → Customize… → (select voices) → OK → (Wait for download…)
 ```
 
 ![Installing & Updating MacOS TTS Voices](./img/voices_manual.png)
 
+## Caveats
+
+- All the `Siri...` voices you might see in the system voices list are not available in `say`, that's why you can not user them
+
 ## Dev Notes
 
 ```sh
@@ -239,8 +243,17 @@ $ bundle exec m
 $ bundle exec m ./test/test_mac-say.rb:34
 ```
 
+__Additionally to update dependencies I use my [one-liner](https://gist.github.com/smileart/9d1d17e9da8cba19f792304fd4b0e58d).__
+
+```
+# A snippet to look for any new/unknown voices and test their attributes
+pp Mac::Say.voices.select {|v| v[:gender].nil? }
+talker = Mac::Say.new(voice: :rishi)
+talker.say string: 'Hello, my name is Rishi. I am an Indian-English voice.'
+```
+
 ## Copyright
 
-Copyright (c) 2017 Serge Bedzhyk
+Copyright (c) 2022 Serge Bedzhyk
 
 See [LICENSE.txt](./LICENSE.txt) for details.

data/lib/mac/say/version.rb

@@ -6,6 +6,6 @@ module Mac
   # Allows to use simple TTS on Mac right from Ruby scripts
   class Say
     # mac-say version
-    VERSION = '0.2.1'
+    VERSION = '0.2.2'
   end
 end

data/lib/mac/say/voices_attributes.rb

@@ -3,9 +3,10 @@
 #
 # @note Unfortunately information in system *.plist files
 #   e.g. /System/Library/Speech/Voices/<VoiceName>.SpeechVoice/Contents/Info.plist"
-#   is inconsistent, fragmentary and sometimes incorrect, but:
+#   is inconsistent, fragmentary and sometimes incorrect, but also keep in mind:
 #
 #   WARNING: all the attributes values provided here are highly subjective!!!
+#
 ADDITIONAL_VOICE_ATTRIBUTES = {
     _unknown_voice: {
       gender: nil,
@@ -409,6 +410,12 @@ ADDITIONAL_VOICE_ATTRIBUTES = {
       quality: :medium,
       singing: false
     },
+    neel: {
+      gender: :male,
+      joke: false,
+      quality: :medium,
+      singing: false
+    },
     nicolas: {
       gender: :male,
       joke: false,
@@ -481,6 +488,12 @@ ADDITIONAL_VOICE_ATTRIBUTES = {
       quality: :low,
       singing: false
     },
+    rishi: {
+      gender: :male,
+      joke: false,
+      quality: :low,
+      singing: false
+    },
     samantha: {
       gender: :female,
       joke: false,

data/mac-say.gemspec

@@ -30,16 +30,16 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ['lib']
 
-  gem.add_development_dependency 'bundler', '~> 1.10'
-  gem.add_development_dependency 'minitest', '~> 5.0'
-  gem.add_development_dependency 'minitest-reporters', '~> 1.1'
-  gem.add_development_dependency 'rake', '~> 12.0'
-  gem.add_development_dependency 'simplecov', '~> 0.12'
+  gem.add_development_dependency 'bundler', '~> 2.3'
+  gem.add_development_dependency 'minitest', '~> 5.15'
+  gem.add_development_dependency 'minitest-reporters', '~> 1.5'
+  gem.add_development_dependency 'rake', '~> 13.0'
+  gem.add_development_dependency 'simplecov', '~> 0.16'
   gem.add_development_dependency 'rubygems-tasks', '~> 0.2'
-  gem.add_development_dependency 'yard', '~> 0.8.7.5'
-  gem.add_development_dependency 'inch', '~> 0.7.1'
-  gem.add_development_dependency 'redcarpet', '~> 3.4'
-  gem.add_development_dependency 'github-markup', '~> 1.4'
-  gem.add_development_dependency 'm', '~> 1.5'
-  gem.add_development_dependency 'coveralls', '~> 0.8'
+  gem.add_development_dependency 'yard', '~> 0.9'
+  gem.add_development_dependency 'inch', '~> 0.8'
+  gem.add_development_dependency 'redcarpet', '~> 3.5'
+  gem.add_development_dependency 'github-markup', '~> 4.0'
+  gem.add_development_dependency 'm', '~> 1.6'
+  gem.add_development_dependency 'coveralls', '~> 0.8.23'
 end

data/test/test_mac-say.rb

@@ -10,19 +10,19 @@ describe 'Mac::Say as a macOS `say` wrapper' do
     end
 
     it 'must have a VERSION constant' do
-      Mac::Say.const_get('VERSION').wont_be_empty
+      _(Mac::Say.const_get('VERSION')).wont_be_empty
     end
 
     it 'must return available voices as an Array of Hashes' do
-      Mac::Say.voices.wont_be_empty
-      Mac::Say.voices.must_be_kind_of Array
+      _(Mac::Say.voices).wont_be_empty
+      _(Mac::Say.voices).must_be_kind_of Array
     end
 
     it 'must return specific Hash structure for a voice' do
       voice = Mac::Say.voice(:name, :alex)
-      voice.wont_be_empty
-      voice.must_be_kind_of Hash
-      voice.keys.must_equal Mac::Say::VOICE_ATTRIBUTES
+      _(voice).wont_be_empty
+      _(voice).must_be_kind_of Hash
+      _(voice.keys).must_equal Mac::Say::VOICE_ATTRIBUTES
     end
 
     it 'must return additional attributes for known voices' do
@@ -30,52 +30,52 @@ describe 'Mac::Say as a macOS `say` wrapper' do
       voice = Mac::Say.voice(:name, voice_name)
       additional_voice_attributes = ADDITIONAL_VOICE_ATTRIBUTES[voice_name]
 
-      voice[:gender].must_equal additional_voice_attributes[:gender]
-      voice[:joke].must_equal additional_voice_attributes[:joke]
-      voice[:quality].must_equal additional_voice_attributes[:quality]
+      _(voice[:gender]).must_equal additional_voice_attributes[:gender]
+      _(voice[:joke]).must_equal additional_voice_attributes[:joke]
+      _(voice[:quality]).must_equal additional_voice_attributes[:quality]
     end
 
     it '.voice must search for a voice using single attribute' do
       voice = Mac::Say.voice(:name, :alex)
-      voice[:name].must_equal :alex
+      _(voice[:name]).must_equal :alex
     end
 
     it '.voice must search for a voice using block given' do
       voices = Mac::Say.voice {|voice| voice[:language] == :en && voice[:joke] == false }
-      voices.must_be_kind_of Array
+      _(voices).must_be_kind_of Array
     end
 
     it '.voice must return one voice as a Hash' do
       voice = Mac::Say.voice(:name, :alex)
-      voice.must_be_kind_of Hash
+      _(voice).must_be_kind_of Hash
     end
 
     # For this test to pass you'd have to have more than
     # one British voice on your machine!
     it '.voice must return an Array of voices if > 1' do
       voices = Mac::Say.voice(:country, :gb)
-      voices.must_be_kind_of Array
+      _(voices).must_be_kind_of Array
     end
 
     it ".voice must return nil if voice wasn't found" do
       voices = Mac::Say.voice(:name, :xxx)
-      voices.must_be_nil
+      _(voices).must_be_nil
     end
 
 
     it '.say must return 0 in successive speech' do
       expectation = ["#{@say_path} -v 'alex' -r 175", 0]
-      Mac::Say.say('42').must_equal expectation
+      _(Mac::Say.say('42')).must_equal expectation
     end
 
     it '.say must use custom voice' do
       expectation = ["#{@say_path} -v 'alex' -r 175", 0]
-      Mac::Say.say('42', :alex).must_equal expectation
+      _(Mac::Say.say('42', :alex)).must_equal expectation
     end
 
     it '.say must work with multiple lines' do
       expectation = ["#{@say_path} -v 'alex' -r 175", 0]
-      Mac::Say.say(<<-TEXT, :alex).must_equal expectation
+      _(Mac::Say.say(<<-TEXT, :alex)).must_equal expectation
         1
         2
         3
@@ -83,13 +83,13 @@ describe 'Mac::Say as a macOS `say` wrapper' do
     end
 
     it '.say must fail on wrong voice' do
-      -> {
+      _{
         Mac::Say.say 'OMG! I lost my voice!', :wrong
       }.must_raise Mac::Say::VoiceNotFound
     end
 
     it '.voice must fail on wrong voice attribute' do
-      -> {
+      _{
         Mac::Say.voice(:tone, :enthusiastic)
       }.must_raise Mac::Say::UnknownVoiceAttribute
     end
@@ -102,24 +102,24 @@ describe 'Mac::Say as a macOS `say` wrapper' do
     end
 
     it 'must instantiate Mac::Say' do
-      @reader.must_be_instance_of Mac::Say
+      _(@reader).must_be_instance_of Mac::Say
     end
 
     it '#say must return 0 on successive speech' do
       expectation = ["#{@say_path} -v 'alex' -r 175", 0]
-      @reader.say(string: '42').must_equal expectation
+      _(@reader.say(string: '42')).must_equal expectation
     end
 
     it '#read must be a synonym of #say' do
       expectation = ["#{@say_path} -v 'alex' -r 175", 0]
-      @reader.read(string: '42').must_equal expectation
+      _(@reader.read(string: '42')).must_equal expectation
     end
 
     it '#say must support :file' do
       absolute_path = File.absolute_path './fixtures/text/en_gb_test.txt', File.dirname(__FILE__)
       expectation = ["#{@say_path} -f #{absolute_path} -v 'alex' -r 175", 0]
 
-      @reader.say(file: absolute_path).must_equal expectation
+      _(@reader.say(file: absolute_path)).must_equal expectation
     end
 
     it '#say must read :file from initial config' do
@@ -127,17 +127,16 @@ describe 'Mac::Say as a macOS `say` wrapper' do
       expectation = ["#{@say_path} -f #{absolute_path} -v 'alex' -r 175", 0]
 
       @reader = Mac::Say.new(file: absolute_path)
-      @reader.say.must_equal expectation
+      _(@reader.say).must_equal expectation
     end
 
     it 'must return nil additional attrs for unknown voices' do
       if ENV['USE_FAKE_SAY']
         voice = @reader.voice(:name, :test)
-        additional_voice_attributes = ADDITIONAL_VOICE_ATTRIBUTES[:test]
 
-        voice[:gender].must_be_nil
-        voice[:joke].must_be_nil
-        voice[:quality].must_be_nil
+        _(voice[:gender]).must_be_nil
+        _(voice[:joke]).must_be_nil
+        _(voice[:quality]).must_be_nil
       end
     end
 
@@ -149,90 +148,90 @@ describe 'Mac::Say as a macOS `say` wrapper' do
 
       # init
       @reader = Mac::Say.new(file: gb_absolute_path)
-      @reader.config[:file].must_equal gb_absolute_path
+      _(@reader.config[:file]).must_equal gb_absolute_path
 
       # change
-      @reader.say(file: us_absolute_path).must_equal expectation
-      @reader.config[:file].must_equal us_absolute_path
+      _(@reader.say(file: us_absolute_path)).must_equal expectation
+      _(@reader.config[:file]).must_equal us_absolute_path
     end
 
     it '#say must prioritise :file over :string' do
       absolute_path = File.absolute_path './fixtures/text/en_gb_test.txt', File.dirname(__FILE__)
       expectation = ["#{@say_path} -f #{absolute_path} -v 'alex' -r 175", 0]
 
-      @reader.say(string: 'test', file: absolute_path).must_equal expectation
+      _(@reader.say(string: 'test', file: absolute_path)).must_equal expectation
     end
 
     it '#say must support custom :rate' do
       expectation = ["#{@say_path} -v 'alex' -r 250", 0]
-      @reader.say(string: '42', rate: 250).must_equal expectation
+      _(@reader.say(string: '42', rate: 250)).must_equal expectation
     end
 
     it '#say must support custom :voice' do
       expectation = ["#{@say_path} -v 'fiona' -r 175", 0]
-      @reader.say(string: '42', voice: :fiona).must_equal expectation
+      _(@reader.say(string: '42', voice: :fiona)).must_equal expectation
     end
 
     it '#say must change the :voice' do
       expectation = ["#{@say_path} -v 'fiona' -r 175", 0]
-      @reader.config[:voice].must_equal :alex
+      _(@reader.config[:voice]).must_equal :alex
 
-      @reader.say(string: '42', voice: :fiona).must_equal expectation
-      @reader.config[:voice].must_equal :fiona
+      _(@reader.say(string: '42', voice: :fiona)).must_equal expectation
+      _(@reader.config[:voice]).must_equal :fiona
 
-      @reader.say(string: '13').must_equal expectation
+      _(@reader.say(string: '13')).must_equal expectation
     end
 
     it '#say must change the :rate' do
       expectation = ["#{@say_path} -v 'alex' -r 300", 0]
-      @reader.config[:rate].must_equal 175
+      _(@reader.config[:rate]).must_equal 175
 
-      @reader.say(string: '42', rate: 300).must_equal expectation
-      @reader.config[:rate].must_equal 300
+      _(@reader.say(string: '42', rate: 300)).must_equal expectation
+      _(@reader.config[:rate]).must_equal 300
 
-      @reader.say(string: '13').must_equal expectation
+      _(@reader.say(string: '13')).must_equal expectation
     end
 
     it '#say must fail on wrong initial voice' do
-      -> {
+      _{
         talker = Mac::Say.new(voice: :wrong)
         talker.say string: 'OMG! I lost my voice!'
       }.must_raise Mac::Say::VoiceNotFound
     end
 
     it '#say must fail on wrong dynamic voice' do
-      -> {
+      _{
         talker = Mac::Say.new
         talker.say string: 'OMG! I lost my voice!', voice: :wrong
       }.must_raise Mac::Say::VoiceNotFound
     end
 
     it '#voice must fail on wrong say path' do
-      -> {
+      _{
         Mac::Say.new(say_path: '/wrong/wrong/path').voice(:name, :alex)
       }.must_raise Mac::Say::CommandNotFound
     end
 
     it '#say must fail on wrong say path' do
-      -> {
+      _{
         Mac::Say.new(say_path: '/wrong/wrong/path').say 'test'
       }.must_raise Mac::Say::CommandNotFound
     end
 
     it '#say must fail on wrong file path' do
-      -> {
+      _{
         Mac::Say.new.say(file: '/wrong/wrong/path')
       }.must_raise Mac::Say::FileNotFound
     end
 
     it '#voice must fail on wrong attribute' do
-      -> {
+      _{
         Mac::Say.new.voice(:articulation, :nostalgic)
       }.must_raise Mac::Say::UnknownVoiceAttribute
     end
 
     it '#say must fail on initial wrong file path' do
-      -> {
+      _{
         Mac::Say.new(file: '/wrong/wrong/path').say
       }.must_raise Mac::Say::FileNotFound
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mac-say
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Serge Bedzhyk
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-10 00:00:00.000000000 Z
+date: 2022-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,70 +16,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '2.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.15'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.15'
 - !ruby/object:Gem::Dependency
   name: minitest-reporters
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.16'
 - !ruby/object:Gem::Dependency
   name: rubygems-tasks
   requirement: !ruby/object:Gem::Requirement
@@ -100,84 +100,84 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.7.5
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.7.5
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: inch
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.1
+        version: '0.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.7.1
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.4'
+        version: '3.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.4'
+        version: '3.5'
 - !ruby/object:Gem::Dependency
   name: github-markup
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: m
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: 0.8.23
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: 0.8.23
 description: Ruby wrapper around the modern version of the macOS `say` command. Inspired
   by the @bratta's mactts
 email: smileart21@gmail.com
@@ -229,8 +229,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Ruby wrapper around the macOS `say` command