russian 0.6.0 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 275655e1686deee67f3a2f05fdde45574d5f4de4ca2c5ed73b82c24646c9bb06
+  data.tar.gz: 68ecfa62dbe878e0664180920e1c9be94717ca81f69eccd4c4b92b127da90d1a
+SHA512:
+  metadata.gz: cda3ef8cb0b32229bf808b95c11d9855a5f12032a35bcd63f499cc266dbcbe00a601af9269c696da43ee27a59747cac4a1cc7c9117e4fc9a80b12d6ece687df6
+  data.tar.gz: 7d20280acc42facdcc0ec7ad07d660f67f1acb8a79cac78bd02f34ac12c135f8f0e4662116b7c657ae83d43adf0cfd0c3bd8ca618f272341c5ba34f756740115

data/CHANGELOG.md

@@ -0,0 +1,203 @@
+## [1.0.0] "Remastered" - 2026-03-16 
+
+A remaster of the library, 15 years later.
+
+It turned out that the library is still in use, even on recent Ruby versions, despite some of its helpers having been broken for a long time.
+On top of that, I wanted to finally release version 1.0 and close the loop.
+
+As a result, the `russian` gem has been largely rewritten while preserving the old API: the `Russian` module methods, and even optional support for the old `strftime` signature.
+The gem now targets modern versions of Ruby (3.2+, 4.0+) and Rails (7.2 and 8.0+).
+
+
+Ремастер библиотеки 15 лет спустя.
+
+Выяснилось, что библиотекой пользуются до сих пор, даже на свежих версиях Ruby, несмотря на то, что некоторые хелперы давно перестали работать.
+Кроме того, хотелось бы выпустить версию 1.0 для закрытия гештальта.
+
+В итоге, gem russian большей частью переписан, но с сохранением старого API: методов модуля Russian, и даже с опциональной поддержкой старой сигнатуры `strftime`.
+gem предназначен для современных версий Ruby (3.2+, 4.0+) и Rails (7.2 и 8.0+).
+
+
+- The library is now designed for Ruby 3.2, 3.3, 3.4 and 4.0.
+- Support Rails integration for Rails 7.2, 8.0 and 8.1.
+- Added RBS signatures for the public API.
+- Full YARD documentation now available.
+- Refreshed Russian locale data and added missing modern keys.
+- Aligned the Russian currency decimal separator with CLDR and standard Russian numeric formatting by using a comma instead of a period.
+- Fixed `Russian.transliterate` so it preserves newlines instead of dropping them during tokenization [#57].
+- Fixed context-sensitive month-name selection in `strftime` formats with width and flag modifiers such as `%-e`, `%3d`, and `%_3d`. [#41] [#43] [Aleksei Savartsov](https://github.com/asavartsov)
+- Added localized versions of `strptime`: `date_strptime`, `time_strptime`, and `datetime_strptime` helpers, including case-insensitive parsing of Russian month and weekday names.
+- Speedup for transliteration [#42] (inspired by [Igor Bochkariov](https://github.com/ujifgc))
+- Speedup for pluralization.
+- Speedup for date format checks.
+- Bundled locale files are now added to `I18n.load_path` in a deterministic sorted order, which avoids filesystem-dependent ordering issues and helps tools such as `i18n-js`. [#56] [Andrey Novikov](https://github.com/Envek)
+- Cleaned up Russian comparison validation messages (`greater_than`, `greater_than_or_equal_to`, `less_than`, `less_than_or_equal_to`) for more natural wording. [#47] [Valentin Vasilyev](https://github.com/Valve)
+- Migrated to GitHub Actions with Ruby and Rails matrix jobs testing.
+- Converted the main docs to Markdown and updated development tooling (modern RSpec, gemfiles for supported Rails lines).
+
+
+- Теперь библиотека предназначена для Ruby 3.2, 3.3, 3.4 и 4.0.
+- Поддержка интеграции с Rails 7.2, 8.0 и 8.1.
+- Добавлены RBS-сигнатуры для публичного API.
+- Доступна документация к gem в формате YARD.
+- Обновлены русские locale-файлы, добавлены отсутствующие современные ключи.
+- Денежный десятичный разделитель для русской локали приведен в соответствие с CLDR и стандартным числовым форматом: теперь используется запятая вместо точки.
+- Исправлена `Russian.transliterate`: теперь при токенизации не теряются переводы строк [#57].
+- Исправление контекстного выбора формы названия месяца в `strftime`-форматах с модификаторами ширины и флагами вроде `%-e`, `%3d` и `%_3d`. [#41] [#43] [Алексей Саварцов](https://github.com/asavartsov)
+- Добавлены локализованные версии `strptime`: хелперы `date_strptime`, `time_strptime` и `datetime_strptime`, включая case-insensitive разбор русских названий месяцев и дней недели.
+- Ускорение транслитерации [#42] (основано на идее [Игоря Бочкарева](https://github.com/ujifgc))
+- Ускорение плюрализации.
+- Ускорение работы с datetime-форматами.
+- Файлы локали из поставки теперь добавляются в `I18n.load_path` в детерминированном отсортированном порядке: это убирает зависимость от порядка файловой системы и помогает инструментам вроде `i18n-js`. [#56] [Andrey Novikov](https://github.com/Envek)
+- Исправлены формулировки русских сообщений валидации для сравнений (`greater_than`, `greater_than_or_equal_to`, `less_than`, `less_than_or_equal_to`) на более естественные. [#47] [Валентин Васильев](https://github.com/Valve)
+- CI перенесен на GitHub Actions, тестируются все поддерживаемые версии Ruby и Rails.
+- Основная документация переведена в Markdown, обновлены инструменты разработки (современный RSpec, gemfiles для поддерживаемых версий Rails).
+
+## [0.6.0] "Haters Gonna Hate" - 2011-10-22
+
+- i18n gem is now a dependency (not using vendored gem anymore)
+- I18n::Backend::Advanced custom backend is no longer used. Russian Ruby i18n files are portable for the first time; using Russian language with i18n does not require a custom backend with language-specific hacks anymore. It became possible thanks to lambda translations support in i18n gem (<https://svenfuchs.com/2009/7/12/ruby-i18n-gem-hits-0-2-0>) and inclusion of Pluralization backend. Notice: ff you are using a custom backend, don't forget to include I18n::Backend::Pluralization and I18n::Backend::Transliterator modules
+- Pluralization is now delegated to I18n backend
+- Transliteration is now delegated to I18n backend (using Russian::Transliteration, of course)
+- Minor gem russian version is now bumped to be in sync with minor version of required i18n gem
+- UPGRADING: Rails 2 is no longer supported, use older versions of the gem
+- UPGRADING: gem russian does not force Russian locale anymore, use I18n::locale/default_locale methods or config.i18n.default_locale = :ru in your Rails environment. Methods with forced encoding still can be used as Russian::translate, Russian::localize
+- Locale files and hacks (date helper, custom ActiveModel error message) updated to support Rails 3.0 and 3.1
+- README updated
+- Remove i18n_label plugin (labels i18n is supported in latest Rails releases)
+
+
+- gem i18n теперь является зависимостью для gem russian, а не включается в vendor, как раньше
+- Собственный бекенд I18n::Backend::Advanced больше не используется. Русские файлы локали i18n для Ruby наконец-то стали переносимыми и не требуют собственного бекенда и хаков для поддержки языка. Это стало возможным благодаря поддержке lambda-переводов в i18n (<https://svenfuchs.com/2009/7/12/ruby-i18n-gem-hits-0-2-0>) и включению Pluralization бекенда в gem i18n. Обратите внимание: если вы используете собственный бекенд (отличный от стандартного), не забудьте включить модули I18n::Backend::Pluralization и I18n::Backend::Transliterator
+- Механизм плюрализации теперь обеспечивает стандартный бекенд I18n
+- Механизм транслитерации теперь обеспечивает стандартный бекенд I18n (с помощью Russian::Transliteration, конечно)
+- Минорная версия gem russian повышена до текущей минорной версии i18n
+- UPGRADING: Rails 2 больше не поддерживается, используйте старые версии gem'а
+- UPGRADING: gem russian больше не форсирует использование русской локали, используйте методы I18n::locale/default_locale или config.i18n.default_locale = :ru в настройках окружения Rails. Если нужно форсировать русскую локаль, можно по-прежнему пользоваться методами Russian::translate, Russian::localize
+- Обновлены файлы переводов и хаки (выбор месяца в date helper, кастомные сообщения об ошибках ActiveModel) для поддержки Rails 3.0 и 3.1
+- Обновлен и переписан README
+- Удален плагин i18n_label (перевод label уже поддерживается в последних версиях Rails)
+
+## [0.2.7] - 2010-05-05
+
+- Fix using of standalone/non-standalone month names with %d/%e surroundings.
+
+
+- Улучшено распознавание формы названия месяца с strftime макросами %d/%e.
+
+## [0.2.6] - 2010.03.25
+
+- Minimum Rails 3.0b support: Added fourth parameter (options) defaulting to nil to Advanced backend localize method for compliance with i18n-0.3 [Nikolay V. Nemshilov](https://github.com/MadRabbit)
+
+
+- Минимальная поддержка Rails 3.0b: В метод localize бекенда Advanced добавлен четвертый параметр, для совместимости с i18n-0.3. По умолчанию равен nil. [Николай Немшилов](https://github.com/MadRabbit)
+
+## [0.2.5] - 2009-12-23
+
+- Added support for multi-char substrings in Russian.transliterate [Alex Fortuna](https://github.com/dadooda)
+- Rails 2.3.5 error messages overloading compatibility (error messages overloading) (thanks Alex Eagle for bugreport)
+
+
+- Russian.transliterate: Теперь можно добавлять правила матчинга подстрок из нескольких символов ("Воробьёв", "Алябьев"). [Alex Fortuna](https://github.com/dadooda)
+- Rails 2.3.5: совместимость для перегрузки сообщений об ошибках (багрепорт - Александр Орел)
+
+## [0.2.4] - 2009.11.12
+
+- Revert nested validation errors patch
+
+
+- Убран патч для вложенных сообщений валидации (не работал с Rails 2.3.3 и ниже)
+
+## [0.2.3] - 2009.11.09
+
+- Improve ActiveRecord translations [Dmitri Koulikoff](https://github.com/dima4p)
+- Fix nested validation errors with custom error message hack for Rails < 2.3.4 [valodzka](https://github.com/valodzka)
+- Added almost_x_years datetime translation
+
+
+- Улучшен перевод ActiveRecord [Dmitri Koulikoff](https://github.com/dima4p)
+- Исправлена ошибка, возникающая при вложенных сообщениях валидации при использовании хака для Rails < 2.3.4 [valodzka](https://github.com/valodzka)
+- Добавлен перевод для ключа даты/времени almost_x_years
+
+## [0.2.2 ]- 2009.09.17
+
+- Fix ^-prefixed error messages handling on Rails 2.3.4
+
+
+- Для Rails 2.3.4 исправлена работа сообщений валидаций, начинающихся с "^"
+
+## [0.2.1] - 2009.09.05
+
+- Rails 2.3.4 compat (ActiveRecord::Error) and deprecation warning (use errors.full_messages.format from now on) [Alexander Semyonov](https://github.com/alsemyonov)/Yaroslav Markin
+- Added a couple of missing translations from Rails 2.3.4
+- transliteration: Ы now transforms to Y [Alex Fortuna](https://github.com/dadooda)
+
+
+- Совместимость с Rails 2.3.4 (ActiveRecord::Error) и устаревшее форматирование через "^" (теперь надо использовать errors.full_messages.format) [Alexander Semyonov](https://github.com/alsemyonov)/Yaroslav Markin]
+- Добавлена пара недостающих переводов из Rails 2.3.4
+- транслитерация: Ы теперь превращается в Y [Alex Fortuna](https://github.com/dadooda)
+
+## [0.2.0] - 2009.03.16
+
+- number_to_human_size() translations: using edge format (Rails 2.3)
+- i18n gem updated (0.1.3)
+- Rails 2.3 compat
+
+
+- Перевод для number_to_human_size(): испольуется форматирование из edge (Rails 2.3)
+- Обновлен gem i18n до версии 0.1.3
+- Совместимость с Rails 2.3
+
+## [0.1.3] - 2008.12.27
+
+- Add support.array.words_connector/two_words_connector/last_word_connector (Array#to_sentence) (Rails Edge)
+- Add datetime.prompts translations (Rails Edge)
+
+
+- Добавлены переводы для Array#to_sentence (Rails Edge)
+- Добавлены переводы для datetime.prompts (Rails Edge)
+
+## [0.1.2] - 2008.12.04
+
+Fixed I18n.load_path ordering, translations shipped with russian gem will no longer overwrite your own translations (thanks Dmitrij Smalko for bugreport).
+
+
+Поправлено добавление переводов russian в I18n.load_path, теперь переводы из russian не будут замещать ваши собственные переводы (спасибо Dmitrij Smalko за обнаружение ошибки).
+
+## [0.1.1] - 2008.11.24
+
+Added number.human.storage_units translation key (Rails Edge).
+
+
+Добавлен ключ number.human.storage_units (появился в Rails Edge).
+
+## [0.1.0] - 2008.11.22
+
+No changes, Rails 2.2 released
+
+## [0.0.9] - 2008.11.21
+
+- Updated I18n gem due to locale changes (0.1.1)
+- NB! I18n changed default locale from :'en-US' to :'en', same recommended for other locales by default
+- NB!! Russian locale is now :'ru' NOT :'ru-RU', update your locale files.
+
+
+- I18n gem обновился до 0.1.1 в связи с изменениями в названиях локалей
+- ВНИМАНИЕ: локаль по умолчанию I18n теперь называется не :'en-US' а :'en', такой же способ именования рекомендуется и для других локалей
+- ВНИМАНИЕ! Локаль русского языка теперь называется :'ru' а не :'ru-RU'. Не забудьте обновить ваши файлы переводов.
+
+## [0.0.8] - 2008.11.20
+
+- Introduce transliteration (Russian.translit, Russian.transliterate)
+- Add an ActiveSupport hack for #parameterize
+
+
+- Добавилась поддержка транслитерации (Russian.translit, Russian.transliterate)
+- Добавился хак для #parameterize ActiveSupport (генерация "красивых" URL)
+
+## [0.0.7] - 2008.11.09
+
+- Updated I18n gem
+
+
+- Новая версия gem I18n

data/Gemfile

@@ -1,9 +1,8 @@
-source :rubygems
+# frozen_string_literal: true
 
-gem 'rake'
-gem 'i18n', '>= 0.5.0'
-gem 'rspec', '~> 2.7.0'
+source "https://rubygems.org"
 
-# Rails 3+
-gem 'activesupport', '~> 3.0.0'
+gemspec
+gem "rails", "~> 8.1.0"
 
+eval_gemfile "gemfiles/standard.gemfile"

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2008-2011 Yaroslav Markin
+Copyright (c) 2008 Yaroslav Markin
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -17,4 +17,4 @@ 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.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,327 @@
+# gem russian
+
+**Russian language support for Ruby and Rails**: localization, date and time handling, pluralization, and improved Russian language support in Rails.
+
+
+**Поддержка русского языка для Ruby и Rails**: локализация, работа с датой и временем, плюрализация, локализация, улучшенная поддержка русского языка в Rails.
+
+[![CI](https://github.com/yaroslav/russian/actions/workflows/ci.yml/badge.svg)](https://github.com/yaroslav/russian/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/yard-docs-blue.svg)](https://rubydoc.info/gems/russian)
+
+## Features
+
+- **Russian date and time localization** (`strftime`)
+- **Russian date and time parsing** (`strptime`)
+- Correct Russian **pluralization** (`"1 вещь"`, `"9 вешей"`)
+- **Cyrillic transliteration** (`transliterate`)
+- A simple proxy for the `i18n` gem with the Russian locale enforced
+
+With Ruby on Rails:
+
+- All necessary **Russian localization** through Rails’ built-in mechanisms (`i18n`)
+- **Support for contextual month names in date and time helpers** (`[Март ↓] [2026 ↓]`, but `[01 ↓] [марта ↓] [2026 ↓]`)
+- **Custom validation error messages** without the attribute name at the beginning (`"You need to accept the license agreement"` instead of something like `"License agreement accepted must be present"`)
+- Working Russian **pluralization**
+- Working Russian **transliteration**, which can also be used for `to_param` when building “pretty” URLs (`posts/42-privet-mir`)
+
+
+## Что умеет
+
+- **Русская локализация даты и времени** (`strftime`)
+- **Разбор даты и времени** на русском языке (`strptime`)
+- Корректную **плюрализацию** для русского языка ("1 вещь", "9 вещей")
+- **Транслитерация** кириллицы (`transliterate`)
+- Простой прокси для gem i18n с явным пробросом русской локали
+
+С Ruby on Rails:
+
+- Всю необходимую **локализацию на русский язык** через встроенные в Rails механизмы (gem i18n)
+- **Поддержка контекстных имен месяцев в хелперах** выбора даты и времени (`[Март ↓] [2026 ↓]`, но `[01 ↓] [марта ↓] [2026 ↓]`)
+- **Особые сообщения об ошибках валидации** без явного названия атрибута в начале ("Нужно принять лицензионное соглашение", вместо чего-то вроде "Лицензионное соглашение принято должно присутствовать")
+- Рабочая **плюрализация** для русского языка
+- Рабочая **транслитерация** для русского языка, которая в том числе может использоваться для `to_param` при составлении "красивых" URL (`posts/42-privet-mir`)
+
+## When to use
+
+- Your application is entirely in Russian or another Cyrillic language
+- Your application supports only a small number of languages, and **Russian is one of them or the primary one**
+
+When not to use it:
+
+- Your application targets many languages or uses unusual or complex I18n backends
+
+
+## Когда стоит использовать
+
+- **Приложение целиком на русском** или другом кириллическом языке
+- Приложение поддерживает небольшое количество языков, но **русский — один из них или основной**
+
+Когда не стоит использовать:
+
+- Приложение сделано для большого количества языков или использует нестандартные или сложные бэкенды для I18n.
+
+# Требования
+
+- Современные версии Ruby и Rails. На момент написания — Ruby 3.2+ или 4.0+, Rails 7.2, 8.0, 8.1;
+- Использование с Ruby on Rails не обязательно
+- Используйте более ранние версии для устаревших и неподдерживаемых версий Ruby и Rails
+
+# Установка
+
+Для установки:
+
+Через Bundler:
+
+```sh
+bundle add russian
+bundle install
+```
+
+Чтобы задать русскую локаль по умолчанию в вашем приложении, укажите
+
+```ruby
+I18n.default_locale = :ru
+```
+
+Чтобы установить локаль для текущего Ruby thread, используйте
+
+```ruby
+I18n.locale = :ru
+```
+
+## Ruby on Rails
+
+После установки через Bundler, укажите
+
+```ruby
+config.i18n.default_locale = :ru
+```
+
+в `config/application.rb`. Если по умолчанию нужна другая локаль, или же нужно переключать локали "на ходу", используйте методы модуля I18n. 
+
+Также ознакомьтесь с [гидом по интернационализации Ruby on Rails](https://guides.rubyonrails.org/i18n.html).
+
+# Использование
+
+gem russian можно использовать как с Ruby on Rails, так и отдельно: с любым другим веб-фреймворком, или в любом другом приложении. gem i18n, который Ruby on Rails использует для интернационализации, включен в gem russian как зависимость.
+
+## Примеры и справка по переводам (I18n)
+
+Небольшую справку по переводам (I18n) и пример того, как можно переводить имена моделей, атрибутов, и многие другие вещи, определенные в Rails или I18n, можно посмотреть в директории [lib/russian/locale](https://github.com/yaroslav/russian/tree/master/lib/russian/locale). Там находятся файлы переводов, которые используются в Russian, со всеми комментариями.
+
+## Вспомогательные методы модуля Russian
+
+### `locale`
+
+Возвращает локаль русского языка (`:'ru'`).
+
+```ruby
+Russian.locale
+Russian::LOCALE
+```
+
+### `init_i18n`
+
+Выполняется автоматически при загрузке. Добавление русских переводов в путь загрузки стандартного бэкенда I18n, включение модулей для плюрализации и транслитерации и перегрузка I18n.
+
+```ruby
+Russian::init_i18n
+```
+
+### `translate` / `t`
+
+Прокси для метода `translate` I18n, форсирует использование русской локали.
+
+Поддерживаются и современный вызов с keyword args, и "старый" вызов с positional hash:
+
+```ruby
+Russian.translate(:"date.formats.default")
+Russian.t(:"date.formats.default", scope: :foo)
+Russian.t(:"date.formats.default", {scope: :foo})
+```
+
+### `localize` / `l`
+
+Прокси для метода `localize` I18n, форсирует использование русской локали.
+
+Поддерживаются и современный вызов с keyword args, и старый вызов с positional hash:
+
+```ruby
+Russian.localize(Date.new(1985, 12, 1), format: :long)
+Russian.l(Date.new(1985, 12, 1), {format: :long})
+```
+
+### `strftime`
+
+`strftime` с форсированием русской локали (упрощенный вариант `localize`)
+
+```ruby
+Russian.strftime(Time.new(2008, 9, 1, 11, 12, 43, "+03:00"), format: :long)
+Russian.strftime(Time.new(2008, 9, 1, 11, 12, 43, "+03:00"), {format: :long})
+
+Russian::strftime(Time.new(2008, 9, 1, 11, 12, 43, "+03:00"))
+=> "Пн, 01 сент. 2008, 11:12:43 +0300"
+Russian::strftime(Time.new(2008, 9, 1, 11, 12, 43, "+03:00"), "%d %B")
+=> "01 сентября"
+Russian::strftime(Time.new(2008, 9, 1, 11, 12, 43, "+03:00"), "%B")
+=> "Сентябрь"
+```
+
+### `date_strptime` / `time_strptime` / `datetime_strptime`
+
+Локализованные `strptime`-хелперы для `Date`, `Time` и `DateTime` для разбора даты и времени.
+
+Понимают русские названия месяцев и дней недели, включая case-insensitive ввод.
+`format` у `date_strptime` и `datetime_strptime` можно опустить, а `now`
+у `time_strptime` остается опциональным, как и в `Time.strptime`.
+Все остальные `%`-директивы обрабатываются нативными parser'ами Ruby:
+`Date.strptime`, `Time.strptime` и `DateTime.strptime`.
+
+```ruby
+Russian.date_strptime("01 апреля 2011", "%d %B %Y")
+=> #<Date: 2011-04-01 ...>
+Russian.time_strptime("пт, 01 апр. 2011 23:45:05 +0300", "%a, %d %b %Y %H:%M:%S %z")
+=> 2011-04-01 23:45:05 +0300
+Russian.datetime_strptime("Пятница, 01 апреля 2011 23:45:05 +0300", "%A, %d %B %Y %H:%M:%S %z")
+=> #<DateTime: 2011-04-01T23:45:05+03:00 ...>
+```
+
+### `pluralize` / `p`
+
+Упрощенная плюрализация для русского языка.
+
+```ruby
+Russian.pluralize(1, "вещь", "вещи", "вещей")
+=> "вещь"
+Russian.p(2, "вещь", "вещи", "вещей")
+=> "вещи"
+Russian.p(10, "вещь", "вещи", "вещей")
+=> "вещей"
+Russian.p(3.14, "вещь", "вещи", "вещей", "вещи") # последний вариант используется для дробных величин
+=> "вещи"
+```
+
+### `transliterate` / `translit`
+
+Транслитерация русских букв в строке.
+
+```ruby
+Russian.translit("рубин")
+=> "rubin"
+Russian.transliterate("Hallo Юлику Тарханову")
+=> "Hallo Yuliku Tarhanovu"
+```
+
+## Ruby on Rails
+
+Если gem russian используется внутри Rails, интеграция с Rails подключается автоматически через и применяется сразу же, если нужные части фреймворка уже загружены. Для современных версий Rails это дает два эффекта:
+
+После загрузки можно использовать все стандартные функции библиотеки I18n, пользоваться измененным функционалом для лучшей поддержки русского языка, или использовать хелперы модуля Russian для еще более простой работы с русским языком.
+
+### Переводы
+
+При использовании с Ruby on Rails загружаются все стандартные переводы, и русский язык становится годным к использованию для локализации. В поставку включены все нужные переводы для ActionView, ActiveRecord, ActiveSupport, ActiveModel, которые можно переопределять по необходимости стандартными средствами I18n из вашего приложения.
+
+### Хелперы
+
+Хелперы даты-времени получают ключ `:use_standalone_month_names` для форсирования отображения отдельностоящего названия месяца ("Сентябрь" а не "сентября"). Такое имя месяца используется, когда включен ключ `:use_standalone_month_names`, либо когда есть ключ `:discard_day`. Для русской локали `select_month` всегда использует отдельностоящие имена месяцев.
+
+### Валидация
+
+На тот случай, если по каким-то причинам нельзя воспользоваться ключом `full_messages.format` в таблице переводов, Russian перегружает вывод "полных сообщений" об ошибках в ActiveModel.
+
+Так, например,
+
+```ruby
+validates :accepted_terms, acceptance: {message: "нужно принять соглашение"}
+```
+
+при валидации выдаст сообщение
+
+```text
+Accepted terms нужно принять соглашение
+```
+
+или, например
+
+```text
+Соглашение об использовании нужно принять соглашение
+```
+
+если вы указали перевод для имени атрибута.
+
+Но
+
+```ruby
+validates :accepted_terms, acceptance: {message: "^Нужно принять соглашение"}
+```
+
+даст сообщение
+
+```text
+Нужно принять соглашение
+```
+
+### Параметризация строк
+
+Метод `parameterize` инфлектора ActiveSupport использует механизмы транслитерации I18n. Если русская локаль является текущей, он сможет поддерживать транслитерацию букв русского алфавита.
+
+Пример:
+
+```erb
+class Person
+  def to_param
+    "#{id}-#{name.parameterize}"
+  end
+end
+
+@person = Person.find(1)
+# => #<Person id: 1, name: "Дональд Кнут">
+
+<%= link_to(@person.name, person_path(@person)) %>
+# => <a href="/person/1-donald-knut">Дональд Кнут</a>
+```
+
+# Историческая справка
+
+gem russian проектировалась для полноценной поддержки русского языка (форматирование даты и времени, плюрализация, транслит, локализация в целом) для Ruby и Ruby on Rails. Приоритет: построить полноценную среду для русской локализации Ruby и Rails проектов, при этом используя минимально возможное количество хаков, сохраняя при этом поддержку локализации приложения на другие языки, а также форсировать включение в основную ветку I18n и Rails всех функций локализации, необходимых для работы с русским языком. Вместе с командой gem i18n решено было обкатывать решение для русского языка на отдельном gem/плагине, и по мере возможности переносить наиболее общий функционал в "родительскую" библиотеку i18n. Таким образом, общей целью gem russian стала поддержка русского языка до тех пор, пока она не появится в самом I18n.
+
+Библиотека I18n входит в состав Ruby on Rails начиная с версии 2.2. I18n — это самое простое и недеструктивное решение для локализации и интернационализации Rails приложений. К сожалению, в первых версиях отсутствовала поддержка нескольких важных возможностей, специфичных для русского языка. Таким образом, русский язык для локализации в Rails 2.2 фактически не поддерживался.
+
+Для исправления этого досадного недоразумения появилась библиотека Russian. Ранее Russian включал в себя собственный бекенд для перегрузки форматирования даты-времени (использование названия месяца или дня недели в зависимости от контекста) и плюрализации (стандартный бекенд поддерживал только плюрализацию для английского языка), несколько хаков для Rails 2.2/2.3 (ActionView, ActiveRecord, ActiveSupport), полную локализацию даты-времени и таблицы переводов Rails на русский язык, и вспомогательные модули (плюрализация и транслитерация). 
+
+В версии 0.2 `gem i18n` наконец появились первые средства для поддержки русского языка: во многом, из-за gem russian была добавлена поддержка lambda-переводов, благодаря которой стало возможным вынести логику перевода названия месяца/дня недели в таблицу переводов. Далее в `gem i18n` появилась поддержка хранения правил плюрализации в таблице переводов (опять же, с помощью lambda-переводов) и правил транслитерации. 
+
+**Сейчас использование gem russian для русскоязычных приложений — скорее комфорт, а не абсолютная необходимость.** Некоторые из возможностей gem russian никогда не появятся в Rails из коробки.
+
+# Разработка и тестирование
+
+Для локального запуска:
+
+Тесты:
+
+```sh
+bundle exec rspec
+```
+
+Линтер:
+
+```sh
+bundle exec standardrb
+```
+
+Rails-интеграцию можно проверять отдельно по gemfile для нужной версии Rails:
+
+```sh
+BUNDLE_GEMFILE=gemfiles/rails_7_2.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/rails_8_0.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/rails_8_1.gemfile bundle exec rspec
+```
+
+# Авторы и благодарности
+
+[Ярослав Маркин](http://yaroslav.io) при участии: [Юлика Тарханова](https://blog.julik.nl), Евгения Пименова, [Дмитрия Смалько](https://github.com/dsmalko), [Алексея Фортуны](https://github.com/dadooda), [Антона Агеева](https://github.com/antage), [Александра Семенова](https://github.com/alsemyonov), [valodzka](https://github.com/valodzka), [Николая Немшилова](https://github.com/MadRabbit), [Дмитрия Куликова](https://github.com/dima4p), [Алексея Саварцова](https://github.com/asavartsov), [Андрея Новикова](https://github.com/Envek), [Игоря Бочкарева](https://github.com/ujifgc), [Валентина Васильева](https://github.com/Valve).
+
+Огромное спасибо:
+
+[Юлику Тарханову](http://julik.nl) за [rutils](https://github.com/julik/rutils).

data/Rakefile

@@ -1,10 +1,17 @@
-require 'rubygems'
-require 'rspec/core/rake_task'
-require 'rubygems/specification'
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "standard/rake"
+require "yard"
 
-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
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Build YARD documentation"
+YARD::Rake::YardocTask.new(:yard)
+
+desc "Run lint and specs"
+task ci: %i[standard spec]
+
+task default: %i[standard spec]