ottra 0.1.0

data/Manifest

@@ -0,0 +1,9 @@
+Manifest
+README.textile
+Rakefile
+lib/config/languages.yml
+lib/ottra.rb
+lib/translator_base.rb
+lib/translators/google_translate.rb
+lib/translators/shvets_google_translate.rb
+lib/translators/tranexp_translate.rb

data/README.textile

@@ -0,0 +1,56 @@
+h1. Ottra
+
+One Translator To Rule them All!
+
+h2. The Problem
+
+The problem with language translation in ruby right now is that everyone does it differently.  If you want to use an external source to translate text in your application then you need to write you code for a specific gem.  What do you do if you realize, post implementation, that the gem doesn't support the language combinations or types that you need?  That leaves you in quite a pickle.
+
+h2. The Game Changer
+
+Ottra is different - it uses a bunch of different gems in an attempt to translate your text.  When you first create a new instance of Ottra, it runs a test translation to each of the different gems it supports and then orders them by whichever was quickest.  Then it goes through each of them trying to translate your text.  The best part?  You write your code for Ottra and then let the gem handle the oddities among the other gems.  It's that simple.
+
+h2. Sample Code
+
+Default, simple example.
+<pre><code>require 'ottra'
+t = Ottra.new
+puts t.translate_text('Hello world!', 'it')
+=> Ciao mondo!
+</code></pre>
+
+Maybe you only want to translate a single string and then send t off to the garbage collector.  It might be best to avoid sorting the translators by speed.
+<pre><code>t = Ottra.new({:no_sorting => true})
+puts t.translate_text('Hello world!', 'it')
+=> Ciao mondo!
+</code></pre>
+
+If your starting language is not English then you need to specify it as the second parameter.
+<pre><code>puts t.translate_text('Ciao mondo!', 'en', 'it')
+=> Hello World!
+</code></pre>
+
+h2. Supported Translation Gems
+
+Currently, Ottra supports shvets-google_translate, googletranslate, and tranexp.  There are tons of other translation gems out there, but I haven't gotten a chance to build in support yet.
+
+h2. But...
+
+Github is social coding!  Got a favorite translation gem?  Fork this project, add your support, and send me a pull request!
+
+h2. What About Tests?
+
+I didn't write any.  
+
+h2. But But But!  That's Blasphemy!
+
+Too bad.  Fork, write, and send me a pull request.
+
+h2. Other Notes
+
+This stuff was originally written as part of the Whatever You Say project (rails app that provides chats with on the fly translation) and then ported to an individual gem.  It's pretty rough around the edges in all aspects.  It is missing things like:
+1. Tests
+2. Installing the supported gems when you install this gem
+3. Bacon
+
+Otherwise, it works pretty well.  Give it a try and if you find something you can't/won't fix then add a github ticket.

data/Rakefile

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('ottra', '0.1.0') do |p|
+  p.description = 'One Translator (gem) To Rule (them) All!  Uses various translation gems to do language translating.'
+  p.url = 'http://github.com/patricktulskie/ottra'
+  p.author = 'Patrick Tulskie'
+  p.email = 'PatrickTulskie@gmail.com'
+  p.ignore_pattern = ['tmp/*', 'script/*', 'lib/main.rb']
+  p.dependencies = ['shvets-google_translate', 'googletranslate', 'tranexp']
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/lib/config/languages.yml

@@ -0,0 +1,43 @@
+uk: Ukrainian
+it: Italian
+zh-CN: Chinese Simplified
+no: Norwegian
+ja: Japanese
+hi: Hindi
+de: German
+fr: French
+sk: Slovak
+hu: Hungarian
+tl: Filipino
+zh: Chinese
+es: Spanish
+sv: Swedish
+sl: Slovenian
+ru: Russian
+iw: Hebrew
+fi: Finnish
+zh-TW: Chinese Traditional
+pt: Portuguese
+ko: Korean
+et: Estonian
+id: Indonesian
+gl: Galician
+cs: Czech
+bg: Bulgarian
+pl: Polish
+ar: Arabic
+ro: Romanian
+mt: Maltese
+el: Greek
+da: Danish
+vi: Vietnamese
+tr: Turkish
+lt: Lithuanian
+nl: Dutch
+ca: Catalan
+sq: Albanian
+th: Thai
+sr: Serbian
+en: English
+lv: Latvian
+hr: Croatian

data/lib/ottra.rb

@@ -0,0 +1,44 @@
+require 'translator_base'
+require 'yaml'
+
+class Ottra
+  
+  attr_accessor :translators, :response_times, :languages
+  
+  def initialize(options = { })
+    # Let's set up our languages. I don't like global variables, but I 
+    $ottra_languages = YAML.load_file(File.expand_path(File.dirname(__FILE__)) + '/config/languages.yml')
+    
+    # Let's get our translators setup
+    translator_classes = Dir.glob(File.expand_path(File.dirname(__FILE__)) + '/translators/*')
+    translator_classes.each { |translator| require translator }
+    
+    # Now let's build a list of translator classes we can interact with
+    @translators = translator_classes.map do |translator|
+      # This is really a terrible way to do this...
+      t = translator.split(/\/|\\/).last.gsub('.rb', '').gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+      Object.const_get(t)
+    end
+    
+    # Let's find out how each of them are responding so we know which one to try first, unless we want to just get going
+    options[:no_sorting] ? @translators = @translators.sort { |a, b| a.to_s <=> b.to_s } : sort_by_response_times
+  end
+  
+  def translate_text(text, destination, source="en")
+    result = text
+    
+    @translators.each do |translator|
+      t = translator.new
+      result = t.translate(text, source, destination)
+      break unless text == result || (result.match(/Error: Translation from /))
+    end
+    
+    return result
+  end
+  
+  def sort_by_response_times
+    @response_times = @translators.inject({}) { |times, translator| times[translator.to_s] = translator.response_time; times }
+    @translators = @translators.sort { |a, b| @response_times[a.to_s] <=> @response_times[b.to_s] }
+  end
+  
+end

data/lib/translator_base.rb

@@ -0,0 +1,12 @@
+require 'benchmark'
+
+class TranslatorBase
+  
+  def self.response_time
+    Benchmark.realtime do
+      inst = self.new
+      inst.translate('hello world', 'en', 'it')
+    end
+  end
+  
+end

data/lib/translators/google_translate.rb

@@ -0,0 +1,16 @@
+require 'rtranslate'
+
+class GoogleTranslate < TranslatorBase
+  
+  def translate(text, source, destination)
+    result = text
+    begin
+      result = Translate.t(text, source, destination)
+    rescue
+      # Nothing!
+    ensure
+      return result
+    end
+  end
+  
+end

data/lib/translators/shvets_google_translate.rb

@@ -0,0 +1,17 @@
+require 'google_translate'
+
+class ShvetsGoogleTranslate < TranslatorBase
+  
+  def translate(text, source, destination)
+    result = text
+    begin
+      shvet_google = Google::Translator.new
+      result = shvet_google.translate(source.to_sym, destination.to_sym, text)
+    rescue
+      # Just do nothing...
+    ensure
+      return result
+    end
+  end
+  
+end

data/lib/translators/tranexp_translate.rb

@@ -0,0 +1,19 @@
+require 'tranexp'
+
+class TranexpTranslate < TranslatorBase
+  
+  def translate(text, source, destination)
+    result = text
+    begin
+      tran_source = eval("Tranexp::Http::#{$ottra_languages[source]}")
+      tran_dest = eval("Tranexp::Http::#{$ottra_languages[source]}")
+      tranexp = Tranexp::Http.new
+      result = tranexp.translate(text, tran_source, tran_dest)
+    rescue
+      # just do nothing
+    ensure
+      return result
+    end
+  end
+  
+end

data/ottra.gemspec

@@ -0,0 +1,39 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ottra}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Patrick Tulskie"]
+  s.date = %q{2009-10-28}
+  s.description = %q{One Translator (gem) To Rule (them) All!  Uses various translation gems to do language translating.}
+  s.email = %q{PatrickTulskie@gmail.com}
+  s.extra_rdoc_files = ["README.textile", "lib/config/languages.yml", "lib/ottra.rb", "lib/translator_base.rb", "lib/translators/google_translate.rb", "lib/translators/shvets_google_translate.rb", "lib/translators/tranexp_translate.rb"]
+  s.files = ["Manifest", "README.textile", "Rakefile", "lib/config/languages.yml", "lib/ottra.rb", "lib/translator_base.rb", "lib/translators/google_translate.rb", "lib/translators/shvets_google_translate.rb", "lib/translators/tranexp_translate.rb", "ottra.gemspec"]
+  s.homepage = %q{http://github.com/patricktulskie/ottra}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Ottra", "--main", "README.textile"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{ottra}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{One Translator (gem) To Rule (them) All!  Uses various translation gems to do language translating.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<shvets-google_translate>, [">= 0"])
+      s.add_runtime_dependency(%q<googletranslate>, [">= 0"])
+      s.add_runtime_dependency(%q<tranexp>, [">= 0"])
+    else
+      s.add_dependency(%q<shvets-google_translate>, [">= 0"])
+      s.add_dependency(%q<googletranslate>, [">= 0"])
+      s.add_dependency(%q<tranexp>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<shvets-google_translate>, [">= 0"])
+    s.add_dependency(%q<googletranslate>, [">= 0"])
+    s.add_dependency(%q<tranexp>, [">= 0"])
+  end
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification 
+name: ottra
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Patrick Tulskie
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-28 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: shvets-google_translate
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: googletranslate
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: tranexp
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: One Translator (gem) To Rule (them) All!  Uses various translation gems to do language translating.
+email: PatrickTulskie@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+- lib/config/languages.yml
+- lib/ottra.rb
+- lib/translator_base.rb
+- lib/translators/google_translate.rb
+- lib/translators/shvets_google_translate.rb
+- lib/translators/tranexp_translate.rb
+files: 
+- Manifest
+- README.textile
+- Rakefile
+- lib/config/languages.yml
+- lib/ottra.rb
+- lib/translator_base.rb
+- lib/translators/google_translate.rb
+- lib/translators/shvets_google_translate.rb
+- lib/translators/tranexp_translate.rb
+- ottra.gemspec
+has_rdoc: true
+homepage: http://github.com/patricktulskie/ottra
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Ottra
+- --main
+- README.textile
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: ottra
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: One Translator (gem) To Rule (them) All!  Uses various translation gems to do language translating.
+test_files: []
+