https://www.usmint.gov/learn/coin-and-medal-programs/coin-specifications
| Denomination | Composition | Weight | Diameter | Thickness | Edge | No. of Reed |
|---|---|---|---|---|---|---|
| Cent | Copper Plated Zinc 2.5% Cu Balance Zn |
2.500 g | 0.750 in. 19.05 mm |
1.52 mm | Plain | N/A |
| Nickel | Cupro-Nickel 25% Ni Balance Cu |
5.000 g | 0.835 in. 21.21 mm |
1.95 mm | Plain | N/A |
| Dime | Cupro-Nickel 8.33% Ni Balance Cu |
2.268 g | 0.705 in. 17.91 mm |
1.35 mm | Reeded | 118 |
| Quarter Dollar | Cupro-Nickel 8.33% Ni Balance Cu |
5.670 g | 0.955 in. 24.26 mm |
1.75 mm | Reeded | 119 |
| Half Dollar | Cupro-Nickel 8.33% Ni Balance Cu |
11.340 g | 1.205 in. 30.61 mm |
2.15 mm | Reeded | 150 |
| Dollar | Manganese-Brass 88.5% Cu 6% Zn 3.5% Mn 2% Ni |
8.1 g | 1.043 in. 26.49 mm |
2.00 mm | Edge-Lettering | N/A |
These instructions are not my own. They were taken from https://gist.githubusercontent.com/Bogghead/e76f3323f3fac005ad9e8b60eee03a34/raw/800cbb550cf1a3030ffdfae02aa77413f6568f91/vendingMachineKata.txt on August 06, 2020.
with many thanks to Guy Royce https://github.com/guyroyse/vending-machine-kata
In this exercise you will build the brains of a vending machine. It will accept money, make change, maintain inventory, and dispense products. All the things that you might expect a vending machine to accomplish.
The point of this kata to to provide a larger than trivial exercise that can be used to practice TDD. A significant portion of the effort will be in determining what tests should be written and, more importantly, written next.
As a vendor
I want a vending machine that accepts coins
So that I can collect money from the customer
The vending machine will accept valid coins (nickels, dimes, and quarters)
and reject invalid ones (pennies). When a valid coin is inserted
the amount of the coin will be added to the current amount
and the display will be updated. When there are no coins inserted,
the machine displays INSERT COIN. Rejected coins are placed in the coin return.
NOTE: The temptation here will be to create Coin objects that know their value.
However, this is not how a real vending machine works. Instead, it identifies
coins by their weight and size and then assigns a value to what was inserted.
You will need to do something similar. This can be simulated using strings,
constants, enums, symbols, or something of that nature.
As a vendor
I want customers to select products
So that I can give them an incentive to put money in the machine
There are three products: cola for $1.00, chips for $0.50, and
candy for $0.65. When the respective button is pressed
and enough money has been inserted, the product is dispensed
and the machine displays THANK YOU.
If the display is checked again, it will display INSERT COIN
and the current amount will be set to $0.00.
If there is not enough money inserted then the machine displays PRICE
and the price of the item and subsequent checks of the
display will display either INSERT COIN or the current amount as appropriate.
As a vendor
I want customers to receive correct change
So that they will use the vending machine again
When a product is selected that costs less than the amount of
money in the machine, then the remaining amount is placed in the coin return.
As a customer
I want to have my money returned
So that I can change my mind about buying stuff from the vending machine
When the return coins button is pressed, the money the customer has placed
in the machine is returned and the display shows INSERT COIN.
As a customer
I want to be told when the item I have selected is not available
So that I can select another item
When the item selected by the customer is out of stock,
the machine displays SOLD OUT. If the display is checked again,
it will display the amount of money remaining in the machine
or INSERT COIN if there is no money in the machine.
As a customer
I want to be told when exact change is required
So that I can determine if I can buy something with the money I have
before inserting it
When the machine is not able to make change with the money in the machine
for any of the items that it sells, it will display EXACT CHANGE ONLY
instead of INSERT COIN.