Warning: This document is for the development version of Bareos Documentation. The main version is bareos-23.


Unit Tests

Bareos unit tests are usually written in C++ using Google Test. The unit tests reside in core/src/tests. If Google Test is available on your system, the tests are compiled during the normal build process of Bareos. Unit tests can be run using make test or ctest.

There are many theoretical approaches how to write unit tests. However, in general we use unit tests for software components such as classes and functions as well as for simple integration tests. A unit test should follow the F.I.R.S.T. principle (Fast, Independent, Repeatable, Self-Validating, Timely).

Adding a new C++ Test

To add a new test, you create your sourcefiles in core/src/tests and register the test in CMakeLists.txt in that directory. The easiest way is to copy an existing test sourcefile and the related lines in core/src/CMakeLists.txt.

For general advice on how to use the Google Test framework see this documentation: Googletest Primer

Adding tests in general

Unittests in other languages i.e. Python can be established using the add_test and set_property commands of cmake. The following cmake code adds a Python script to the test suite. The actual test in the source is disabled by default.

  NAME python-simple-test-example
  COMMAND python ${CMAKE_CURRENT_SOURCE_DIR}/test/simple-test-example.py
  #add current directory for documentation only
  TEST python-simple-test-example PROPERTY ENVIRONMENT PYTHONPATH=./
  TEST python-simple-test-example PROPERTY DISABLED true
 #!/usr/bin/env python

 from sys import exit

 if __name__ == "__main__":
     print("--- Hello World ---")

In this case only the return value of the script is evaluated: 0 for success and 1 for failure.