sermoa-ruby_translate 0.1.1

data/lib/ruby_translate.rb

@@ -0,0 +1,70 @@
+# RubyTranslate provides a simple wrapper around the Google Translate API for detecting and translating languages
+#
+# Author:: Aimee Daniells (mailto:aimee@edendevelopment.co.uk)
+# License:: MIT License
+
+require 'net/http'
+require 'uri'
+require 'cgi'
+require 'json'
+
+# Uses Google Translate to detect and translate languages.
+#
+# Google documentation here:
+# http://code.google.com/apis/ajaxlanguage/documentation/reference.html#_intro_fonje
+module RubyTranslate
+
+  # Translate a string from one language to another.
+  # The <tt>from</tt> parameter is optional - 
+  # if you don't specify it, detect will be used to guess.
+  #
+  # Examples:
+  #
+  #   RubyTranslate.translate("Mein Luftkissenfahrzeug ist voller Aale", "en")
+  #   => "My hovercraft is full of eels"
+  #
+  #   RubyTranslate.translate("Il y a un singe qui vole dans l'arbre.", "en")
+  #   => "There is a flying monkey in the tree."
+  #
+  #   RubyTranslate.translate("They are singing in St Peter's Square", "it")
+  #   => "Essi sono il canto, in Piazza San Pietro"
+  #
+  #   RubyTranslate.translate("Eu queria um outro pedacinho de Apfelstrudel, por favor", "sv", "pt")
+  #   => "Jag ville ha en bit av Apfelstrudel, tack"
+  #
+  # Google Translate is not always perfect! Hopefully you already know that!
+  #
+  def self.translate(text, to, from=nil)
+    from = detect(text) if from.nil?
+    json = run('translate', {:langpair => "#{from}|#{to}", :q => text})
+    return json['responseData']['translatedText'] if json['responseStatus'] == 200
+    raise StandardError, json['responseDetails']
+  end
+  
+  # Detect a language given a string of text.
+  #
+  # Examples:
+  #
+  #   RubyTranslate.detect("Mein Luftkissenfahrzeug ist voller Aale")
+  #   => "de"
+  #
+  #   RubyTranslate.detect("Safisha viatu yangu mara moja!")
+  #   => "sw"
+  #
+  def self.detect(text)
+    json = run('detect', {:q => text})
+    return json['responseData']['language'] if json['responseStatus'] == 200
+    raise StandardError, json['responseDetails']
+  end
+  
+  private
+
+  def self.run(service, parameters)
+    base = 'http://ajax.googleapis.com/ajax/services/language'
+    parameters.merge!({:v => 1.0})
+    query = parameters.map{|k,v| "#{k}=#{CGI.escape(v.to_s)}"}.join('&')
+    response = Net::HTTP.get_response(URI.parse("#{base}/#{service}?#{query}"))
+    JSON.parse(response.body)
+  end
+
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification 
+name: sermoa-ruby_translate
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Aimee Daniells
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-15 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.3
+    version: 
+description: RubyTranslate provides a simple wrapper around the Google Translate API for detecting and translating languages.
+email: aimee@edendevelopment.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/ruby_translate.rb
+has_rdoc: true
+homepage: http://www.edendevelopment.co.uk
+post_install_message: 
+rdoc_options: []
+
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: An easy way to access the Google Translate API via Ruby.
+test_files: []
+