/string-calculator-tdd

A Simple String Calculator Using TDD.

Primary LanguageJavaApache License 2.0Apache-2.0

String Calculator

A Simple String Calculator Using TDD Kata

Purpose

Learn to use Test Driven Development to create a program.

Description

This kata was created by Roy Osherove and is designed to help you learn TDD coding and refactoring.
Try not to read ahead – do one task at a time. Work incrementally.

Kata Steps

  1. Create a String calculator with a method int Add(string numbers)
  2. The method can take 0, 1, or 2 numbers and will return their sum.
  3. An empty string will return 0.
  4. Example inputs: “”, “1”, or “1,2”
  5. Start with the simplest test case of an empty string. Then 1 number. Then 2 numbers.
  6. Remember to solve things as simply as possible, forcing yourself to write tests for things you didn’t think about.
  7. Remember to refactor after each passing test.
  8. Allow the Add method to handle an unknown number of arguments/numbers.
  9. Allow the Add method to handle new lines between numbers (instead of commas).
    1. Example: “1\n2,3” should return 6.
    2. Example: “1,\n” is invalid, but you don’t need a test for this case.
    3. Only test correct inputs – there is no need to deal with invalid inputs for this kata.
  10. Calling Add with a negative number will throw an exception “Negatives not allowed: “ listing all negative numbers that were in the list of numbers.
    1. Example “-1,2” throws “Negatives not allowed: -1”
    2. Example “2,-4,3,-5” throws “Negatives not allowed: -4,-5”
  11. Numbers bigger than 1000 should be ignored.
    • Example: “1001,2” returns 2
  12. Allow the Add method to handle a different delimiter:
    1. To change the delimiter, the beginning of the string will contain a separate line that looks like this: “//[delimiter]\n[numbers]”
    2. Example: “//;\n1;2” should return 3 (the delimiter is ;)
    3. This first line is optional; all existing scenarios (using , or \n) should work as before.