machine_translation 0.0.1

data/LICENSE

@@ -0,0 +1,14 @@
+
+Copyright (c) Eric Woodward.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,8 @@
+
+= Ruby gem for Machine Translations from Google
+
+More details TBA.
+
+== Copyright
+
+Copyright (c) 2010 Eric Woodward.. See LICENSE for details. http://ejw.com.

data/Rakefile

@@ -0,0 +1,73 @@
+##
+# Copyright (c) Eric Woodward.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+# modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+# is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+# IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##
+
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "machine_translation"
+    gem.summary = %Q{gem for getting a machine generated translation}
+    gem.description = %Q{gem for getting a machine generated translation from Google and hopefully other sources too (eventually)}
+
+    gem.email = "me@ejw.com"
+    gem.homepage = "http://github.com/ejw/machine_translation"
+    gem.authors = ["Eric Woodward"]
+    gem.rubyforge_project = "machine_translation"
+    gem.files = FileList['[A-Z]*', 'lib/**/*.rb', 'lib/tasks/*.rake', 'test/**/*.rb']
+
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    gem.add_dependency 'rest-client', '~> 1.6.0'
+    gem.add_dependency 'json', '>= 1.4.4'
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/*test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/*test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "machine_translation #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/machine_translation.rb

@@ -0,0 +1,46 @@
+##
+# Copyright (c) Eric Woodward.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+# modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+# is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+# IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##
+
+require 'rubygems'
+require 'json'
+require 'active_support'
+require 'rest_client'
+
+module MachineTranslation
+  class << self
+    ##
+    # *CONFIGURATION*
+    # Call the configure method within a application configuration initializer to set your Google Translate API key:
+    #   MachineTranslation.configure do |config|
+    #     config.google_key = 'APIKEY'
+    #     config.google_referer = 'http://yoursite.com'
+    #   end
+    ##
+
+    attr_writer :configuration
+    def configure
+      configuration ||= Configuration.new
+      yield(@configuration)
+    end
+    def configuration
+      @configuration ||= Configuration.new
+    end
+  end
+end
+
+require 'machine_translation/configuration'
+require 'machine_translation/google'
+require 'machine_translation/translator'

data/lib/machine_translation/configuration.rb

@@ -0,0 +1,29 @@
+##
+# Copyright (c) Eric Woodward.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+# modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+# is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+# IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##
+
+module MachineTranslation
+  class Configuration
+    attr_accessor :google_key, :google_referer
+
+    DEFAULT_GOOGLE_KEY = 'TBA'
+    DEFAULT_GOOGLE_REFERER = 'TBA'
+      
+    def initialize
+      @google_key = DEFAULT_GOOGLE_KEY
+      @google_referer = DEFAULT_GOOGLE_REFERER
+    end
+  end
+end

data/lib/machine_translation/google.rb

@@ -0,0 +1,92 @@
+##
+# Copyright (c) Eric Woodward.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+# modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+# is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+# IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##
+
+module MachineTranslation
+  class Google
+    GOOGLE_API_HOST = 'http://ajax.googleapis.com'
+    GOOGLE_API_PATH = '/ajax/services/language/translate'
+    GOOGLE_API_VERSION = '1.0'
+    GOOGLE_LANGUAGES_PAIRS = {
+      'af' => 'afrikaans',
+      'sq' => 'albanian',
+      'ar' => 'arabic',
+      'be' => 'belarusian',
+      'bg' => 'bulgarian',
+      'zh-CN' => 'chinese simplified',
+      'zh-TW' => 'chinese-traditional',
+      'ca' => 'catalan',
+      'hr' => 'croatian',
+      'cs' => 'czech',
+      'da' => 'danish',
+      'nl' => 'dutch',
+      'en' => 'english',
+      'et' => 'estonian',
+      'tl' => 'filipino',
+      'fi' => 'finnish',
+      'fr' => 'french',
+      'gl' => 'galician',
+      'de' => 'german',
+      'el' => 'greek',
+      'ht' => 'haitian creole',
+      'he' => 'hebrew',
+      'hi' => 'hindi',
+      'hu' => 'hungarian',
+      'is' => 'icelandic',
+      'id' => 'indonesian',
+      'ga' => 'irish',
+      'it' => 'italian',
+      'ja' => 'japanese',
+      'ko' => 'korean',
+      'lv' => 'latvian',
+      'lt' => 'lithuanian',
+      'mk' => 'macedonian',
+      'ms' => 'malay',
+      'mt' => 'maltese',
+      'no' => 'norwegian',
+      'fa' => 'persian',
+      'pl' => 'polish',
+      'pt' => 'portuguese',
+      'ro' => 'romanian',
+      'ru' => 'russian',
+      'es' => 'spanish',
+      'sr' => 'serbian',
+      'sk' => 'slovak',
+      'sl' => 'slovenian',
+      'sw' => 'swahili',
+      'sv' => 'swedish',
+      'th' => 'thai',
+      'tr' => 'turkish',
+      'uk' => 'ukrainian',
+      'vi' => 'vietnamese',
+      'cy' => 'welsh',
+      'yi' => 'yiddish'
+    }
+
+    class << self
+      def translate(from, to, content)
+        lp = "#{from}|#{to}"
+        begin
+          resource = RestClient::Resource.new(GOOGLE_API_HOST, { :headers => { 'Referer' => MachineTranslation.configuration.google_referer } })
+          response = resource["#{GOOGLE_API_PATH}?v=#{GOOGLE_API_VERSION}&langpair=#{CGI::escape(lp)}&q=#{CGI::escape(content)}"].get
+          case response.code
+          when 200
+            JSON.parse(response.body)['responseData']['translatedText']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/machine_translation/translator.rb

@@ -0,0 +1,29 @@
+##
+# Copyright (c) Eric Woodward.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+# modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+# is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+# IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##
+
+module MachineTranslation
+  class Translator
+    class << self
+      def translate(from, to, content)
+        ## Only support for Google at the moment, but this structure, requesting a translation from a Translator class,
+        ## allows for adding different sources for machine translations in the future within configuration, defaulted
+        ## to Google.
+
+        Google.translate(from, to, content)
+      end
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,26 @@
+##
+# Copyright (c) Eric Woodward.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+# modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+# is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+# IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##
+
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+require 'lib/machine_translation'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+class Test::Unit::TestCase
+end

data/test/translation_test.rb

@@ -0,0 +1,34 @@
+##
+# Copyright (c) Eric Woodward.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+# modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+# is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+# IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##
+
+require 'test/helper'
+
+class TranslationTest < Test::Unit::TestCase
+  should "translate some english to english" do
+    result = MachineTranslation::Translator.translate('en', 'en', 'hello world')
+    ## puts "TRANSLATING some English to French ['#{'hello world'}' -> '#{result}']"
+  end
+
+  should "translate some english to french" do
+    result = MachineTranslation::Translator.translate('en', 'fr', 'hello world')
+    ## puts "TRANSLATING some English to French ['#{'hello world'}' -> '#{result}']"
+  end
+
+  should "translate some english to simplified chinese" do
+    result = MachineTranslation::Translator.translate('en', 'zh-CN', 'hello world')
+    ## puts "TRANSLATING some English to French ['#{'hello world'}' -> '#{result}']"
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: machine_translation
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Eric Woodward
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-05 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thoughtbot-shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 6
+        - 0
+        version: 1.6.0
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 4
+        - 4
+        version: 1.4.4
+  type: :runtime
+  version_requirements: *id003
+description: gem for getting a machine generated translation from Google and hopefully other sources too (eventually)
+email: me@ejw.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/machine_translation.rb
+- lib/machine_translation/configuration.rb
+- lib/machine_translation/google.rb
+- lib/machine_translation/translator.rb
+- test/helper.rb
+- test/translation_test.rb
+has_rdoc: true
+homepage: http://github.com/ejw/machine_translation
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: machine_translation
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: gem for getting a machine generated translation
+test_files: 
+- test/helper.rb
+- test/translation_test.rb