r18n-core 0.4.10 → 0.4.11

data/lib/r18n-core/helpers.rb

@@ -20,9 +20,9 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 module R18n
   # Useful aliases. Set I18n object before use them:
-  # 
+  #
   #   R18n.set('en')
-  #   
+  #
   #   t.ok               #=> "OK"
   #   l Time.now, :human #=> "now"
   #   r18n.locale.code   #=> "en"
@@ -32,12 +32,12 @@ module R18n
       R18n.get
     end
     alias i18n r18n
-    
+
     # Translate message. Alias for <tt>r18n.t</tt>.
     def t(*params)
       R18n.get.t(*params)
     end
-    
+
     # Localize object. Alias for <tt>r18n.l</tt>.
     def l(*params)
       R18n.get.l(*params)

data/lib/r18n-core/i18n.rb

@@ -29,19 +29,19 @@ module R18n
   # translation’s name or <tt>[name]</tt> method. Translations will be also
   # loaded for default locale, +sublocales+ from first in +locales+ and general
   # languages for dialects (it will load +fr+ for +fr_CA+ too).
-  # 
+  #
   # Translations will loaded by loader object, which must have 2 methods:
   # * <tt>available</tt> – return array of locales of available translations;
   # * <tt>load(locale)</tt> – return Hash of translation.
   # If you will use default loader (+R18n.default_loader+) you can pass to I18n
   # only constructor argument for loader:
-  # 
+  #
   #   R18n::I18n.new('en', R18n::Loader::YAML.new('dir/with/translations'))
-  # 
+  #
   # is a same as:
-  # 
+  #
   #   R18n::I18n.new('en', 'dir/with/translations')
-  # 
+  #
   # In translation file you can use strings, numbers, floats (any YAML types)
   # and pluralizable values (<tt>!!pl</tt>). You can use params in string
   # values, which you can replace in program. Just write <tt>%1</tt>,
@@ -65,16 +65,16 @@ module R18n
   #   two: Two
   #
   # example.rb
-  # 
+  #
   #   i18n = R18n::I18n.new(['ru', 'en'], 'translations/')
-  #   
+  #
   #   i18n.one   #=> "Один"
   #   i18n.two   #=> "Two"
-  #   
+  #
   #   i18n.locale.title        #=> "Русский"
   #   i18n.locale.code         #=> "ru"
   #   i18n.locale.ltr?         #=> true
-  #   
+  #
   #   i18n.l -11000.5          #=> "−11 000,5"
   #   i18n.l Time.now          #=> "Вск, 21 сен 2008, 22:10:10 MSD"
   #   i18n.l Time.now, :date   #=> "21.09.2008"
@@ -97,7 +97,7 @@ module R18n
     def self.default
       @@default
     end
-    
+
     # Parse HTTP_ACCEPT_LANGUAGE and return array of user locales
     def self.parse_http(str)
       return [] if str.nil?
@@ -113,12 +113,12 @@ module R18n
       locales.sort! { |a, b| b[1] <=> a[1] }
       locales.map! { |i| i[0] }
     end
-    
+
     # Return Array of locales with available translations.
     def self.available_locales(places)
       convert_places(places).map { |i| i.available }.flatten.uniq
     end
-    
+
     # Load default loader for elements in +places+ with only constructor
     # argument.
     def self.convert_places(places)
@@ -130,16 +130,16 @@ module R18n
         end
       end
     end
-    
+
     # User locales, ordered by priority
     attr_reader :locales
-    
+
     # Loaders with translations files
     attr_reader :translation_places
-    
+
     # First locale with locale file
     attr_reader :locale
-    
+
     # Create i18n for +locales+ with translations from +translation_places+ and
     # locales data. Translations will be also loaded for default locale,
     # +sublocales+ from first in +locales+ and general languages for dialects
@@ -149,7 +149,7 @@ module R18n
     # +Translation_places+ must be a string with path or array.
     def initialize(locales, translation_places = nil)
       locales = Array(locales)
-      
+
       if not locales.empty? and Locale.exists? locales.first
         locales += Locale.load(locales.first).sublocales
       end
@@ -162,16 +162,16 @@ module R18n
       locales.map! { |i| i.to_s.downcase }.uniq!
       @locales_codes = locales
       @locales = locales.map { |i| Locale.load(i) }
-      
+
       if translation_places
         @original_places = translation_places
       else
         @original_places = R18n.extension_places
         @locale = @locales.first
       end
-      
+
       @translation_places = self.class.convert_places(@original_places)
-      
+
       key = translation_cache_key
       if R18n.cache.has_key? key
         @locale, @translation = *R18n.cache[key]
@@ -179,7 +179,7 @@ module R18n
         reload!
       end
     end
-    
+
     # Return unique key for current locales in translation and places.
     def translation_cache_key
       @available_codes ||= @translation_places.inject([]) { |all, i|
@@ -188,15 +188,15 @@ module R18n
         R18n.default_loader.hash.to_s +
         @translation_places.hash.to_s + R18n.extension_places.hash.to_s
     end
-    
+
     # Reload translations.
     def reload!
       @available = @available_codes = nil
       @translation_places = self.class.convert_places(@original_places)
-      
+
       available_in_places = @translation_places.map { |i| [i, i.available] }
       available_in_extensions = R18n.extension_places.map {|i| [i, i.available]}
-      
+
       unless @locale
         available_in_places.each do |place, available|
           @locales.each do |locale|
@@ -217,7 +217,7 @@ module R18n
           end
         end
       end
-      
+
       @translation = Translation.new @locale
       @locales.each do |locale|
         loaded = false
@@ -235,15 +235,15 @@ module R18n
           end
         end
       end
-      
+
       R18n.cache[translation_cache_key] = [@locale, @translation]
     end
-    
+
     # Return Array of locales with available translations.
     def available_locales
       @available ||= self.class.available_locales(@translation_places)
     end
-    
+
     # Convert +object+ to String, according to the rules of the current locale.
     # It support Fixnum, Bignum, Float, Time, Date and DateTime.
     #
@@ -261,12 +261,12 @@ module R18n
       locale.localize(object, format, self, *params)
     end
     alias :l :localize
-    
+
     # Return translations.
     def t
       @translation
     end
-    
+
     # Return translation with special +name+.
     #
     # Translation can contain variable part. Just set is as <tt>%1</tt>,

data/lib/r18n-core/locale.rb

@@ -56,7 +56,7 @@ module R18n
   # <tt>locales/</tt> dir.
   class Locale
     LOCALES_DIR = Pathname(__FILE__).dirname.expand_path + '../../locales/'
-    
+
     @@loaded = {}
 
     # Codes of all available locales.
@@ -75,7 +75,7 @@ module R18n
     def self.load(code)
       original = code.to_s.gsub(/[^-_a-zA-Z]/, '')
       code = original.gsub('_', '-').downcase
-      
+
       @@loaded[code] ||= begin
         if exists? code
           require LOCALES_DIR + "#{code}.rb"
@@ -86,15 +86,15 @@ module R18n
         end
       end
     end
-    
+
     # Set locale +properties+. Locale class will have methods for each propetry
     # name, which return propetry value:
-    # 
+    #
     #   class R18n::Locales::En < R18n::Locale
     #     set :title => 'English',
     #         :code  => 'en'
     #   end
-    #   
+    #
     #   locale = R18n::Locales::En.new
     #   locale.title #=> "English"
     #   locale.code  #=> "en"
@@ -103,12 +103,12 @@ module R18n
         define_method(key) { value }
       end
     end
-    
+
     # Locale RFC 3066 code.
     def code
       self.class.name.split('::').last.downcase
     end
-    
+
     set :sublocales => %w{en},
         :week_start => :monday,
         :time_am => 'AM',
@@ -116,10 +116,10 @@ module R18n
         :time_format => ' %H:%M',
         :full_format => '%e %B',
         :year_format => '_ %Y'
-    
+
     def month_standalone; month_names; end
     def month_abbrs;      month_names; end
-    
+
     # Is locale has left-to-right write direction.
     def ltr?; true; end
 
@@ -127,7 +127,7 @@ module R18n
     def ==(locale)
       self.class == locale.class
     end
-    
+
     # Is locale has information file. In this class always return true.
     def supported?
       true
@@ -137,7 +137,7 @@ module R18n
     def inspect
       "Locale #{code} (#{title})"
     end
-    
+
     # Convert +object+ to String. It support Fixnum, Bignum, Float, Time, Date
     # and DateTime.
     #
@@ -155,39 +155,39 @@ module R18n
         return strftime(obj, format) if format.is_a? String
         return month_standalone[obj.month - 1] if :month == format
         return obj.to_s if :human == format and not params.first.is_a? I18n
-        
+
         type = obj.is_a?(Date) ? 'date' : 'time'
         format = :standard unless format
-        
+
         unless [:human, :full, :standard].include? format
           raise ArgumentError, "Unknown time formatter #{format}"
         end
-          
+
         send "format_#{type}_#{format}", obj, *params
       else
         obj.to_s
       end
     end
-    
+
     # Returns the integer in String form, according to the rules of the locale.
     # It will also put real typographic minus.
     def format_integer(integer)
       str = integer.to_s
       str[0] = '−' if 0 > integer # Real typographic minus
       group = number_group
-      
+
       str.gsub(/(\d)(?=(\d\d\d)+(?!\d))/) do |match|
         match + group
       end
     end
-    
+
     # Returns the float in String form, according to the rules of the locale.
     # It will also put real typographic minus.
     def format_float(float)
       decimal = number_decimal
       self.format_integer(float.to_i) + decimal + float.to_s.split('.').last
     end
-    
+
     # Same that <tt>Time.strftime</tt>, but translate months and week days
     # names. In +time+ you can use Time, DateTime or Date object. In +format+
     # you can use standard +strftime+ format.
@@ -211,12 +211,12 @@ module R18n
       end
       time.strftime(translated)
     end
-    
+
     # Format +time+ without date. For example, “12:59”.
     def format_time(time)
       strftime(time, time_format)
     end
-    
+
     # Format +time+ in human usable form. For example “5 minutes ago” or
     # “yesterday”. In +now+ you can set base time, which be used to get relative
     # time. For special cases you can replace it in locale’s class.
@@ -240,18 +240,18 @@ module R18n
         end
       end
     end
-    
+
     # Format +time+ in compact form. For example, “12/31/09 12:59”.
     def format_time_standard(time, *params)
       format_date_standard(time) + format_time(time)
     end
-    
+
     # Format +time+ in most official form. For example, “December 31st, 2009
     # 12:59”. For special cases you can replace it in locale’s class.
     def format_time_full(time, *params)
       format_date_full(time) + format_time(time)
     end
-    
+
     # Format +date+ in human usable form. For example “5 days ago” or
     # “yesterday”. In +now+ you can set base time, which be used to get relative
     # time. For special cases you can replace it in locale’s class.
@@ -272,12 +272,12 @@ module R18n
         format_date_full(date, date.year != now.year)
       end
     end
-    
+
     # Format +date+ in compact form. For example, “12/31/09”.
     def format_date_standard(date, *params)
       strftime(date, date_format)
     end
-    
+
     # Format +date+ in most official form. For example, “December 31st, 2009”.
     # For special cases you can replace it in locale’s class. If +year+ is false
     # date will be without year.
@@ -300,6 +300,6 @@ module R18n
       end
     end
   end
-  
+
   module Locales; end
 end

data/lib/r18n-core/translated.rb

@@ -21,43 +21,43 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
 module R18n
   # Module to add i18n support to any class. It will be useful for ORM or
   # R18n plugin with out-of-box i18n support.
-  # 
+  #
   # Module can add proxy-methods to find translation in object methods. For
   # example, if you class have +title_en+ and +title_ru+ methods, you can add
   # proxy-method +title+, which will use +title_ru+ for Russian users and
   # +title_en+ for English:
-  # 
+  #
   #   require 'r18n-core/translated'
-  #   
+  #
   #   class Product
   #     include DataMapper::Resource
   #     property :title_ru, String
   #     property :title_en, String
   #     property :desciption_ru, String
   #     property :desciption_en, String
-  #     
+  #
   #     include R18n::Translated
   #     translations :title, :desciption
   #   end
-  #   
+  #
   #   # User know only Russian
   #   R18n.set('ru')
-  #   
+  #
   #   product.title #=> Untranslated
-  #   
+  #
   #   # Set value to English (default) title
   #   product.title_en = "Anthrax"
   #   product.title #=> "Anthrax"
   #   product.title.locale #=> Locale en (English)
-  #   
+  #
   #   # Set value to title on user locale (Russian)
   #   product.title = "Сибирская язва"
   #   product.title #=> "Сибирская язва"
   #   product.title.locale #=> Locale ru (Russian)
-  #   
+  #
   #   product.title_en #=> "Anthrax"
   #   product.title_ru #=> "Сибирская язва"
-  # 
+  #
   # Proxy-method support all funtion from I18n: global and type filters,
   # pluralization, variables. It also return TranslatedString or Untranslated.
   #
@@ -67,7 +67,7 @@ module R18n
   # must call <tt>i18n</tt> helper in Sinatra before use models.
   #
   # See R18n::Translated::Base for class method documentation.
-  # 
+  #
   # == Options
   # You can set option for proxy-method as Hash with keys;
   # * +type+ – YAML type for filters. For example, "markdown" or "escape_html".
@@ -75,9 +75,9 @@ module R18n
   # * +no_params+ – set it to true if you proxy-method must send it parameters
   #   only to filters.
   # * +no_write+ – set it to true if you don’t want to create proxy-setters.
-  # 
+  #
   # Method +translation+ will be more useful for options:
-  # 
+  #
   #   translation :title, :methods => {:ru => :russian, :en => :english}
   module Translated
     class << self
@@ -88,12 +88,12 @@ module R18n
         base.instance_variable_set '@translation_types', {}
       end
     end
-    
+
     # Module with class methods, which be added after R18n::Translated include.
     module Base
       # Hash of translation method names to it type for filters.
       attr_reader :translation_types
-      
+
       # Add several proxy +methods+. See R18n::Translated for description.
       # It’s more compact, that +translation+.
       # 
@@ -103,7 +103,7 @@ module R18n
           translation(*method)
         end
       end
-      
+
       # Add proxy-method +name+. See R18n::Translated for description.
       # It’s more useful to set options.
       # 
@@ -117,10 +117,10 @@ module R18n
               hash_map(options[:methods]) { |l, i| [ l.to_s, i.to_s + '=' ] }
           end
         end
-        
+
         @translation_types[name] = options[:type]
         params = options[:no_params] ? '' : ', *params'
-        
+
         class_eval <<-EOS, __FILE__, __LINE__
           def #{name}(*params)
             unlocalized = self.class.unlocalized_getters(#{name.inspect})
@@ -129,7 +129,7 @@ module R18n
               next unless unlocalized.has_key? code
               result = send unlocalized[code]#{params}
               next unless result
-              
+
               path = "\#{self.class.name}##{name}"
               type = self.class.translation_types[#{name.inspect}]
               if type
@@ -143,12 +143,12 @@ module R18n
                 return result
               end
             end
-            
+
             R18n::Untranslated.new("\#{self.class.name}\#", '#{name}',
                                    R18n.get.locale)
           end
         EOS
-        
+
         unless options[:no_write]
           class_eval <<-EOS, __FILE__, __LINE__
             def #{name}=(*params)
@@ -162,7 +162,7 @@ module R18n
           EOS
         end
       end
-      
+
       # Return array of methods to find +unlocalized_getters+ or
       # +unlocalized_setters+.
       def unlocalized_methods
@@ -182,7 +182,7 @@ module R18n
         end
         @unlocalized_getters[method]
       end
-      
+
       # Return Hash of locale code to setter method for proxy +method+. If you
       # didn’t set map in +translation+ option +methods+, it will be detect
       # automatically.