num2words 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa5b9caee063d530f67b6c582ec33a27e3af6e8d5128d5fdcabbe0203156f4e9
-  data.tar.gz: 76a4d77f82d271c7139e34ffa54fb8e9c79841a0027ae5d14997941e50b27031
+  metadata.gz: 83b33cb28c58663786a3033b2aefceb7e0478d49d40b1db5b1bee5bc63f0198b
+  data.tar.gz: 5293c916f1a5ad2726662cb5973033b23fa5f9b703920b2b4be21f293d47d67e
 SHA512:
-  metadata.gz: b890bbf4084a1390703166991d3a518ef6576c28cc950b096d4f9f8155d6bd2ea9f85df031673d8ed1e38f1764d42ee3af62dce895d15d91ca71642032f2489d
-  data.tar.gz: 6492214777cf0cfecbbf4d4d7518d2bc1ebebfbab93906165e7d764a2afc710e11b246bf1c490b40f450f295376661a35b9132bfedf862eb26c382d5a628f7f1
+  metadata.gz: c498c97a62099658e43c6d29159b9c6fc5c8d3113e19fdc0fe774966dbacce7084d8e0e5293e1a9b1b9cad5b0441af1ae35efe1922441a19196fd49f0d771756
+  data.tar.gz: 53ceaa5a779dd1e7c3e8308d4f21dcafe2a3cde1a775ddb68fb7497be605d551497ee22350c3309feb4f21c648ff9546761c427ff5839ae43e0c01f073febc08

data/CHANGELOG.md

@@ -0,0 +1,71 @@
+# Changelog
+
+Все заметные изменения в этом проекте будут документироваться в этом файле.
+
+Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),  
+и этот проект использует [Semantic Versioning](https://semver.org/lang/ru/).
+
+---
+
+## [Unreleased]
+
+- Добавление новых локалей (планируется расширение поддерживаемых языков).
+- Оптимизация производительности при больших числах.
+- Улучшения документации.
+
+---
+
+## [0.1.3] – 2025-08-20
+### Added
+- Параметр **`word_case:`** для методов `to_words`, `to_currency` со значениями:
+    - `:upper`, `:capitalize`, `:title`, `:downcase`.
+- В английской локали:
+    - Поддержка опции **`style: :decimal`**, которая выводит дробную часть через `point` по-цифровому (например: `"twelve point one two"`).
+    - Улучшена поддержка стиля **`:fraction`** — дроби преобразуются в слова с корректными окончаниями (`"tenths"`, `"hundredths"` и т.д.).
+- Улучшена читаемость кода:
+    - Унифицированные имена переменных (`major_value`, `minor_value`).
+    - Вынес функционал `apply_case` для управления регистром.
+
+###  Examples after 0.1.3
+
+```ruby
+10.1.to_words(locale: :ru, word_case: :capitalize)
+# => "Десять целых одна десятая"
+
+5.5.to_words(locale: :en, style: :fraction) # По умолчанию: style = fraction
+# => "five and five tenths"
+
+123.01.to_words(:en, style: :decimal, word_case: :upper)
+# => "ONE HUNDRED TWENTY THREE POINT ZERO ONE" 
+
+99.99.to_currency(locale: :ru, word_case: :upper)
+# => "ДЕВЯНОСТО ДЕВЯТЬ РУБЛЕЙ ДЕВЯНОСТО ДЕВЯТЬ КОПЕЕК"
+
+42.to_words(locale: :en, word_case: :title)
+# => "Forty Two"
+
+76.03.to_words(word_case: :downcase) # По умолчанию: word_case = downcase
+"семьдесят шесть целых три сотые"
+```
+
+## [0.1.2] - 2025-08-19
+### Fixed
+- Исправлена ошибка с локалью `no` → заменена на корректную `nb` (Norwegian Bokmål).
+
+---
+
+## [0.1.1] - 2025-08-18
+### Added
+- Добавлены переводы для новых языков (Swahili, Punjabi и др.).
+- В README.md добавлена Markdown-таблица языков с ISO-кодами и валютами.
+
+### Fixed
+- Исправлены ошибки в конфигурации валют для некоторых локалей.
+
+---
+
+## [0.1.0] - 2025-08-17
+### Added
+- Первая публичная версия гема `num2words`.
+- Поддержка перевода чисел в слова для нескольких языков.
+- Поддержка валют (RUB, USD, EUR и др.).

data/README.md

@@ -1,4 +1,4 @@
-# num2words
+# num2words [![Gem Version](https://badge.fury.io/rb/num2words.svg)](https://badge.fury.io/rb/num2words)
 
 📦 **num2words** — Ruby-гем для преобразования чисел в строковое представление (прописью).
 

data/config/locales/en.yml

@@ -24,3 +24,18 @@ en:
         fractional:
           name: ["cent", "cents", "cents"]
           feminine: false
+
+    grammar:
+      minus: "minus"
+      conjunction: "and"
+      default_fraction: "parts"
+    fractions:
+      10: ["tenth", "tenths", "tenths"]
+      100: ["hundredth", "hundredths", "hundredths"]
+      1000: ["thousandth", "thousandths", "thousandths"]
+      10000: ["ten-thousandth", "ten-thousandths", "ten-thousandths"]
+      100000: ["hundred-thousandth", "hundred-thousandths", "hundred-thousandths"]
+      1000000: ["millionth", "millionths", "millionths"]
+      10000000: ["ten-millionth", "ten-millionths", "ten-millionths"]
+      100000000: ["hundred-millionth", "hundred-millionths", "hundred-millionths"]
+      1000000000: ["billionth", "billionths", "billionths"]

data/config/locales/ru.yml

@@ -19,3 +19,18 @@ ru:
         fractional:
           name: ["копейка", "копейки", "копеек"]
           feminine: true
+
+    grammar:
+      minus: "минус"
+      conjunction: "целых"
+      default_fraction: "дробных"
+    fractions:
+      10: ["десятая", "десятые", "десятых"]
+      100: ["сотая", "сотые", "сотых"]
+      1000: ["тысячная", "тысячные", "тысячных"]
+      10000: ["десятитысячная", "десятитысячные", "десятитысячных"]
+      100000: ["стотысячная", "стотысячные", "стотысячных"]
+      1000000: ["миллионная", "миллионные", "миллионных"]
+      10000000: ["десятимиллионная", "десятимиллионные", "десятимиллионных"]
+      100000000: ["стомиллионная", "стомиллионные", "стомиллионных"]
+      1000000000: ["миллиардная", "миллиардные", "миллиардных"]

data/lib/num2words/converter.rb

@@ -3,57 +3,50 @@
 module Num2words
   class Converter
     class << self
-      # number — целое число (0..10^12-1)
       def to_words(number, *args, **opts)
-        locale = args.first.is_a?(Symbol) ? args.first : opts[:locale] || :ru
-        feminine = opts.delete(:feminine) || false
-
+        locale    = args.first.is_a?(Symbol) ? args.first : opts[:locale] || I18n.default_locale
+        feminine  = opts[:feminine] || false
+        style     = opts[:style] || :fraction
+        word_case = opts[:word_case] || :downcase
         locale_data = Locales[locale]
 
-        number = Integer(number)
-        return (feminine ? locale_data::ONES_FEM[0] : locale_data::ONES_MASC[0]) if number.zero?
-
-        groups = number.to_s
-                       .chars.reverse.each_slice(3).map(&:reverse)
-                       .map(&:join).map!(&:to_i).reverse
+        result = if number.is_a?(Float)
+                   to_words_fractional(number, locale, feminine, locale_data, style: style)
+                 else
+                   to_words_integer(number, locale, feminine, locale_data)
+                 end
 
-        words = []
-        groups.each_with_index do |grp, idx|
-          scale_idx = groups.size - idx - 1
-          fem = (scale_idx == 1) || feminine # тысячи — жен. род
-          words.concat triple_to_words(grp, scale_idx, locale_data, feminine: fem)
-        end
-        words.join(" ")
+        apply_case(result, word_case)
       end
 
-      # amount может быть String, Integer, Float, BigDecimal
       def to_currency(amount, *args, **opts)
-        locale = args.first.is_a?(Symbol) ? args.first : opts[:locale] || :ru
+        locale      = args.first.is_a?(Symbol) ? args.first : opts[:locale] || I18n.default_locale
+        word_case   = opts[:word_case] || :downcase
         locale_data = Locales[locale]
 
-        str = amount.to_s
-        rub_str, kop_str = str.split(".")
-        rub = Integer(rub_str)
-        # всегда 2 знака для копеек; обрезаем лишние, дополняем недостающие
-        kop = (kop_str || "0")[0, 2].ljust(2, "0").to_i
+        major_str, minor_str = sprintf('%.2f', amount).split('.')
+        major_value = major_str.to_i
+        minor_value = minor_str.to_i
 
-        rub_words = to_words(rub, locale: locale)
-        rub_name  = pluralize(rub, *locale_data::RUB)
+        major_words = to_words(major_value, locale: locale)
+        major_name  = pluralize(major_value, *locale_data::MAJOR_UNIT)
 
-        kop_words = to_words(kop, locale: locale, feminine: true)
-        kop_name  = pluralize(kop, *locale_data::KOP)
+        minor_words = to_words(minor_value, locale: locale, feminine: true)
+        minor_name  = pluralize(minor_value, *locale_data::MINOR_UNIT)
 
-        "#{rub_words} #{rub_name} #{kop_words} #{kop_name}"
+        result = [major_words, major_name, minor_words, minor_name].join(" ")
+        apply_case(result, word_case)
       end
 
       private
 
-      def pluralize(n, one, few, many)
-        return many if (11..14).include?(n % 100)
-        case n % 10
-        when 1 then one
+      def pluralize(number, singular, few, plural)
+        return plural if (11..14).include?(number % 100)
+
+        case number % 10
+        when 1 then singular
         when 2..4 then few
-        else many
+        else plural
         end
       end
 
@@ -77,6 +70,68 @@ module Num2words
         words << pluralize(n, *local_data::SCALES[scale_idx]) unless scale_idx.zero?
         words.compact
       end
+
+      def to_words_fractional(number, locale, feminine, locale_data, style: :fraction)
+        minus_word       = locale_data::GRAMMAR[:minus] || "minus"
+        conjunction_word = locale_data::GRAMMAR[:conjunction] || "and"
+        default_fraction = locale_data::GRAMMAR[:default_fraction] || "parts"
+        fractions_data   = locale_data::FRACTIONS || {}
+
+        sign_word = number.negative? ? minus_word : ""
+
+        integer_string, fraction_string = number.abs.to_s.split('.', 2)
+        integer_value = integer_string.to_i
+
+        return to_words_integer(integer_value, locale, feminine, locale_data) if fraction_string.to_i.zero?
+
+        fraction_string = fraction_string.sub(/0+\z/, "")
+        numerator   = fraction_string.to_i
+        denominator = 10 ** fraction_string.length
+
+        integer_words = to_words_integer(integer_value, locale, feminine, locale_data)
+
+        if locale.to_sym == :en && style == :decimal
+          fraction_digits = fraction_string.chars.map { |d| to_words_integer(d.to_i, locale, feminine, locale_data) }
+          full_string = [sign_word, integer_words, "point", fraction_digits.join(" ")].reject(&:empty?).join(" ")
+          return full_string
+        end
+
+        numerator_words = to_words_integer(numerator, locale, (locale.to_sym == :ru ? true : feminine), locale_data)
+
+        denom_forms = fractions_data[denominator] || fractions_data[denominator.to_s] # массив склонений
+        denominator_words = denom_forms.is_a?(Array) ? pluralize(numerator, *denom_forms) : default_fraction
+
+        [sign_word, integer_words, conjunction_word, numerator_words, denominator_words].reject(&:empty?).join(" ")
+      end
+
+      def to_words_integer(number, locale, feminine, locale_data)
+        integer_value = Integer(number)
+
+        return (feminine ? locale_data::ONES_FEM[0] : locale_data::ONES_MASC[0]) if integer_value.zero?
+
+        groups = integer_value.to_s
+                              .chars.reverse.each_slice(3).map(&:reverse)
+                              .map(&:join).map!(&:to_i).reverse
+
+        words = []
+        groups.each_with_index do |group_value, index|
+          scale_index = groups.size - index - 1
+          group_feminine = (scale_index == 1) || feminine
+          words.concat triple_to_words(group_value, scale_index, locale_data, feminine: group_feminine)
+        end
+
+        words.join(" ")
+      end
+
+      def apply_case(text, word_case)
+        case word_case
+        when :upper then text.upcase
+        when :capitalize then text.capitalize
+        when :title then text.split.map(&:capitalize).join(" ")
+        when :downcase then text.downcase
+        else text
+        end
+      end
     end
   end
 end

data/lib/num2words/core_ext.rb

@@ -11,6 +11,10 @@ class Integer
 end
 
 class Float
+  def to_words(*args, **opts)
+    Num2words::Converter.to_words(self, *args, **opts)
+  end
+
   def to_currency(*args, **opts)
     Num2words::Converter.to_currency(self, *args, **opts)
   end

data/lib/num2words/locales/ar.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ar)
       SCALES = I18n.t("num2words.scales", locale: :ar)
 
-      RUB = I18n.t("num2words.currencies.SAR.name", locale: :ar)
-      KOP = I18n.t("num2words.currencies.SAR.fractional.name", locale: :ar)
+      MAJOR_UNIT = I18n.t("num2words.currencies.SAR.name", locale: :ar)
+      MINOR_UNIT = I18n.t("num2words.currencies.SAR.fractional.name", locale: :ar)
     end
 
     register :ar, AR

data/lib/num2words/locales/be.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :be)
       SCALES = I18n.t("num2words.scales", locale: :be)
 
-      RUB = I18n.t("num2words.currencies.BYN.name", locale: :be)
-      KOP = I18n.t("num2words.currencies.BYN.fractional.name", locale: :be)
+      MAJOR_UNIT = I18n.t("num2words.currencies.BYN.name", locale: :be)
+      MINOR_UNIT = I18n.t("num2words.currencies.BYN.fractional.name", locale: :be)
     end
 
     register :be, BE

data/lib/num2words/locales/bg.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :bg)
       SCALES = I18n.t("num2words.scales", locale: :bg)
 
-      RUB = I18n.t("num2words.currencies.BGN.name", locale: :bg)
-      KOP = I18n.t("num2words.currencies.BGN.fractional.name", locale: :bg)
+      MAJOR_UNIT = I18n.t("num2words.currencies.BGN.name", locale: :bg)
+      MINOR_UNIT = I18n.t("num2words.currencies.BGN.fractional.name", locale: :bg)
     end
 
     register :bg, BG

data/lib/num2words/locales/bn.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :bn)
       SCALES = I18n.t("num2words.scales", locale: :bn)
 
-      RUB = I18n.t("num2words.currencies.BDT.name", locale: :bn)
-      KOP = I18n.t("num2words.currencies.BDT.fractional.name", locale: :bn)
+      MAJOR_UNIT = I18n.t("num2words.currencies.BDT.name", locale: :bn)
+      MINOR_UNIT = I18n.t("num2words.currencies.BDT.fractional.name", locale: :bn)
     end
 
     register :bn, BN

data/lib/num2words/locales/cs.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :cs)
       SCALES = I18n.t("num2words.scales", locale: :cs)
 
-      RUB = I18n.t("num2words.currencies.CZK.name", locale: :cs)
-      KOP = I18n.t("num2words.currencies.CZK.fractional.name", locale: :cs)
+      MAJOR_UNIT = I18n.t("num2words.currencies.CZK.name", locale: :cs)
+      MINOR_UNIT = I18n.t("num2words.currencies.CZK.fractional.name", locale: :cs)
     end
 
     register :cs, CS

data/lib/num2words/locales/da.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :da)
       SCALES = I18n.t("num2words.scales", locale: :da)
 
-      RUB = I18n.t("num2words.currencies.DKK.name", locale: :da)
-      KOP = I18n.t("num2words.currencies.DKK.fractional.name", locale: :da)
+      MAJOR_UNIT = I18n.t("num2words.currencies.DKK.name", locale: :da)
+      MINOR_UNIT = I18n.t("num2words.currencies.DKK.fractional.name", locale: :da)
     end
 
     register :da, DA

data/lib/num2words/locales/de.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :de)
       SCALES = I18n.t("num2words.scales", locale: :de)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :de)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :de)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :de)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :de)
     end
 
     register :de, DE

data/lib/num2words/locales/el.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :el)
       SCALES = I18n.t("num2words.scales", locale: :el)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :el)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :el)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :el)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :el)
     end
 
     register :el, EL

data/lib/num2words/locales/en.rb

@@ -10,8 +10,11 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :en)
       SCALES = I18n.t("num2words.scales", locale: :en)
 
-      RUB = I18n.t("num2words.currencies.USD.name", locale: :en)
-      KOP = I18n.t("num2words.currencies.USD.fractional.name", locale: :en)
+      MAJOR_UNIT = I18n.t("num2words.currencies.USD.name", locale: :en)
+      MINOR_UNIT = I18n.t("num2words.currencies.USD.fractional.name", locale: :en)
+
+      FRACTIONS = I18n.t("num2words.fractions", locale: :en)
+      GRAMMAR = I18n.t("num2words.grammar", locale: :en)
     end
 
     register :en, EN

data/lib/num2words/locales/es.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :es)
       SCALES = I18n.t("num2words.scales", locale: :es)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :es)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :es)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :es)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :es)
     end
 
     register :es, ES

data/lib/num2words/locales/et.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :et)
       SCALES = I18n.t("num2words.scales", locale: :et)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :et)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :et)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :et)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :et)
     end
 
     register :et, ET

data/lib/num2words/locales/fa.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :fa)
       SCALES = I18n.t("num2words.scales", locale: :fa)
 
-      RUB = I18n.t("num2words.currencies.IRR.name", locale: :fa)
-      KOP = I18n.t("num2words.currencies.IRR.fractional.name", locale: :fa)
+      MAJOR_UNIT = I18n.t("num2words.currencies.IRR.name", locale: :fa)
+      MINOR_UNIT = I18n.t("num2words.currencies.IRR.fractional.name", locale: :fa)
     end
 
     register :fa, FA

data/lib/num2words/locales/fi.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :fi)
       SCALES = I18n.t("num2words.scales", locale: :fi)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :fi)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :fi)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :fi)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :fi)
     end
 
     register :fi, FI

data/lib/num2words/locales/fr.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :fr)
       SCALES = I18n.t("num2words.scales", locale: :fr)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :fr)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :fr)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :fr)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :fr)
     end
 
     register :fr, FR

data/lib/num2words/locales/gu.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :gu)
       SCALES = I18n.t("num2words.scales", locale: :gu)
 
-      RUB = I18n.t("num2words.currencies.INR.name", locale: :gu)
-      KOP = I18n.t("num2words.currencies.INR.fractional.name", locale: :gu)
+      MAJOR_UNIT = I18n.t("num2words.currencies.INR.name", locale: :gu)
+      MINOR_UNIT = I18n.t("num2words.currencies.INR.fractional.name", locale: :gu)
     end
 
     register :gu, GU

data/lib/num2words/locales/he.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :he)
       SCALES = I18n.t("num2words.scales", locale: :he)
 
-      RUB = I18n.t("num2words.currencies.ILS.name", locale: :he)
-      KOP = I18n.t("num2words.currencies.ILS.fractional.name", locale: :he)
+      MAJOR_UNIT = I18n.t("num2words.currencies.ILS.name", locale: :he)
+      MINOR_UNIT = I18n.t("num2words.currencies.ILS.fractional.name", locale: :he)
     end
 
     register :he, HE

data/lib/num2words/locales/hi.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :hi)
       SCALES = I18n.t("num2words.scales", locale: :hi)
 
-      RUB = I18n.t("num2words.currencies.INR.name", locale: :hi)
-      KOP = I18n.t("num2words.currencies.INR.fractional.name", locale: :hi)
+      MAJOR_UNIT = I18n.t("num2words.currencies.INR.name", locale: :hi)
+      MINOR_UNIT = I18n.t("num2words.currencies.INR.fractional.name", locale: :hi)
     end
 
     register :hi, HI

data/lib/num2words/locales/hr.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :hr)
       SCALES = I18n.t("num2words.scales", locale: :hr)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :hr)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :hr)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :hr)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :hr)
     end
 
     register :hr, HR

data/lib/num2words/locales/hu.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :hu)
       SCALES = I18n.t("num2words.scales", locale: :hu)
 
-      RUB = I18n.t("num2words.currencies.HUF.name", locale: :hu)
-      KOP = I18n.t("num2words.currencies.HUF.fractional.name", locale: :hu)
+      MAJOR_UNIT = I18n.t("num2words.currencies.HUF.name", locale: :hu)
+      MINOR_UNIT = I18n.t("num2words.currencies.HUF.fractional.name", locale: :hu)
     end
 
     register :hu, HU

data/lib/num2words/locales/id.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :id)
       SCALES = I18n.t("num2words.scales", locale: :id)
 
-      RUB = I18n.t("num2words.currencies.IDR.name", locale: :id)
-      KOP = I18n.t("num2words.currencies.IDR.fractional.name", locale: :id)
+      MAJOR_UNIT = I18n.t("num2words.currencies.IDR.name", locale: :id)
+      MINOR_UNIT = I18n.t("num2words.currencies.IDR.fractional.name", locale: :id)
     end
 
     register :id, ID

data/lib/num2words/locales/it.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :it)
       SCALES = I18n.t("num2words.scales", locale: :it)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :it)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :it)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :it)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :it)
     end
 
     register :it, IT

data/lib/num2words/locales/ja.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ja)
       SCALES = I18n.t("num2words.scales", locale: :ja)
 
-      RUB = I18n.t("num2words.currencies.JPY.name", locale: :ja)
-      KOP = I18n.t("num2words.currencies.JPY.fractional.name", locale: :ja)
+      MAJOR_UNIT = I18n.t("num2words.currencies.JPY.name", locale: :ja)
+      MINOR_UNIT = I18n.t("num2words.currencies.JPY.fractional.name", locale: :ja)
     end
 
     register :ja, JA

data/lib/num2words/locales/kn.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :kn)
       SCALES = I18n.t("num2words.scales", locale: :kn)
 
-      RUB = I18n.t("num2words.currencies.INR.name", locale: :kn)
-      KOP = I18n.t("num2words.currencies.INR.fractional.name", locale: :kn)
+      MAJOR_UNIT = I18n.t("num2words.currencies.INR.name", locale: :kn)
+      MINOR_UNIT = I18n.t("num2words.currencies.INR.fractional.name", locale: :kn)
     end
 
     register :kn, KN

data/lib/num2words/locales/ko.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ko)
       SCALES = I18n.t("num2words.scales", locale: :ko)
 
-      RUB = I18n.t("num2words.currencies.KRW.name", locale: :ko)
-      KOP = I18n.t("num2words.currencies.KRW.fractional.name", locale: :ko)
+      MAJOR_UNIT = I18n.t("num2words.currencies.KRW.name", locale: :ko)
+      MINOR_UNIT = I18n.t("num2words.currencies.KRW.fractional.name", locale: :ko)
     end
 
     register :ko, KO

data/lib/num2words/locales/kz.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :kz)
       SCALES = I18n.t("num2words.scales", locale: :kz)
 
-      RUB = I18n.t("num2words.currencies.KZT.name", locale: :kz)
-      KOP = I18n.t("num2words.currencies.KZT.fractional.name", locale: :kz)
+      MAJOR_UNIT = I18n.t("num2words.currencies.KZT.name", locale: :kz)
+      MINOR_UNIT = I18n.t("num2words.currencies.KZT.fractional.name", locale: :kz)
     end
 
     register :kz, KZ

data/lib/num2words/locales/lt.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :lt)
       SCALES = I18n.t("num2words.scales", locale: :lt)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :lt)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :lt)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :lt)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :lt)
     end
 
     register :lt, LT

data/lib/num2words/locales/lv.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :lv)
       SCALES = I18n.t("num2words.scales", locale: :lv)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :lv)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :lv)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :lv)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :lv)
     end
 
     register :lv, LV

data/lib/num2words/locales/ml.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ml)
       SCALES = I18n.t("num2words.scales", locale: :ml)
 
-      RUB = I18n.t("num2words.currencies.INR.name", locale: :ml)
-      KOP = I18n.t("num2words.currencies.INR.fractional.name", locale: :ml)
+      MAJOR_UNIT = I18n.t("num2words.currencies.INR.name", locale: :ml)
+      MINOR_UNIT = I18n.t("num2words.currencies.INR.fractional.name", locale: :ml)
     end
 
     register :ml, ML

data/lib/num2words/locales/mr.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :mr)
       SCALES = I18n.t("num2words.scales", locale: :mr)
 
-      RUB = I18n.t("num2words.currencies.INR.name", locale: :mr)
-      KOP = I18n.t("num2words.currencies.INR.fractional.name", locale: :mr)
+      MAJOR_UNIT = I18n.t("num2words.currencies.INR.name", locale: :mr)
+      MINOR_UNIT = I18n.t("num2words.currencies.INR.fractional.name", locale: :mr)
     end
 
     register :mr, MR

data/lib/num2words/locales/ms.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ms)
       SCALES = I18n.t("num2words.scales", locale: :ms)
 
-      RUB = I18n.t("num2words.currencies.MYR.name", locale: :ms)
-      KOP = I18n.t("num2words.currencies.MYR.fractional.name", locale: :ms)
+      MAJOR_UNIT = I18n.t("num2words.currencies.MYR.name", locale: :ms)
+      MINOR_UNIT = I18n.t("num2words.currencies.MYR.fractional.name", locale: :ms)
     end
 
     register :ms, MS

data/lib/num2words/locales/nl.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :nl)
       SCALES = I18n.t("num2words.scales", locale: :nl)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :nl)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :nl)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :nl)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :nl)
     end
 
     register :nl, NL

data/lib/num2words/locales/no.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :nb)
       SCALES = I18n.t("num2words.scales", locale: :nb)
 
-      RUB = I18n.t("num2words.currencies.NOK.name", locale: :nb)
-      KOP = I18n.t("num2words.currencies.NOK.fractional.name", locale: :nb)
+      MAJOR_UNIT = I18n.t("num2words.currencies.NOK.name", locale: :nb)
+      MINOR_UNIT = I18n.t("num2words.currencies.NOK.fractional.name", locale: :nb)
     end
 
     register :nb, NB

data/lib/num2words/locales/pa.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :pa)
       SCALES = I18n.t("num2words.scales", locale: :pa)
 
-      RUB = I18n.t("num2words.currencies.INR.name", locale: :pa)
-      KOP = I18n.t("num2words.currencies.INR.fractional.name", locale: :pa)
+      MAJOR_UNIT = I18n.t("num2words.currencies.INR.name", locale: :pa)
+      MINOR_UNIT = I18n.t("num2words.currencies.INR.fractional.name", locale: :pa)
     end
 
     register :pa, PA

data/lib/num2words/locales/pl.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :pl)
       SCALES = I18n.t("num2words.scales", locale: :pl)
 
-      RUB = I18n.t("num2words.currencies.PLN.name", locale: :pl)
-      KOP = I18n.t("num2words.currencies.PLN.fractional.name", locale: :pl)
+      MAJOR_UNIT = I18n.t("num2words.currencies.PLN.name", locale: :pl)
+      MINOR_UNIT = I18n.t("num2words.currencies.PLN.fractional.name", locale: :pl)
     end
 
     register :pl, PL

data/lib/num2words/locales/pt.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :pt)
       SCALES = I18n.t("num2words.scales", locale: :pt)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :pt)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :pt)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :pt)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :pt)
     end
 
     register :pt, PT

data/lib/num2words/locales/ro.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ro)
       SCALES = I18n.t("num2words.scales", locale: :ro)
 
-      RUB = I18n.t("num2words.currencies.RON.name", locale: :ro)
-      KOP = I18n.t("num2words.currencies.RON.fractional.name", locale: :ro)
+      MAJOR_UNIT = I18n.t("num2words.currencies.RON.name", locale: :ro)
+      MINOR_UNIT = I18n.t("num2words.currencies.RON.fractional.name", locale: :ro)
     end
 
     register :ro, RO

data/lib/num2words/locales/ru.rb

@@ -10,8 +10,11 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ru)
       SCALES = I18n.t("num2words.scales", locale: :ru)
 
-      RUB = I18n.t("num2words.currencies.RUB.name", locale: :ru)
-      KOP = I18n.t("num2words.currencies.RUB.fractional.name", locale: :ru)
+      MAJOR_UNIT = I18n.t("num2words.currencies.RUB.name", locale: :ru)
+      MINOR_UNIT = I18n.t("num2words.currencies.RUB.fractional.name", locale: :ru)
+
+      FRACTIONS = I18n.t("num2words.fractions", locale: :ru)
+      GRAMMAR = I18n.t("num2words.grammar", locale: :ru)
     end
 
     register :ru, RU

data/lib/num2words/locales/sk.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :sk)
       SCALES = I18n.t("num2words.scales", locale: :sk)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :sk)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :sk)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :sk)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :sk)
     end
 
     register :sk, SK

data/lib/num2words/locales/sl.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :sl)
       SCALES = I18n.t("num2words.scales", locale: :sl)
 
-      RUB = I18n.t("num2words.currencies.EUR.name", locale: :sl)
-      KOP = I18n.t("num2words.currencies.EUR.fractional.name", locale: :sl)
+      MAJOR_UNIT = I18n.t("num2words.currencies.EUR.name", locale: :sl)
+      MINOR_UNIT = I18n.t("num2words.currencies.EUR.fractional.name", locale: :sl)
     end
 
     register :sl, SL

data/lib/num2words/locales/sr.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :sr)
       SCALES = I18n.t("num2words.scales", locale: :sr)
 
-      RUB = I18n.t("num2words.currencies.RSD.name", locale: :sr)
-      KOP = I18n.t("num2words.currencies.RSD.fractional.name", locale: :sr)
+      MAJOR_UNIT = I18n.t("num2words.currencies.RSD.name", locale: :sr)
+      MINOR_UNIT = I18n.t("num2words.currencies.RSD.fractional.name", locale: :sr)
     end
 
     register :sr, Sr

data/lib/num2words/locales/sv.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :sv)
       SCALES = I18n.t("num2words.scales", locale: :sv)
 
-      RUB = I18n.t("num2words.currencies.SEK.name", locale: :sv)
-      KOP = I18n.t("num2words.currencies.SEK.fractional.name", locale: :sv)
+      MAJOR_UNIT = I18n.t("num2words.currencies.SEK.name", locale: :sv)
+      MINOR_UNIT = I18n.t("num2words.currencies.SEK.fractional.name", locale: :sv)
     end
 
     register :sv, SV

data/lib/num2words/locales/sw.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :sw)
       SCALES = I18n.t("num2words.scales", locale: :sw)
 
-      RUB = I18n.t("num2words.currencies.KES.name", locale: :sw)
-      KOP = I18n.t("num2words.currencies.KES.fractional.name", locale: :sw)
+      MAJOR_UNIT = I18n.t("num2words.currencies.KES.name", locale: :sw)
+      MINOR_UNIT = I18n.t("num2words.currencies.KES.fractional.name", locale: :sw)
     end
 
     register :sw, SW

data/lib/num2words/locales/ta.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ta)
       SCALES = I18n.t("num2words.scales", locale: :ta)
 
-      RUB = I18n.t("num2words.currencies.INR.name", locale: :ta)
-      KOP = I18n.t("num2words.currencies.INR.fractional.name", locale: :ta)
+      MAJOR_UNIT = I18n.t("num2words.currencies.INR.name", locale: :ta)
+      MINOR_UNIT = I18n.t("num2words.currencies.INR.fractional.name", locale: :ta)
     end
 
     register :ta, TA

data/lib/num2words/locales/te.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :te)
       SCALES = I18n.t("num2words.scales", locale: :te)
 
-      RUB = I18n.t("num2words.currencies.INR.name", locale: :te)
-      KOP = I18n.t("num2words.currencies.INR.fractional.name", locale: :te)
+      MAJOR_UNIT = I18n.t("num2words.currencies.INR.name", locale: :te)
+      MINOR_UNIT = I18n.t("num2words.currencies.INR.fractional.name", locale: :te)
     end
 
     register :te, TE

data/lib/num2words/locales/th.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :th)
       SCALES = I18n.t("num2words.scales", locale: :th)
 
-      RUB = I18n.t("num2words.currencies.THB.name", locale: :th)
-      KOP = I18n.t("num2words.currencies.THB.fractional.name", locale: :th)
+      MAJOR_UNIT = I18n.t("num2words.currencies.THB.name", locale: :th)
+      MINOR_UNIT = I18n.t("num2words.currencies.THB.fractional.name", locale: :th)
     end
 
     register :th, TH

data/lib/num2words/locales/tr.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :tr)
       SCALES = I18n.t("num2words.scales", locale: :tr)
 
-      RUB = I18n.t("num2words.currencies.TRY.name", locale: :tr)
-      KOP = I18n.t("num2words.currencies.TRY.fractional.name", locale: :tr)
+      MAJOR_UNIT = I18n.t("num2words.currencies.TRY.name", locale: :tr)
+      MINOR_UNIT = I18n.t("num2words.currencies.TRY.fractional.name", locale: :tr)
     end
 
     register :tr, TR

data/lib/num2words/locales/uk.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :uk)
       SCALES = I18n.t("num2words.scales", locale: :uk)
 
-      RUB = I18n.t("num2words.currencies.UAH.name", locale: :uk)
-      KOP = I18n.t("num2words.currencies.UAH.fractional.name", locale: :uk)
+      MAJOR_UNIT = I18n.t("num2words.currencies.UAH.name", locale: :uk)
+      MINOR_UNIT = I18n.t("num2words.currencies.UAH.fractional.name", locale: :uk)
     end
 
     register :uk, UK

data/lib/num2words/locales/ur.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ur)
       SCALES = I18n.t("num2words.scales", locale: :ur)
 
-      RUB = I18n.t("num2words.currencies.PKR.name", locale: :ur)
-      KOP = I18n.t("num2words.currencies.PKR.fractional.name", locale: :ur)
+      MAJOR_UNIT = I18n.t("num2words.currencies.PKR.name", locale: :ur)
+      MINOR_UNIT = I18n.t("num2words.currencies.PKR.fractional.name", locale: :ur)
     end
 
     register :ur, UR

data/lib/num2words/locales/vi.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :vi)
       SCALES = I18n.t("num2words.scales", locale: :vi)
 
-      RUB = I18n.t("num2words.currencies.VND.name", locale: :vi)
-      KOP = I18n.t("num2words.currencies.VND.fractional.name", locale: :vi)
+      MAJOR_UNIT = I18n.t("num2words.currencies.VND.name", locale: :vi)
+      MINOR_UNIT = I18n.t("num2words.currencies.VND.fractional.name", locale: :vi)
     end
 
     register :vi, VI

data/lib/num2words/locales/zh.rb

@@ -10,8 +10,8 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :zh)
       SCALES = I18n.t("num2words.scales", locale: :zh)
 
-      RUB = I18n.t("num2words.currencies.CNY.name", locale: :zh)
-      KOP = I18n.t("num2words.currencies.CNY.fractional.name", locale: :zh)
+      MAJOR_UNIT = I18n.t("num2words.currencies.CNY.name", locale: :zh)
+      MINOR_UNIT = I18n.t("num2words.currencies.CNY.fractional.name", locale: :zh)
     end
 
     register :zh, ZH

data/lib/num2words/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Num2words
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: num2words
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Ruslan Fedotov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-19 00:00:00.000000000 Z
+date: 2025-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n
@@ -33,6 +33,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md