num_words 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92bd9503909fd6d11da13baeccbe68e60c86505d1cb9aabc057ca704c962af4b
-  data.tar.gz: db689f477ab8a791fc8c09a648407b2edb3a2fa954a780034b6c5d1e2218fe10
+  metadata.gz: dcb338b276c0afbc161d4ede15bb75c6f64fd279be42066ecabb9c2c986be10c
+  data.tar.gz: 60b8112d1ad8729eb652d7acd893b1cd1e5aa83b5ac31a200ff8df06ca83a4a8
 SHA512:
-  metadata.gz: 98db3a1bcf32c42384c53cd990c83e37c22d1a0bb47ad91beecf0b96009051405e18c72cec3a35ec71de49bdd127aca44cf41fa2d34c78fdae5a6acbb82bde7d
-  data.tar.gz: 7df9d662a74480d9ae3f1b41a1153d5700726cf19f4f6572cf8e93c2224f4e90ab3f6490dd1411d70f339333cf09dd70dbc05795d4d773685a4a9e9ad521e992
+  metadata.gz: e12980e8da746190aa011b645978741ac7c7dbc2ce5c9dc91c8fa6ebae3ca4dd57d25b81295d3d28294fc417e7ca0dc3536e45cead806363fcc62122c633442b
+  data.tar.gz: 42dc76855150a5c44fa7cce78d6fa401ec4e161ee6808642dfded60919d65b5ec01bee2b939b288f37ac5dd16948c556b5f79a8f7d5f9cd8af2536c58f580e5f

data/README.md

@@ -1,36 +1,31 @@
 # NumWords
 
-TODO: Delete this and the text below, and describe your gem
+**NumWords** is a Ruby gem that converts numbers into words in multiple numbering systems, including US, European, UK, French, and Indian. It supports both integer and decimal numbers and is useful for invoices, financial documents, or any application that requires converting numeric values into readable text.
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/num_words`. To experiment with that code, run `bin/console` for an interactive prompt.
+---
 
-## Installation
-
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
-
-Install the gem and add to the application's Gemfile by executing:
-
-```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
-```
+## Features
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+- 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`
+- Easy to integrate into Ruby or Rails applications.
+- Supports numbers up to `duovigintillion` (10^69) in the American system.
 
-```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
-```
-
-## Usage
-
-TODO: Write usage instructions here
+---
 
-## Development
+## Installation
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+### Using RubyGems
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+After releasing your gem to [RubyGems.org](https://rubygems.org), install it with:
 
-## Contributing
+```bash
+# Using Bundler
+bundle add num_words
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/num_words.
-# num_words
+bundle add num_words

data/lib/num_words/converter.rb

@@ -2,70 +2,69 @@
 # 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 words ---
+  ONES_HI = %w[शून्य एक दो तीन चार पाँच छह सात आठ नौ दस ग्यारह बारह तेरह चौदह पंद्रह सोलह सत्रह अठारह उन्नीस].freeze
+  TENS_HI = %w[शून्य दस बीस तीस चालीस पचास साठ सत्तर अस्सी नब्बे].freeze
+  INDIAN_UNITS_HI = ['', 'हज़ार', 'लाख', 'करोड़', 'अरब', 'खरब'].freeze
+
+  # --- English exponents ---
   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'
+    27 => 'octillion', 30 => 'nonillion', 33 => 'decillion', 36 => 'undecillion'
   }.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'
-  }.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
+    # Main method: convert number to words
+    # language: :en or :hi
+    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
-      to_words_generic(val, exp_hash, include_and)
+      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
+
+      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)
+    # Indian system (supports English & Hindi)
+    def to_words_indian(num, language: :en)
       integer_part, decimal_part = num.to_s.split('.')
-      integer_words = indian_units_to_words(integer_part.to_i)
+      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) }.join(' ')
+      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)
+    def to_words_generic(val, exp_hash, include_and, ones_array, tens_array)
       chunks = []
       while val.positive?
         chunks << val % 1000
@@ -75,55 +74,62 @@ 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 == ONES_HI ? 'सौ' : 'hundred'}"
         val %= 100
-        words << 'and' if val.positive? && include_and
+        words << 'and' if val.positive? && include_and && ones_array != ONES_HI
       end
 
-      words << TENS[val / 10] if val >= 20
+      words << tens_array[val / 10] if val >= 20
       val %= 10 if val >= 20
-      words << ONES[val] if val.positive?
+      words << ones_array[val] if val.positive?
       words.join(' ').strip
     end
 
-    def indian_units_to_words(num)
+    def indian_units_to_words(num, ones_array, tens_array, units)
       num = num.to_i
-      return 'zero' if num.zero?
+      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)} #{INDIAN_UNITS[unit_index]}".strip) if remainder.positive?
+        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)
-      num = num.to_i
-      return ONES[num] if num < 20
-      return "#{ONES[num / 100]} hundred" if num >= 100 && (num % 100).zero?
+    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?
 
-      if num < 100
-        "#{TENS[num / 10]} #{ONES[num % 10]}".strip
-      else
-        "#{ONES[num / 100]} hundred and #{sub_thousand_to_words(num % 100)}"
+      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
       end
+
+      words << ones_array[num] if num.positive?
+      words.join(' ').strip
     end
   end
 end

data/lib/num_words/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: num_words
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - mrmalvi
@@ -24,10 +24,10 @@ files:
 - lib/num_words.rb
 - lib/num_words/converter.rb
 - lib/num_words/version.rb
-- num_words-0.1.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
@@ -39,7 +39,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="