Creating Trust-able Unit Tests in Swift

It may come as a surprise to you, but a green-lit passing unit test is not always a sign that all is well with our software. Our apps and their corresponding unit test suites always start off clean and basic and simple.

But they don’t stay that way for long.

Cycles of code changes and additions and re-writes take place throughout the days, weeks, and months of the application development cycle. The app’s code-base and unit tests become more complex as the end-product progresses along its asymptotic approach to completion.

Unit tests are only as good as they are trust-able. As our products navigate their way through development iterations, how can we keep a handle on the trustworthiness of our unit tests? How can we be assured that they’re testing the right thing? How can we know that changing a unit test because a fundamental requirement has changed is still accurate when it lights up green? After all, we’re writing code to test our code!

Here, I explore several categories of thought that will help you think about creating trust-able unit tests.

Test Organization

How you organize the code within a single unit test can make all the difference in understanding it when you return to it later.

Having a consistent strategy for organizing the body of a test function will save you time and effort in trying to understand what’s happening. Keeping things consistent across a team of developers will make everyone more productive as well.

Two of the most common organizational structures for unit tests are the “Arrange-Act-Assert (AAA)” and the “Given-When-Then” structures:

 1func testAppFeatureBehavior() {
 2    // Arrange
 3    let sut = SystemUnderTest()
 4    // configure properties as necessary to prepare the system for the next step
 5
 6    // Act
 7    sut.functionProducingObservableBehavior()
 8
 9    // Assert
10    XCTAssert(...expectations are met...)
11}

A similar pattern is the “Given-When-Then” structure:

 1func testAppFeatureBehavior() {
 2    // Given
 3    let sut = SystemUnderTest()
 4    // configure properties as necessary to prepare the system for the next step
 5
 6    // When
 7    sut.functionProducingObservableBehavior()
 8
 9    // Then
10    XCTAssert(...expectations are met...)
11}

They’re exactly the same structures with different descriptive comments outlining the three phases of the test.

The outline itself can help you look at the test and verify its trustworthiness as it pertains to its logical, clear order and organization.

Test Length

Another contributor to the trustworthiness of a given unit test is the number of lines of code it has.

It’s been said that a 100% guaranteed bug-free line of code is the line of code that was never written in the first place!

It makes sense that if we can keep our unit tests short and to the point, there will be a smaller chance for error than if the test body is extremely long.

Small (<20ish lines of code) tests are more-trusted than large tests.

20 lines of code is sort of arbitrary, but can help alert you to when you might need to re-look at the test and apply DRY (Don’t Repeat Yourself) principles. Large test bodies may be a sign that there’s a possible opportunity to factor out common, repeated test code.

Extracting out larger portions of code into smaller named functions may also help with the clarity of your unit test code, leading you to say with greater confidence, “I trust that this test is correct”.

Test Complexity

Unit tests should be as simple as possible. Reducing the complexity of a unit test results in clarity.

Make sure there’s a clear path through the test case.

Avoid branching logic (if-else statements) or looping constructs in your tests if at all possible. If you find the need to test two code paths of your system under test, write two tests for that, rather than applying if-else logic inside of a single unit test.

If you’re using analytics, such as cyclomatic complexity, absolutely make sure your unit tests have as low of a cyclomatic complexity as possible.

Test Semantics

Applying simple clean coding practices to your unit tests can also go a long way in terms of being able to trust your tests.

Use descriptive and meaningful phrases (DAMP) in your test names and variables. Be sure to update them as the semantics of your system under test change. This will provide a consistency and accuracy to the names of things that will lead to a greater confidence that your tests are giving you an accurate picture of the health of your system.

comments powered by Disqus