num2words 0.2.0 → 0.3.1

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.2.0"
+  VERSION = "0.3.1"
 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")
@@ -26,4 +26,5 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_runtime_dependency "i18n", "~> 1.8"
+  spec.add_runtime_dependency "bigdecimal", "~> 3.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: num2words
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Ruslan Fedotov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-31 00:00:00.000000000 Z
+date: 2026-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n
@@ -24,8 +24,22 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.8'
-description: Converts integers and amounts to Russian words with proper gender and
-  plural forms.
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: Converts numbers, currency amounts, dates, and times to words with locale-aware
+  grammar across supported locales.
 email:
 - progruson@gmail.com
 executables:
@@ -33,12 +47,14 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
+- benchmark/converter_benchmark.rb
 - bin/console
 - bin/setup
 - config/locales/ar.yml
@@ -91,6 +107,12 @@ files:
 - config/locales/ur.yml
 - config/locales/vi.yml
 - config/locales/zh.yml
+- docs/api.md
+- docs/api.ru.md
+- docs/limits.md
+- docs/limits.ru.md
+- docs/locale_development.md
+- docs/locale_development.ru.md
 - exe/num2words-console
 - lib/num2words.rb
 - lib/num2words/config.rb
@@ -129,8 +151,8 @@ files:
 - lib/num2words/locales/ml.rb
 - lib/num2words/locales/mr.rb
 - lib/num2words/locales/ms.rb
+- lib/num2words/locales/nb.rb
 - lib/num2words/locales/nl.rb
-- lib/num2words/locales/no.rb
 - lib/num2words/locales/pa.rb
 - lib/num2words/locales/pl.rb
 - lib/num2words/locales/pt.rb
@@ -176,5 +198,5 @@ requirements: []
 rubygems_version: 3.1.2
 signing_key:
 specification_version: 4
-summary: Russian number-to-words with currency (руб/коп) and correct declensions
+summary: Convert numbers, amounts, dates, and times to words
 test_files: []

data/lib/num2words/locales/no.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module Num2words
-  module Locales
-    module NB
-      ONES_MASC = I18n.t("num2words.ones_masc", locale: :nb)
-      ONES_FEM = I18n.t("num2words.ones_fem", locale: :nb)
-      TEENS = I18n.t("num2words.teens", locale: :nb)
-      TENS = I18n.t("num2words.tens", locale: :nb)
-      HUNDREDS = I18n.t("num2words.hundreds", locale: :nb)
-      SCALES = I18n.t("num2words.scales", 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
-  end
-end