AutoFixture Kata Starter

A starting point for a code kata using AutoFixture.

This exercise builds on two previous exercises:

• Test Builders in C#
• FileLogger Mocking Kata

You should be familiar with, and ideally have completed, both of the above exercises before starting this one. If you haven't, you can start from this kata's code and perform these katas in this project if desired. Alternately, you can borrow working versions of these services from this tagged repo.

Introducing AutoFixture

AutoFixture is a tool designed to speed up the "Arrange" or "Setup" portion of your automated tests. It is designed to help developers/testers focus on test behavior instead of the setup steps of the scenario. It supports setting up tests data, creating services to be tested with their dependencies, and mocking of service dependencies (when integrated with Moq).

Kata Instructions

Having completed the BuilderTestSample exercise and the FileLogger exercise, you now have two working, tested types:

• OrderService
• FileLogger

Your new task is to combine the two by adding logging to the OrderService and testing that it works as expected. You will write these tests using AutoFixture. Try to use this test approach where possible.

Use Your Code

Start with this repo, which you can download as a zip file and unzip into a folder where you're going to work. Copy your OrderService.cs file that you completed in the Test Builders kata and replace the file in the Services folder. Likewise, take your FileLogger.cs class and replace the class in that file of the same name in the root of AutoFixtureKataStarter.

Update OrderService to Set Id

Some log messages will use the Order.Id property, which has been 0 for all of the previous kata. We need to add a step to give it a value. You can do that with this code snippet (change in OrderService class) by adding the SaveOrder method and calling it from PlaceOrder as shown:

public void PlaceOrder(Order order)
{
    ValidateOrder(order);

    SaveOrder(order);

    ExpediteOrder(order);

    AddOrderToCustomerHistory(order);
}

private void SaveOrder(Order order)
{
    order.Id = new Random().Next(1000, 10000);
}

Add New Behavior

Add new behavior to OrderService and test it (using AutoFixture):

• If a customer's total prior purchases (not including this order) exceeds 10,000, expedite this order

Add the following log messages:

• If order passes validation and has been saved, log "Order [[orderId]] validated and saved."
• If order should be expedited, log "Order [[orderId]] expedited."
• After adding order to customer history, if customer qualifies for expedited orders, log "Customer [[First Name]] [[Last Name]] now qualifies for expedited delivery."

Write tests using xUnit, Moq, and AutoFixture to verify these messages are logged when they should be.

Extra Credit

• Rewrite your OrderService tests to use AutoFixture to build Order, Customer, and Address as needed for its tests.