russian 0.0.1 → 0.0.2

data/README.textile

@@ -1,44 +1,219 @@
 h1. Russian
 
-Russian language support for Ruby and Rails, using I18n library (also shipped in Rails 2.2+).
+Поддержка русского языка для Ruby и Rails при помощи библиотеки I18n.
 
-Поддержка русского языка для Ruby и Rails при помощи библиотеки I18n (также входит в состав Rails 2.2+)
+Russian language support for Ruby and Rails, using I18n library.
 
 h3. If you don't speak Russian
 
-This code may still be useful for you. You can learn how to create custom backends for I18n and how to 
-provide support of "standalone" (as defined in "Unicode CLDR":http://unicode.org/cldr/) month names with I18n and Rails, and also how to add dead simple pluralization rules into your translation tables.
+This code may still be useful for you and Ruby I18n community. You can learn how to create custom backends for I18n and how to provide support of "standalone" (as defined in "Unicode CLDR":http://unicode.org/cldr/) month names with I18n and Rails, and also how to add dead simple pluralization rules into your translation tables. This library also includes a module (@Russian@) with a set of helpers to provide simplistic pluralization and @strftime@ for Russian language -- in a way that is easier than using I18n methods.
+
+Feel free to shoot an email to Yaroslav Markin ("yaroslav@markin.net":mailto:yaroslav@markin.net)
 
 h1. Что это
 
 Russian -- это библиотека для полноценной поддержки русского языка (форматирование даты и времени, плюрализация, локализация в целом) для Ruby и Ruby on Rails.
 
-Для этого используется библиотека I18n, несколько хаков поверх нее и файлы переводов.
+Цель проекта -- построить полноценную среду для русской локализации Ruby и Rails проектов, при этом используя минимально возможное количество хаков, сохраняя при этом поддержку локализации приложения на другие языки, а также форсировать включение в основную ветку I18n и Rails всех функций локализации, необходимых для работы с русским языком.
+
+Russian использует библиотеку I18n (включена в поставку), несколько хаков поверх нее (собственный бекэнд с поддержкой спецефичного для русского форматирования даты и времени, поддержкой плюрализации), несколько хаков поверх Rails (хаки хелперов даты-времени, хак для сообщений валидации) и файлы переводов, а также набор хелперов, упрощающий работу с русским языком (простая плюрализация, простой strftime и др.).
+
+Russian стремится быть минимально деструктивной для окружения и быть полностью совместимой с другими языками (таким образом, когда приложение использует Russian и собственный бекэнд Russian, оно остается польностью совместимым с Rails i18n). 
+
+h2. Что такое I18n
+
+Библиотека I18n входит в состав Ruby on Rails начиная с версии 2.2. В перспективе I18n -- это самое простое и недеструктивное решение для локализации и интернационализации Rails приложений, но в текущей версии отсутствовала поддержка нескольких важных возможностей, специфичных для русского языка. Таким образом, русский язык для локализации в Rails 2.2 фактически не поддерживался.
 
-I18n входит в состав Ruby on Rails начиная с версии 2.2, но на момент публикации нормальная поддержка русского языка отсутствовала.
+Для исправления этого досадного недоразумения появилась библиотека Russian (подробнее см. _Использование_).
+
+h1. Требования
+
+* Ruby 1.8 (тестировалось на 1.8.6);
+* Для использования с Rails нужна версия не ниже 2.2;
+* Для тестирования библиотеки вам понадобится RSpec.
 
 h1. Установка
 
-TODO: пути на GitHub, публикация на RubyForge
+Страница Russian на github -- "http://github.com/yaroslav/russian/":http://github.com/yaroslav/russian/
+
+Russian можно установить как gem с github. Для этого:
+
+1. Нужно добавить репозиторий gem'ов github в качестве источника
 
-* gem rubyforge
-* gem github
+@gem sources -a http://gems.github.com@
+
+2. Установить gem
+
+@gem install yaroslav-russian@
+
+Gem @russian@ также зеркалируется на RubyForge, поэтому его можно установить командой 
+
+@gem install russian@.
 
 h2. Ruby on Rails
 
-* gem
-* plugin github
+Существует два варианта использования Russian вместе с Rails:
+
+1. Установка gem
+
+В файле @config/environment.rb@ сделайте ссылку на gem @yaroslav-russian@ с github:
+
+<pre><code>
+Rails::Initializer.run do |config|
+  config.gem 'yaroslav-russian', :lib => 'russian', :source => 'http://gems.github.com'
+end
+</code></pre>
+
+Чтобы установить gem, используйте команду 
+
+@rake gems:install@.
+
+2. Установка плагина
+
+Для того, чтобы установить Russian как плагин к Rails, используйте команду
+
+@script/plugin install git://github.com/yaroslav/russian.git@
+
+_NB:_ вполне вероятно, что на Windows нет нормальной реализации git, поэтому вам придется загружать исходники
+в виде архива с github или же просто использовать gem.
 
 h1. Использование
 
-* Прозрачное: локаль по умолчанию, свой бекенд (недеструктивный)
-* Хелперы Russian.*
+При загрузке Russian включает:
+
+* библиотеку I18n если она еще не используется (например, если Russian используется отдельно от Rails)
+* собственный класс для I18n бекэнда (полностью совместим со стандартным бекэндом)
+* перегрузку хелперов даты для Rails (если Rails загружен)
+* пререгрузку обработки сообщений валидации для ActiveRecord (если Rails загружен)
+
+При инициализации:
+
+* заменяется бэкэнд I18n со стандартного на собственный бекэнд Russian (@I18n::Backend::Advanced@)
+* _NB:_ локаль русского языка (@ru-RU@) становится локалью по умолчанию
+* загружаются все файлы переводов, в том числе переводы для Rails.
+
+После этого можно использовать все стандартные функции библиотеки I18n, пользоваться измененным функицоналом для лучшей поддержки русского языка, или использовать хелперы модуля Russian для еще более простой работы с русским языком.
+
+h2. Отличия от стандартной библиотеки I18n
+
+1. Поддержка двух видов названий месяцев -- контекст ("сентября") и отдельностоящее ("Сентябрь").
+
+Для этого перегружена функция локализации, теперь название месяца используется в зависимости от контекста. В словарях Russian определены оба варианта.
+
+Перегрузка недеструктивная: если для какого-то другого языка не определены два варианта названий месяцев, ошибки не возникнет.
+
+Аналогично есть поддержка двух видов названий дней недели.
+
+2. Плюрализация
+
+Стандартно I18n поддерживается только плюрализация по английским правилам; бекэнд, использующийся в Russian, позволяет каждому языку определять правила плюрализации в таблице переводов, задавая их как @Proc@.
+
+Перегрузка недеструктивная: если правила в таблице нет, используется правило по умолчанию (английский язык).
+
+Правила для русского языка включены.
+
+h1. Справочник
+
+h2. Вспомогательные методы модуля Russian
+
+<pre></code>
+Russian.locale
+Russian::LOCALE
+</code></pre>
+
+-- возвращает локаль русского языка (@ru-RU@).
+
+<pre></code>
+Russian::i18n_backend_class
+</code></pre>
+
+-- возвращает класс собственного бекенда I18n
+
+<pre></code>
+Russian::init_i18n
+</code></pre>
+
+-- инициализация Russian. Включение бекэнда, русский язык по умолчанию, загрузка переводов. 
+
+_NB:_ Выполняется автоматически при загрузке.
+
+<pre></code>
+Russian::translate
+Russian::t
+</code></pre>
+
+-- прокси для метода @translate@ I18n, форсирует использование русской локали.
+
+<pre></code>
+Russian::localize
+Russian::l
+</code></pre>
+
+-- прокси для метода @localize@ I18n, форсирует использование русской локали.
+
+<pre></code>
+Russian::strftime
+
+Russian::strftime(Time.now)
+=> "Пн, 01 сент. 2008, 11:12:43 +0300"
+Russian::strftime(Time.now, "%B")
+=> "Сентябрь"
+</code></pre>
+
+-- @strftime@ с форсированием русской локали (упрощенный вариант @localize@)
+
+<pre></code>
+Russian::pluralize
+Russian::p
+
+Russian.p(1, "вещь", "вещи", "вещей")
+=> "вещь"
+Russian.p(2, "вещь", "вещи", "вещей")
+=> "вещи"
+Russian.p(10, "вещь", "вещи", "вещей")
+=> "вещей"
+</code></pre>
+
+-- упрощенная (без использования хешей I18n) плюрализация для русского языка
 
 h2. Ruby on Rails
 
-* Стандартный язык для I18n
-* Перегрузка хелперов
+h3. Переводы
+
+При использовании с Ruby on Rails загружаются все стандартные переводы, и русский язык становится годным к использованию для локализации. В поставку включены все нужные переводы для ActionView, ActiveRecord, ActiveSupport, которые можно переопределять по необходимости стандартными средствами I18n.
+
+h3. Хелперы
+
+Хелперы даты-времени получают ключ @:use_standalone_month_names@ для форсирования отображения отдельностоящего названия месяца ("Сентябрь" а не "сентября"). Такое имя месяца используется когда включен ключ @:use_standalone_month_names@ (для отдельностоящего @select_month@ он включается по умолчанию), либо когда есть ключ @:discard_day@.
+
+h3. Валидация
+
+Обработка ошибок в ActiveRecord перегружается -- в Russian включен популярный плагин custom_error_message, с помощью которого можно переопределять стандартное отображение сообщений об ошибках. Так, например,
+
+@validates_acceptance_of :accepted_terms, :message => 'нужно принять соглашение'@
+
+даст сообщение
+
+@Accepted terms нужно принять соглашение@
+
+или, например
+
+@Соглашение об использовании нужно принять соглашение@
+
+если вы указали перевод для имени атрибута.
+  
+Но
+
+@validates_acceptance_of :accepted_terms, :message => '^Нужно принять соглашение'@
+
+даст сообщение
+
+@Нужно принять соглашение@
+
+_NB:_ в сообщениях валидации можно использовать такие макросы как @{{attribute}}@, @{{value}}@ -- подробнее см. документацию по I18n.
 
 h1. Автор
 
-Ярослав Маркин ("yaroslav@markin.net":mailto:yaroslav@markin.net)
+Для сообщений об ошибках, обнаруженных неточностях и предложений:
+
+Ярослав Маркин ("yaroslav@markin.net":mailto:yaroslav@markin.net)

data/Rakefile

@@ -5,7 +5,7 @@ require 'rubygems/specification'
 require 'date'
 
 GEM = "russian"
-GEM_VERSION = "0.0.1"
+GEM_VERSION = "0.0.2"
 AUTHOR = "Yaroslav Markin"
 EMAIL = "yaroslav@markin.net"
 HOMEPAGE = "http://github.com/yaroslav/russian/"

data/TODO

@@ -1,8 +1,9 @@
 TODO
 ====
-* docs and README (english - brief, full russian doc)
 * check Unicode CLDR to ensure all datetime formats are correct
+* examples of custom translations, AR models/attributes/messages translations
 * refactor Advanced backend localize method (looks ugly)
+* Countries list
 
 Questionable
 ============

data/lib/russian.rb

@@ -13,7 +13,7 @@ module Russian
   module VERSION
     MAJOR = 0
     MINOR = 0
-    TINY  = 1
+    TINY  = 2
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end
@@ -67,6 +67,7 @@ module Russian
       variants_hash = pluralization_variants_to_hash(*variants)
       I18n.backend.send(:pluralize, LOCALE, variants_hash, n)
     end
+    alias :p :pluralize
     
     protected
       # Returns all locale files shipped with library

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

@@ -1,4 +1,14 @@
-# Replaces Rails select_month helper and translated_month_names private method to provide
+# Заменяет хелпер 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).
@@ -20,6 +30,11 @@ if defined?(ActionView::Helpers::DateTimeSelector) && ActionView::Helpers::DateT
         # 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".
@@ -64,6 +79,11 @@ if defined?(ActionView::Helpers::DateTimeSelector) && ActionView::Helpers::DateT
           #
           # 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
             begin
               if @options[:use_short_month]

data/lib/russian/active_record_ext/custom_error_message.rb

@@ -9,6 +9,26 @@ if defined?(ActiveRecord::Errors)
       #  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'
+      #
+      #
+      # Переопределяет метод ActiveRecord::Errors::full_messages. Сообщения об ошибках для атрибутов
+      # теперь не имеют префикса с названием атрибута если в сообщении об ошибке первым символом указан "^".
+      #
+      # Так, например,
+      # 
+      #   validates_acceptance_of :accepted_terms, :message => 'нужно принять соглашение'
+      # 
+      # даст сообщение
+      # 
+      #   Accepted terms нужно принять соглашение
+      # 
+      # однако,
+      # 
+      #   validates_acceptance_of :accepted_terms, :message => '^Нужно принять соглашение'
+      # 
+      # даст сообщение
+      # 
+      #   Нужно принять соглашение
       def full_messages
         full_messages = []
   

data/lib/russian/backend/advanced.rb

@@ -1,9 +1,17 @@
 module I18n
   module Backend
+    # "Продвинутый" бекэнд для I18n.
+    # 
+    # Наследует Simple бекэнд и полностью с ним совместим. Добаляет поддержку 
+    # для отдельностоящих/контекстных названий дней недели и месяцев.
+    # Также позволяет каждому языку использовать собственные правила плюрализации,
+    # объявленные как Proc (<tt>lambda</tt>).
+    # 
+    #
     # Advanced I18n backend.
     #
-    # Extends <tt>Simple</tt> backend. Allows usage of <tt>standalone_*</tt> keys
-    # for DateTime localization and usage of user-defined <tt>Proc</tt> (lambda) pluralization
+    # Extends Simple backend. Allows usage of "standalone" keys
+    # for DateTime localization and usage of user-defined Proc (lambda) pluralization
     # methods in translation tables.
     class Advanced < Simple
       LOCALIZE_ABBR_MONTH_NAMES_MATCH = /(%d|%e)?(\s*)(%b)/
@@ -15,8 +23,13 @@ module I18n
       # formatted date string. Takes a key from the date/time formats 
       # translations as a format argument (<em>e.g.</em>, <tt>:short</tt> in <tt>:'date.formats'</tt>).
       #
-      # Note that it differs from <tt>localize</tt> in <tt>Simple</tt> backend by checking for 
-      # <tt>standalone_*</tt> month name/day name keys in translation and using them if available.
+      #
+      # Метод отличается от <tt>localize</tt> в Simple бекэнде поддержкой 
+      # отдельностоящих/контекстных названий дней недели и месяцев.
+      #
+      #
+      # Note that it differs from <tt>localize</tt> in Simple< backend by checking for 
+      # "standalone" month name/day name keys in translation and using them if available.
       def localize(locale, object, format = :default)
         raise ArgumentError, "Object must be a Date, DateTime or Time object. #{object.inspect} given." unless object.respond_to?(:strftime)
         
@@ -65,6 +78,19 @@ module I18n
       end
       
       protected
+        # Использует правила плюрализации из таблицы переводов для языка (если присутствуют),
+        # иначе использует правило плюрализации по умолчанию (английский язык).
+        # 
+        # Пример задания правила в таблице переводов:
+        #
+        #   store_translations :'en-US', {
+        #     :pluralize => lambda { |n| n == 1 ? :one : :other }
+        #   }
+        # 
+        # Правило должно возвращать один из символов для таблицы переводов:
+        #   :zero, :one, :two, :few, :many, :other
+        #
+        #
         # Picks a pluralization rule specified in translation tables for a language or
         # uses default pluralization rules.
         #

data/lib/russian/locale/actionview.yml

@@ -1,5 +1,8 @@
 ru-RU:
   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:
@@ -13,6 +16,9 @@ ru-RU:
     # Used in number_to_currency()
     currency:
       format:
+        # Формат отображения валюты и обозначение самой валюты
+        #
+        #
         # Where is the currency sign? %u is the currency unit, %n the number (default: $5.00)
         format: "%n %u"
         unit: "руб."
@@ -45,6 +51,9 @@ ru-RU:
         delimiter: ""
         precision: 1
 
+  # Используется в хелперах 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:
@@ -100,14 +109,20 @@ ru-RU:
         many:  "больше {{count}} лет"
         other: "больше {{count}} лет"
 
+  # Используется в хелпере error_messages_for
   activerecord:
     errors:
       template:
+        # Заголовок сообщения об ошибке
         header:
           one:   "{{model}} не удалось сохранить из-за 1 ошибки"
           few:   "{{model}} не удалось сохранить из-за {{count}} ошибок"
           many:  "{{model}} не удалось сохранить из-за {{count}} ошибок"
           other: "{{model}} не удалось сохранить из-за {{count}} ошибок"
+
+        # Первый параграф сообщения об ошибке. Можно использовать макрос {{count}}
+        #
+        #
         # The variable :count is also available
         body: "Проблемы возникли со следующими полями:"
 

data/lib/russian/locale/activerecord.yml

@@ -1,6 +1,15 @@
 ru-RU:
   activerecord:
+    # Сообщения об ошибке (валидации) ActiveRecord
     errors:
+      # Для всех сообщений доступны макросы {{model}}, {{attribute}}, {{value}}.
+      # Для некоторых доступен макрос {{count}} -- в этом случае можно задать несколько вариантов
+      # сообщения (плюрализация)
+      #
+      # Также можно использовать сообщения, начинающиеся с "^" -- в этом случае
+      # в списке ошибок валидации перед конкретным сообщением не будет выводиться имя атрибута.
+      #
+      #
       # The values :model, :attribute and :value are always available for interpolation
       # The value :count is available when applicable. Can be used for pluralization.
       #
@@ -15,20 +24,20 @@ ru-RU:
         empty: "не может быть пустым"
         blank: "не может быть пустым"
         too_long:
-          one:   "слишком большой длины (допустимая длина - менее 1 символа)"
-          few:   "слишком большой длины (допустимая длина - менее {{count}} символов)"
-          many:  "слишком большой длины (допустимая длина - менее {{count}} символов)"
-          other: "слишком большой длины (допустимая длина - менее {{count}} символов)"
+          one:   "слишком большой длины (не может быть больше чем 1 символ)"
+          few:   "слишком большой длины (не может быть больше чем {{count}} символа)"
+          many:  "слишком большой длины (не может быть больше чем {{count}} символов)"
+          other: "слишком большой длины (не может быть больше чем {{count}} символа)"
         too_short:
-          one:   "недостаточной длины (допустимая длина - более 1 символа)"
-          few:   "недостаточной длины (допустимая длина - более {{count}} символов)"
-          many:  "недостаточной длины (допустимая длина - более {{count}} символов)"
-          other: "недостаточной длины (допустимая длина - более {{count}} символов)"
+          one:   "недостаточной длины (не может быть меньше 1 символа)"
+          few:   "недостаточной длины (не может быть меньше {{count}} символов)"
+          many:  "недостаточной длины (не может быть меньше {{count}} символов)"
+          other: "недостаточной длины (не может быть меньше {{count}} символов)"
         wrong_length:
-          one:   "неверной длины (допустимая длина - ровно 1 символ)"
-          few:   "неверной длины (допустимая длина - ровно {{count}} символа)"
-          many:  "неверной длины (допустимая длина - ровно {{count}} символов)"
-          other: "неверной длины (допустимая длина - ровно {{count}} символа)"
+          one:   "неверной длины (может быть длиной ровно 1 символ)"
+          few:   "неверной длины (может быть длиной ровно {{count}} символа)"
+          many:  "неверной длины (может быть длиной ровно {{count}} символов)"
+          other: "неверной длины (может быть длиной ровно {{count}} символа)"
         taken: "уже существует"
         not_a_number: "не является числом"
         greater_than: "может иметь значение большее {{count}}"
@@ -38,11 +47,20 @@ ru-RU:
         less_than_or_equal_to: "может иметь значение меньшее или равное {{count}}"
         odd: "может иметь лишь четное значение"
         even: "может иметь лишь нечетное значение"
+        # Можно добавить собственные сообщения об ошибке тут или в конкексте модели/атрибутов (ниже)
+        #
+        #
         # Append your own errors here or at the model/attributes scope.
 
-      models:
-        # Overrides default messages
+    models:
+      # Перегрузка названий моделей
+      #
+      #
+      # Overrides default messages
       
-      attributes:
-        # Overrides model and default messages.
+    attributes:
+      # Перегрузка сообщений атрибутов
+      #
+      #
+      # Overrides model and default messages.
         

data/lib/russian/locale/activesupport.yml

@@ -1,4 +1,7 @@
 ru-RU:
+# Используется в array.to_sentence
+#  
+#  
 # Used in array.to_sentence.
   support:
     array:

data/lib/russian/locale/datetime.yml

@@ -1,29 +1,46 @@
 ru-RU:
   date:
     formats:
+      # Форматы указываются в виде, поддерживаемом strftime.
+      # По умолчанию используется default.
+      # Можно добавлять собственные форматы
+      #
+      #
       # Use the strftime parameters for formats.
       # When no format has been given, it uses default.
       # You can provide other formats here if you like!
       default: "%d.%m.%Y"
       short: "%d %b"
       long: "%d %B %Y"
-      
+    
+    # Названия дней недели -- контекстные и отдельностоящие
     day_names: [воскресенье, понедельник, вторник, среда, четверг, пятница, суббота]
     standalone_day_names: [Воскресенье, Понедельник, Вторник, Среда, Четверг, Пятница, Суббота]
     abbr_day_names: [Вс, Пн, Вт, Ср, Чт, Пт, Сб]
-      
+
+    # Названия месяцев -- сокращенные и полные, плюс отдельностоящие.
+    # Не забудьте nil в начале массиве (~)
+    # 
+    #
     # Don't forget the nil at the beginning; there's no such thing as a 0th month
     month_names: [~, января, февраля, марта, апреля, мая, июня, июля, августа, сентября, октября, ноября, декабря]
     standalone_month_names: [~, Январь, Февраль, Март, Апрель, Май, Июнь, Июль, Август, Сентябрь, Октябрь, Ноябрь, Декабрь]
     abbr_month_names: [~, янв., февр., марта, апр., мая, июня, июля, авг., сент., окт., нояб., дек.]
     standalone_abbr_month_names: [~, янв., февр., март, апр., май, июнь, июль, авг., сент., окт., нояб., дек.]
+    
+    # Порядок компонентов даты для хелперов
+    #
+    #
     # Used in date_select and datime_select.
     order: [ :day, :month, :year ]
 
   time:
+    # Форматы времени
     formats:
       default: "%a, %d %b %Y, %H:%M:%S %z"
       short: "%d %b, %H:%M"
       long: "%d %B %Y, %H:%M"
+    
+    # am/pm решено перевести как "утра/вечера" :)
     am: "утра"
     pm: "вечера"

data/lib/russian/locale/pluralize.rb

@@ -1,6 +1,9 @@
 {
   :'ru-RU' => {
     :pluralize => lambda { |n| 
+      # Правило плюрализации для русского языка, взято из CLDR, http://unicode.org/cldr/
+      #
+      #
       # Russian language pluralization rules, taken from CLDR project, http://unicode.org/cldr/
       #
       # one -> n mod 10 is 1 and n mod 100 is not 11;

data/spec/russian_spec.rb

@@ -117,25 +117,27 @@ describe Russian do
     end
   end
   
-  describe "pluralize" do
-    it "should pluralize with variants given" do
-      variants = %w(вещь вещи вещей)
+  describe "with pluralization" do
+    %w(p pluralize).each do |method|
+      it "'#{method}' should pluralize with variants given" do
+        variants = %w(вещь вещи вещей)
+        
+        Russian.send(method, 1, *variants).should == "вещь"
+        Russian.send(method, 2, *variants).should == 'вещи'
+        Russian.send(method, 3, *variants).should == 'вещи'
+        Russian.send(method, 5, *variants).should == 'вещей'
+        Russian.send(method, 10, *variants).should == 'вещей'
+        Russian.send(method, 21, *variants).should == 'вещь'
+        Russian.send(method, 29, *variants).should == 'вещей'
+        Russian.send(method, 129, *variants).should == 'вещей'
+        Russian.send(method, 131, *variants).should == 'вещь'
+      end
       
-      Russian.pluralize(1, *variants).should == "вещь"
-      Russian.pluralize(2, *variants).should == 'вещи'
-      Russian.pluralize(3, *variants).should == 'вещи'
-      Russian.pluralize(5, *variants).should == 'вещей'
-      Russian.pluralize(10, *variants).should == 'вещей'
-      Russian.pluralize(21, *variants).should == 'вещь'
-      Russian.pluralize(29, *variants).should == 'вещей'
-      Russian.pluralize(129, *variants).should == 'вещей'
-      Russian.pluralize(131, *variants).should == 'вещь'
-    end
-    
-    it "should raise an exception when there are not enough variants" do
-      lambda { Russian.pluralize(1) }.should raise_error(ArgumentError)
-      lambda { Russian.pluralize(1, "вещь") }.should raise_error(ArgumentError)
-      lambda { Russian.pluralize(1, "вещь", "вещи") }.should raise_error(ArgumentError)
+      it "should raise an exception when there are not enough variants" do
+        lambda { Russian.send(method, 1) }.should raise_error(ArgumentError)
+        lambda { Russian.send(method, 1, "вещь") }.should raise_error(ArgumentError)
+        lambda { Russian.send(method, 1, "вещь", "вещи") }.should raise_error(ArgumentError)
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: russian
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Yaroslav Markin