num_words 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcb338b276c0afbc161d4ede15bb75c6f64fd279be42066ecabb9c2c986be10c
-  data.tar.gz: 60b8112d1ad8729eb652d7acd893b1cd1e5aa83b5ac31a200ff8df06ca83a4a8
+  metadata.gz: a0d117daa9a0ef678984f1a03b1b1456047e7ea67b4b13f610ab8cfb90634646
+  data.tar.gz: 4732ef7b105d1ae22b208529fe6098cbab124aef3547ee4650f3d24dd4b3a89e
 SHA512:
-  metadata.gz: e12980e8da746190aa011b645978741ac7c7dbc2ce5c9dc91c8fa6ebae3ca4dd57d25b81295d3d28294fc417e7ca0dc3536e45cead806363fcc62122c633442b
-  data.tar.gz: 42dc76855150a5c44fa7cce78d6fa401ec4e161ee6808642dfded60919d65b5ec01bee2b939b288f37ac5dd16948c556b5f79a8f7d5f9cd8af2536c58f580e5f
+  metadata.gz: 75c3b9d42dc93e10d5a413d2f1a03b04921f8277dd1ae056bcf4f020c9672e6e4737752d82d02541e9ac9b0560e0facb5888e64cb3de72ee83dcb881855f27b0
+  data.tar.gz: 666c1624f2d5c82ac29cd479f3c1625f0f43941be7876d190b3483ff87de195d4c949b9d88b74b9c10e8886f64e2657d91812ce85a2041fd5705d4038900208c

data/README.md

@@ -13,8 +13,25 @@
   - **UK** – `thousand, million, billion`
   - **France** – `mille, million, milliard`
   - **India** – `thousand, lakh, crore`
+- Supports multiple languages:
+  - **English** (`:en`)
+  - **Hindi** (`:hi`)
+  - **French** (`:fr`) *(optional / extended)*
 - Easy to integrate into Ruby or Rails applications.
 - Supports numbers up to `duovigintillion` (10^69) in the American system.
+- Handles both integers and decimal numbers.
+
+# In US system
+- NumWords.to_words(123456789012345, country: :us, language: :en)
+  - "one hundred and twenty-three trillion four hundred and fifty-six billion seven hundred and eighty-nine million twelve thousand three hundred and forty-five"
+
+# In Hindi
+- NumWords.to_words(123456789012345, country: :hi, language: :hi)
+  - "बारह खरब चौतीस अरब छप्पन करोड़ सात करोड़ अस्सी लाख बारह हज़ार तीन सौ पैंतालीस"
+
+# Indian number with decimals
+- NumWords.to_words(1234567890.123, country: :in, language: :en)
+  - "one hundred and twenty-three crore forty-five lakh sixty-seven thousand eight hundred and ninety and one two three"
 
 ---
 
@@ -26,6 +43,10 @@ After releasing your gem to [RubyGems.org](https://rubygems.org), install it wit
 
 ```bash
 # Using Bundler
-bundle add num_words
+bundle add gem "num_words"
+
+# Or using gem install
+gem install num_words
+
+
 
-bundle add num_words

data/lib/num_words/converter.rb

@@ -6,18 +6,26 @@ module NumWords
   ONES_EN = %w[zero one two three four five six seven eight nine ten eleven twelve thirteen fourteen fifteen sixteen seventeen eighteen nineteen].freeze
   TENS_EN = %w[zero ten twenty thirty forty fifty sixty seventy eighty ninety].freeze
 
-  # --- Hindi words ---
-  ONES_HI = %w[शून्य एक दो तीन चार पाँच छह सात आठ नौ दस ग्यारह बारह तेरह चौदह पंद्रह सोलह सत्रह अठारह उन्नीस].freeze
-  TENS_HI = %w[शून्य दस बीस तीस चालीस पचास साठ सत्तर अस्सी नब्बे].freeze
-  INDIAN_UNITS_HI = ['', 'हज़ार', 'लाख', 'करोड़', 'अरब', 'खरब'].freeze
+  # --- Hindi numbers 1 to 99 (pure Hindi) ---
+  HINDI_NUMBERS_1_TO_99 = {
+    0=>"शून्य",1=>"एक",2=>"दो",3=>"तीन",4=>"चार",5=>"पाँच",6=>"छह",7=>"सात",8=>"आठ",9=>"नौ",10=>"दस",
+    11=>"ग्यारह",12=>"बारह",13=>"तेरह",14=>"चौदह",15=>"पंद्रह",16=>"सोलह",17=>"सत्रह",18=>"अठारह",19=>"उन्नीस",
+    20=>"बीस",21=>"इक्कीस",22=>"बाईस",23=>"तेईस",24=>"चौबीस",25=>"पच्चीस",26=>"छब्बीस",27=>"सत्ताईस",28=>"अट्ठाईस",29=>"उनतीस",
+    30=>"तीस",31=>"इकतीस",32=>"बत्तीस",33=>"तैंतीस",34=>"चौंतीस",35=>"पैंतीस",36=>"छत्तीस",37=>"सैंतीस",38=>"अड़तीस",39=>"उनतालीस",
+    40=>"चालीस",41=>"इकतालीस",42=>"बयालीस",43=>"तैंतालीस",44=>"चवालीस",45=>"पैंतालीस",46=>"छियालीस",47=>"सैंतालीस",48=>"अड़तालीस",49=>"उनचास",
+    50=>"पचास",51=>"इक्यावन",52=>"बावन",53=>"तिरेपन",54=>"चौवन",55=>"पचपन",56=>"छप्पन",57=>"सत्तावन",58=>"अट्ठावन",59=>"उनसठ",
+    60=>"साठ",61=>"इकसठ",62=>"बासठ",63=>"तिरेसठ",64=>"चौंसठ",65=>"पैंसठ",66=>"छियासठ",67=>"सड़सठ",68=>"अड़सठ",69=>"उनहत्तर",
+    70=>"सत्तर",71=>"इकहत्तर",72=>"बहत्तर",73=>"तिहत्तर",74=>"चौहत्तर",75=>"पचहत्तर",76=>"छिहत्तर",77=>"सतहत्तर",78=>"अठहत्तर",79=>"उन्यासी",
+    80=>"अस्सी",81=>"इक्यासी",82=>"बयासी",83=>"तिरेासी",84=>"चौरासी",85=>"पचासी",86=>"छियासी",87=>"सत्तासी",88=>"अठासी",89=>"नवासी",
+    90=>"नब्बे",91=>"इक्यानवे",92=>"बयानवे",93=>"तिरेनवे",94=>"चौरानवे",95=>"पचानवे",96=>"छियानवे",97=>"सत्तानवे",98=>"अट्ठानवे",99=>"निन्यानवे"
+  }.freeze
 
-  # --- English exponents ---
+  INDIAN_UNITS_HI = ['', 'हज़ार', 'लाख', 'करोड़', 'अरब', 'खरब'].freeze
   AM_EXPONENTS = {
     3 => 'thousand', 6 => 'million', 9 => 'billion', 12 => 'trillion',
     15 => 'quadrillion', 18 => 'quintillion', 21 => 'sexillion', 24 => 'septillion',
     27 => 'octillion', 30 => 'nonillion', 33 => 'decillion', 36 => 'undecillion'
   }.freeze
-
   INDIAN_UNITS_EN = ['', 'thousand', 'lakh', 'crore', 'arab', 'kharab'].freeze
 
   COUNTRY_EXPONENTS = {
@@ -26,19 +34,18 @@ module NumWords
   }.freeze
 
   class << self
-    # Main method: convert number to words
-    # language: :en or :hi
+    # Convert number to words
     def to_words(number, country: :us, language: :en, include_and: true)
       if [:in].include?(country) && language == :hi
-        return to_words_indian(number, language: language)
+        return to_words_indian(number)
       end
 
       val = number.to_i.abs
       return 'zero' if val.zero?
 
       exp_hash = COUNTRY_EXPONENTS[country] || AM_EXPONENTS
-      ones_array = language == :hi ? ONES_HI : ONES_EN
-      tens_array = language == :hi ? TENS_HI : TENS_EN
+      ones_array = language == :hi ? HINDI_NUMBERS_1_TO_99 : ONES_EN
+      tens_array = language == :hi ? HINDI_NUMBERS_1_TO_99 : TENS_EN
       units = language == :hi ? INDIAN_UNITS_HI : INDIAN_UNITS_EN
 
       if country == :in
@@ -48,22 +55,40 @@ module NumWords
       end
     end
 
-    # Indian system (supports English & Hindi)
-    def to_words_indian(num, language: :en)
-      integer_part, decimal_part = num.to_s.split('.')
-      ones_array = language == :hi ? ONES_HI : ONES_EN
-      tens_array = language == :hi ? TENS_HI : TENS_EN
-      units = language == :hi ? INDIAN_UNITS_HI : INDIAN_UNITS_EN
+    # Indian system (Hindi & English)
+    def to_words_indian(num, language: :hi)
+      num = num.to_i
+      return HINDI_NUMBERS_1_TO_99[num] if num <= 99
 
-      integer_words = indian_units_to_words(integer_part.to_i, ones_array, tens_array, units)
-      return integer_words if decimal_part.nil? || decimal_part.to_i.zero?
+      words = []
+      unit_index = 0
+
+      loop do
+        break if num.zero?
+        num, remainder = unit_index.zero? ? num.divmod(1000) : num.divmod(100)
+        part = convert_hindi_sub_thousand(remainder)
+        words.unshift("#{part} #{INDIAN_UNITS_HI[unit_index]}".strip) if remainder.positive?
+        unit_index += 1
+      end
 
-      decimal_words = decimal_part.chars.map { |d| sub_thousand_to_words(d.to_i, ones_array, tens_array) }.join(' ')
-      "#{integer_words} and #{decimal_words}"
+      words.join(' ').strip
     end
 
     private
 
+    def convert_hindi_sub_thousand(num)
+      return HINDI_NUMBERS_1_TO_99[num] if num <= 99
+
+      words = []
+      if num >= 100
+        words << "#{HINDI_NUMBERS_1_TO_99[num / 100]} सौ"
+        num %= 100
+      end
+      words << HINDI_NUMBERS_1_TO_99[num] if num.positive?
+      words.join(' ').strip
+    end
+
+    # Generic system (English or other)
     def to_words_generic(val, exp_hash, include_and, ones_array, tens_array)
       chunks = []
       while val.positive?
@@ -85,50 +110,13 @@ module NumWords
 
       words = []
       if val >= 100
-        words << "#{ones_array[val / 100]} #{ones_array == ONES_HI ? 'सौ' : 'hundred'}"
+        words << "#{ones_array[val / 100]} #{ones_array == HINDI_NUMBERS_1_TO_99 ? 'सौ' : 'hundred'}"
         val %= 100
-        words << 'and' if val.positive? && include_and && ones_array != ONES_HI
-      end
-
-      words << tens_array[val / 10] if val >= 20
-      val %= 10 if val >= 20
-      words << ones_array[val] if val.positive?
-      words.join(' ').strip
-    end
-
-    def indian_units_to_words(num, ones_array, tens_array, units)
-      num = num.to_i
-      return ones_array[0] if num.zero?
-
-      words = []
-      unit_index = 0
-
-      loop do
-        break if num.zero?
-        num, remainder = unit_index.zero? ? num.divmod(1000) : num.divmod(100)
-        words.unshift("#{sub_thousand_to_words(remainder, ones_array, tens_array)} #{units[unit_index]}".strip) if remainder.positive?
-        unit_index += 1
-      end
-
-      words.join(' ').strip
-    end
-
-    def sub_thousand_to_words(num, ones_array, tens_array)
-      return ones_array[num] if num < 20
-      return "#{ones_array[num / 100]} #{ones_array == ONES_HI ? 'सौ' : 'hundred'}" if num >= 100 && (num % 100).zero?
-
-      words = []
-      if num >= 100
-        words << "#{ones_array[num / 100]} #{ones_array == ONES_HI ? 'सौ' : 'hundred'}"
-        num %= 100
-      end
-
-      if num >= 20
-        words << tens_array[num / 10]
-        num %= 10
+        words << 'and' if val.positive? && include_and && ones_array != HINDI_NUMBERS_1_TO_99
       end
 
-      words << ones_array[num] if num.positive?
+      words << tens_array[val] if val > 0 && val <= 99 && ones_array == HINDI_NUMBERS_1_TO_99
+      words << ones_array[val] if val > 0 && val < 20 && ones_array != HINDI_NUMBERS_1_TO_99
       words.join(' ').strip
     end
   end

data/lib/num_words/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NumWords
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: num_words
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - mrmalvi