belorussian 0.6.0

data/Rakefile

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'rspec/core/rake_task'
+require 'rubygems/specification'
+
+task :default => :spec
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = FileList['spec/**/*_spec.rb']
+  t.rspec_opts = %w(-fs --color)
+end

data/TODO

@@ -0,0 +1,4 @@
+TODO
+====
+* RDoc
+

data/belorussian.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+
+$: << File.expand_path('../lib', __FILE__)
+require 'belorussian/version'
+
+Gem::Specification.new do |s|
+  s.name = %q{belorussian}
+  s.version = Belorussian::VERSION::STRING
+
+  s.required_rubygems_version = '>= 1.3.5'
+  s.authors = ["Yaroslav Markin"]
+  s.autorequire = %q{belorussian}
+  s.description = %q{Belorussian language support for Ruby and Rails}
+  s.email = %q{yaroslav@markin.net}
+  s.extra_rdoc_files = ["README.textile", "LICENSE", "CHANGELOG", "TODO"]
+  s.files = Dir.glob("{lib,spec}/**/**") + %w(CHANGELOG Gemfile LICENSE Rakefile README.textile belorussian.gemspec TODO)
+  s.platform = Gem::Platform::RUBY
+  s.homepage = %q{http://github.com/yaroslav/belorussian/}
+  s.require_paths = ["lib"]
+  s.summary = %q{Belorussian language support for Ruby and Rails}
+
+  s.add_dependency('i18n', '>= 0.5.0')
+
+  s.add_development_dependency 'activesupport', '>= 3.0.0'
+  s.add_development_dependency 'rspec', '~> 2.7.0'
+end

data/lib/belorussian.rb

@@ -0,0 +1,98 @@
+# -*- encoding: utf-8 -*- 
+
+$KCODE = 'u' if RUBY_VERSION < "1.9"
+
+require 'i18n'
+
+$:.push File.join(File.dirname(__FILE__), 'belorussian')
+require 'russian_rails'
+
+module Belorussian
+  extend self
+  
+  autoload :Transliteration, 'transliteration'
+  
+  # Belorussian locale
+  LOCALE = :'by'
+
+  # Belorussian locale
+  def locale
+    LOCALE
+  end
+
+  # Regexp machers for context-based belorussian month names and day names translation
+  LOCALIZE_ABBR_MONTH_NAMES_MATCH = /(%[-\d]?d|%e)(.*)(%b)/
+  LOCALIZE_MONTH_NAMES_MATCH = /(%[-\d]?d|%e)(.*)(%B)/
+  LOCALIZE_STANDALONE_ABBR_DAY_NAMES_MATCH = /^%a/
+  LOCALIZE_STANDALONE_DAY_NAMES_MATCH = /^%A/
+    
+  # Init Belorussian i18n: load all translations shipped with library.
+  def init_i18n
+    I18n::Backend::Simple.send(:include, I18n::Backend::Pluralization)
+    I18n::Backend::Simple.send(:include, I18n::Backend::Transliterator)
+
+    I18n.load_path.unshift(*locale_files)
+
+    I18n.reload!
+  end
+
+  # See I18n::translate
+  def translate(key, options = {})
+    I18n.translate(key, options.merge({ :locale => LOCALE }))
+  end        
+  alias :t :translate
+  
+  # See I18n::localize
+  def localize(object, options = {})
+    I18n.localize(object, options.merge({ :locale => LOCALE }))
+  end
+  alias :l :localize
+  
+  # strftime() proxy with Belorussian localization
+  def strftime(object, format = :default)
+    localize(object, { :format => format })
+  end
+  
+  # Simple pluralization proxy
+  #
+  # Usage: 
+  #   Belorussian.pluralize(1, "вещь", "вещи", "вещей")
+  #   Belorussian.pluralize(3.14, "вещь", "вещи", "вещей", "вещи")
+  def pluralize(n, *variants)
+    raise ArgumentError, "Must have a Numeric as a first parameter" unless n.is_a?(Numeric)
+    raise ArgumentError, "Must have at least 3 variants for pluralization" if variants.size < 3
+    raise ArgumentError, "Must have at least 4 variants for pluralization" if (variants.size < 4 && n != n.round)
+    variants_hash = pluralization_variants_to_hash(*variants)
+    I18n.backend.send(:pluralize, LOCALE, variants_hash, n)
+  end
+  alias :p :pluralize
+
+  # Transliteration for belorussian language
+  #
+  # Usage:
+  #  Belorussian.translit("рубин")
+  #  Belorussian.transliterate("рубин")
+  def transliterate(str)
+    Belorussian::Transliteration.transliterate(str)
+  end
+  alias :translit :transliterate
+  
+  protected
+    # Returns all locale files shipped with library
+    def locale_files
+      Dir[File.join(File.dirname(__FILE__), "belorussian", "locale", "**/*")]
+    end
+    
+    # Converts an array of pluralization variants to a Hash that can be used
+    # with I18n pluralization.
+    def pluralization_variants_to_hash(*variants)
+      {
+        :one => variants[0],
+        :few => variants[1],
+        :many => variants[2],
+        :other => variants[3]
+      }
+    end
+end
+
+Belorussian.init_i18n

data/lib/belorussian/action_view_ext/helpers/date_helper.rb

@@ -0,0 +1,118 @@
+# -*- encoding: utf-8 -*- 
+
+# Заменяет хелпер Rails <tt>select_month</tt> и метод <tt>translated_month_names</tt> 
+# для поддержки функционала "отдельностоящих имен месяцев".
+#
+# Теперь можно использовать и полные, и сокращенные название месяцев в двух вариантах -- контекстном
+# (по умолчанию) и отдельностоящем (если в текущем языке есть соответствующие переводы).
+# Теперь хелперы поддерживают ключ <tt>:use_standalone_month_names</tt>, хелпер <tt>select_month</tt> 
+# устанавливает его по умолчанию.
+# Отдельностоящие имена месяцев также используютс когда указан ключ <tt>:discard_day</tt>.
+#
+#
+# Replaces Rails <tt>select_month</tt> helper and <tt>translated_month_names</tt> private method to provide
+# "standalone month names" feature. 
+#
+# It is now possible to use both abbreviated and full month names in two variants (if current locale provides them).
+# All date helpers support <tt>:use_standalone_month_names</tt> key now, <tt>select_month</tt> helper sets 
+# it to true by default.
+# Standalone month names are also used when <tt>:discard_day</tt> key is provided.
+if defined?(ActionView::Helpers::DateTimeSelector)
+  module ActionView
+    module Helpers
+      module DateHelper
+        # Returns a select tag with options for each of the months January through December with the current month
+        # selected. The month names are presented as keys (what's shown to the user) and the month numbers (1-12) are
+        # used as values (what's submitted to the server). It's also possible to use month numbers for the presentation
+        # instead of names -- set the <tt>:use_month_numbers</tt> key in +options+ to true for this to happen. If you
+        # want both numbers and names, set the <tt>:add_month_numbers</tt> key in +options+ to true. If you would prefer
+        # to show month names as abbreviations, set the <tt>:use_short_month</tt> key in +options+ to true. If you want
+        # to use your own month names, set the <tt>:use_month_names</tt> key in +options+ to an array of 12 month names. 
+        # You can also choose if you want to use i18n standalone month names or default month names -- you can
+        # force standalone month names usage by using <tt>:use_standalone_month_names</tt> key.
+        # Override the field name using the <tt>:field_name</tt> option, 'month' by default.
+        #
+        #
+        # Также поддерживается ключ <tt>:use_standalone_month_names</tt> для явного указания о необходимости
+        # использования отдельностоящих имен месяцев, если текущий язык их поддерживает.
+        #
+        #
+        # ==== Examples
+        #   # Generates a select field for months that defaults to the current month that
+        #   # will use keys like "January", "March".
+        #   select_month(Date.today)
+        #
+        #   # Generates a select field for months that defaults to the current month that
+        #   # is named "start" rather than "month"
+        #   select_month(Date.today, :field_name => 'start')
+        #
+        #   # Generates a select field for months that defaults to the current month that
+        #   # will use keys like "1", "3".
+        #   select_month(Date.today, :use_month_numbers => true)
+        #
+        #   # Generates a select field for months that defaults to the current month that
+        #   # will use keys like "1 - January", "3 - March".
+        #   select_month(Date.today, :add_month_numbers => true)
+        #
+        #   # Generates a select field for months that defaults to the current month that
+        #   # will use keys like "Jan", "Mar".
+        #   select_month(Date.today, :use_short_month => true)
+        #
+        #   # Generates a select field for months that defaults to the current month that
+        #   # will use keys like "Januar", "Marts."
+        #   select_month(Date.today, :use_month_names => %w(Januar Februar Marts ...))
+        #
+        def select_month(date, options = {}, html_options = {})
+          DateTimeSelector.new(date, options.merge(:use_standalone_month_names => true), html_options).select_month
+        end
+      end
+      
+      class DateTimeSelector #:nodoc:
+        private
+          # Returns translated month names
+          #  => [nil, "January", "February", "March",
+          #           "April", "May", "June", "July",
+          #           "August", "September", "October",
+          #           "November", "December"]
+          #
+          # If :use_short_month option is set
+          #  => [nil, "Jan", "Feb", "Mar", "Apr", "May", "Jun",
+          #           "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
+          #
+          # Also looks up if <tt>:discard_day</tt> or <tt>:use_standalone_month_names</tt> option is set
+          # and uses i18n standalone month names if so.
+          #
+          #
+          # Также в зависимости от использования ключей <tt>:discard_day</tt> или <tt>:use_standalone_month_names</tt>
+          # убеждается, есть ли соотвествующие переводы в текущем языке и использует "отдельностоящие" названия
+          # месяцев по необходимости
+          def translated_month_names
+            if @options[:use_short_month]
+              if I18n.backend.send(:lookup, I18n.locale, :'date.common_abbr_month_names')
+                if (@options[:discard_day] || @options[:use_standalone_month_names])
+                  key = :'date.standalone_abbr_month_names'
+                else
+                  key = :'date.common_abbr_month_names'
+                end
+              else
+                key = :'date.abbr_month_names'
+              end
+            else
+              if I18n.backend.send(:lookup, I18n.locale, :'date.common_month_names')
+                if (@options[:discard_day] || @options[:use_standalone_month_names])
+                  key = :'date.standalone_month_names'
+                else
+                  key = :'date.common_month_names'
+                end
+              else
+                key = :'date.month_names'
+              end
+            end
+            
+            I18n.translate(key, :locale => @options[:locale])
+          end
+          
+      end
+    end
+  end
+end # if defined?

data/lib/belorussian/active_model_ext/custom_error_message.rb

@@ -0,0 +1,70 @@
+# -*- encoding: utf-8 -*- 
+
+if defined?(ActiveModel::Errors)
+  module ActiveModel
+    class Errors
+      # Redefine the ActiveModel::Errors.full_messages method:
+      #  Returns all the full error messages in an array. 'Base' messages are handled as usual.
+      #  Non-base messages are prefixed with the attribute name as usual UNLESS they begin with '^'
+      #  in which case the attribute name is omitted.
+      #  E.g. validates_acceptance_of :accepted_terms, :message => '^Please accept the terms of service'
+      #
+      # Переопределяет метод ActiveModel::Errors.full_messages. Сообщения об ошибках для атрибутов
+      # теперь не имеют префикса с названием атрибута если в сообщении об ошибке первым символом указан "^".
+      #
+      # Так, например,
+      # 
+      #   validates_acceptance_of :accepted_terms, :message => 'нужно принять соглашение'
+      # 
+      # даст сообщение
+      # 
+      #   Accepted terms нужно принять соглашение
+      # 
+      # однако,
+      # 
+      #   validates_acceptance_of :accepted_terms, :message => '^Нужно принять соглашение'
+      # 
+      # даст сообщение
+      # 
+      #   Нужно принять соглашение
+      #
+      #
+      # Returns all the full error messages in an array.
+      #
+      #   class Company
+      #     validates_presence_of :name, :address, :email
+      #     validates_length_of :name, :in => 5..30
+      #   end
+      #
+      #   company = Company.create(:address => '123 First St.')
+      #   company.errors.full_messages # =>
+      #     ["Name is too short (minimum is 5 characters)", "Name can't be blank", "Address can't be blank"]
+      def full_messages
+        full_messages = []
+
+        each do |attribute, messages|
+          messages = Array.wrap(messages)
+          next if messages.empty?
+
+          if attribute == :base
+            messages.each {|m| full_messages << m }
+          else
+            attr_name = attribute.to_s.gsub('.', '_').humanize
+            attr_name = @base.class.human_attribute_name(attribute, :default => attr_name)
+            options = { :attribute => attr_name, :default => "%{attribute} %{message}" }
+
+            messages.each do |m|
+              if m =~ /^\^/
+                full_messages << m[1..-1]
+              else
+                full_messages << I18n.t(:"errors.format", options.merge(:message => m))
+              end
+            end
+          end
+        end
+
+        full_messages
+      end
+    end
+  end
+end # if defined?

data/lib/belorussian/belorussian_rails.rb

@@ -0,0 +1,8 @@
+# Rails hacks
+if defined?(ActiveModel)
+  require 'active_model_ext/custom_error_message'
+end
+
+if defined?(ActionView::Helpers)
+  require 'action_view_ext/helpers/date_helper' 
+end

data/lib/belorussian/locale/actionview.yml

@@ -0,0 +1,212 @@
+by:
+  number:
+    # Используется в number_with_delimiter()
+    # Также является установками по умолчанию для 'currency', 'percentage', 'precision', 'human'
+    #
+    # Used in number_with_delimiter()
+    # These are also the defaults for 'currency', 'percentage', 'precision', and 'human'
+    format:
+      # Sets the separator between the units, for more precision (e.g. 1.0 / 2.0 == 0.5)
+      separator: "."
+      # Delimets thousands (e.g. 1,000,000 is a million) (always in groups of three)
+      delimiter: " "
+      # Number of decimals, behind the separator (the number 1 with a precision of 2 gives: 1.00)
+      precision: 3
+      significant: false
+      strip_insignificant_zeros: false
+      
+    # Used in number_to_currency()
+    currency:
+      format:
+        # Формат отображения валюты и обозначение самой валюты
+        #
+        #
+        format: "%n %u"
+        negative_format: "-%n %u"
+        unit: "руб."
+        # These three are to override number.format and are optional
+        separator: "."
+        delimiter: " "
+        precision: 2
+        significant: false
+        strip_insignificant_zeros: false
+        
+    # Used in number_to_percentage()
+    percentage:
+      format:
+        # These three are to override number.format and are optional
+        # separator: 
+        delimiter: ""
+        
+    # Used in number_to_precision()
+    precision:
+      format:
+        # These three are to override number.format and are optional
+        # separator:
+        delimiter: ""
+        # precision:
+        
+    # Used in number_to_human_size()
+    human:
+      format:
+        # These three are to override number.format and are optional
+        # separator: 
+        delimiter: ""
+        precision: 1
+        significant: false
+        strip_insignificant_zeros: false
+      
+      # Rails 2.2
+      # storage_units: [байт, КБ, МБ, ГБ, ТБ]
+      
+      # Rails 2.3+
+      storage_units:
+        # Storage units output formatting.
+        # %u is the storage unit, %n is the number (default: 2 MB)
+        format: "%n %u"
+        units:
+          byte:
+            one:   "байт"
+            few:   "байта"
+            many:  "байт"
+            other: "байта"
+          kb: "КБ"
+          mb: "МБ"
+          gb: "ГБ"
+          tb: "ТБ"
+
+      decimal_units:
+        format: "%n %u"
+        units:
+          unit: ""
+          thousand:
+            one: "тысяча"
+            few: "тысяч"
+            many: "тысяч"
+            other: "тысяч"
+          million:
+            one: "миллион"
+            few: "миллионов"
+            many: "миллионов"
+            other: "миллионов"
+          billion:
+            one: "миллиард"
+            few: "миллиардов"
+            many: "миллиардов"
+            other: "миллиардов"
+          trillion:
+            one: "триллион"
+            few: "триллионов"
+            many: "триллионов"
+            other: "триллионов"
+          quadrillion:
+            one: "квадриллион"
+            few: "квадриллионов"
+            many: "квадриллионов"
+            other: "квадриллионов"
+
+  # Используется в хелперах distance_of_time_in_words(), distance_of_time_in_words_to_now(), time_ago_in_words()
+  #
+  #
+  # Used in distance_of_time_in_words(), distance_of_time_in_words_to_now(), time_ago_in_words()
+  datetime:
+    distance_in_words:
+      half_a_minute: "меньше минуты"
+      less_than_x_seconds:
+        one:   "меньше %{count} секунды"
+        few:   "меньше %{count} секунд"
+        many:  "меньше %{count} секунд"
+        other: "меньше %{count} секунды"
+      x_seconds:
+        one:   "%{count} секунда"
+        few:   "%{count} секунды"
+        many:  "%{count} секунд"
+        other: "%{count} секунды"
+      less_than_x_minutes:
+        one:   "меньше %{count} минуты"
+        few:   "меньше %{count} минут"
+        many:  "меньше %{count} минут"
+        other: "меньше %{count} минуты"
+      x_minutes:
+        one:   "%{count} минута"
+        few:   "%{count} минуты"
+        many:  "%{count} минут"
+        other: "%{count} минуты"
+      about_x_hours:
+        one:   "около %{count} часа"
+        few:   "около %{count} часов"
+        many:  "около %{count} часов"
+        other: "около %{count} часа"
+      x_days:
+        one:   "%{count} день"
+        few:   "%{count} дня"
+        many:  "%{count} дней"
+        other: "%{count} дня"
+      about_x_months:
+        one:   "около %{count} месяца"
+        few:   "около %{count} месяцев"
+        many:  "около %{count} месяцев"
+        other: "около %{count} месяца"
+      x_months:
+        one:   "%{count} месяц"
+        few:   "%{count} месяца"
+        many:  "%{count} месяцев"
+        other: "%{count} месяца"
+      about_x_years:
+        one:   "около %{count} года"
+        few:   "около %{count} лет"
+        many:  "около %{count} лет"
+        other: "около %{count} лет"
+      over_x_years:
+        one:   "больше %{count} года"
+        few:   "больше %{count} лет"
+        many:  "больше %{count} лет"
+        other: "больше %{count} лет"
+      almost_x_years:
+        one:   "почти %{count} год"
+        few:   "почти %{count} года"
+        many:  "почти %{count} лет"
+        other: "почти %{count} лет"
+
+    prompts:
+      year:   "Год"
+      month:  "Месяц"
+      day:    "День"
+      hour:   "Часов"
+      minute: "Минут"
+      second: "Секунд"
+
+  # Используется в хелпере error_messages_for
+  activerecord:
+    errors:
+      template:
+        # Заголовок сообщения об ошибке
+        header:
+          one:   "%{model}: сохранение не удалось из-за %{count} ошибки"
+          few:   "%{model}: сохранение не удалось из-за %{count} ошибок"
+          many:  "%{model}: сохранение не удалось из-за %{count} ошибок"
+          other: "%{model}: сохранение не удалось из-за %{count} ошибки"
+
+        # Первый параграф сообщения об ошибке. Можно использовать макрос %{count}
+        #
+        #
+        # The variable :count is also available
+        body: "Проблемы возникли со следующими полями:"
+
+  support:
+    select:
+      # default value for :prompt => true in FormOptionsHelper
+      prompt: "Выберите: "
+
+  helpers:
+    select:
+      # default value for :prompt => true in FormOptionsHelper
+      prompt: "Выберите: "
+
+
+    # Default translation keys for submit FormHelper
+    submit:
+      create: 'Создать %{model}'
+      update: 'Сохранить %{model}'
+      submit: 'Сохранить %{model}'
+