Writing Unit Tests and Functional Tests in Django

One of the key aspects of developing robust and reliable web applications is writing tests. In Django, there are two types of tests that can be written: unit tests and functional tests. Unit tests focus on testing individual components or functions of the application, whereas functional tests aim to ensure that the application is working as expected from a user's perspective. In this article, we will explore how to write both unit tests and functional tests in Django.

Unit Tests

Unit tests in Django are used to test individual components or functions in isolation, without relying on any external dependencies or interactions. These tests are typically written in the tests.py file within each Django app.

To write a unit test, you need to create a class that inherits from django.test.TestCase. Inside the class, define methods that start with the word test_ to indicate that they are test methods. For example, consider the following test case for testing a simple function that adds two numbers:

from django.test import TestCase

def add_numbers(a, b):
    return a + b

class MyTestCase(TestCase):
    def test_add_numbers(self):
        result = add_numbers(2, 3)
        self.assertEqual(result, 5)

In the above example, the test_add_numbers method calls the add_numbers function and asserts that the result is equal to 5 using the self.assertEqual() method provided by Django's TestCase class.

Once you have defined your test cases, you can run them by executing the command python manage.py test in the terminal. Django's test runner will discover and run all the test cases in your project.

Functional Tests

Functional tests, also known as integration tests or end-to-end tests, are used to test the application's behavior from a user's perspective. These tests validate the overall functionality of the application and can involve multiple components, including views, models, and templates.

Functional tests in Django are typically written using a combination of Selenium WebDriver and Django's built-in LiveServerTestCase class. Selenium WebDriver allows you to interact with the web application programmatically and simulate user actions like clicking buttons or filling out forms.

To write a functional test, create a class that inherits from django.test.LiveServerTestCase. Inside the class, define methods that start with the word test_. For example, consider the following test case for testing the login functionality:

from selenium import webdriver
from selenium.webdriver.common.keys import Keys
from django.contrib.staticfiles.testing import LiveServerTestCase

class MyFunctionalTestCase(LiveServerTestCase):
    def setUp(self):
        self.browser = webdriver.Firefox()

    def tearDown(self):

    def test_login(self):
        self.assertIn("My Web Application", self.browser.title)

        username_input = self.browser.find_element_by_name("username")
        password_input = self.browser.find_element_by_name("password")


        # Assert that the user is redirected to the dashboard page
        self.assertIn("Dashboard", self.browser.title)

In the above example, the test_login method starts by opening the browser and navigating to the application's login page using self.browser.get(self.live_server_url). It then interacts with the input fields by finding them using find_element_by_name and simulates the login action by sending the enter key using send_keys(Keys.RETURN). Finally, it asserts that the user is redirected to the dashboard page based on the title of the page.

To run the functional tests, you can use the same python manage.py test command as for unit tests. Django's test runner will automatically start a live web server and run the functional tests against it.


Writing tests is fundamental to ensure the stability and correctness of your Django applications. By combining unit tests and functional tests, you can thoroughly validate the individual components and overall functionality of your application. The examples provided in this article should give you a good starting point for writing tests for your own Django projects. Happy testing!

noob to master © copyleft