Categories: Unit Testing

Unit Tests – An Alternate Functional Requirements Documentation

The article presents a perspective on how unit tests could be written in a way that they could be used as an alternate form of documentation for understanding functional requirements.

Many a times, it has been found that developers, primarily rookies, did not have a clarity on how to name unit tests. Thus, many of them have been found to name the unit tests such as testXXX where XXX is name of the method which they wanted to tests. There has been many recommendations on how to name unit tests, some of which are following:

This article takes a shot at naming unit tests representing different use case scenarios of a functional requirement. Feel free to suggest.

Following is a Calculator class (Java) which has two methods such as add and subtract. These methods take two numbers and return the output appropriately.

 

public class Calculator { 

 public Calculator(){ 
 }

 public int add( int a, int b ) {
  return a + b;
 }

}

 

Unit Tests Generated using Eclipse

Following is a set of of JUnit tests that could be written for above Calculator Class. It can be noted that there is just one unit test named as testAdd which gets added if you create the unit tests for Calculator class using Eclipse. One may require to test different scenarios of addition within testAdd method. And, for developers, it would be difficult to associate tests like these (testXXX) with different scenarios which may be related with one or more functional requirements.

public class CalculatorTest {

 private Calculator c;

 @Before
 public void setUp() throws Exception {
  c = new Calculator();
 }

 @Test
 public void testAdd() {
  int res = c.add( 3, 4 );
  assertEquals( res, 7 );

  res = c.add( 3, -4 );
  assertEquals( res, -1 );

  res = c.add( -3, 4 );
  assertEquals( res, 1 );
 } 

       @After
 public void tearDown() throws Exception {
  c = null;
 }

}

 

Unit Tests Representing Functional Requirements

Following is an another set of JUnit tests that could be written for same Calculator Class. Take a note of following different unit tests methods:

  • testAdditionOfPositiveNumbers
  • testAdditionOfPositiveAndNegativeNumbers
  • testAdditionOfNegativeNumbers

These unit tests’ method names, being self-explanatory, clearly spells out different scenarios which are being tested and not just the method, “add” of the class, Calculator. It helps developers to understand different scenarios which, in turn, be related with one or more functional requirements. Going this approach can achieve some of the following objectives:

  • Enhanced readability of unit tests and hence, greater code usability
  • Enhanced trace-ability of functionality with unit tests
  • Reduction in test smells as a result of increased trace-ability
public class CalculatorTest {

 private Calculator c;

 @Before
 public void setUp() throws Exception {
  c = new Calculator();
 }

        @Test
 public void testAdditionOfPositiveNumbers() {
  int res = c.add( 3, 4 );
  assertEquals( res, 7 );
 }

 @Test
 public void testAdditionOfPositiveAndNegativeNumbers() {
  int res = c.add( 3, -4 );
  assertEquals( res, -1 );

  res = c.add( -3, 4 );
  assertEquals( res, 1 );  
 } 

 @Test
 public void testAdditionOfNegativeNumbers() {
  int res = c.add( -3, -4 );
  assertEquals( res, -7 );

 }

       @After
 public void tearDown() throws Exception {
  c = null;
 }

}
Ajitesh Kumar

I have been recently working in the area of Data analytics including Data Science and Machine Learning / Deep Learning. I am also passionate about different technologies including programming languages such as Java/JEE, Javascript, Python, R, Julia, etc, and technologies such as Blockchain, mobile computing, cloud-native technologies, application security, cloud computing platforms, big data, etc. I would love to connect with you on Linkedin. Check out my latest book titled as First Principles Thinking: Building winning products using first principles thinking.

Share
Published by
Ajitesh Kumar
Tags: unit tests

Recent Posts

Agentic Reasoning Design Patterns in AI: Examples

In recent years, artificial intelligence (AI) has evolved to include more sophisticated and capable agents,…

1 month ago

LLMs for Adaptive Learning & Personalized Education

Adaptive learning helps in tailoring learning experiences to fit the unique needs of each student.…

1 month ago

Sparse Mixture of Experts (MoE) Models: Examples

With the increasing demand for more powerful machine learning (ML) systems that can handle diverse…

2 months ago

Anxiety Disorder Detection & Machine Learning Techniques

Anxiety is a common mental health condition that affects millions of people around the world.…

2 months ago

Confounder Features & Machine Learning Models: Examples

In machine learning, confounder features or variables can significantly affect the accuracy and validity of…

2 months ago

Credit Card Fraud Detection & Machine Learning

Last updated: 26 Sept, 2024 Credit card fraud detection is a major concern for credit…

2 months ago