tr8n_core 4.0.1

data/lib/tr8n/translation_key.rb

@@ -0,0 +1,205 @@
+#--
+# Copyright (c) 2013 Michael Berkovich, tr8nhub.com
+#
+# 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 'digest/md5'
+
+class Tr8n::TranslationKey < Tr8n::Base  
+  belongs_to :application, :language
+  attributes :id, :key, :label, :description, :locale, :level, :locked
+  has_many :translations # hashed by language
+
+  def initialize(attrs = {})
+    super
+
+    self.attributes[:key] ||= self.class.generate_key(label, description)
+    self.attributes[:locale] ||= Tr8n.config.block_options[:locale] || application.default_locale
+    self.attributes[:language] ||= application.language(locale)
+    self.attributes[:translations] = {}
+
+    if hash_value(attrs, :translations)
+      hash_value(attrs, :translations).each do |locale, translations|
+        language = application.language(locale)
+
+        self.attributes[:translations][locale] ||= []
+
+        translations.each do |translation_hash|
+          translation = Tr8n::Translation.new(translation_hash.merge(:translation_key => self, :locale => language.locale))
+          self.attributes[:translations][locale] << translation
+        end
+      end
+    end
+  end
+
+  def self.generate_key(label, desc = "")
+    "#{Digest::MD5.hexdigest("#{label};;;#{desc}")}~"[0..-2].to_s
+  end
+
+  def has_translations_for_language?(language)
+    translations and translations[language.locale] and translations[language.locale].any?
+  end
+
+  def fetch_translations(language, options = {})
+    return self if self.id and has_translations_for_language?(language)
+
+    if options[:dry] or Tr8n.config.block_options[:dry]
+      return application.cache_translation_key(self)
+    end
+
+    tkey = application.post("translation_key/translations",
+                            {:key => key, :label => label, :description => description, :locale => language.locale},
+                            {:class => Tr8n::TranslationKey, :attributes => {:application => application}})
+
+    application.cache_translation_key(tkey)
+  end
+
+  # switches to a new application
+  def set_application(app)
+    self.application = app
+    translations.values.each do |locale_translations|
+      locale_translations.each do |t|
+        t.set_translation_key(self)
+      end
+    end
+    self
+  end
+
+  def set_language_translations(language, translations)
+    translations.each do |translation|
+      translation.locale = language.locale
+      translation.set_translation_key(self)
+    end
+    self.translations[language.locale] = translations
+  end
+
+  ###############################################################
+  ## Translation Methods
+  ###############################################################
+
+  def translations_for_language(language)
+    return [] unless self.translations
+    self.translations[language.locale] || []
+  end
+
+  def find_first_valid_translation(language, token_values)
+    translations = translations_for_language(language)
+
+    translations.sort! { |x,y| x.precedence <=> y.precedence }
+
+    translations.each do |translation|
+      return translation if translation.matches_rules?(token_values)
+    end
+    
+    nil
+  end
+
+  def translate(language, token_values = {}, options = {})
+    if Tr8n.config.disabled? or language.locale == self.attributes[:locale]
+      return substitute_tokens(label, token_values, language, options.merge(:fallback => false))
+    end
+
+    translation = find_first_valid_translation(language, token_values)
+    decorator = Tr8n::Decorators::Base.decorator
+
+    if translation
+      translated_label = substitute_tokens(translation.label, token_values, translation.language, options)
+      return decorator.decorate(translated_label, translation.language, language, self, options)
+    end
+
+    #Tr8n.logger.info("Translating: #{label}")
+
+    translated_label = substitute_tokens(label, token_values, self.attributes[:language], options)
+    decorator.decorate(translated_label, self.attributes[:language], language, self, options)
+  end
+
+  ###############################################################
+  ## Token Substitution Methods
+  ###############################################################
+
+  # Returns an array of decoration tokens from the translation key
+  def decoration_tokens
+    @decoration_tokens ||= begin
+      dt = Tr8n::Tokens::DecorationTokenizer.new(label)
+      dt.parse
+      dt.tokens
+    end
+  end
+
+  # Returns an array of data tokens from the translation key
+  def data_tokens
+    @data_tokens ||= begin
+      dt = Tr8n::Tokens::DataTokenizer.new(label)
+      dt.tokens
+    end
+  end
+
+  def data_tokens_names_map
+    @data_tokens_names_map ||= begin
+      map = {}
+      data_tokens.each do |token|
+        map[token.name] = token
+      end
+      map
+    end
+  end
+
+  # if the translations engine is disabled
+  def self.substitute_tokens(label, token_values, language, options = {})
+    return label.to_s if options[:skip_substitution] 
+    Tr8n::TranslationKey.new(:label => label.to_s).substitute_tokens(label.to_s, token_values, language, options)
+  end
+
+  def substitute_tokens(translated_label, token_values, language, options = {})
+    if translated_label.index('{')
+      dt = Tr8n::Tokens::DataTokenizer.new(translated_label, token_values, :allowed_tokens => data_tokens_names_map)
+      translated_label = dt.substitute(language, options)
+    end
+
+    return translated_label unless translated_label.index('[')
+    dt = Tr8n::Tokens::DecorationTokenizer.new(translated_label, token_values, :allowed_tokens => decoration_tokens)
+    dt.substitute
+  end
+
+  #######################################################################################################
+  ##  Cache Methods
+  #######################################################################################################
+
+  def self.cache_prefix
+    't@'
+  end
+
+  def self.cache_key(label, description, locale)
+    "#{cache_prefix}_[#{locale}]_[#{generate_key(label, description)}]";
+  end
+
+  def to_cache_hash
+    hash = to_hash(:id, :key, :label, :description, :locale, :level)
+    if translations and translations.any?
+      hash["translations"] = {}
+      translations.each do |locale, locale_translations|
+        hash["translations"][locale] = locale_translations.collect{|t| t.to_cache_hash}
+      end
+    end
+    hash
+  end
+
+end

data/lib/tr8n/translator.rb

@@ -0,0 +1,62 @@
+#--
+# Copyright (c) 2013 Michael Berkovich, tr8nhub.com
+#
+# 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 'digest/md5'
+
+class Tr8n::Translator < Tr8n::Base
+  belongs_to :application
+  attributes :id, :name, :email, :gender, :mugshot, :link, :inline, :features
+  attributes :voting_power, :rank, :level, :locale, :manager, :code, :access_token 
+
+  def self.authorize(application, username, password, options = {})
+    data = application.get('oauth/request_token', {:grant_type => :password, :username => username, :password => password})
+    init(application, data['access_token'])
+  end
+
+  def self.init(application, access_token)
+    application.get('translator', {:access_token => access_token}, {:class => Tr8n::Translator, :attributes => {
+      :application => application, 
+      :access_token => access_token
+    }})
+  end
+
+  def applications
+    application.get("translator/applications", {:access_token => access_token}, {:class => Tr8n::Application})
+  end  
+
+  def translations
+    application.get("translator/translations", {:access_token => access_token}, {:class => Tr8n::Application})
+  end
+
+  def feature_enabled?(key)
+    return false unless features
+    hash_value(features, key)
+  end
+
+  def mugshot_url
+    return nil unless email
+    gravatar_id = Digest::MD5.hexdigest(email.downcase)
+    "http://gravatar.com/avatar/#{gravatar_id}.png?s=48"
+  end
+
+end

data/lib/tr8n/utils.rb

@@ -0,0 +1,124 @@
+#--
+# Copyright (c) 2013 Michael Berkovich, tr8nhub.com
+#
+# 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 'yaml'
+require 'base64'
+require 'openssl'
+require 'json'
+require 'uri'
+
+module Tr8n
+  class Utils
+    def self.normalize_tr_params(label, description, tokens, options)
+      return label if label.is_a?(Hash)
+
+      if description.is_a?(Hash)
+        return {
+          :label        => label,
+          :description  => nil,
+          :tokens       => description,
+          :options      => tokens
+        }
+      end
+
+      {
+        :label        => label,
+        :description  => description,
+        :tokens       => tokens,
+        :options      => options
+      }
+    end
+
+    def self.guid
+      (0..16).to_a.map{|a| rand(16).to_s(16)}.join
+    end
+
+    def self.split_by_sentence(text)
+      sentence_regex = /[^.!?\s][^.!?]*(?:[.!?](?![\'"]?\s|$)[^.!?]*)*[.!?]?[\'"]?(?=\s|$)/
+
+      sentences = []
+      text.scan(sentence_regex).each do |s|
+        sentences << s
+      end
+
+      sentences
+    end
+
+    def self.load_json(file_path, env = nil)
+      json = JSON.parse(File.read(file_path))
+      return json if env.nil?
+      return yml['defaults'] if env == 'defaults'
+      yml['defaults'].rmerge(yml[env] || {})
+    end
+
+    def self.load_yaml(file_path, env = nil)
+      yaml = YAML.load_file(file_path)
+      return yaml if env.nil?
+      return yaml['defaults'] if env == 'defaults'
+      yaml['defaults'].rmerge(yaml[env] || {})
+    end
+
+    def self.sign_and_encode_params(params, secret)
+      payload = params.merge(:algorithm => 'HMAC-SHA256', :ts => Time.now.to_i).to_json
+      payload = Base64.encode64(payload)
+
+      sig = OpenSSL::HMAC.digest('sha256', secret, payload)
+      encoded_sig = Base64.encode64(sig)
+
+      URI::encode(Base64.encode64("#{encoded_sig}.#{payload}"))
+    end
+
+    def self.decode_and_verify_params(signed_request, secret)
+      signed_request = URI::decode(signed_request)
+      signed_request = Base64.decode64(signed_request)
+
+      encoded_sig, payload = signed_request.split('.', 2)
+      expected_sig = OpenSSL::HMAC.digest('sha256', secret, payload)
+      expected_sig = Base64.encode64(expected_sig)
+      if expected_sig != encoded_sig
+        raise Tr8n::Exception.new("Bad signature")
+      end
+
+      JSON.parse(Base64.decode64(payload))
+    end
+
+    ######################################################################
+    # Author: Iain Hecker
+    # reference: http://github.com/iain/http_accept_language
+    ######################################################################
+    def self.browser_accepted_locales(request)
+      request.env['HTTP_ACCEPT_LANGUAGE'].split(/\s*,\s*/).collect do |l|
+        l += ';q=1.0' unless l =~ /;q=\d+\.\d+$/
+        l.split(';q=')
+      end.sort do |x,y|
+        raise Tr8n::Exception.new("Not correctly formatted") unless x.first =~ /^[a-z\-]+$/i
+        y.last.to_f <=> x.last.to_f
+      end.collect do |l|
+        l.first.downcase.gsub(/-[a-z]+$/i) { |x| x.upcase }
+      end
+    rescue
+      []
+    end
+
+  end
+end

data/lib/tr8n_core/ext/array.rb

@@ -0,0 +1,74 @@
+#--
+# Copyright (c) 2013 Michael Berkovich, tr8nhub.com
+#
+# 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.
+#++
+
+class Array
+
+  # translates an array of options for a select tag
+  def tro(description = "", options = {}, language = Tr8n.config.current_language)
+    return [] if empty?
+
+    collect do |opt|
+      if opt.is_a?(Array) and opt.first.is_a?(String) 
+        [opt.first.trl(description, {}, options, language), opt.last]
+      elsif opt.is_a?(String)
+        [opt.trl(description, {}, options, language), opt]
+      else  
+        opt
+      end
+    end
+  end
+
+  # translate array values 
+  def trl(description = "", options = {}, language = Tr8n.config.current_language)
+    return [] if empty?
+
+    collect do |opt|
+      if opt.is_a?(String)
+        opt.trl(description, {}, options, language)
+      else  
+        opt
+      end
+    end
+  end
+
+  # creates a sentence with tr "and" joiner
+  def tr_sentence(options = {}, language = Tr8n.config.current_language)
+    return "" if empty?
+    return first if size == 1
+
+    result = "#{self[0..-2].join(", ")}"
+    result << " " << "and".translate("List elements joiner", {}, options, language) << " "
+    result << self.last
+  end
+
+  def tr8n_translated
+    return self if frozen?
+    @tr8n_translated = true
+    self
+  end
+
+  def tr8n_translated?
+    @tr8n_translated
+  end
+
+end

data/lib/tr8n_core/ext/date.rb

@@ -0,0 +1,63 @@
+#--
+# Copyright (c) 2013 Michael Berkovich, tr8nhub.com
+#
+# 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.
+#++
+
+class Date
+
+  def translate(format = :default, language = Tr8n.config.current_language, options = {})
+    label = (format.is_a?(String) ? format.clone : Tr8n.config.default_date_formats[format].clone)
+    symbols = label.scan(/(%\w)/).flatten.uniq
+
+    selected_tokens = []
+    symbols.each do |symbol|
+      token = Tr8n.config.strftime_symbol_to_token(symbol)
+      next unless token
+      selected_tokens << token
+      label.gsub!(symbol, token)
+    end
+
+    tokens = {}
+    selected_tokens.each do |token|
+      case token
+        when "{days}"                 then tokens[:days] = options[:with_leading_zero] ? day.with_leading_zero : day.to_s
+        when "{year_days}"            then tokens[:year_days] = options[:with_leading_zero] ? yday.with_leading_zero : yday.to_s
+        when "{months}"               then tokens[:months] = options[:with_leading_zero] ? month.with_leading_zero : month.to_s
+        when "{week_num}"             then tokens[:week_num] = wday
+        when "{week_days}"            then tokens[:week_days] = strftime("%w")
+        when "{short_years}"          then tokens[:short_years] = strftime("%y")
+        when "{years}"                then tokens[:years] = year
+        when "{short_week_day_name}"  then tokens[:short_week_day_name] = language.tr(Tr8n.config.default_abbr_day_names[wday], "Short name for a day of a week", {}, options)
+        when "{week_day_name}"        then tokens[:week_day_name] = language.tr(Tr8n.config.default_day_names[wday], "Day of a week", {}, options)
+        when "{short_month_name}"     then tokens[:short_month_name] = language.tr(Tr8n.config.default_abbr_month_names[month - 1], "Short month name", {}, options)
+        when "{month_name}"           then tokens[:month_name] = language.tr(Tr8n.config.default_month_names[month - 1], "Month name", {}, options)
+        when "{day_of_month}"         then tokens[:day_of_month] = strftime("%e")
+      end
+    end
+
+    language.tr(label, nil, tokens, options)
+  end
+  alias :tr :translate  
+  
+  def trl(format = :default, language = Tr8n.config.current_language, options = {})
+    tr(format, language, options.merge!(:skip_decorations => true))
+  end
+end

data/lib/tr8n_core/ext/fixnum.rb

@@ -0,0 +1,39 @@
+#--
+# Copyright (c) 2013 Michael Berkovich, tr8nhub.com
+#
+# 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.
+#++
+
+class Fixnum
+
+  def with_leading_zero
+    (to_i < 10 ? "0#{to_s}" : to_s)
+  end
+
+  def translate(desc = "", tokens = {}, options = {}, language = Tr8n.config.current_language)
+    to_s.translate(desc, tokens, options, language)
+  end
+  alias tr translate
+  
+  def trl(desc = "", tokens = {}, options = {}, language = Tr8n.config.current_language)
+    to_s.trl(desc, tokens, options, language)
+  end
+
+end

data/lib/tr8n_core/ext/hash.rb

@@ -0,0 +1,126 @@
+#--
+# Copyright (c) 2013 Michael Berkovich, tr8nhub.com
+#
+# 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.
+#++
+
+class Hash
+
+  # Return all combinations of a hash.
+  #
+  # Example:
+  #   {
+  #     :a => [1, 2]
+  #     :b => [1, 2]
+  #   }.combinations #=> [{:a=>1, :b=>1}, {:a=>1, :b=>2}, {:a=>2, :b=>1}, {:a=>2, :b=>2}]
+  #
+  def combinations
+    return [{}] if empty?
+
+    copy = dup
+    values = copy.delete(key = keys.first)
+
+    result = []
+    copy.combinations.each do |tail|
+      values.each do |value|
+        result << tail.merge(key=>value)
+      end
+    end
+
+    result
+  end
+
+  def tr8n_translated
+    return self if frozen?
+    @tr8n_translated = true
+    self
+  end
+
+  def tr8n_translated?
+    @tr8n_translated
+  end
+
+  # 
+  # = Hash Recursive Merge
+  # 
+  # Merges a Ruby Hash recursively, Also known as deep merge.
+  # Recursive version of Hash#merge and Hash#merge!.
+  # 
+  # Category::    Ruby
+  # Package::     Hash
+  # Author::      Simone Carletti <weppos@weppos.net>
+  # Copyright::   2007-2008 The Authors
+  # License::     MIT License
+  # Link::        http://www.simonecarletti.com/
+  # Source::      http://gist.github.com/gists/6391/
+  
+  #
+  # Recursive version of Hash#merge!
+  # 
+  # Adds the contents of +other_hash+ to +hsh+, 
+  # merging entries in +hsh+ with duplicate keys with those from +other_hash+.
+  # 
+  # Compared with Hash#merge!, this method supports nested hashes.
+  # When both +hsh+ and +other_hash+ contains an entry with the same key,
+  # it merges and returns the values from both arrays.
+  # 
+  #    h1 = {"a" => 100, "b" => 200, "c" => {"c1" => 12, "c2" => 14}}
+  #    h2 = {"b" => 254, "c" => 300, "c" => {"c1" => 16, "c3" => 94}}
+  #    h1.rmerge!(h2)   #=> {"a" => 100, "b" => 254, "c" => {"c1" => 16, "c2" => 14, "c3" => 94}}
+  #    
+  # Simply using Hash#merge! would return
+  # 
+  #    h1.merge!(h2)    #=> {"a" => 100, "b" = >254, "c" => {"c1" => 16, "c3" => 94}}
+  # 
+  def rmerge!(other_hash)
+    merge!(other_hash) do |key, oldval, newval| 
+        oldval.class == self.class ? oldval.rmerge!(newval) : newval
+    end
+  end
+
+  #
+  # Recursive version of Hash#merge
+  # 
+  # Compared with Hash#merge!, this method supports nested hashes.
+  # When both +hsh+ and +other_hash+ contains an entry with the same key,
+  # it merges and returns the values from both arrays.
+  # 
+  # Compared with Hash#merge, this method provides a different approch
+  # for merging nasted hashes.
+  # If the value of a given key is an Hash and both +other_hash+ abd +hsh
+  # includes the same key, the value is merged instead replaced with
+  # +other_hash+ value.
+  # 
+  #    h1 = {"a" => 100, "b" => 200, "c" => {"c1" => 12, "c2" => 14}}
+  #    h2 = {"b" => 254, "c" => 300, "c" => {"c1" => 16, "c3" => 94}}
+  #    h1.rmerge(h2)    #=> {"a" => 100, "b" => 254, "c" => {"c1" => 16, "c2" => 14, "c3" => 94}}
+  #    
+  # Simply using Hash#merge would return
+  # 
+  #    h1.merge(h2)     #=> {"a" => 100, "b" = >254, "c" => {"c1" => 16, "c3" => 94}}
+  # 
+  def rmerge(other_hash)
+    r = {}
+    merge(other_hash)  do |key, oldval, newval| 
+      r[key] = oldval.class == self.class ? oldval.rmerge(newval) : newval
+    end
+  end
+
+end