ada_numbers 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 687cb405cfb56c733e1f7744a14999e22bc15ef11ae93c3163522c2a1dbe2e0f
+  data.tar.gz: 6324a7fe749ed13b5589ce8c180758ff46415f1427981ea10ac49c3a12506e6e
+SHA512:
+  metadata.gz: a3be0a5c634712132d807f58524629ce698a74447745394380ff082aec034cb95cb1466859f62b826068a971e583fe941046d0ddec091b9a1ebcf1570ec3299d
+  data.tar.gz: 9b6d9d02c84bd66f179bdf6002c65fd8bcb21d8cf816034ddb74fb91c4f7544062f63b655b5e8430fb90c6dd383bc6338a72c93ff451062f607b15c9122071fc

data/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

data/.idea/ada_numbers.iml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="rbenv: 2.7.7" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.1.4, rbenv: 2.7.7) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest (v5.18.0, rbenv: 2.7.7) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v12.3.3, rbenv: 2.7.7) [gem]" level="application" />
+  </component>
+  <component name="RakeTasksCache">
+    <option name="myRootTask">
+      <RakeTaskImpl id="rake">
+        <subtasks>
+          <RakeTaskImpl description="Build ada_numbers-0.1.0.gem into the pkg directory" fullCommand="build" id="build" />
+          <RakeTaskImpl description="Remove any temporary products" fullCommand="clean" id="clean" />
+          <RakeTaskImpl description="Remove any generated files" fullCommand="clobber" id="clobber" />
+          <RakeTaskImpl description="Build and install ada_numbers-0.1.0.gem into system gems" fullCommand="install" id="install" />
+          <RakeTaskImpl id="install">
+            <subtasks>
+              <RakeTaskImpl description="Build and install ada_numbers-0.1.0.gem into system gems without network access" fullCommand="install:local" id="local" />
+            </subtasks>
+          </RakeTaskImpl>
+          <RakeTaskImpl description="Create tag v0.1.0 and build and push ada_numbers-0.1.0.gem to rubygems.org" fullCommand="release[remote]" id="release[remote]" />
+          <RakeTaskImpl description="Run tests" fullCommand="test" id="test" />
+          <RakeTaskImpl description="" fullCommand="default" id="default" />
+          <RakeTaskImpl description="" fullCommand="release" id="release" />
+          <RakeTaskImpl id="release">
+            <subtasks>
+              <RakeTaskImpl description="" fullCommand="release:guard_clean" id="guard_clean" />
+              <RakeTaskImpl description="" fullCommand="release:rubygem_push" id="rubygem_push" />
+              <RakeTaskImpl description="" fullCommand="release:source_control_push" id="source_control_push" />
+            </subtasks>
+          </RakeTaskImpl>
+        </subtasks>
+      </RakeTaskImpl>
+    </option>
+  </component>
+</module>

data/.idea/modules.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/ada_numbers.iml" filepath="$PROJECT_DIR$/.idea/ada_numbers.iml" />
+      <module fileurl="file://$PROJECT_DIR$/../.idea/ada_numbers_gem.iml" filepath="$PROJECT_DIR$/../.idea/ada_numbers_gem.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+  </component>
+</project>

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in ada_numbers.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "minitest", "~> 5.0"

data/Gemfile.lock

@@ -0,0 +1,21 @@
+PATH
+  remote: .
+  specs:
+    ada_numbers (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    minitest (5.18.0)
+    rake (12.3.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  ada_numbers!
+  minitest (~> 5.0)
+  rake (~> 12.0)
+
+BUNDLED WITH
+   2.1.4

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/ada_numbers.gemspec

@@ -0,0 +1,30 @@
+require_relative 'lib/ada_numbers/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ada_numbers"
+  spec.version       = AdaNumbers::VERSION
+  spec.authors       = ["Roberto W. P. Ribeiro"]
+  spec.email         = ["rober.will@hotmail.com"]
+
+  spec.summary       = %q{It converts a number to its equivalent in written words,
+    i.e. 123 to "cento e vinte três" or to "one hundred and twenty-three", and vice versa.}
+  spec.description   = %q{It converts a number to its equivalent in written words,
+    i.e. 123 to "cento e vinte três" or to "one hundred and twenty-three", and vice versa.}
+  spec.homepage      = "https://github.com/roberwil/ada_numbers_gem"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/roberwil/ada_numbers_gem"
+  spec.metadata["changelog_uri"] = "https://github.com/roberwil/ada_numbers_gem/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  spec.license       = "MIT"
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "ada_numbers"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/ada_numbers/constants/en/separators.rb

@@ -0,0 +1,11 @@
+module AdaNumbers
+  module Separator
+    class En
+      NUMBERS_SEPARATOR                = "And"
+      DECIMAL_SEPARATOR                = "Point"
+      DECIMAL_SEPARATOR_ALTERNATIVE    = "Comma"
+      COMMA                            = ","
+      DASH                             = "-"
+    end
+  end
+end

data/lib/ada_numbers/constants/en/written_numbers.rb

@@ -0,0 +1,113 @@
+module AdaNumbers
+  module WrittenNumber
+    class En
+      ZERO               = "Zero"
+      ONE                = "One"
+      TWO                = "Two"
+      THREE              = "Three"
+      FOUR               = "Four"
+      FIVE               = "Five"
+      SIX                = "Six"
+      SEVEN              = "Seven"
+      EIGHT              = "Eight"
+      NINE               = "Nine"
+      TEN                = "Ten"
+      ELEVEN             = "Eleven"
+      TWELVE             = "Twelve"
+      THIRTEEN           = "Thirteen"
+      FOURTEEN           = "Fourteen"
+      FIFTEEN            = "Fifteen"
+      SIXTEEN            = "Sixteen"
+      SEVENTEEN          = "Seventeen"
+      EIGHTEEN           = "Eighteen"
+      NINETEEN           = "Nineteen"
+      TWENTY             = "Twenty"
+      THIRTY             = "Thirty"
+      FORTY              = "Forty"
+      FIFTY              = "Fifty"
+      SIXTY              = "Sixty"
+      SEVENTY            = "Seventy"
+      EIGHTY             = "Eighty"
+      NINETY             = "Ninety"
+      HUNDRED            = "Hundred"
+      THOUSAND           = "Thousand"
+      MILLION            = "Million"
+      THOUSAND_MILLION   = "Thousand Million"
+      BILLION            = "Billion"
+      TRILLION           = "Trillion"
+
+      @@numbers_that_ignore_separator = [
+        HUNDRED, THOUSAND, MILLION,
+        THOUSAND_MILLION, BILLION, TRILLION
+      ]
+
+      def self.numbers_that_ignore_separator; @@numbers_that_ignore_separator; end
+
+      @@unities_that_combine_with_separator = [
+        TWENTY, THIRTY, FORTY, FIFTY,
+        SIXTY, SEVENTY, EIGHTY, NINETY
+      ]
+
+      def self.unities_that_combine_with_separator; @@unities_that_combine_with_separator; end
+
+      @@words_to_number_map = {
+        ZERO     => 0,  ONE     => 1,  TWO       => 2,  THREE    => 3,   FOUR     => 4,
+        FIVE     => 5,  SIX     => 6,  SEVEN     => 7,  EIGHT    => 8,   NINE     => 9,
+        TEN      => 10, ELEVEN  => 11, TWELVE    => 12, THIRTEEN => 13,  FOURTEEN => 14,
+        FIFTEEN  => 15, SIXTEEN => 16, SEVENTEEN => 17, EIGHTEEN => 18,  NINETEEN => 19,
+        TWENTY   => 20, THIRTY  => 30, FORTY     => 40, FIFTY    => 50,  SIXTY    => 60,
+        SEVENTY  => 70, EIGHTY  => 80, NINETY    => 90, HUNDRED  => 100, THOUSAND => 1e3.to_i,
+        MILLION  => 1e6.to_i
+      }
+
+      def self.words_to_number_map; @@words_to_number_map; end
+
+      @@words_to_number_unities_and_tens_map = {
+        ZERO     => 0,  ONE     => 1,  TWO       => 2,  THREE    => 3,   FOUR     => 4,
+        FIVE     => 5,  SIX     => 6,  SEVEN     => 7,  EIGHT    => 8,   NINE     => 9,
+        TEN      => 10, ELEVEN  => 11, TWELVE    => 12, THIRTEEN => 13,  FOURTEEN => 14,
+        FIFTEEN  => 15, SIXTEEN => 16, SEVENTEEN => 17, EIGHTEEN => 18,  NINETEEN => 19,
+        TWENTY   => 20, THIRTY  => 30, FORTY     => 40, FIFTY    => 50,  SIXTY    => 60,
+        SEVENTY  => 70, EIGHTY  => 80, NINETY    => 90
+      }
+
+      def self.words_to_number_unities_and_tens_map; @@words_to_number_unities_and_tens_map; end
+
+      @@words_to_number_map_long_scale = {
+        THOUSAND_MILLION => 1e9.to_i,
+        BILLION          => 1e12.to_i
+      }
+
+      def self.words_to_number_map_long_scale; @@words_to_number_map_long_scale; end
+
+      @@words_to_number_map_short_scale = {
+        BILLION  => 1e9.to_i,
+        TRILLION => 1e12.to_i
+      }
+
+      def self.words_to_number_map_short_scale; @@words_to_number_map_short_scale; end
+
+      @@not_to_combine_with_thousand = [
+        MILLION, BILLION, TRILLION
+      ]
+
+      def self.not_to_combine_with_thousand; @@not_to_combine_with_thousand; end
+
+      @@numbers_to_words_map_unities = {
+        0 => ZERO, 1 => ONE, 2 => TWO  , 3 => THREE, 4 => FOUR,
+        5 => FIVE, 6 => SIX, 7 => SEVEN, 8 => EIGHT, 9 => NINE
+      }
+
+      def self.numbers_to_words_map_unities; @@numbers_to_words_map_unities; end
+
+      @@numbers_to_words_map_tens = {
+        10 => TEN    , 11 => ELEVEN , 12 => TWELVE   , 13 => THIRTEEN, 14 => FOURTEEN,
+        15 => FIFTEEN, 16 => SIXTEEN, 17 => SEVENTEEN, 18 => EIGHTEEN, 19 => NINETEEN,
+        20 => TWENTY , 30 => THIRTY , 40 => FORTY    , 50 => FIFTY   , 60 => SIXTY   ,
+        70 => SEVENTY, 80 => EIGHTY , 90 => NINETY
+      }
+
+      def self.numbers_to_words_map_tens; @@numbers_to_words_map_tens; end
+    end
+  end
+end

data/lib/ada_numbers/constants/message.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module AdaNumbers
+  class Message
+    UNSUPPORTED    = "Unsupported"
+    INVALID_NUMBER = "Invalid Number"
+  end
+end

data/lib/ada_numbers/constants/pt/separators.rb

@@ -0,0 +1,9 @@
+module AdaNumbers
+  module Separator
+    class Pt
+      NUMBERS_SEPARATOR              = "E"
+      DECIMAL_SEPARATOR              = "Vírgula"
+      DECIMAL_SEPARATOR_ALTERNATIVE  = "Ponto"
+    end
+  end
+end

data/lib/ada_numbers/constants/pt/written_numbers.rb

@@ -0,0 +1,116 @@
+module AdaNumbers
+  module WrittenNumber
+    class Pt
+      ZERO                = "Zero"
+      ONE                 = "Um"
+      TWO                 = "Dois"
+      THREE               = "Três"
+      FOUR                = "Quatro"
+      FIVE                = "Cinco"
+      SIX                 = "Seis"
+      SEVEN               = "Sete"
+      EIGHT               = "Oito"
+      NINE                = "Nove"
+      TEN                 = "Dez"
+      ELEVEN              = "Onze"
+      TWELVE              = "Doze"
+      THIRTEEN            = "Treze"
+      FOURTEEN            = "Catorze"
+      FIFTEEN             = "Quinze"
+      SIXTEEN             = "Dezasseis"
+      SEVENTEEN           = "Dezassete"
+      EIGHTEEN            = "Dezoito"
+      NINETEEN            = "Dezanove"
+      TWENTY              = "Vinte"
+      THIRTY              = "Trinta"
+      FORTY               = "Quarenta"
+      FIFTY               = "Cinquenta"
+      SIXTY               = "Sessenta"
+      SEVENTY             = "Setenta"
+      EIGHTY              = "Oitenta"
+      NINETY              = "Noventa"
+      ONE_HUNDRED_SINGLE  = "Cem"
+      ONE_HUNDRED         = "Cento"
+      TWO_HUNDRED         = "Duzentos"
+      THREE_HUNDRED       = "Trezentos"
+      FOUR_HUNDRED        = "Quatrocentos"
+      FIVE_HUNDRED        = "Quinhentos"
+      SIX_HUNDRED         = "Seiscentos"
+      SEVEN_HUNDRED       = "Setecentos"
+      EIGHT_HUNDRED       = "Oitocentos"
+      NINE_HUNDRED        = "Novecentos"
+      THOUSAND            = "Mil"
+      MILLION_SINGULAR    = "Um Milhão"
+      MILLION_PLURAL      = "Milhões"
+      THOUSAND_MILLION    = "Mil Milhões"
+      BILLION_SINGULAR    = "Um Bilião"
+      BILLION_PLURAL      = "Biliões"
+      TRILLION_SINGULAR   = "Um Trilião"
+      TRILLION_PLURAL     = "Triliões"
+
+      @@numbers_that_ignore_separator = [
+        ONE_HUNDRED, TWO_HUNDRED, THREE_HUNDRED, FOUR_HUNDRED, FIVE_HUNDRED,
+        SIX_HUNDRED, SEVEN_HUNDRED, EIGHT_HUNDRED, NINE_HUNDRED, THOUSAND,
+        MILLION_SINGULAR, MILLION_PLURAL, THOUSAND_MILLION, BILLION_SINGULAR,
+        BILLION_PLURAL, TRILLION_SINGULAR, TRILLION_PLURAL
+      ]
+
+      def self.numbers_that_ignore_separator; @@numbers_that_ignore_separator; end
+
+      @@words_to_number_map = {
+        ZERO           => 0,   ONE                => 1,   TWO          => 2,        THREE             => 3,
+        FOUR           => 4,   FIVE               => 5,   SIX          => 6,        SEVEN             => 7,
+        EIGHT          => 8,   NINE               => 9,   TEN          => 10,       ELEVEN            => 11,
+        TWELVE         => 12,  THIRTEEN           => 13,  FOURTEEN     => 14,       FIFTEEN           => 15,
+        SIXTEEN        => 16,  SEVENTEEN          => 17,  EIGHTEEN     => 18,       NINETEEN          => 19,
+        TWENTY         => 20,  THIRTY             => 30,  FORTY        => 40,       FIFTY             => 50,
+        SIXTY          => 60,  SEVENTY            => 70,  EIGHTY       => 80,       NINETY            => 90,
+        ONE_HUNDRED    => 100, ONE_HUNDRED_SINGLE => 100, TWO_HUNDRED  => 200,      THREE_HUNDRED     => 300,
+        FOUR_HUNDRED   => 400, FIVE_HUNDRED       => 500, SIX_HUNDRED  => 600,      SEVEN_HUNDRED     => 700,
+        EIGHT_HUNDRED  => 800, NINE_HUNDRED       => 900, THOUSAND     => 1e3.to_i, MILLION_SINGULAR  => 1e6.to_i,
+        MILLION_PLURAL => 1e6.to_i
+      }
+
+      def self.words_to_number_map; @@words_to_number_map; end
+
+      @@words_to_number_map_long_scale = {
+        THOUSAND_MILLION => 1e9.to_i,
+        BILLION_SINGULAR => 1e12.to_i,
+        BILLION_PLURAL   => 1e12.to_i
+      }
+
+      def self.words_to_number_map_long_scale; @@words_to_number_map_long_scale; end
+
+      @@words_to_number_map_short_scale = {
+        BILLION_SINGULAR  => 1e9.to_i,
+        BILLION_PLURAL    => 1e9.to_i,
+        TRILLION_SINGULAR => 1e12.to_i,
+        TRILLION_PLURAL   => 1e12.to_i
+      }
+
+      def self.words_to_number_map_short_scale; @@words_to_number_map_short_scale; end
+
+      @@not_to_combine_with_thousand = [
+        MILLION_SINGULAR, BILLION_PLURAL, TRILLION_PLURAL
+      ]
+
+      def self.not_to_combine_with_thousand; @@not_to_combine_with_thousand; end
+
+      @@numbers_to_words_map_unities = {
+        0 => ZERO, 1 => ONE, 2 => TWO  , 3 => THREE, 4 => FOUR,
+        5 => FIVE, 6 => SIX, 7 => SEVEN, 8 => EIGHT, 9 => NINE
+      }
+
+      def self.numbers_to_words_map_unities; @@numbers_to_words_map_unities; end
+
+      @@numbers_to_words_map_tens = {
+        10 => TEN    , 11 => ELEVEN , 12 => TWELVE   , 13 => THIRTEEN, 14 => FOURTEEN,
+        15 => FIFTEEN, 16 => SIXTEEN, 17 => SEVENTEEN, 18 => EIGHTEEN, 19 => NINETEEN,
+        20 => TWENTY , 30 => THIRTY , 40 => FORTY    , 50 => FIFTY   , 60 => SIXTY   ,
+        70 => SEVENTY, 80 => EIGHTY , 90 => NINETY
+      }
+
+      def self.numbers_to_words_map_tens; @@numbers_to_words_map_tens; end
+    end
+  end
+end

data/lib/ada_numbers/converters/en/number_to_words_converter.rb

@@ -0,0 +1,185 @@
+require_relative '../../utilities/integer_extensions'
+require_relative '../../utilities/hash_extensions'
+require_relative '../../utilities/settings'
+require_relative '../../utilities/number_category'
+
+require_relative '../../constants/en/written_numbers'
+require_relative '../../constants/en/separators'
+require_relative '../../constants/message'
+
+module AdaNumbers
+  module NumberToWordsConverter
+    class En
+      @@use_short_scale = false
+      @@number_tokens = []
+
+      def self.convert(number)
+        return convert_integer(number) if number.class == Integer
+        return convert_float(number)
+      end
+
+      private
+
+      def self.convert_integer(number)
+        return Message::UNSUPPORTED if number.number_of_digits > Settings::Parameters::DIGITS_LIMIT
+
+        select_scale
+        @@number_tokens.clear
+        return resolve_number number
+      end
+
+      def self.convert_float(number)
+        select_scale
+
+        str_number = number.to_s.split '.'
+
+        str_integer_part = str_number.first
+        str_decimal_part = str_number.size == 1 ? "0" : str_number.last
+
+        return Message::UNSUPPORTED if str_integer_part.size > Settings::Parameters::DIGITS_LIMIT || str_decimal_part.size > Settings::Parameters::DIGITS_LIMIT
+
+        whole_part = str_integer_part.to_i
+        decimal_part = str_decimal_part.to_i
+
+        @@number_tokens.clear
+        result = resolve_number whole_part
+
+        return result if decimal_part == 0
+
+        result += " #{Separator::En::DECIMAL_SEPARATOR.downcase} "
+        # just aggregating the zeros
+        result += str_decimal_part.split('').
+          take_while { |c| c == "0" }.
+          collect { |c| WrittenNumber::En::ZERO }.
+          join ' '
+
+        @@number_tokens.clear
+        result += result[-1] == ' ' ? resolve_number(decimal_part) :
+                    " #{resolve_number(decimal_part)}"
+
+        return result
+      end
+
+      def self.select_scale
+        @@use_short_scale = Settings.scale == Settings::Parameters::SCALES[:short]
+      end
+
+      def self.resolve_number(number)
+        result = ''
+        number_category = number.category
+
+        case number_category
+        when NumberCategory::UNITY
+          result = unities number
+        when NumberCategory::TEN
+          result = tens number
+        when NumberCategory::HUNDRED
+          result = hundreds number
+        when NumberCategory::THOUSAND
+          result = thousands number
+        when NumberCategory::MILLION
+          result = millions number
+        when NumberCategory::THOUSAND_MILLIONS
+          result = thousand_millions number
+        when NumberCategory::BILLION
+          result = billions number
+        end
+
+        if result.empty?
+          str_number = number.to_s
+          bridge = number.bridge
+
+          first_digits = (str_number[0...bridge] + '0' * number_category).to_i
+          other_digits = (str_number[bridge..-1]).to_i
+
+          resolve_number first_digits
+          resolve_number other_digits
+        else
+          @@number_tokens << result
+        end
+
+        add_separators_to_number @@number_tokens
+      end
+
+      def self.unity_or_ten?(number)
+        result = !WrittenNumber::En.words_to_number_unities_and_tens_map.resolve(number).nil?
+        result ? result : number.include?(Separator::En::DASH)
+      end
+
+      def self.add_separators_to_number(number_tokens)
+        result = number_tokens.first
+
+        (1...number_tokens.size).each do |cursor|
+          current_token = number_tokens[cursor]
+
+          is_hundred = cursor + 1 < number_tokens.size && unity_or_ten?(current_token) &&
+             (number_tokens[cursor + 1] == WrittenNumber::En::HUNDRED ||
+              number_tokens[cursor + 1] == WrittenNumber::En::THOUSAND ||
+              number_tokens[cursor + 1] == WrittenNumber::En::MILLION ||
+              number_tokens[cursor + 1] == WrittenNumber::En::THOUSAND_MILLION ||
+              number_tokens[cursor + 1] == WrittenNumber::En::BILLION ||
+              number_tokens[cursor + 1] == WrittenNumber::En::TRILLION)
+
+          add_comma = cursor > 1 && is_hundred
+          no_separator = WrittenNumber::En.numbers_that_ignore_separator.include?(current_token) || is_hundred
+
+          if (add_comma)
+            result += "#{Separator::En::COMMA} #{current_token}"
+          elsif no_separator
+            result += " #{current_token}"
+          else
+            result += " #{Separator::En::NUMBERS_SEPARATOR.downcase} #{current_token}"
+          end
+        end
+
+        return result
+      end
+
+      def self.unities(number)
+        WrittenNumber::En.numbers_to_words_map_unities.resolve number
+      end
+
+      def self.tens(number)
+        result = WrittenNumber::En.numbers_to_words_map_tens.resolve number
+        return result if result != ''
+
+        bridge = number.bridge
+        ten = number.to_s[0...bridge].to_i * 10
+        unity = number.to_s[bridge..-1].to_i
+
+        result = "#{tens(ten)}#{Separator::En::DASH}#{unities(unity).downcase}"
+        result
+      end
+
+      def self.hundreds(number)
+        evaluate_hundreds_and_over number, 1e2.to_i, WrittenNumber::En::HUNDRED
+      end
+
+      def self.thousands(number)
+        evaluate_hundreds_and_over number, 1e3.to_i, WrittenNumber::En::THOUSAND
+      end
+
+      def self.millions(number)
+        evaluate_hundreds_and_over number, 1e6.to_i, WrittenNumber::En::MILLION
+      end
+
+      def self.thousand_millions(number)
+        qualifier = (@@use_short_scale ? WrittenNumber::En::BILLION : WrittenNumber::En::THOUSAND_MILLION)
+        evaluate_hundreds_and_over number, 1e9.to_i, qualifier
+      end
+
+      def self.billions(number)
+        qualifier = (@@use_short_scale ? WrittenNumber::En::TRILLION : WrittenNumber::En::BILLION)
+        evaluate_hundreds_and_over number, 1e12.to_i, qualifier
+      end
+
+      def self.evaluate_hundreds_and_over(number, category_identifier, qualifier)
+        return '' if number % category_identifier != 0
+
+        partial_number = number.to_s[0...number.bridge].to_i
+        resolve_number partial_number
+        return qualifier
+      end
+    end
+  end
+end