How to Write Unit Tests in Python: A Practical Tutorial

Unit tests verify that individual pieces of code work correctly. In Python, the built-in unittest module makes it easy to write and run tests. This tutorial covers the essential steps to get you started writing efficient unit tests for your Python projects.

Before diving in, make sure you have a Python file (e.g., calculator.py) containing functions you want to test. Create a separate test file (e.g., test_calculator.py) to keep things organized.

Article illustration

1. Set Up the Test Framework

Import the unittest module and create a test class that inherits from unittest.TestCase. This class will contain all your test methods.

  • Import: import unittest
  • Define class: class TestCalculator(unittest.TestCase):
  • Optionally, use setUp() to initialize common objects before each test.

2. Write Test Methods

Each test method should start with the word test_ so it’s automatically discovered by the runner. Inside, call the function you want to test and compare the result using assert methods.

  • Example: def test_add(self):
  • Assertion: self.assertEqual(add(2, 3), 5)
  • Common assert methods: assertEqual, assertTrue, assertFalse, assertRaises (for exceptions).

3. Run Your Tests

Add a simple entry point at the bottom of your test file to run the tests directly.

  • Add: if __name__ == '__main__': unittest.main()
  • Run the file: python test_calculator.py
  • Alternatively, use test discovery: python -m unittest discover

Writing unit tests helps you catch bugs early and ensures your code behaves as expected. Start simple, test one function at a time, and gradually build a comprehensive test suite for your Python projects.

sarah antaboga
Author: sarah antaboga

Leave a Reply

Your email address will not be published. Required fields are marked *