Unit Testing with NSubstitute

Unit Testing with NSubstitute

 

These are the materials of my unit testing training session, about how could we write better unit tests with NSubstitute framework.

Agenda

Unit Testing Introduction

Unit Testing Classic Definition

A unit test is a piece of a code (usually a method) that invokes another piece of code and checks the correctness of some assumptions afterward. If the assumptions turn out to be wrong, the unit test has failed. A “unit” is a method or function. In OOP, a “unit” is often an entire interface, such as class, but could be an individual method.
  -- from Wikipedia
Kent Beck introduced the concept of unit testing in Smalltalk.

Why Unit Testing?

  • Find Problems Early
    • Find problems in development cycle.
  • Facilitate Changes
    • Allow programmer to refactor code at a later date.
  • Simplify Integration
    • Reduce uncertainty, reduce efforts from integration test.
  • Documentation
    • Sort of living documentation of system.
  • Design by Test Driven
    • Support TDD approach.

Properties of a good unit test

A unit test  should have the following properties:
  • It should be automated and repeatable.
  • It should be easy to implement.
  • Once it’s written, it should remain for future use.
  • Anyone should be able to run it.
  • It should run at the push of a button.
  • It should run quickly.

Unit Testing Good Definition

A unit test is an automated piece of code that invokes the method or class being tested and then checks some assumptions about the logical behavior of that method or class. A unit test is almost always written using a unit-testing framework. It can be written easily and runs quickly. It’s fully automated, trustworthy, readable, and maintainable.

What’s Logical Behavior?

Logical code is any piece of code that  has some sort of logic in it, small as it may be. It’s logical code if it has one or more of the following: an IF statement, a loop, switch or case statements, calculations, or any other type of  decision-making code.

Verification Patterns – State

  • State Verification, also known as State-based Testing.
    • We inspect the state of the system under test (SUT) after it has been exercised and compare it to the expected state.
Unit Testing with NSubstitute_第1张图片
 

Verification Patterns – Behavior

  • Behavior Verification, also known as Interaction Testing.
    • We capture the indirect outputs of the SUT as they occur and compare them to the expected behavior.
Unit Testing with NSubstitute_第2张图片
 

Simple Example

Code:

Unit Testing with NSubstitute_第3张图片
 
Test:
 
Unit Testing with NSubstitute_第4张图片
 

TDD: Test-Driven Development

When to write the tests?

  1. Write a failing test to prove code or functionality is missing from the end product. (RED)
  2. Make the test pass by writing production code that meets the expectations of your test. (GREEN)
  3. Refactor your code. (REFACTOR)

Define TDD Paradigm

Unit Testing with NSubstitute_第5张图片

TAD: Test After Development

  • Are we TDD-style?
    • No, we are TAD now.
  • Must we do TDD-style coding?
    • No, TDD is a style choice. You can make your own choice.

Unit Testing Frameworks

Framework for Unit Testing

Unit testing frameworks are code libraries and modules that help developers unit-test their code. And also help running the tests as part of an automated build.

What Unit Testing Framework Offer

  • Write tests easily and in a structured manner.
    • Base classes or interfaces to inherit.
    • Attributes to place in code to note the tests to run.
    • Assert classes.
  • Execute one or all of the unit tests.
    • Identify tests in your code.
    • Run tests automatically.
    • Indicate status while running.
  • Review the result of the test runs.
    • Red/Green

xUnit architecture

  • Test Fixtures
  • Test Cases
  • Test Suites
  • Test Execution
  • Assertions

List of Unit Testing Frameworks

Integrated with Automated Build

  • With MSBuild.
    • <RunTest>true</RunTest>
    • <TestContainer Include="UT*.dll"/>

Unit Testing with NSubstitute_第6张图片

Unit Testing Patterns

Record – Replay – Verify Model

A model that allows for recording actions on a mock object and then replaying and verifying them.

Unit Testing with NSubstitute_第7张图片

Arrange – Act – Assert Pattern

  • "Arrange-Act-Assert" is a pattern for arranging and formatting code in UnitTest methods.
    • Each method should group these functional sections, separated by blank lines:
      1. Arrange all necessary preconditions and inputs.
      2. Act on the object or method under test.
      3. Assert that the expected results have occurred.

Unit Testing with NSubstitute_第8张图片

Unit Testing Mocking Libraries

Mocking Library

A mocking library is a set of programmable APIs that make creating mock and stub objects much easier. Mocking libraries save the developer from the need to write repetitive code to test or simulate object interactions.

Other names:

  • Mocking framework
  • Isolation framework

Unit Testing with NSubstitute_第9张图片

Most Features of Mocking Library

  • No Record/Replay idioms to learn.
  • Very low learning curve. Don't even need to read the documentation.
  • No need to learn what's the theoretical difference between a mock, a stub, a fake, a dynamic mock, etc.
  • Strong-typed, no object-typed return values or constraints.
  • Mock both interfaces and classes.
  • Override expectations as needed on tests.
  • Pass constructor arguments for mocked classes.
  • Intercept and raise events on mocks.
  • Intuitive support for out/ref arguments.

Famous Mocking Libraries

  • NSubstitute
  • Moq
  • Rhino Mocks
  • Microsoft Fakes
  • NMock
  • EasyMock.NET
  • TypeMock Isolator
  • JustMock
  • FakeItEasy

The Values of a Good Mocking Library

  • Simple to use. For example, a single point of entry in the API, easy to remember API, or Intelligence guidance.
  • Test Robustness. Making sure the test can live as long as possible while the system changes, and it only breaks when something important to it changes. Things like recursive fakes help a lot there. So does being non strict by default.
  • Helpful. If something is wrong, the user should not feel stupid. Helpful error messages go a long way. Being specific and not surprising the user as much as possible.

Mocking Libraries Comparison

Unit Testing with NSubstitute_第10张图片
-- Roy Osherove, the author of “The Art of Unit Testing”

Why we choose NSubstitute?

Why We Choose NSubstitute?

  • Simple, succinct, pleasant to use.
  • Helpful exceptions.
  • Don't sweat the small stuff.
    • Mock, stub, fake, spy, test double? Nah, just substitute for the type you need!

NSubstitute Features & Demos

Creating a substitute

Unit Testing with NSubstitute_第11张图片

Unit Testing with NSubstitute_第12张图片

Setting a return value

Unit Testing with NSubstitute_第13张图片

Return for any args

Unit Testing with NSubstitute_第14张图片

Return from a function

Unit Testing with NSubstitute_第15张图片

Argument matchers

Unit Testing with NSubstitute_第16张图片

Replacing return values

Unit Testing with NSubstitute_第17张图片

Check received calls

Unit Testing with NSubstitute_第18张图片

Callbacks, When..Do

Unit Testing with NSubstitute_第19张图片

Throwing exceptions

Unit Testing with NSubstitute_第20张图片

Raising events

Unit Testing with NSubstitute_第21张图片

References

 

 
 
标签:  Unit TestingUTNSubstituteStubMockAAATDD

你可能感兴趣的:(unit,TDD,mock,UT,stub,testing,AAA,NSubstitute)