numbertotext-ruby 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 648a8f9b8f448c41208dd6d36fc8f5bfb8091a3e
+  data.tar.gz: eb8736bdf21bee2b440ca7b437e17d2543e631a6
+SHA512:
+  metadata.gz: 35e4b388284ee17913ea084bcf03254569b04cabb1876f1d84c0860b1b48588b3045cb268de6d76d3e6aa837556c655f13dd3db82c8b0593a7ccb65cdecaa7c8
+  data.tar.gz: abd1ad9003ae0ca4d7503ee9b79aae0145edfd5f40abf1f6a787ff4045d97a6ad1f5db1d61aa2b97437e56edb8abbc7b8d2613e6d3bbc0aafaaedb0c05f6515f

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+group :test do
+  gem 'rake', '~> 10.1'
+  gem 'rspec', '~> 3.0'
+end
+
+group :development do
+	gem 'guard-rspec', require: false
+end

data/Gemfile.lock

@@ -0,0 +1,68 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    celluloid (0.16.0)
+      timers (~> 4.0.0)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    ffi (1.9.8)
+    formatador (0.2.5)
+    guard (2.12.5)
+      formatador (>= 0.2.4)
+      listen (~> 2.7)
+      lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.5.1)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    hitimes (1.2.2)
+    listen (2.10.0)
+      celluloid (~> 0.16.0)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.9)
+    method_source (0.8.2)
+    nenv (0.2.0)
+    notiffany (0.0.6)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rake (10.4.2)
+    rb-fsevent (0.9.5)
+    rb-inotify (0.9.5)
+      ffi (>= 0.5.0)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.2)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    shellany (0.0.1)
+    slop (3.6.0)
+    thor (0.19.1)
+    timers (4.0.1)
+      hitimes
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  guard-rspec
+  rake (~> 10.1)
+  rspec (~> 3.0)

data/Guardfile

@@ -0,0 +1,5 @@
+guard :rspec, cmd: 'rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/README.md

@@ -0,0 +1,24 @@
+# NumberToText
+A Ruby gem for converting numbers to their text equivalent (e.g. 1000 = One Thousand). The limit of the converter 999999999999 but can be easily extended to convert larger numbers.
+
+## Installation
+Add this line to your application's Gemfile:
+
+    gem 'numbertotext-ruby'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install numbertotext-ruby
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/lib/numbertotext/version.rb

@@ -0,0 +1,3 @@
+module NumberToText
+  VERSION = "1.0.0"
+end

data/lib/numbertotext.rb

@@ -0,0 +1,48 @@
+require 'numbertotext/version' unless defined?(NumberToText::VERSION)
+
+module NumberToText
+
+  @dictionary1 =['zero','one','two','three','four','five','six','seven','eight','nine','ten',
+                 'eleven','twelve','thirteen','fourteen','fifteen','sixteen','seventeen','eighteen','nineteen']
+
+  @dictionary2 = ['zero','ten','twenty','thirty','fourty','fifty','sixty','seventy','eighty','ninety']
+
+  #generic convert: uses recursion to convert numbers above 100
+  private
+  def self.generic_convert(number,multiple,text)
+    whole = number / multiple
+    remainder = number - whole * multiple
+    return convert(whole) + ' ' + text if remainder == 0
+    return convert(whole) + ' ' + text + ' and ' + convert(remainder) if (remainder < 100 && remainder > 0)
+    return convert(whole) + ' ' + text + ', ' + convert(remainder) if remainder > 99
+  end
+
+  #special case for 20 to 99: requires lookup on dictionary two and numbers are formatted with a hyphen in the middle. also uses recursion to convert remainder
+  private
+  def self.convert_20_to_99(number)
+    tens = number / 10
+    remainder = number - tens * 10
+    return @dictionary2[tens] if remainder == 0
+    return @dictionary2[tens] + '-' + convert(remainder) if remainder > 0
+  end
+
+
+  def self.convert(number)
+    if number < 20
+      return @dictionary1[number]
+    elsif number < 100 && number > 19
+      convert_20_to_99(number)
+    elsif number < 1000 && number > 99
+      return generic_convert(number,100,'hundred')
+    elsif number < 1000000 && number > 999
+      return generic_convert(number,1000,'thousand')
+    elsif number < 1000000000 && number > 999999
+      return generic_convert(number,1000000,'million')
+    elsif number < 1000000000000 && number > 999999999
+      return generic_convert(number,1000000000,'billion')
+    else
+      return 'number too large. please try with a number lower than or equal to 999999999999'
+    end
+  end
+
+end

data/numbertotext.gemspec

@@ -0,0 +1,19 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'numbertotext/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'numbertotext-ruby'
+  spec.version       = NumberToText::VERSION
+  spec.authors       = ['Edem Kumodzi']
+  spec.email         = ['edem@kumodzi.com']
+  spec.summary       = 'A simple library for converting numbers to their text equivalent (e.g. 1000 = One Thousand)'
+  spec.description   = 'A simple library for converting numbers to their text equivalent (e.g. 1000 = One Thousand)'
+  spec.homepage      = 'https://github.com/edemkumodzi/numbertotext-ruby'
+  spec.license       = 'MIT'
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+  spec.required_ruby_version = '>= 1.9.3'
+end

data/spec/lib/numbertotext_spec.rb

@@ -0,0 +1,152 @@
+require 'spec_helper'
+
+describe NumberToText do
+
+  it 'should convert 0 to 20 to equivalent text' do
+    ntt = NumberToText
+    actual = [ntt.convert(0),ntt.convert(1),ntt.convert(2),ntt.convert(3),ntt.convert(4),ntt.convert(5),
+              ntt.convert(6),ntt.convert(7),ntt.convert(8),ntt.convert(9),ntt.convert(10),
+              ntt.convert(11),ntt.convert(12),ntt.convert(13),ntt.convert(14),ntt.convert(15),
+              ntt.convert(16),ntt.convert(17),ntt.convert(18),ntt.convert(19)]
+
+    expected = ['zero','one','two','three','four','five',
+                'six','seven','eight','nine','ten',
+                'eleven','twelve','thirteen','fourteen','fifteen',
+                'sixteen','seventeen','eighteen','nineteen']
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 20' do
+    actual = NumberToText.convert(20)
+    expected = 'twenty'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 21' do
+    actual = NumberToText.convert(21)
+    expected = 'twenty-one'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 30' do
+    actual = NumberToText.convert(30)
+    expected = 'thirty'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 37' do
+    actual = NumberToText.convert(37)
+    expected = 'thirty-seven'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 40' do
+    actual = NumberToText.convert(40)
+    expected = 'fourty'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 49' do
+    actual = NumberToText.convert(49)
+    expected = 'fourty-nine'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 100' do
+    actual = NumberToText.convert(100)
+    expected = 'one hundred'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 101' do
+    actual = NumberToText.convert(101)
+    expected = 'one hundred and one'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 121' do
+    actual = NumberToText.convert(121)
+    expected = 'one hundred and twenty-one'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 999' do
+    actual = NumberToText.convert(999)
+    expected = 'nine hundred and ninety-nine'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 1000' do
+    actual = NumberToText.convert(1000)
+    expected = 'one thousand'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 1021' do
+    actual = NumberToText.convert(1021)
+    expected = 'one thousand and twenty-one'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 1135' do
+    actual = NumberToText.convert(1135)
+    expected = 'one thousand, one hundred and thirty-five'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 9999' do
+    actual = NumberToText.convert(9999)
+    expected = 'nine thousand, nine hundred and ninety-nine'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 999999' do
+    actual = NumberToText.convert(999999)
+    expected = 'nine hundred and ninety-nine thousand, nine hundred and ninety-nine'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 1000000' do
+    actual = NumberToText.convert(1000000)
+    expected = 'one million'
+    expect(actual).to eq(expected)
+  end
+
+
+  it 'should convert 1000001' do
+    actual = NumberToText.convert(1000001)
+    expected = 'one million and one'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 999999999' do
+    actual = NumberToText.convert(999999999)
+    expected = 'nine hundred and ninety-nine million, nine hundred and ninety-nine thousand, nine hundred and ninety-nine'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 1000000000' do
+    actual = NumberToText.convert(1000000000)
+    expected = 'one billion'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 1000000001' do
+    actual = NumberToText.convert(1000000001)
+    expected = 'one billion and one'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should convert 1000000001' do
+    actual = NumberToText.convert(1000000001)
+    expected = 'one billion and one'
+    expect(actual).to eq(expected)
+  end
+
+  it 'should not convert above 999999999999' do
+    actual = NumberToText.convert(9999999999999)
+    expected = 'number too large. please try with a number lower than or equal to 999999999999'
+    expect(actual).to eq(expected)
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'bundler'
+Bundler.setup
+
+require 'numbertotext'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: numbertotext-ruby
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Edem Kumodzi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-21 00:00:00.000000000 Z
+dependencies: []
+description: A simple library for converting numbers to their text equivalent (e.g.
+  1000 = One Thousand)
+email:
+- edem@kumodzi.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- README.md
+- lib/numbertotext.rb
+- lib/numbertotext/version.rb
+- numbertotext.gemspec
+- spec/lib/numbertotext_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/edemkumodzi/numbertotext-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.1
+signing_key: 
+specification_version: 4
+summary: A simple library for converting numbers to their text equivalent (e.g. 1000
+  = One Thousand)
+test_files:
+- spec/lib/numbertotext_spec.rb
+- spec/spec_helper.rb