RubiSpeech 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 369299c826cd1d82dbb2c1787e38b184a4b19939b0aeaac47ef20d01ad1f1b3d
+  data.tar.gz: 5c311538e7123bc6a13125488d9e2219cabcea8c20bceaf30439a38b50ee14cf
+SHA512:
+  metadata.gz: c130a500cb17a03cde4a9ea856f9414f712c0c81d8bd6272661f3f4a2ae7d8889217c767b6b09163ac3762701a20ca14181e498369aeece7d4f1a79de0a0541c
+  data.tar.gz: df9933b84c3917716cb0a625e98597ac57379e73b777d4b1060f1f40a41801117d98f812955ff08990d4fef6764497ae419d32e3621e312a8807ce9620fe4df3

data/Gemfile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in my_speech_library.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+gem "rspec", "~> 3.0"

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/Readme.md

@@ -0,0 +1,152 @@
+# RubiSpeech
+
+A lightweight, cross-platform Ruby gem for text-to-speech functionality. RubiSpeech is designed for AI applications and natural language processing systems, with the ability to detect and adapt to different operating systems (Windows, macOS, Linux).
+
+[![Gem Version](https://badge.fury.io/rb/RubiSpeech.svg)](https://badge.fury.io/rb/RubiSpeech)
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Features
+
+- Cross-platform text-to-speech capabilities
+- Automatic operating system detection
+- Easy-to-use API
+- Supports Windows, macOS, and Linux
+- Designed for AI and NLP applications
+
+## Requirements
+
+- Ruby >= 2.6.0
+- Windows: No additional requirements (uses System.Speech via PowerShell)
+- macOS: No additional requirements (uses built-in `say` command)
+- Linux: `espeak` package installed
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'RubiSpeech'
+```
+
+And then execute:
+
+```
+$ bundle install
+```
+
+Or install it yourself as:
+
+```
+$ gem install RubiSpeech
+```
+
+## Usage
+
+### Quick Start
+
+```ruby
+require 'my_speech_library'
+
+# Simple usage - speak text immediately
+MySpeechLibrary.talk("Hello, world!")
+```
+
+### Creating an Instance
+
+```ruby
+require 'my_speech_library'
+
+# Create a speech instance
+speech = MySpeechLibrary::Speech.new
+
+# Speak some text
+speech.talk("Hello, I'm speaking using RubiSpeech library")
+
+# Check the current operating system
+current_os = speech.current_os
+puts "Current operating system: #{current_os}"
+```
+
+### Multiple Phrases with Interval
+
+```ruby
+require 'my_speech_library'
+
+# Create a new instance
+speaker = MySpeechLibrary::Speech.new
+
+# Phrases to speak
+phrases = [
+  "Welcome to the Ruby world",
+  "This is a text-to-speech library",
+  "Works on Windows, Mac, and Linux"
+]
+
+# Speak each phrase with a time interval
+phrases.each do |phrase|
+  speaker.talk(phrase)
+  sleep(2) # Wait for 2 seconds between phrases
+end
+```
+
+### Direct Use of Components
+
+```ruby
+require 'my_speech_library'
+
+# Use the OS detector directly
+os_detector = MySpeechLibrary::OSDetector.new
+puts "Is the system Windows? #{os_detector.windows?}"
+puts "Is the system macOS? #{os_detector.macos?}"
+puts "Is the system Linux? #{os_detector.linux?}"
+
+# Use the speaker directly
+speaker = MySpeechLibrary::Speaker.new(os_detector)
+speaker.speak("This is a test using the Speaker class directly")
+```
+
+### Simple Translation Application Example
+
+```ruby
+require 'my_speech_library'
+
+def translate_and_speak(text, language)
+  # This is a hypothetical translation example (in a real app, you'd need a translation service)
+  translated = case language
+               when :english
+                 "This is translated to English: " + text
+               when :french
+                 "C'est traduit en français: " + text
+               else
+                 text
+               end
+  
+  # Speak the translated text
+  MySpeechLibrary.talk(translated)
+end
+
+# Use the function
+translate_and_speak("Hello world", :french)
+```
+
+## How It Works
+
+RubiSpeech uses system commands to provide text-to-speech functionality:
+
+- On Windows: PowerShell with System.Speech
+- On macOS: The built-in `say` command
+- On Linux: The `espeak` command (must be installed)
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+
+# RubiSpeech

data/examples/example-1.rb

@@ -0,0 +1,76 @@
+# Example 1: Quick Usage (Direct Method)
+require 'my_speech_library'
+
+# Use the helper function for immediate speech
+MySpeechLibrary.talk("Hello, world!")
+
+
+# Example 2: Creating and Using an Instance
+require 'my_speech_library'
+
+# Create an instance of the main class
+speech = MySpeechLibrary::Speech.new
+
+# Use the object to speak text
+speech.talk("Hello, I'm speaking using RubiSpeech library")
+
+# Get the current operating system
+current_os = speech.current_os
+puts "Current operating system: #{current_os}"
+
+
+# Example 3: Using the Library in a Script (Multiple Phrases)
+#!/usr/bin/env ruby
+require 'my_speech_library'
+
+# Create a new instance
+speaker = MySpeechLibrary::Speech.new
+
+# Phrases to speak
+phrases = [
+  "Welcome to the Ruby world",
+  "This is a text-to-speech library",
+  "Works on Windows, Mac, and Linux"
+]
+
+# Speak each phrase with a time interval
+phrases.each do |phrase|
+  speaker.talk(phrase)
+  sleep(2) # Wait for 2 seconds between phrases
+end
+
+
+# Example 4: Direct Use of Different Components
+require 'my_speech_library'
+
+# Use the OS detector directly
+os_detector = MySpeechLibrary::OSDetector.new
+puts "Is the system Windows? #{os_detector.windows?}"
+puts "Is the system macOS? #{os_detector.macos?}"
+puts "Is the system Linux? #{os_detector.linux?}"
+
+# Use the speaker directly
+speaker = MySpeechLibrary::Speaker.new(os_detector)
+speaker.speak("This is a test using the Speaker class directly")
+
+
+# Example 5: Using the Library in a Simple Translation Application
+require 'my_speech_library'
+
+def translate_and_speak(text, language)
+  # This is a hypothetical translation example (in a real app, you'd need a translation service)
+  translated = case language
+               when :english
+                 "This is translated to English: " + text
+               when :french
+                 "C'est traduit en français: " + text
+               else
+                 text
+               end
+  
+  # Speak the translated text
+  MySpeechLibrary.talk(translated)
+end
+
+# Use the function
+translate_and_speak("Hello world", :french)

data/lib/my_speech_library/os_detector.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module MySpeechLibrary
+    class OSDetector
+      OS_TYPES = {
+        windows: /mswin|mingw|cygwin/,
+        macos: /darwin/,
+        linux: /linux/
+      }.freeze
+      
+      def detect_os
+        @detected_os ||= begin
+          host_os = RbConfig::CONFIG['host_os']
+          
+          OS_TYPES.each do |os_type, pattern|
+            return os_type if host_os =~ pattern
+          end
+          
+          :unknown
+        end
+      end
+      
+      def windows?
+        detect_os == :windows
+      end
+      
+      def macos?
+        detect_os == :macos
+      end
+      
+      def linux?
+        detect_os == :linux
+      end
+      
+      def unknown?
+        detect_os == :unknown
+      end
+    end
+  end

data/lib/my_speech_library/speaker.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module MySpeechLibrary
+    class Speaker
+      def initialize(os_detector)
+        @os_detector = os_detector
+      end
+      
+      def speak(text)
+        command = speech_command(text)
+        
+        if command.nil?
+          error_message = "The operating system #{@os_detector.detect_os} is not supported for voice pronunciation"
+          warn error_message
+          raise UnsupportedOSError, error_message
+        end
+        
+        result = system(command)
+        
+        result
+      end
+      
+      private
+      
+      def speech_command(text)
+        case @os_detector.detect_os
+        when :windows
+          escaped_text = text.gsub("'", "''")
+          %{powershell -Command "Add-Type -AssemblyName System.Speech; (New-Object System.Speech.Synthesis.SpeechSynthesizer).Speak('#{escaped_text}')"}
+        when :macos
+          escaped_text = text.gsub("'", "'\\''")
+          "say '#{escaped_text}'"
+        when :linux
+          escaped_text = text.gsub("'", "'\\''")
+          "espeak '#{escaped_text}'"
+        else
+          nil
+        end
+      end
+    end
+  end

data/lib/my_speech_library/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module MySpeechLibrary
+    VERSION = "0.1.0"
+end

data/lib/my_speech_library.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative "my_speech_library/version"
+require_relative "my_speech_library/os_detector"
+require_relative "my_speech_library/speaker"
+
+module MySpeechLibrary
+  class Error < StandardError; end
+  
+  class Speech
+    def initialize
+      @os_detector = OSDetector.new
+      @speaker = Speaker.new(@os_detector)
+    end
+    
+    def talk(text)
+      @speaker.speak(text)
+    end
+    
+    def current_os
+      @os_detector.detect_os
+    end
+  end
+  
+  def self.talk(text)
+    Speech.new.talk(text)
+  end
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: RubiSpeech
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Maven
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-03-09 00:00:00.000000000 Z
+dependencies: []
+description: A library for text-to-speech functionality designed for AI applications
+  and natural language processing, with the ability to detect and adapt to the operating
+  system (Windows, macOS, Linux)
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- Rakefile
+- Readme.md
+- examples/example-1.rb
+- lib/my_speech_library.rb
+- lib/my_speech_library/os_detector.rb
+- lib/my_speech_library/speaker.rb
+- lib/my_speech_library/version.rb
+homepage: https://github.com/Abo5/RubiSpeech
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/Abo5/RubiSpeech
+  source_code_uri: https://github.com/Abo5/RubiSpeech
+  changelog_uri: https://github.com/Abo5/RubiSpeech/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.3
+signing_key:
+specification_version: 4
+summary: Ruby text-to-speech library for AI applications
+test_files: []