num2words 0.1.6 → 0.3.0

data/lib/num2words/locales/uk.rb

@@ -10,8 +10,140 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :uk)
       SCALES = I18n.t("num2words.scales", locale: :uk)
 
-      MAJOR_UNIT = I18n.t("num2words.currencies.UAH.name", locale: :uk)
-      MINOR_UNIT = I18n.t("num2words.currencies.UAH.fractional.name", locale: :uk)
+      FRACTIONS = I18n.t("num2words.fractions", locale: :uk)
+      GRAMMAR = I18n.t("num2words.grammar", locale: :uk)
+
+      DATE = I18n.t("num2words.date", locale: :uk)
+      DATE_TEMPLATE = I18n.t("num2words.date.template", locale: :uk)
+      TIME = I18n.t("num2words.time", locale: :uk)
+      TIME_TEMPLATE = I18n.t("num2words.time.template", locale: :uk)
+      DATETIME_TEMPLATE = I18n.t("num2words.datetime.template", locale: :uk)
+
+      ORDINALS = I18n.t("num2words.numbers.ordinals", locale: :uk)
+
+      FEMININE_MAJOR_CURRENCIES = %i[UAH JPY CZK BGN INR IDR PKR TRY BDT KRW].freeze
+      FEMININE_MINOR_CURRENCIES = %i[UAH RUB BGN ILS INR IRR RSD BDT PKR].freeze
+
+      module_function
+
+      def feminine_group?(scale_idx)
+        scale_idx == 1
+      end
+
+      def fraction_numerator_feminine?
+        true
+      end
+
+      def minus_word
+        GRAMMAR[:minus]
+      end
+
+      def fraction_joiner(joiner)
+        joiner.to_sym == :and ? "і" : GRAMMAR[:conjunction]
+      end
+
+      def default_fraction_word
+        GRAMMAR[:default_fraction]
+      end
+
+      def triple_to_words(number, scale_idx, feminine: false)
+        words = []
+
+        words << HUNDREDS[number / 100] if number >= 100
+        rest = number % 100
+
+        if rest.between?(10, 19)
+          words << TEENS[rest - 10]
+        else
+          words << TENS[rest / 10] if rest >= 20
+          ones = rest % 10
+          words << (feminine ? ONES_FEM[ones] : ONES_MASC[ones]) if ones.positive?
+        end
+
+        words << pluralize(number, *SCALES[scale_idx]) unless scale_idx.zero?
+        words.compact
+      end
+
+      def date_day(day, format:, date_case:)
+        return ordinal(day, :default, gender: :masculine) if date_case.to_sym == :genitive
+
+        ordinal(day, :nominative, gender: :neuter)
+      end
+
+      def date_year(year, format:)
+        ordinal(year, :default)
+      end
+
+      def currency_major_feminine?(currency)
+        FEMININE_MAJOR_CURRENCIES.include?(currency.to_sym)
+      end
+
+      def currency_minor_feminine?(currency)
+        FEMININE_MINOR_CURRENCIES.include?(currency.to_sym)
+      end
+
+      def currency_number_words(number, currency, unit:)
+        cardinal(number, feminine: unit == :major ? currency_major_feminine?(currency) : currency_minor_feminine?(currency))
+      end
+
+      def time_unit_feminine?(unit)
+        %i[hour minute second].include?(unit)
+      end
+
+      def time_number_words(number, unit:)
+        cardinal(number, feminine: time_unit_feminine?(unit))
+      end
+
+      def ordinal(value, format, gender: :masculine)
+        ordinals = ORDINALS[format]
+        gender_data = ordinals[gender] || ordinals[:masculine]
+
+        return gender_data[value - 1] if value.between?(1, gender_data.length)
+
+        if value > 31
+          thousands = (value / 100) * 100
+          last_two = value % 100
+          base_year = cardinal(thousands)
+          last_ordinal = gender_data[last_two - 1] || cardinal(last_two)
+
+          return [base_year, last_ordinal].join(" ")
+        end
+
+        cardinal(value)
+      end
+
+      def cardinal(number, feminine: false)
+        integer_value = Integer(number)
+        negative = integer_value.negative?
+        integer_value = integer_value.abs
+
+        return (feminine ? ONES_FEM[0] : 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_idx = groups.size - index - 1
+          group_feminine = feminine_group?(scale_idx) || feminine
+          words.concat triple_to_words(group_value, scale_idx, feminine: group_feminine)
+        end
+
+        words.unshift(minus_word) if negative
+        words.join(" ")
+      end
+
+      def pluralize(number, singular, few, plural)
+        number = number.abs
+        return plural if (11..14).include?(number % 100)
+
+        case number % 10
+        when 1 then singular
+        when 2..4 then few
+        else plural
+        end
+      end
     end
 
     register :uk, UK

data/lib/num2words/locales/ur.rb

@@ -10,8 +10,136 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :ur)
       SCALES = I18n.t("num2words.scales", locale: :ur)
 
-      MAJOR_UNIT = I18n.t("num2words.currencies.PKR.name", locale: :ur)
-      MINOR_UNIT = I18n.t("num2words.currencies.PKR.fractional.name", locale: :ur)
+      FRACTIONS = I18n.t("num2words.fractions", locale: :ur)
+      GRAMMAR = I18n.t("num2words.grammar", locale: :ur)
+
+      DATE = I18n.t("num2words.date", locale: :ur)
+      DATE_TEMPLATE = I18n.t("num2words.date.template", locale: :ur)
+      TIME = I18n.t("num2words.time", locale: :ur)
+      TIME_TEMPLATE = I18n.t("num2words.time.template", locale: :ur)
+      DATETIME_TEMPLATE = I18n.t("num2words.datetime.template", locale: :ur)
+
+      ORDINALS = I18n.t("num2words.numbers.ordinals", locale: :ur)
+
+      UNDER_HUNDRED = [
+        "صفر", "ایک", "دو", "تین", "چار", "پانچ", "چھ", "سات", "آٹھ", "نو",
+        "دس", "گیارہ", "بارہ", "تیرہ", "چودہ", "پندرہ", "سولہ", "سترہ", "اٹھارہ", "انیس",
+        "بیس", "اکیس", "بائیس", "تئیس", "چوبیس", "پچیس", "چھبیس", "ستائیس", "اٹھائیس", "انتیس",
+        "تیس", "اکتیس", "بتیس", "تینتیس", "چونتیس", "پینتیس", "چھتیس", "سینتیس", "اڑتیس", "انتالیس",
+        "چالیس", "اکتالیس", "بیالیس", "تینتالیس", "چوالیس", "پینتالیس", "چھیالیس", "سینتالیس", "اڑتالیس", "انچاس",
+        "پچاس", "اکیاون", "باون", "ترپن", "چون", "پچپن", "چھپن", "ستاون", "اٹھاون", "انسٹھ",
+        "ساٹھ", "اکسٹھ", "باسٹھ", "تریسٹھ", "چونسٹھ", "پینسٹھ", "چھیاسٹھ", "سڑسٹھ", "اڑسٹھ", "انہتر",
+        "ستر", "اکہتر", "بہتر", "تہتر", "چوہتر", "پچھتر", "چھہتر", "ستتر", "اٹھہتر", "اناسی",
+        "اسی", "اکیاسی", "بیاسی", "تراسی", "چوراسی", "پچاسی", "چھیاسی", "ستاسی", "اٹھاسی", "نواسی",
+        "نوے", "اکیانوے", "بانوے", "ترانوے", "چورانوے", "پچانوے", "چھیانوے", "ستانوے", "اٹھانوے", "ننانوے"
+      ].freeze
+
+      INDIAN_SCALES = [
+        [1_000_000_000, "ارب"],
+        [10_000_000, "کروڑ"],
+        [100_000, "لاکھ"],
+        [1_000, "ہزار"]
+      ].freeze
+
+      module_function
+
+      def integer_to_words(number, feminine: false)
+        cardinal(number)
+      end
+
+      def triple_to_words(number, scale_idx, feminine: false)
+        return [] if number.zero?
+
+        words = [under_thousand(number)]
+        words << SCALES[scale_idx][0] unless scale_idx.zero?
+        words
+      end
+
+      def minus_word
+        GRAMMAR[:minus]
+      end
+
+      def fraction_joiner(joiner)
+        joiner.to_sym == :and ? "اور" : GRAMMAR[:conjunction]
+      end
+
+      def default_fraction_word
+        GRAMMAR[:default_fraction]
+      end
+
+      def fraction_numerator_feminine?
+        false
+      end
+
+      def decimal_separator_word
+        "اعشاریہ"
+      end
+
+      def decimal_fraction_words(fraction_string)
+        fraction_string.chars.map { |digit| cardinal(digit.to_i) }.join(" ")
+      end
+
+      def date_day(day, format:, date_case:)
+        ordinal(day, :default)
+      end
+
+      def date_year(year, format:)
+        cardinal(year)
+      end
+
+      def currency_number_words(number, currency, unit:)
+        cardinal(number)
+      end
+
+      def time_number_words(number, unit:)
+        cardinal(number)
+      end
+
+      def ordinal(value, format, gender: :masculine)
+        ordinals = ORDINALS[format] || ORDINALS[:default] || ORDINALS[:nominative]
+        gender_data = ordinals[gender] || ordinals[:masculine]
+
+        return gender_data[value - 1] if value.between?(1, gender_data.length)
+
+        cardinal(value)
+      end
+
+      def cardinal(number)
+        integer_value = Integer(number)
+        negative = integer_value.negative?
+        integer_value = integer_value.abs
+
+        return UNDER_HUNDRED[0] if integer_value.zero?
+
+        remainder = integer_value
+        words = []
+
+        INDIAN_SCALES.each do |value, label|
+          next if remainder < value
+
+          group_value = remainder / value
+          remainder %= value
+          words << [cardinal(group_value), label].join(" ")
+        end
+
+        words << under_thousand(remainder) if remainder.positive?
+        words.unshift(minus_word) if negative
+        words.join(" ")
+      end
+
+      def under_thousand(number)
+        return UNDER_HUNDRED[number] if number < 100
+
+        hundreds = number / 100
+        rest = number % 100
+        words = [HUNDREDS[hundreds]]
+        words << UNDER_HUNDRED[rest] if rest.positive?
+        words.join(" ")
+      end
+
+      def pluralize(number, singular, few, _plural)
+        number.abs == 1 ? singular : few
+      end
     end
 
     register :ur, UR

data/lib/num2words/locales/vi.rb

@@ -10,8 +10,148 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :vi)
       SCALES = I18n.t("num2words.scales", locale: :vi)
 
-      MAJOR_UNIT = I18n.t("num2words.currencies.VND.name", locale: :vi)
-      MINOR_UNIT = I18n.t("num2words.currencies.VND.fractional.name", locale: :vi)
+      FRACTIONS = I18n.t("num2words.fractions", locale: :vi)
+      GRAMMAR = I18n.t("num2words.grammar", locale: :vi)
+
+      DATE = I18n.t("num2words.date", locale: :vi)
+      DATE_TEMPLATE = I18n.t("num2words.date.template", locale: :vi)
+      TIME = I18n.t("num2words.time", locale: :vi)
+      TIME_TEMPLATE = I18n.t("num2words.time.template", locale: :vi)
+      DATETIME_TEMPLATE = I18n.t("num2words.datetime.template", locale: :vi)
+
+      ORDINALS = I18n.t("num2words.numbers.ordinals", locale: :vi)
+
+      module_function
+
+      def integer_to_words(number, feminine: false)
+        cardinal(number)
+      end
+
+      def triple_to_words(number, scale_idx, feminine: false)
+        return [] if number.zero?
+
+        words = [under_thousand(number)]
+        words << SCALES[scale_idx][0] unless scale_idx.zero?
+        words
+      end
+
+      def minus_word
+        GRAMMAR[:minus]
+      end
+
+      def fraction_joiner(joiner)
+        joiner.to_sym == :and ? "và" : GRAMMAR[:conjunction]
+      end
+
+      def default_fraction_word
+        GRAMMAR[:default_fraction]
+      end
+
+      def fraction_numerator_feminine?
+        false
+      end
+
+      def decimal_separator_word
+        "phẩy"
+      end
+
+      def decimal_fraction_words(fraction_string)
+        fraction_string.chars.map { |digit| cardinal(digit.to_i) }.join(" ")
+      end
+
+      def date_day(day, format:, date_case:)
+        cardinal(day)
+      end
+
+      def date_year(year, format:)
+        cardinal(year)
+      end
+
+      def currency_number_words(number, currency, unit:)
+        cardinal(number)
+      end
+
+      def time_number_words(number, unit:)
+        cardinal(number)
+      end
+
+      def ordinal(value, format, gender: :masculine)
+        ordinals = ORDINALS[format] || ORDINALS[:default] || ORDINALS[:nominative]
+        gender_data = ordinals[gender] || ordinals[:masculine]
+
+        return gender_data[value - 1] if value.between?(1, gender_data.length)
+
+        cardinal(value)
+      end
+
+      def cardinal(number)
+        integer_value = Integer(number)
+        negative = integer_value.negative?
+        integer_value = integer_value.abs
+
+        return 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|
+          next if group_value.zero?
+
+          scale_idx = groups.size - index - 1
+          full_group = words.any? && group_value < 100
+          group_words = under_thousand(group_value, full: full_group)
+          words << [group_words, SCALES[scale_idx][0]].reject(&:empty?).join(" ")
+        end
+
+        words.unshift(minus_word) if negative
+        words.join(" ")
+      end
+
+      def under_thousand(number, full: false)
+        return ONES_MASC[number] if number < 10 && !full
+        return under_hundred(number, after_hundreds: false) if number < 100 && !full
+
+        hundreds = number / 100
+        rest = number % 100
+        words = []
+
+        words << (hundreds.positive? ? HUNDREDS[hundreds] : "không trăm")
+        words << under_hundred(rest, after_hundreds: true) if rest.positive?
+        words.join(" ")
+      end
+
+      def under_hundred(number, after_hundreds:)
+        return ["linh", ONES_MASC[number]].join(" ") if number < 10 && after_hundreds
+        return ONES_MASC[number] if number < 10
+        return "mười" if number == 10
+
+        if number < 20
+          ones = number % 10
+          return "mười lăm" if ones == 5
+
+          return ["mười", ONES_MASC[ones]].join(" ")
+        end
+
+        tens = number / 10
+        ones = number % 10
+        words = [TENS[tens]]
+
+        words << case ones
+                 when 0 then nil
+                 when 1 then "mốt"
+                 when 4 then "tư"
+                 when 5 then "lăm"
+                 else ONES_MASC[ones]
+                 end
+
+        words.compact.join(" ")
+      end
+
+      def pluralize(number, singular, _few, _plural)
+        singular
+      end
     end
 
     register :vi, VI

data/lib/num2words/locales/zh.rb

@@ -10,8 +10,178 @@ module Num2words
       HUNDREDS = I18n.t("num2words.hundreds", locale: :zh)
       SCALES = I18n.t("num2words.scales", locale: :zh)
 
-      MAJOR_UNIT = I18n.t("num2words.currencies.CNY.name", locale: :zh)
-      MINOR_UNIT = I18n.t("num2words.currencies.CNY.fractional.name", locale: :zh)
+      FRACTIONS = I18n.t("num2words.fractions", locale: :zh)
+      GRAMMAR = I18n.t("num2words.grammar", locale: :zh)
+
+      DATE = I18n.t("num2words.date", locale: :zh)
+      DATE_TEMPLATE = I18n.t("num2words.date.template", locale: :zh)
+      TIME = I18n.t("num2words.time", locale: :zh)
+      TIME_TEMPLATE = I18n.t("num2words.time.template", locale: :zh)
+      DATETIME_TEMPLATE = I18n.t("num2words.datetime.template", locale: :zh)
+
+      ORDINALS = I18n.t("num2words.numbers.ordinals", locale: :zh)
+
+      LARGE_SCALES = ["", "万", "亿", "兆", "京"].freeze
+      SMALL_UNITS = ["", "十", "百", "千"].freeze
+
+      module_function
+
+      def integer_to_words(number, feminine: false)
+        cardinal(number)
+      end
+
+      def triple_to_words(number, scale_idx, feminine: false)
+        return [] if number.zero?
+
+        ["#{under_ten_thousand(number)}#{LARGE_SCALES[scale_idx]}"]
+      end
+
+      def minus_word
+        GRAMMAR[:minus]
+      end
+
+      def fraction_joiner(joiner)
+        joiner.to_sym == :and ? "又" : GRAMMAR[:conjunction]
+      end
+
+      def default_fraction_word
+        GRAMMAR[:default_fraction]
+      end
+
+      def fraction_numerator_feminine?
+        false
+      end
+
+      def decimal_separator_word
+        GRAMMAR[:decimal_separator] || "点"
+      end
+
+      def decimal_fraction_words(fraction_string)
+        fraction_string.chars.map { |digit| ONES_MASC[digit.to_i] }.join
+      end
+
+      def join_decimal_words(words)
+        words.compact.reject(&:empty?).join
+      end
+
+      def join_fraction_words(words)
+        sign_word, integer_words, conjunction_word, numerator_words, denominator_words = words
+        numerator_words = "" if denominator_words.to_s.end_with?(numerator_words.to_s)
+
+        [sign_word, integer_words, conjunction_word, denominator_words, numerator_words].compact.reject(&:empty?).join
+      end
+
+      def date_day(day, format:, date_case:)
+        cardinal(day)
+      end
+
+      def date_year(year, format:)
+        cardinal(year)
+      end
+
+      def time_unit_feminine?(_unit)
+        false
+      end
+
+      def time_number_words(number, unit:)
+        cardinal(number)
+      end
+
+      def join_time_words(number_words, unit_words)
+        "#{number_words}#{unit_words}"
+      end
+
+      def currency_major_feminine?(_currency)
+        false
+      end
+
+      def currency_minor_feminine?(_currency)
+        false
+      end
+
+      def currency_number_words(number, _currency, unit:)
+        cardinal(number)
+      end
+
+      def join_currency_parts(parts)
+        parts.join
+      end
+
+      def ordinal(value, format, gender: :masculine)
+        ordinals = ORDINALS[format] || ORDINALS[:default] || ORDINALS[:nominative]
+        gender_data = ordinals[gender] || ordinals[:masculine]
+
+        return gender_data[value - 1] if value.between?(1, gender_data.length)
+
+        "第#{cardinal(value)}"
+      end
+
+      def cardinal(number)
+        integer_value = Integer(number)
+        negative = integer_value.negative?
+        integer_value = integer_value.abs
+
+        return ONES_MASC[0] if integer_value.zero?
+
+        groups = integer_value.to_s
+                              .chars.reverse.each_slice(4).map(&:reverse)
+                              .map(&:join).map!(&:to_i).reverse
+
+        words = []
+        zero_between = false
+
+        groups.each_with_index do |group_value, index|
+          scale_idx = groups.size - index - 1
+
+          if group_value.zero?
+            zero_between = words.any?
+            next
+          end
+
+          words << ONES_MASC[0] if words.any? && (zero_between || group_value < 1000) && words.last != ONES_MASC[0]
+          words << "#{under_ten_thousand(group_value)}#{LARGE_SCALES.fetch(scale_idx, '')}"
+          zero_between = false
+        end
+
+        words.unshift(minus_word) if negative
+        words.join
+      end
+
+      def under_ten_thousand(number)
+        digits = number.digits
+        words = []
+        zero_needed = false
+
+        (3).downto(0) do |position|
+          digit = digits[position].to_i
+
+          if digit.zero?
+            zero_needed = words.any? && lower_nonzero?(digits, position)
+            next
+          end
+
+          words << ONES_MASC[0] if zero_needed
+          words << unit_words(digit, position, words.empty?)
+          zero_needed = false
+        end
+
+        words.join
+      end
+
+      def unit_words(digit, position, group_start)
+        return ONES_MASC[digit] if position.zero?
+        return SMALL_UNITS[position] if position == 1 && digit == 1 && group_start
+
+        "#{ONES_MASC[digit]}#{SMALL_UNITS[position]}"
+      end
+
+      def lower_nonzero?(digits, position)
+        (0...position).any? { |lower_position| digits[lower_position].to_i.positive? }
+      end
+
+      def pluralize(number, singular, few, _plural)
+        number == 1 ? singular : few
+      end
     end
 
     register :zh, ZH

data/lib/num2words/version.rb

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

data/num2words.gemspec

@@ -6,8 +6,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Ruslan Fedotov"]
   spec.email         = ["progruson@gmail.com"]
 
-  spec.summary       = %q{Russian number-to-words with currency (руб/коп) and correct declensions}
-  spec.description   = %q{Converts integers and amounts to Russian words with proper gender and plural forms.}
+  spec.summary       = %q{Convert numbers, amounts, dates, and times to words}
+  spec.description   = %q{Converts numbers, currency amounts, dates, and times to words with locale-aware grammar across supported locales.}
   spec.homepage      = "https://github.com/skyrusx/num2words"
   spec.license       = "MIT"
   spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
@@ -25,5 +25,5 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_runtime_dependency "i18n", ">= 1.8"
+  spec.add_runtime_dependency "i18n", "~> 1.8"
 end