rbabel 0.2

data/CHANGELOG

@@ -0,0 +1,13 @@
+=== 0.2 (2008-01-14)
+
+* Added command-line utility.
+
+* Changed lib and gem name to rbabel (to avoid name collision).
+
+=== 0.1.1 (2008-01-13)
+
+* Small fix to Rakefile.
+
+=== 0.1 (2008-01-13)
+
+* Initial version.

data/COPYING

@@ -0,0 +1,18 @@
+Copyright (c) 2008 Sharon Rosner
+
+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 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

@@ -0,0 +1,31 @@
+== Babel: Automatic language translation
+
+Babel is tiny library for translating between languages using Google's automatic language translation ({more info}[http://www.google.com/intl/en/help/faq_translation.html]).
+
+=== Installation
+
+  sudo gem install rbabel
+  
+=== Usage
+
+  require 'rbabel'
+  Babel.translate("hello", :en, :fr) #=> "Bonjour"
+  
+You can also translate a text into multiple languages by supplying multiple destination languages:
+
+  Babel.translate("hello", :en, :fr, :it) #=> ["Bonjour", "Ciao"]
+
+Babel extends String with a #translate method for convenience:
+
+  "hello".translate(:en, :fr) #=> "Bonjour"
+  "hello".translate(:en, :fr, :it) #=> ["Bonjour", "Ciao"]
+
+=== Command line utility
+
+Babel can also be used as a command line utility that translates stdin to stdout. Example usage:
+
+  cat english.txt | rbabel en:fr > french.txt
+
+=== Contact
+
+If you have any comments or suggestions please send an email to ciconia at gmail.com and I'll get back to you.

data/Rakefile

@@ -0,0 +1,129 @@
+require "rake"
+require "rake/clean"
+require "rake/gempackagetask"
+require "rake/rdoctask"
+require "fileutils"
+include FileUtils
+
+##############################################################################
+# Configuration
+##############################################################################
+NAME = "rbabel"
+VERS = "0.2"
+CLEAN.include ["**/.*.sw?", "pkg/*", ".config", "doc/*", "coverage/*"]
+RDOC_OPTS = [
+  "--quiet", 
+  "--title", "Babel: automatic translation",
+  "--opname", "index.html",
+  "--line-numbers", 
+  "--main", "README",
+  "--inline-source"
+]
+
+##############################################################################
+# RDoc
+##############################################################################
+task :doc => [:rdoc]
+
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = "doc/rdoc"
+  rdoc.options += RDOC_OPTS
+  rdoc.main = "README"
+  rdoc.title = "Babel: automatic translation"
+  rdoc.rdoc_files.add ["README", "COPYING", "lib/rbabel.rb", "lib/**/*.rb"]
+end
+
+task :doc_rforge => [:doc]
+
+desc "Update docs and upload to rubyforge.org"
+task :doc_rforge do
+  sh %{scp -r doc/rdoc/* ciconia@rubyforge.org:/var/www/gforge-projects/babel}
+end
+
+##############################################################################
+# Gem packaging
+##############################################################################
+desc "Packages up Babel."
+task :default => [:package]
+task :package => [:clean]
+
+spec = Gem::Specification.new do |s|
+  s.name = NAME
+  s.rubyforge_project = 'babel'
+  s.version = VERS
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "CHANGELOG", "COPYING"]
+  s.rdoc_options += RDOC_OPTS + 
+    ["--exclude", "^(examples|extras)\/", "--exclude", "lib/rbabel.rb"]
+  s.summary = "Automatic language translation"
+  s.description = s.summary
+  s.author = "Sharon Rosner"
+  s.email = "ciconia@gmail.com"
+  s.homepage = "http://babel.rubyforge.org"
+  s.executables = ["rbabel"]
+  s.required_ruby_version = ">= 1.8.4"
+  
+  s.add_dependency("hpricot")
+
+  s.files = %w(COPYING README Rakefile) + Dir.glob("{bin,doc,spec,lib}/**/*")
+
+  s.require_path = "lib"
+  s.bindir = "bin"
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.need_tar = true
+  p.gem_spec = spec
+end
+
+##############################################################################
+# installation & removal
+##############################################################################
+task :install do
+  sh %{rake package}
+  sh %{sudo gem install pkg/#{NAME}-#{VERS}}
+end
+
+task :install_no_docs do
+  sh %{rake package}
+  sh %{sudo gem install pkg/#{NAME}-#{VERS} --no-rdoc --no-ri}
+end
+
+task :uninstall => [:clean] do
+  sh %{sudo gem uninstall #{NAME}}
+end
+
+task :tag do
+  cwd = FileUtils.pwd
+  sh %{cd .. && svn copy #{cwd} tags/babel-#{VERS} && svn commit -m "babel-#{VERS} tag." tags}
+end
+
+##############################################################################
+# gem and rdoc release
+##############################################################################
+task :release => [:package] do
+  sh %{rubyforge login}
+  sh %{rubyforge add_release babel #{NAME} #{VERS} pkg/#{NAME}-#{VERS}.tgz}
+  sh %{rubyforge add_file babel #{NAME} #{VERS} pkg/#{NAME}-#{VERS}.gem}
+end
+
+##############################################################################
+# specs
+##############################################################################
+require "spec/rake/spectask"
+
+desc "Run specs with coverage"
+Spec::Rake::SpecTask.new("spec") do |t|
+  t.spec_files = FileList["spec/*_spec.rb"]
+  t.spec_opts  = File.read("spec/spec.opts").split("\n")
+  t.rcov_opts  = File.read("spec/rcov.opts").split("\n")
+  t.rcov = true
+end
+
+desc "Run specs without coverage"
+Spec::Rake::SpecTask.new("spec_no_cov") do |t|
+  t.spec_files = FileList["spec/*_spec.rb"]
+  t.spec_opts  = File.read("spec/spec.opts").split("\n")
+end
+

data/bin/rbabel

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'rbabel'
+
+usage = <<END
+Usage: rbabel <lang>:<lang>
+Babel: automatic language translation
+
+Examples:
+  cat english.txt | rbabel en:fr > french.txt
+
+For more information see http://babel.rubyforge.org
+END
+
+langpair = ARGV.shift
+
+if langpair.nil? || langpair.empty? || langpair !~ /(.+):(.+)/
+  puts usage
+  exit
+end
+
+STDOUT << STDIN.read.translate($1, $2)

data/lib/rbabel.rb

@@ -0,0 +1,6 @@
+dir = File.join(File.dirname(__FILE__), "rbabel")
+%w[
+  core_ext
+  translation
+].each {|f| require(File.join(dir, f))}
+

data/lib/rbabel/core_ext.rb

@@ -0,0 +1,12 @@
+# String extensions.
+class String
+  # Translates self from the source language into one or more destination
+  # languages.
+  #
+  #   "hello".translate(:en, :fr) #=> "Bonjour"
+  #
+  #   "hello".translate(:en, :nl, :it) #=> ["Hallo", "Ciao"]
+  def translate(source_lang, *dest_lang)
+    Babel.translate(self, source_lang, *dest_lang)
+  end
+end

data/lib/rbabel/translation.rb

@@ -0,0 +1,32 @@
+require 'hpricot'
+require 'net/http'
+
+module Babel
+  # Encodes a string into a URI-escaped string.
+  def self.uri_escape(text)
+    text.gsub(/([^ a-zA-Z0-9_.-]+)/n) {'%'+$1.unpack('H2'*$1.size).
+      join('%').upcase}.tr(' ', '+')
+  end
+  
+  # Fetches the translation page from Google.
+  def self.fetch_translation(text, source_lang, dest_lang)
+    res = Net::HTTP.start('google.com', 80) do |h|
+      h.get("/translate_t?langpair=%s|%s&text=%s" % [
+        source_lang,
+        dest_lang,
+        uri_escape(text)
+      ])
+    end
+    res.body
+  end
+  
+  # Translates the given text from the given source language into one or
+  # more destination languages.
+  def self.translate(text, source_lang, *dest_lang)
+    translations = dest_lang.map do |l|
+      doc = Hpricot(fetch_translation(text, source_lang, l))
+      (doc/"#result_box").text
+    end
+    (dest_lang.size == 1) ? translations.first : translations
+  end
+end

data/spec/core_ext_spec.rb

@@ -0,0 +1,12 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe "String#translate" do
+  it "should translate between languages" do
+    "five days".translate(:en, :fr).should == "Cinq jours"
+    "cinq jours".translate(:fr, :en).should == "Five days"
+  end
+  
+  it "should translate the text to multiple languages if given" do
+    "hello".translate(:en, :fr, :nl, :it).should == ["Bonjour", "Hallo", "Ciao"]
+  end
+end

data/spec/rcov.opts

@@ -0,0 +1,4 @@
+--exclude
+gems
+--exclude
+spec

data/spec/spec.opts

@@ -0,0 +1,5 @@
+--colour
+--backtrace
+--format
+specdoc
+--diff

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), "../lib/rbabel") 

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: rbabel
+version: !ruby/object:Gem::Version 
+  version: "0.2"
+platform: ruby
+authors: 
+- Sharon Rosner
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-01-14 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hpricot
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Automatic language translation
+email: ciconia@gmail.com
+executables: 
+- rbabel
+extensions: []
+
+extra_rdoc_files: 
+- README
+- CHANGELOG
+- COPYING
+files: 
+- COPYING
+- README
+- Rakefile
+- bin/rbabel
+- spec/core_ext_spec.rb
+- spec/rcov.opts
+- spec/spec.opts
+- spec/spec_helper.rb
+- lib/rbabel
+- lib/rbabel/core_ext.rb
+- lib/rbabel/translation.rb
+- lib/rbabel.rb
+- CHANGELOG
+has_rdoc: true
+homepage: http://babel.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --quiet
+- --title
+- "Babel: automatic translation"
+- --opname
+- index.html
+- --line-numbers
+- --main
+- README
+- --inline-source
+- --exclude
+- ^(examples|extras)/
+- --exclude
+- lib/rbabel.rb
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.4
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: babel
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Automatic language translation
+test_files: []
+