X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Fdeveloper-guide.rst;h=4d9851b9e139f1567007b60c99b6fd374a1ae217;hb=11b64161a8b9fd80749bca1279609cdb77863852;hp=b8dc8e1d22af99b773c73b791d11d00ba6ad6243;hpb=02cf8dfcafb7380cda35beaa2aad783ffea87fa3;p=ric-plt%2Fsdl.git diff --git a/docs/developer-guide.rst b/docs/developer-guide.rst index b8dc8e1..4d9851b 100644 --- a/docs/developer-guide.rst +++ b/docs/developer-guide.rst @@ -209,6 +209,43 @@ supports, for example:: ./testrunner ./testrunner --gtest_filter=AsyncStorageTest* +To get unit test code coverage analysis enable unit test gcov code coverage +analysis by configuring gcov reporting directory:: + + configure --with-gcov-report-dir=DIR + +Directory can be an absolute path or a relative path to an SDL source root. +Unit test build creates directory if it does not exist. + +Build and run unit tests with code coverage analysis:: + + make test_gcov + +After successful unit test run code coverage (.gcov) result files are in +a directory, what was defined by '--with-gcov-report-dir' configure option. + +In addition, graphical gcov front-ends such as lcov can be used for coverage +analysis:: + + lcov --directory tst/ --directory src --capture --output-file coverage.info + genhtml coverage.info --output-directory out + +Open the out/index.html using any web browser. + + +Docker Tests +============ + +It's also possible to test SDL compilation, run unit tests and test building of +rpm and Debian packages in a Docker:: + + docker build --no-cache -f docker_test/Dockerfile-Test -t sdltest:latest . + +If needed, ready rpm and Debian packages can be copied from Docker to host. In +below example packages are copied to host's /tmp/sdltest-packages directory:: + + docker run -v /tmp/sdltest-packages:/export sdltest:latest /export + Functional Tests ================