i18n_translator 0.0.1

data/README.rdoc

@@ -0,0 +1,59 @@
+== Overview
+
+Rake task which creates translated locales files of a rails project from source locales. 
+Translations are 'bulk' translations from google, and might be reviewed but that's a easy first step.
+Create your locales files with your own language and run the task with targeted languages.
+It uses the gem 'easy_translator' which use google translations api.
+
+== Usage
+
+  rake i18n:translate['en','fr;es'].
+
+Separate targets languages symbols with semicolons.
+<b>/!\ Don't put space after the coma for rake tasks parameters.</b>
+
+With no additional argument, it will translate and create locales for <b>all</b> your source locales.
+If you want to just do the work with only one locale source, pass an additional path to file source argument to rake tasks :
+
+  rake i18n:translate['en','fr;es','config/locales/user/en.yml'].
+
+== Convention
+
+The source locale is supposed to be named <lang>.yml where lang is the language symbol (fr, en , es ... and so on)
+
+== Example
+
+- config
+ - locales
+  - models
+   - user
+    - en.yml
+   - book
+    - en.yml
+    
+Will generate :
+
+- config
+ - locales
+  - models
+   - user
+    - en.yml
+    - fr.yml
+    - es.yml
+   - book
+    - en.yml
+    - fr.yml
+    - es.yml
+  
+== Dependencies
+
+* rake
+* easy_translator    
+
+== TO-DOs
+
+Add options to be more flexible ; ie pass a translator lambda to use other translator.
+
+== Issues
+
+Sometimes phrases with interpolations are not double quoted

data/lib/i18n_translator.rake

@@ -0,0 +1,21 @@
+namespace :i18n do
+  
+  def indicator 
+    Proc.new do |dirname, lang|
+      print "\033[37m -->  #{dirname} : #{lang} .. \033[32m done  \n"
+    end
+  end
+  
+  desc "Translate and create locales from source locale"
+  
+  task :translate, [:from, :to, :path_to_file] => :environment do |t , args|
+    locales = args[:path_to_file] || Dir.glob("#{RAILS_ROOT}/config/locales/**/*.yml")
+
+
+    locales.each do |locale_path|
+      dirname = File.dirname(locale_path)
+      I18nTranslator.create_locales(:dir_path => dirname, :from => args[:from], :to => args[:to].split(';'), :indicator => indicator)
+    end
+    
+  end
+end

data/lib/i18n_translator.rb

@@ -0,0 +1,62 @@
+require 'rake'
+require 'yaml/encoding'
+require 'yaml'
+require 'easy_translate'
+
+class Insider
+  
+  def self.redefine klass, method, &block
+    klass.send(:alias_method, original_method(method), method)
+    klass.send(:define_method, method) do |*params|
+      instance_exec(*params, &block)
+    end
+  end
+
+  def self.undefine klass, method
+    klass.send(:undef_method, method)
+    klass.send(:alias_method, method, original_method(method))
+  end
+
+  def self.original_method method
+    ('original_' + method.to_s).to_sym
+  end
+  
+end
+
+module I18nTranslator
+    
+  def self.create_locales(args)
+    redefine_hash_to_yaml
+    source = File.join(args[:dir_path], "#{args[:from].to_s}.yml")
+    source_yaml = YAML.load_file(source)
+
+    args[:to].each do |language|
+      @@target_language =  language
+      target_yaml = source_yaml.dup.replace(language.to_s => source_yaml[args[:from].to_s])
+      target = File.join(args[:dir_path], "#{language.to_s}.yml")
+    
+      File.open(target, 'w+') do |file|
+        file << YAML.unescape(YAML.dump(target_yaml))
+      end
+      args[:indicator].call(args[:dir_path], language) if args[:indicator]
+    end
+    
+    Insider.undefine(Hash, :to_yaml)
+  end
+  
+  def self.redefine_hash_to_yaml
+    Insider.redefine(Hash, :to_yaml) do |opts|
+      YAML::quick_emit( object_id, opts ) do |out|
+        out.map( taguri, to_yaml_style ) do |map|
+          sort.each do |k, v|
+            v = EasyTranslate.translate(v, :to => @@target_language) unless v.is_a?(Hash)
+            map.add( k, v )
+          end
+        end
+      end
+    end
+  end
+
+  import File.join(File.dirname(__FILE__), 'i18n_translator.rake')
+end
+

data/lib/i18n_translator/version.rb

@@ -0,0 +1,3 @@
+module I18nTranslator
+  VERSION = "0.0.1"
+end

data/test/test_i18n_translator.rb

@@ -0,0 +1,53 @@
+require 'test/unit'
+require 'i18n_translator'
+require 'mocha'
+
+$KCODE = 'utf-8'
+
+class TestI18nTranslator < Test::Unit::TestCase
+
+  def setup
+    stubs_easy_translate
+    
+    @dirname = File.join(File.dirname(__FILE__), 'config/locales/models/user')
+    @source = File.join(@dirname, 'fr.yml')
+    @targets = {:en => File.join(@dirname, 'en.yml'), :es => File.join(@dirname, 'es.yml')}
+    I18nTranslator.create_locales(:dir_path => @dirname, :from => :fr, :to => [:en, :es])
+  end
+  
+  def teardown
+    File.delete(*@targets.values)
+  end
+  
+  def test_should_create_english_locale_for_model_user
+    yaml_locale = YAML.load_file(@targets[:en])
+    
+    assert_equal 'car', yaml_locale['en']['models']['user']['car']
+    assert_equal 'error', yaml_locale['en']['models']['user']['error']
+    assert_equal 'home', yaml_locale['en']['models']['user']['house']
+  end
+  
+  def test_should_create_spanish_locale_for_model_user
+    yaml_locale = YAML.load_file(@targets[:es])
+    
+    assert_equal 'coche', yaml_locale['es']['models']['user']['car']
+    assert_equal 'error', yaml_locale['es']['models']['user']['error']
+    assert_equal 'casa', yaml_locale['es']['models']['user']['house']
+  end
+  
+  def test_should_keep_double_quoted_interpolations
+    yaml_locale = YAML.load_file(@targets[:en])
+    
+    assert_equal 'Users : {{n}}', yaml_locale['en']['models']['user']['total_user']
+  end
+  
+  private
+  
+  def stubs_easy_translate
+    fr_to_en = [['maison', "home"], ['erreur', 'error'], ['voiture', 'car'], ['Utilisateurs : {{n}}', 'Users : {{n}}']]
+    fr_to_es = [['maison', "casa"], ['erreur', 'error'], ['voiture', 'coche'], ['Utilisateurs : {{n}}', 'Usuario : {{n}}']]
+    map = {:en => fr_to_en, :es => fr_to_es}
+    map.each {|target, translations| translations.each { |fr, translated| EasyTranslate.stubs(:translate).with(fr, :to => target).returns(translated) } }
+  end
+  
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification 
+name: i18n_translator
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Philippe Cantin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-15 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: easy_translate
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: " Automatically create translated locales files of a rails project from source locales. \n                      Translations are 'bulk' translations from google, and might be reviewed but that's a easy first step'.\n                      Create your locales files with your own language and run the task with targettd languages.\n                      Example: > rake i18n:translate['en','fr;es']. See more on github\n                    "
+email: 
+- anoiaque@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- lib/i18n_translator/version.rb
+- lib/i18n_translator.rb
+- lib/i18n_translator.rake
+- README.rdoc
+- test/test_i18n_translator.rb
+has_rdoc: true
+homepage: https://github.com/anoiaque/i18n_translator
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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: i18n_translator
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Automatically create translated locales files of a rails project
+test_files: 
+- test/test_i18n_translator.rb