History

Heikki Tampio c91910351f formats: Develop solution to H26x aggregation when there are multiple non-consecutive small NAL units		2024-02-20 13:00:48 +02:00
..
CMakeLists.txt	tests: Distribute IPv6 tests to other tests	2024-01-30 11:43:25 +02:00
README.md	doc: Update test suite instructions	2022-12-14 15:52:31 +02:00
main.cpp	build: Completely Redesigned CMake files (#44 )	2021-08-08 22:18:40 +02:00
test_1_version.cpp	Merge branch 'example_improvements'	2022-02-22 14:03:49 +02:00
test_2_rtp.cpp	test: Fix small compiler warnings in tests	2024-01-30 11:56:26 +02:00
test_3_rtcp.cpp	tests: Increase bandwidth in RTCP mux tests to make sure there is enough reports sent	2024-02-20 10:10:31 +02:00
test_4_formats.cpp	formats: Develop solution to H26x aggregation when there are multiple non-consecutive small NAL units	2024-02-20 13:00:48 +02:00
test_5_srtp_zrtp.cpp	test: Fix small compiler warnings in tests	2024-01-30 11:56:26 +02:00
test_6_scl_unit_test.cpp	tests: Add more tests for start code lookup	2022-10-28 16:01:44 +03:00
test_common.hh	test: Fix small compiler warnings in tests	2024-01-30 11:56:26 +02:00

README.md

Testing uvgRTP

Testing uvgRTP is meant for the developers of uvgRTP. After each major change, it is recommended to run the automated tests. New automated tests can be a great help in validating the functionality of new features as well as helping detect bugs caused by later changes.

These tests are not meant to be readable examples. For that you might want to check out examples.

Building the automated tests

uvgRTP uses GoogleTest framework for automated testing. The automated tests are run separately after the build process. First, build uvgRTP normally. Running the CMake will create a new folder called test under the build folder, where you can find the necessary files for building the test suite.

GCC (Linux)

Install Crypto++ if you want to test encryption. After this, run make in build/test folder. This will create a program called uvgrtp_test. Run this program to run the automated tests.

MSVC (Windows)

Open the generated solution. Building the uvgrtp_test will generate the program in Debug/Release folder. Run the uvgrtp_test.exe to start the automated tests. Using a command line is recommended so the results don't disappear after finishing.

See the build instruction for how to integrate Crypto++ to test suite.

Current test suites

Currently, the automated tests consist of the following test suites:

The tests should be coded in such a way to make the tests themselves as resilient as possible to problems while also validating that the uvgRTP output is correct. In other words, it is more helpful if a check is false than if the test suite crashes.

Creating new tests

New tests can be created by adding a new function in one of the existing files or creating a new file. Each file should only contain tests from a single test suite and all tests of one test suite should be located in a single file. New files have to also be added to the local CMakeLists.txt file.

You can read about GoogleTest framework here.