bach 0.0.1

data/README.md

@@ -0,0 +1,74 @@
+# Bach
+
+In the later years of his life, Johann Sebastion Bach became increasingly
+blind. His final works were dictated from his deathbed.
+
+This project, Bach, provides text-to-speech as a service.
+
+
+Up and running fast
+-------------------
+
+I've provided a Vagrant setup that will get you up and running fast. Install
+the necessary gems using Bundler:
+
+    $ cd /path/to/checkout/of/bach
+    $ bundle
+
+Ask Vagrant to bring up the server components for you:
+
+    $ cd /path/to/checkout/of/bach
+    $ bundle exec vagrant up
+
+Ask Bach to translate a file full of text to an audio file:
+
+    $ cd /path/to/checkout/of/bach
+    $ bundle exec ./bin/bach < textfile > speech.mp3
+
+That's it, text-to-speech with very little fuss.
+
+Of course, if you want to use it as a real service on your network you'll
+probably want to set it up a little differently. See the following sections on
+Installing and Usage for information on how to setup your own text-to-speech
+service.
+
+
+Installing
+----------
+
+The server needs eSpeak and Lame installed. Mostly I do this using `apt-get`:
+
+    $ apt-get install espeak lame
+
+You'll need a broker that talks Stomp somewhere on your network. I use Apache
+Apollo, and I'm not totally sure if the code uses anything that's specific to
+that. I'd love it to be broker-agnostic though, so if you have patches that'll
+bring this closer to reality please send them to me!
+
+
+Usage
+-----
+
+Run the server, somewhere that has eSpeak and Lame installed:
+
+    $ bachd --broker=stomp://mq.yourdomain.com:61613
+
+Use the services on the command line. You don't need to have eSpeak
+installed on your client machines, just Bach.
+
+A brief example of what interacting with Bach looks like, here
+converting the text of the Gettysberb address to an mp3:
+
+    $ curl -O http://history.eserver.org/gettysburg-address.txt
+    $ bach --broker=stomp://mq.yourdomain.com:61613 \
+      < ./gettysburg-address.txt > .//gettysburg-address.mp3
+
+I explicitly state the broker in the above commands but if you leave out that
+option it'll default to stomp://localhost:61613 ie it expects a broker running
+on your local machine if you don't tell it otherwise.
+
+
+Authors
+-------
+
+Craig R Webster <http://barkingiguana.com/>

data/bin/bach

@@ -0,0 +1,35 @@
+#! /usr/bin/env ruby
+
+require 'base64'
+require 'stomp'
+require 'json'
+require "getoptlong"
+
+options = {}
+argv = GetoptLong.new(
+  [ "--broker", "-b", GetoptLong::OPTIONAL_ARGUMENT ]
+)
+argv.each do |option, value|
+  options['broker'] = value if option == '--broker'
+end
+options['broker'] ||= 'stomp://127.0.0.1:61613'
+
+text = ARGF.read
+encoded_text = Base64.encode64 text
+command = { text: encoded_text }
+command_json = JSON.generate command
+
+results = '/queue/bach.results-' + Process.pid.to_s + '-' + Time.now.to_i.to_s
+client = Stomp::Client.new options['broker']
+
+client.subscribe results, 'auto-delete' => true do |message|
+  results = JSON.parse message.body
+  encoded_output = results['output']
+  decoded_output = Base64.decode64 encoded_output
+  print decoded_output
+  client.close
+end
+
+client.publish '/queue/bach', command_json, 'reply-to' => results
+
+client.join

data/bin/bachd

@@ -0,0 +1,91 @@
+#! /usr/bin/env ruby
+
+require 'stomp'
+require 'json'
+require 'base64'
+require 'getoptlong'
+require 'espeak-ruby'
+
+class Job
+  include ESpeak
+
+  def serial
+    @serial ||= random_id
+  end
+
+  def random_id
+    [ File.basename($0), Time.now.to_i, rand(1_000_000) ].join '-'
+  end
+
+  def working_directory
+    @working_directory ||= %x[mktemp -d -t #{serial}-XXXXXX].strip
+  end
+
+  def clean_up
+    %x[test -d "#{@working_directory}" && rm -rf "#{@working_directory}"]
+  end
+
+  def hostname
+    %x[hostname].strip
+  end
+
+  def temp_file_name ext = nil
+    File.join working_directory, "#{random_id}#{ext}"
+  end
+
+  attr_accessor :options
+  private :options, :options=
+
+  def initialize options
+    self.options = options
+  end
+
+  def execute
+    sanitize_options!
+    target = temp_file_name '.mp3'
+    espeak target, options
+    raw_data = File.read target
+    encoded_data = Base64.encode64 raw_data
+    {
+      :output => encoded_data,
+      :processor => {
+	:hostname => hostname,
+	:pid => Process.pid
+      }
+    }
+  ensure
+    clean_up
+  end
+
+  def sanitize_options!
+    return if @sanitized_options
+    options['text'] = Base64.decode64 options['text']
+    @sanitized_options = true
+  end
+end
+
+options = {}
+argv = GetoptLong.new(
+  [ "--broker", "-b", GetoptLong::OPTIONAL_ARGUMENT ]
+)
+argv.each do |option, value|
+  options['broker'] = value if option == '--broker'
+end
+options['broker'] ||= 'stomp://127.0.0.1:61613'
+
+client = Stomp::Client.new options['broker']
+client.subscribe '/queue/bach' do |message|
+  puts "Received #{message.headers['message-id']}"
+
+  options = JSON.parse message.body
+  results = Job.new(options).execute
+
+  result_json = JSON.generate results
+  destination = message.headers['reply-to']
+  client.publish destination, result_json
+
+  puts "Finished processing #{message.headers['message-id']}"
+end
+
+puts "Waiting for clients..."
+client.join

data/lib/bach/version.rb

@@ -0,0 +1,3 @@
+module Bach
+  VERSION = '0.0.1'
+end

data/lib/constable.rb

@@ -0,0 +1 @@
+require 'constable/version'

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: bach
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Craig R Webster
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-08 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: stomp
+  requirement: &70362642534600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70362642534600
+- !ruby/object:Gem::Dependency
+  name: espeak-ruby
+  requirement: &70362642533340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70362642533340
+description: Provide a Text-to-Speech service on the service bus
+email:
+- craig@barkingiguana.com
+executables:
+- bach
+- bachd
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/bach/version.rb
+- lib/constable.rb
+- bin/bach
+- bin/bachd
+- README.md
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- A broker capable of talking Stomp
+- A server with Lame and eSpeak installed
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Text-to-Speech as a service
+test_files: []