Welcome to your fifth and final unit for this course, focused on practicing the principles of Test Driven Development (TDD) using Scala and ScalaTest. We’ll continue building our ShoppingCart system by integrating more sophisticated features into the class.

In this course, the emphasis is placed on hands-on practice, where you’ll receive requirements through tests, one at a time. Your task is to write tests AND implement code that makes each test pass, simulating a real-world TDD environment. In previous lessons, tests were provided to guide you, but now it’s your turn to define them!

Remember to apply the core concepts of the Red-Green-Refactor cycle while completing these coding exercises. Ask questions if you need clarification!

These requirements introduce more sophisticated capabilities for the ShoppingCart class, focusing on robust item management, discount application, and quantity handling. These features will challenge you to apply TDD principles effectively and enhance the system's functionality.

Let's take a look at the final set of requirements.

• Description: The cart should enforce a maximum quantity limit of 10 for a single type of item, preventing more than this allowed amount from being added.

• Details:

  • Utilize the addItem(product: Product, quantity: Int) method to add items to the cart.
  • Ensure an exception is raised when adding a quantity that exceeds the limit of 10 for a single item.
  • The exception’s message should clearly state "Maximum quantity exceeded" when the limit is breached.

• Examples: Attempting to add 11 units of an item should throw a custom InvalidCartOperationException indicating "Maximum quantity exceeded".

• Description: When an item is added to the cart, it should be possible to retrieve that item’s details using its ID, including the product information and the quantity in the cart.

• Details:

  • Enable items to be added using the addItem() method with specific IDs.
  • Ensure that getItem(id: String): CartItem returns the correct item details, including the quantity, after being added to the cart.

• Examples: Adding a "Book" of ID "1" with a price of 10 and retrieving by ID "1" should return { Id: "1", Name: "Book", Price: 10, Quantity: 1 }.

• Description: Applying a valid discount code should reduce the total price of items in the cart by the specified discount percentage.

• Details:

  • Use the applyDiscountCode(code: String) method to apply a discount.
  • Support valid discount codes such as "HOLIDAY25" for a 25% discount.
  • Update getTotal() to reflect the discounted price.

• Examples: Applying the discount code "HOLIDAY25" to a product "Book" with a price of 100 should reduce the total to 75.

• Description: The system should not accept invalid discount codes and should throw an appropriate exception when such a code is applied.

• Details:

  • Ensure applyDiscountCode(code: String) checks against a list of valid codes.
  • Raise an exception with the message "Invalid discount code" if the code is not valid.

• Examples: Applying the discount code "INVALID" after adding an item should throw an error indicating the code is invalid.

• Description: When an item that already exists in the cart is added again, its quantity should increase without creating duplicates, and the total price should reflect the cumulative quantity.

• Details:

  • Allow items to be added again using the addItem() method without creating duplicates in the cart.
  • Ensure getItem(id: String) returns the updated quantity after adding the same item.
  • Update the total price to reflect the cumulative quantity of the added items.

• Examples: Adding a "Book" with a price of 200 twice should result in a quantity of 2 for that item, with the total updated price reflecting the double addition.

• Description: When adding more units to existing items in the cart, the total quantity should not exceed the predefined maximum limit.

• Details:

  • Use the addItem(product: Product, quantity: Int) method to add units to an existing item.
  • Ensure that adding a quantity which causes the total to exceed the maximum allowed quantity throws an exception.
  • The exception message should be "Maximum quantity exceeded" when the quantity limit is breached.

• Examples: Adding 3 units of an item with ID "1", named "Book", priced at 200, to an existing 8 units should throw an error, as it exceeds the limit.

In this unit, you reviewed descriptions for more advanced test cases to expand the functionality of the ShoppingCart class. The focus was on utilizing TDD practices for advanced features like handling non-existent items, applying discounts, and updating item quantities. With solidified TDD skills, let’s proceed to writing targeted test cases that capture essential functionality for a robust ShoppingCart class.

As you undertake these exercises, remember to engage in the Red-Green-Refactor cycle.

You are almost done with this practice course! Keep up the great work, and soon you’ll have mastered these unit testing techniques. Red! Green! Refactor!