ATM TDD Training Project

Overview

This repository contains a series of projects demonstrating the Test-Driven Development (TDD) process using an ATM application as the example. Each project progressively builds upon the last, illustrating the TDD cycle:

1. Testing (Feature Definition)
2. Code Implementation
3. Refactoring

The repository is broken down into five separate projects that reflect different stages of development:

1. ATM00: Feature files only (Cucumber testing).
2. ATM01: Feature files with step definitions (no code implementation).
3. ATM02: Feature files and step definitions, with code skeleton but no functionality.
4. ATM03: Full feature, step definitions, and complete ATM functionality.
5. ATM04: Full implementation with Moq-based unit tests for mocking behaviors.

Project Structure

├── ATM00/                  # Project with feature files only
├── ATM01/                  # Project with step definitions but no code implementation
├── ATM02/                  # Project with step definitions and a code skeleton
├── ATM03/                  # Project with full ATM implementation
├── ATM04/                  # Full implementation with Moq testing
└── README.md               # Parent repository README file (this file)

Prerequisites

• .NET 7 SDK (or higher)
• Visual Studio or any other IDE with C# support
• NuGet for package management (used to install Moq, SpecFlow, etc.)

Setup Instructions

1. Clone the Repository

   git clone https://github.com/conceptsandbeyond/ATM-TDD-Training.git
   

2. Open Projects Navigate to the project folder you're interested in (ATM00, ATM01, etc.) and open the project in Visual Studio or your preferred IDE.

3. Installing Dependencies Each project might require different dependencies, such as SpecFlow for Cucumber testing or Moq for mocking. Install them via the NuGet Package Manager or .NET CLI:

   • Example for Moq:

   dotnet add package Moq
   

4. Run Tests For each project, tests can be run using the following command: dotnet test

5. Exploring the TDD Stages

   • Start with ATM00 to see how the feature files are written.
   • Move to ATM01 to see the step definitions.
   • In ATM02, explore the skeleton code and try writing your own implementation.
   • In ATM03, see the completed implementation.
   • In ATM04, check out the usage of Moq for unit testing with mocks.

Project Breakdown

1. ATM00: Feature File Only (Cucumber Testing)

• Defines the test scenarios in a Gherkin-based feature file.
• No code or step definitions are implemented.

2. ATM01: Feature and Step Definitions (No Code Implementation)

• Contains feature files and step definitions but no ATM logic is implemented.
• Illustrates the "write tests first" principle of TDD.

3. ATM02: Feature, Steps, and Code Skeleton

• Adds a code skeleton for the ATM operations without any actual functionality.
• Tests will fail due to unimplemented methods.

4. ATM03: Fully Implemented ATM Operations

• Complete implementation of the ATM operations.
• All tests should pass successfully.

5. ATM04: Full Implementation with Moq Testing

• Fully implemented ATM with unit tests that use Moq for mocking dependencies.
• Demonstrates how to mock dependencies and test them.

Contributing

Feel free to fork this repository and create pull requests if you would like to contribute to the project or make improvements to the TDD training cycle.

License

This project is licensed under the ConceptsandBeyond License. See the LICENSE file for more details.

---

This parent README.md file provides an overview of the repository, details about each sub-project, instructions for setup, and a general description of the TDD process in relation to each stage of the project. It is designed to be the first point of reference for users exploring the repository.