RubyChangeMaker 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 88d8521b4ce52d0023993f6949292c1d870eadc6
-  data.tar.gz: d70cc3443ed712cdc6d0d195813f7c5e13b26a6a
+  metadata.gz: abaa5fb7db490527ab2cdf91b1a34a2dfb02ef3a
+  data.tar.gz: 5c3e4814bef2505a40fa82da405bfb2b7b04aaec
 SHA512:
-  metadata.gz: b3475c2dd2a50032373a06c8de15c05d1c999e5b130324578f86226d64adceeafc65d4813b8faec0b635fdc33c118795048e4b87b16ad983b326fa98f61ca12f
-  data.tar.gz: 0a23f0493fbe343e55e7492bab84d3dcb9d75bf705b83c87622bd12a2b86a705c7b4cfe7348a23b4e139c9aa2eb114c0bc35425713a1e3d3b6002b1f350d54e9
+  metadata.gz: fd06b179941a8d7990a9c7eb0beedcf81fcefe74e510f32488bba9d9e645f59028892eb293b821d57fdeb60b323f18e1f4f879f7f233ec9ac2f3fa84b360b58d
+  data.tar.gz: 26e0e61c8a11a3207caa66e559b2fbcdf8277f63f1192855d662391a1ba8ce46a2e8dc0d665a99e73e5527353b4abdf4e5acff2aea18464cc70d78f47717aaca

data/README.md

@@ -1,6 +1,26 @@
 # Ruby Change Maker
 Given a currency amount (assuming US Currency ) returns that amount expressed as the least amount of change using the least number of bills, coins, or combination of bills and coins.
-## ALL EXPLANATIONS ARE ASSUMING OS X OR LINUX
+
+## To use as a gem:
+
+```
+gem install RubyChangeMaker
+```
+
+Then, in your source file:
+
+```
+require 'RubyChangeMaker'
+
+cm = RubyChangeMaker::Change.new
+
+dollars, cents = cm.make_change(amt)
+```
+
+To see an example program using the Module, look in this repo's **bin/** directory
+
+
+## To work with the source files:
 
 ### To Run:
 ```      

data/bin/changemaker

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+# Nicholas Sardo <ruby.code.artist@gmail.com>
+ 
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'rubychangemaker/rubychangemaker'
+
+cm = RubyChangeMaker::Change.new
+system 'clear'
+
+loop do
+  puts "Enter currency amount as floating point, \n(i.e 0.75 for 75 cents or 1.25 for a dollar twenty-five)\nor 'q' to quit: "
+  amt = gets
+  break if amt.match(/q/) 
+  
+  dollars, cents = cm.make_change(amt)
+  puts "\nYour change is: \n\n"
+  puts "BILLS: #{dollars}\n"
+  puts "COINS: #{cents}\n\n"
+end
+ 
+ 

data/features/all_usd_denominations.feature

@@ -0,0 +1,27 @@
+Feature: Make use of common USD dollar denominations
+  In order to create correct change
+  As a user
+  I want to ensure use of all common USD denominations
+ 
+  Scenario Outline: all usd denominations
+  Given I have started the program
+  Then available for use should be all current usd <bills> and <coins>
+  
+  Scenarios: all current USD bills
+  |bills|
+  |1|
+  |2|
+  |5|
+  |10|
+  |20|
+  |50|
+  |100|
+
+  Scenarios: all current USD coins
+  |coins|
+  |50|
+  |25|
+  |10|
+  |5|
+  |1|
+  

data/features/return_minimum_currency_necessary.feature

@@ -0,0 +1,35 @@
+Feature: Calculate change using the minimum number of bills and coins necessary
+  In order to create correct change
+  As a user
+  I want to receive change in the minimum amount of currency necessary
+ 
+  Scenario Outline: Minimum currency necessary
+  Given I have started the program
+  Then If I enter an amount of <money> I should receive the minimum currency necessary as <change>
+  
+  Scenarios: minimum denominations necessary as change
+  |money |change|
+  |55    |{50=>1, 5=>1}|
+  |55.25 |{50=>1, 5=>1}, {25=>1}|
+  |55.26 |{50=>1, 5=>1}, {25=>1, 1=>1}|
+  |55.72 |{50=>1, 5=>1}, {50=>1, 10=>2, 1=>2}|
+  |55.99 |{50=>1, 5=>1}, {50=>1, 25=>1, 10=>2, 1=>4}|
+  |55.93 |{50=>1, 5=>1}, {50=>1, 25=>1, 10=>1, 5=>1, 1=>3}|
+  |114   |{100=>1, 10=>1, 2=>2}|
+  |115   |{100=>1, 10=>1, 5=>1}|
+  |115.25|{100=>1, 10=>1, 5=>1}, {25=>1}|
+  |115.26|{100=>1, 10=>1, 5=>1}, {25=>1, 1=>1}|
+  |115.72|{100=>1, 10=>1, 5=>1}, {50=>1, 10=>2, 1=>2}|
+  |115.99|{100=>1, 10=>1, 5=>1}, {50=>1, 25=>1, 10=>2, 1=>4}|
+  |115.93|{100=>1, 10=>1, 5=>1}, {50=>1, 25=>1, 10=>1, 5=>1, 1=>3}|
+  |162   |{100=>1, 50=>1, 10=>1, 2=>1}|
+  |157.25|{100=>1, 50=>1, 5=>1, 2=>1}, {25=>1}|
+  |157.26|{100=>1, 50=>1, 5=>1, 2=>1}, {25=>1, 1=>1}|
+  |157.76|{100=>1, 50=>1, 5=>1, 2=>1},{50=>1, 25=>1, 1=>1}|
+  |157.99|{100=>1, 50=>1, 5=>1, 2=>1}, {50=>1, 25=>1, 10=>2, 1=>4}|
+  |157.93|{100=>1, 50=>1, 5=>1, 2=>1}, {50=>1, 25=>1, 10=>1, 5=>1, 1=>3}|
+  |237.25|{100=>2, 20=>1, 10=>1, 5=>1, 2=>1}, {25=>1}|
+  |237.55|{100=>2, 20=>1, 10=>1, 5=>1, 2=>1}, {50=>1, 5=>1}|
+  |237.76|{100=>2, 20=>1, 10=>1, 5=>1, 2=>1}, {50=>1, 25=>1, 1=>1}|
+  |237.99|{100=>2, 20=>1, 10=>1, 5=>1, 2=>1}, {50=>1, 25=>1, 10=>2, 1=>4}|
+  |237.93|{100=>2, 20=>1, 10=>1, 5=>1, 2=>1}, {50=>1, 25=>1, 10=>1, 5=>1, 1=>3}|

data/features/step_definitions/rubychangemaker_steps.rb

@@ -0,0 +1,130 @@
+# Nicholas Sardo <ruby.code.artist@gmail.com>
+
+Given(/^I have started the program$/) do
+  @c = RubyChangeMaker::Change.new
+end
+
+# all current USD Bills
+Then(/^available for use should be all current usd (\d+) and <coins>$/) do |arg1|
+  RubyChangeMaker::Change::BILLS.include?(arg1)
+end
+
+# all current USD Coins
+Then(/^available for use should be all current usd <bills> and (\d+)$/) do |arg1|
+  RubyChangeMaker::Change::COINS.include?(arg1)
+end
+
+#BILLS: 2, COINS: 0
+Then(/^If I enter an amount of (\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5|
+  @c.make_change(arg1.to_i) == {arg2=>arg3, arg4=>arg5}
+end
+
+#BILLS: 2, COINS: 1
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6}, {arg7=>arg8}]
+end
+
+#BILLS: 2, COINS: 2
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6}, {arg7=>arg8, arg9=>arg10}]
+end
+
+#BILLS: 2, COINS: 3
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6}, {arg7=>arg8, arg9=>arg10, arg11=>arg12}]
+end
+
+#BILLS: 2, COINS: 4
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6}, {arg7=>arg8, arg9=>arg10, arg11=>arg12, arg13=>arg14}]
+end
+
+#BILLS: 2, COINS: 5
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6}, {arg7=>arg8, arg9=>arg10, arg11=>arg12, arg13=>arg14, arg15=>arg16}]
+end
+
+#BILLS: 3, COINS: 0
+Then(/^If I enter an amount of (\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7|
+  @c.make_change(arg1.to_i) == {arg2=>arg3, arg4=>arg5, arg6=>arg7}
+end
+
+#BILLS: 3, COINS: 1
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8}, {arg9=>arg10}]
+end
+
+#BILLS: 3, COINS: 2
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8}, {arg9=>arg10, arg11=>arg12}]
+end
+
+#BILLS: 3, COINS: 3
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14| 
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8}, {arg9=>arg10, arg11=>arg12, arg13=>arg14}]
+end
+
+#BILLS: 3, COINS: 4
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8}, {arg9=>arg10, arg11=>arg12, arg13=>arg14, arg15=>arg16}]
+end
+
+#BILLS: 3, COINS: 5
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16, arg17, arg18|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8}, {arg9=>arg10, arg11=>arg12, arg13=>arg14, arg15=>arg16, arg17=>arg18}]
+end
+
+#BILLS: 4, COINS: 0
+Then(/^If I enter an amount of (\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9| 
+  @c.make_change(arg1.to_i) == {arg2=>arg3, arg4=>arg5, arg6=>arg7, arg8=>arg9}
+end
+
+#BILLS: 4, COINS: 1
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10}, {arg11=>arg12}]
+end
+
+#BILLS: 4, COINS: 2
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10}, {arg11=>arg12, arg13=>arg14}]
+end
+
+#BILLS: 4, COINS: 3
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\},\{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16| 
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10}, {arg11=>arg12, arg13=>arg14, arg15=>arg16}]
+end
+
+#BILLS: 4, COINS: 4
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16, arg17, arg18|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10}, {arg11=>arg12, arg13=>arg14, arg15=>arg16, arg17=>arg18}]
+end
+
+#BILLS: 4, COINS: 5
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16, arg17, arg18, arg19, arg20|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10}, {arg11=>arg12, arg13=>arg14, arg15=>arg16, arg17=>arg18, arg19=>arg20}]
+end
+
+#BILLS: 5, COINS: 1
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14| 
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10, arg11=>arg12}, {arg13=>arg14}]
+end
+
+#BILLS: 5, COINS: 2
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10, arg11=>arg12}, {arg13=>arg14, arg15=>arg16}]
+end
+
+#BILLS: 5, COINS: 3
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16, arg17, arg18|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10, arg11=>arg12}, {arg13=>arg14, arg15=>arg16, arg17=>arg18}]
+end
+
+#BILLS: 5, COINS: 4
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16, arg17, arg18, arg19, arg20|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10, arg11=>arg12}, {arg13=>arg14, arg15=>arg16, arg17=>arg18, arg19=>arg20}]
+end
+
+#BILLS: 5, COINS: 5
+Then(/^If I enter an amount of (\d+)\.(\d+) I should receive the minimum currency necessary as \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}, \{(\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+), (\d+)=>(\d+)\}$/) do |arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16, arg17, arg18, arg19, arg20, arg21, arg22|
+  @c.make_change(Float("#{arg1}.#{arg2}")) == [{arg3=>arg4, arg5=>arg6, arg7=>arg8, arg9=>arg10, arg11=>arg12}, {arg13=>arg14, arg15=>arg16, arg17=>arg18, arg19=>arg20, arg21=>arg22}]
+end

data/features/support/env.rb

@@ -0,0 +1,4 @@
+# Nicholas Sardo <ruby.code.artist@gmail.com>
+$LOAD_PATH << File.expand_path( '../../../lib', __FILE__ )
+
+require 'rubychangemaker/rubychangemaker'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: RubyChangeMaker
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Nicholas Sardo
@@ -19,6 +19,11 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- bin/changemaker
+- features/all_usd_denominations.feature
+- features/return_minimum_currency_necessary.feature
+- features/step_definitions/rubychangemaker_steps.rb
+- features/support/env.rb
 - lib/rubychangemaker.rb
 - lib/rubychangemaker/rubychangemaker.rb
 homepage: https://rubygems.org/gems/RubyChangeMaker