num_words 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcb338b276c0afbc161d4ede15bb75c6f64fd279be42066ecabb9c2c986be10c
-  data.tar.gz: 60b8112d1ad8729eb652d7acd893b1cd1e5aa83b5ac31a200ff8df06ca83a4a8
+  metadata.gz: c707e6c57aaf783107cb3290b903a117e012ce6c187d01eb9c6845c709c247a3
+  data.tar.gz: 8cde67422c55d5ebc89d90a70992af08a5f8404cdc121b250adf901e5ded661d
 SHA512:
-  metadata.gz: e12980e8da746190aa011b645978741ac7c7dbc2ce5c9dc91c8fa6ebae3ca4dd57d25b81295d3d28294fc417e7ca0dc3536e45cead806363fcc62122c633442b
-  data.tar.gz: 42dc76855150a5c44fa7cce78d6fa401ec4e161ee6808642dfded60919d65b5ec01bee2b939b288f37ac5dd16948c556b5f79a8f7d5f9cd8af2536c58f580e5f
+  metadata.gz: f7d41d25b31437a63ac7ae7efd4e91c9ae930fc52b087f5c83951d28a4accf70b8e5c1bb88019822630afdb5a846da9406f81ee99c9564760a0f90b60afd4961
+  data.tar.gz: 2d94b537a8db62c48749bb0ae149efb58d91c976e334fb0aec48f1e9649b6146b5d89671d9ef1f8b063ee8144ea53086166f98e7a2a7ce2c3391ea5cc6183fea

data/README.md

@@ -9,12 +9,26 @@
 - Convert integers and decimals to words.
 - Supports multiple country numbering systems:
   - **US / American** – `thousand, million, billion`
-  - **European** – `thousand, million, milliard, billion`
-  - **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 +40,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,10 +6,23 @@ 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
+  # --- 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
+
+  # --- Units ---
   INDIAN_UNITS_HI = ['', 'हज़ार', 'लाख', 'करोड़', 'अरब', 'खरब'].freeze
+  INDIAN_UNITS_EN = ['', 'thousand', 'lakh', 'crore', 'arab', 'kharab'].freeze
 
   # --- English exponents ---
   AM_EXPONENTS = {
@@ -18,87 +31,33 @@ module NumWords
     27 => 'octillion', 30 => 'nonillion', 33 => 'decillion', 36 => 'undecillion'
   }.freeze
 
-  INDIAN_UNITS_EN = ['', 'thousand', 'lakh', 'crore', 'arab', 'kharab'].freeze
-
   COUNTRY_EXPONENTS = {
     us: AM_EXPONENTS,
     in: INDIAN_UNITS_EN
   }.freeze
 
   class << self
-    # Main method: convert number to words
-    # language: :en or :hi
+    # Convert number to words
+    # Default language: :en
     def to_words(number, country: :us, language: :en, include_and: true)
-      if [:in].include?(country) && language == :hi
-        return to_words_indian(number, language: language)
-      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
-      units = language == :hi ? INDIAN_UNITS_HI : INDIAN_UNITS_EN
+      return language == :hi ? HINDI_NUMBERS_1_TO_99[0] : 'zero' if val.zero?
 
       if country == :in
-        to_words_indian(number, language: language)
-      else
-        to_words_generic(val, exp_hash, include_and, ones_array, tens_array)
+        return language == :hi ? to_words_indian(number) : to_words_indian(number, language: :en)
       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
 
-      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?
-
-      decimal_words = decimal_part.chars.map { |d| sub_thousand_to_words(d.to_i, ones_array, tens_array) }.join(' ')
-      "#{integer_words} and #{decimal_words}"
-    end
-
-    private
-
-    def to_words_generic(val, exp_hash, include_and, ones_array, tens_array)
-      chunks = []
-      while val.positive?
-        chunks << val % 1000
-        val /= 1000
-      end
-
-      result = []
-      chunks.each_with_index do |chunk, index|
-        next if chunk.zero?
-        words = hundreds_to_words(chunk, include_and && index.zero?, ones_array, tens_array)
-        result.unshift("#{words} #{exp_hash[index * 3]}".strip)
-      end
-      result.join(' ').strip
-    end
-
-    def hundreds_to_words(val, include_and, ones_array, tens_array)
-      return '' if val.zero?
-
-      words = []
-      if val >= 100
-        words << "#{ones_array[val / 100]} #{ones_array == ONES_HI ? 'सौ' : '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
+      exp_hash = COUNTRY_EXPONENTS[country] || AM_EXPONENTS
+      ones_array = language == :hi ? HINDI_NUMBERS_1_TO_99 : ONES_EN
+      tens_array = language == :hi ? HINDI_NUMBERS_1_TO_99 : TENS_EN
+      to_words_generic(val, exp_hash, include_and, ones_array, tens_array)
     end
 
-    def indian_units_to_words(num, ones_array, tens_array, units)
+    # Indian system (supports English & Hindi)
+    def to_words_indian(num, language: :hi)
       num = num.to_i
-      return ones_array[0] if num.zero?
+      return HINDI_NUMBERS_1_TO_99[num] if language == :hi && num <= 99
+      return ONES_EN[num] if language == :en && num <= 19
 
       words = []
       unit_index = 0
@@ -106,30 +65,56 @@ module NumWords
       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?
+        part = language == :hi ? convert_hindi_sub_thousand(remainder) : convert_english_sub_thousand(remainder)
+        unit_name = language == :hi ? INDIAN_UNITS_HI[unit_index] : INDIAN_UNITS_EN[unit_index]
+        words.unshift("#{part} #{unit_name}".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?
+    private
 
+    def convert_hindi_sub_thousand(num)
+      return HINDI_NUMBERS_1_TO_99[num] if num <= 99
       words = []
       if num >= 100
-        words << "#{ones_array[num / 100]} #{ones_array == ONES_HI ? 'सौ' : 'hundred'}"
+        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
 
-      if num >= 20
-        words << tens_array[num / 10]
-        num %= 10
+    def convert_english_sub_thousand(num)
+      return ONES_EN[num] if num < 20
+      words = []
+      if num >= 100
+        words << "#{ONES_EN[num / 100]} hundred"
+        num %= 100
       end
-
-      words << ones_array[num] if num.positive?
+      words << TENS_EN[num / 10] if num >= 20
+      num %= 10 if num >= 20
+      words << ONES_EN[num] if num.positive?
       words.join(' ').strip
     end
+
+    def to_words_generic(val, exp_hash, include_and, ones_array, tens_array)
+      chunks = []
+      while val.positive?
+        chunks << val % 1000
+        val /= 1000
+      end
+
+      result = []
+      chunks.each_with_index do |chunk, index|
+        next if chunk.zero?
+        words = convert_english_sub_thousand(chunk)
+        words = "and #{words}" if include_and && index.zero? && chunk >= 100
+        result.unshift("#{words} #{exp_hash[index * 3]}".strip)
+      end
+      result.join(' ').strip
+    end
   end
 end

data/lib/num_words/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NumWords
-  VERSION = "0.4.0"
+  VERSION = "0.6.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.6.0
 platform: ruby
 authors:
 - mrmalvi
@@ -9,8 +9,8 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: NumWords gem converts integers and decimals to words. Supports US, EU,
-  UK, FR, and Indian number systems with proper handling of decimals.
+description: NumWords gem converts integers and decimals to words. Supports US and
+  Indian number systems with proper handling of decimals.
 email:
 - malviyak00@gmail.com
 executables: