num_words 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24463f1da6ace2a42347b2e4bd275527a02510175087ebc98eaf3011ea56f4ff
-  data.tar.gz: e61dc04d74d11bde0825d575a5240b96790d1a156ad8048813449adf1e267e05
+  metadata.gz: a0d117daa9a0ef678984f1a03b1b1456047e7ea67b4b13f610ab8cfb90634646
+  data.tar.gz: 4732ef7b105d1ae22b208529fe6098cbab124aef3547ee4650f3d24dd4b3a89e
 SHA512:
-  metadata.gz: 9decb67c34898169365951b2c04c79449c0024ea83263ed30a8d0412ce1f6f2ac62a6423e380c9492cd87afce0841085e3f4e06900b9141a87427d4043fc8a04
-  data.tar.gz: 2f5fe30029e8c3ed6915c0ace3f913d3ed3ea0f47ac119f200b1a8dc4b410e0575317f5011275bc40c466e1593af21732c918829b02bfa1a47cd5ac3f0709704
+  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,7 +43,10 @@ After releasing your gem to [RubyGems.org](https://rubygems.org), install it wit
 
 ```bash
 # Using Bundler
-bundle add gem 'num_words'
+bundle add gem "num_words"
 
-# Or install manually
+# Or using gem install
 gem install num_words
+
+
+

data/lib/num_words/converter.rb

@@ -2,70 +2,94 @@
 # frozen_string_literal: true
 
 module NumWords
-  ONES = %w[zero one two three four five six seven eight nine ten eleven twelve thirteen fourteen fifteen sixteen seventeen eighteen nineteen].freeze
-  TENS = %w[zero ten twenty thirty forty fifty sixty seventy eighty ninety].freeze
+  # --- English words ---
+  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 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
 
+  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',
-    39 => 'duodecillion', 42 => 'tredecillion', 45 => 'quattuordecillion', 48 => 'quindecillion',
-    51 => 'sexdecillion', 54 => 'septendecillion', 57 => 'octodecillion', 60 => 'novemdecillion',
-    63 => 'vigintillion', 66 => 'unvigintillion', 69 => 'duovigintillion'
-  }.freeze
-
-  EU_EXPONENTS = {
-    3 => 'thousand', 6 => 'million', 9 => 'milliard', 12 => 'billion',
-    15 => 'billiard', 18 => 'trillion', 21 => 'trilliard', 24 => 'quadrillion',
-    27 => 'quadrilliard', 30 => 'quintillion', 33 => 'quintilliard', 36 => 'sextillion',
-    39 => 'sextilliard', 42 => 'septillion', 45 => 'septilliard', 48 => 'octillion',
-    51 => 'octilliard', 54 => 'noventillion', 57 => 'noventilliard', 60 => 'decillion',
-    63 => 'decilliard', 66 => 'undecillion', 69 => 'undecilliard'
-  }.freeze
-
-  UK_EXPONENTS = {
-    3 => 'thousand', 6 => 'million', 12 => 'billion', 15 => 'billiard',
-    18 => 'trillion', 21 => 'trilliard', 24 => 'quadrillion'
-  }.freeze
-
-  FR_EXPONENTS = {
-    3 => 'mille', 6 => 'million', 9 => 'milliard', 12 => 'billion',
-    15 => 'billiard', 18 => 'trillion', 21 => 'trilliard'
+    27 => 'octillion', 30 => 'nonillion', 33 => 'decillion', 36 => 'undecillion'
   }.freeze
-
-  INDIAN_UNITS = ['', 'thousand', 'lakh', 'crore'].freeze
+  INDIAN_UNITS_EN = ['', 'thousand', 'lakh', 'crore', 'arab', 'kharab'].freeze
 
   COUNTRY_EXPONENTS = {
     us: AM_EXPONENTS,
-    eu: EU_EXPONENTS,
-    uk: UK_EXPONENTS,
-    fr: FR_EXPONENTS,
-    in: INDIAN_UNITS
+    in: INDIAN_UNITS_EN
   }.freeze
 
   class << self
-    def to_words(number, country: :us, include_and: true)
-      return to_words_indian(number) if country == :in
+    # 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)
+      end
 
       val = number.to_i.abs
       return 'zero' if val.zero?
 
       exp_hash = COUNTRY_EXPONENTS[country] || AM_EXPONENTS
-      to_words_generic(val, exp_hash, include_and)
+      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
+        to_words_indian(number, language: language)
+      else
+        to_words_generic(val, exp_hash, include_and, ones_array, tens_array)
+      end
     end
 
-    def to_words_indian(num)
-      integer_part, decimal_part = num.to_s.split('.')
-      integer_words = indian_units_to_words(integer_part.to_i)
-      return integer_words if decimal_part.nil? || decimal_part.to_i.zero?
+    # 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
 
-      decimal_words = decimal_part.chars.map { |d| sub_thousand_to_words(d.to_i) }.join(' ')
-      "#{integer_words} and #{decimal_words}"
+      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
+
+      words.join(' ').strip
     end
 
     private
 
-    def to_words_generic(val, exp_hash, include_and)
+    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?
         chunks << val % 1000
@@ -75,55 +99,25 @@ module NumWords
       result = []
       chunks.each_with_index do |chunk, index|
         next if chunk.zero?
-        words = hundreds_to_words(chunk, include_and && index.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 = false)
+    def hundreds_to_words(val, include_and, ones_array, tens_array)
       return '' if val.zero?
 
       words = []
       if val >= 100
-        words << "#{ONES[val / 100]} hundred"
+        words << "#{ones_array[val / 100]} #{ones_array == HINDI_NUMBERS_1_TO_99 ? 'सौ' : 'hundred'}"
         val %= 100
-        words << 'and' if val.positive? && include_and
-      end
-
-      words << TENS[val / 10] if val >= 20
-      val %= 10 if val >= 20
-      words << ONES[val] if val.positive?
-      words.join(' ').strip
-    end
-
-    def indian_units_to_words(num)
-      num = num.to_i
-      return 'zero' 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)} #{INDIAN_UNITS[unit_index]}".strip) if remainder.positive?
-        unit_index += 1
+        words << 'and' if val.positive? && include_and && ones_array != HINDI_NUMBERS_1_TO_99
       end
 
+      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
-
-    def sub_thousand_to_words(num)
-      num = num.to_i
-      return ONES[num] if num < 20
-      return "#{ONES[num / 100]} hundred" if num >= 100 && (num % 100).zero?
-
-      if num < 100
-        "#{TENS[num / 10]} #{ONES[num % 10]}".strip
-      else
-        "#{ONES[num / 100]} hundred and #{sub_thousand_to_words(num % 100)}"
-      end
-    end
   end
 end

data/lib/num_words/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NumWords
-  VERSION = "0.3.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.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - mrmalvi
@@ -24,11 +24,10 @@ files:
 - lib/num_words.rb
 - lib/num_words/converter.rb
 - lib/num_words/version.rb
-- num_words-0.1.0.gem
-- num_words-0.2.0.gem
 - sig/num_words.rbs
 homepage: https://github.com/mrmalvi/num_words
-licenses: []
+licenses:
+- MIT
 metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/mrmalvi/num_words