X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=src%2Fbindings%2Frmr-python%2Fdocs%2Fsource%2Findex.rst;h=addb96373d8cdc8f6bfab8faca1ae4b127ea39a8;hb=fa09c30e9450c45853311c6f07a621e1b9218ff0;hp=cbda718dd3ba514bfaf50357ee1a467ed48ca1fe;hpb=0cb4b57403307f128b3597a52fa77cbc8524f078;p=ric-plt%2Flib%2Frmr.git diff --git a/src/bindings/rmr-python/docs/source/index.rst b/src/bindings/rmr-python/docs/source/index.rst index cbda718..addb963 100644 --- a/src/bindings/rmr-python/docs/source/index.rst +++ b/src/bindings/rmr-python/docs/source/index.rst @@ -15,9 +15,9 @@ new functions are added into the C lib, we only need to again wrap the function signatures. The downside is this seems to be Linux only currently. This wrapper -immediately SIGABRT’s on Mac, and no one yet seems to know why. The +immediately SIGABRT's on Mac, and no one yet seems to know why. The other downside is that there are currently some functionality that needs -to be “exported” from the C library for this to be fully operational. +to be 'exported' from the C library for this to be fully operational. For example, CTYPES does not have access to C header files, and important constants are defined in the C header files. @@ -40,12 +40,24 @@ are not yet implemented in this library (do we need them?): Unit Testing ============ +You can unit test in docker or outside of docker. +The preferred method (by far) is to use Docker, because it encapsulates rmr, as well as ensuring that ports that rmr opens do not conflict with the host machine + +:: + + docker build -t rmrunittestt:latest -f Dockerfile-Unit-Test . + +A coverage report will be shown in stdout. + +It is possible to run tox locally provided that rmr is intalled, and you are prepared to have the test open ports (4562) as ``rmr_init`` must succeed for the tests to proceed. :: tox open htmlcov/index.html +The added benefit of the local option is that the coverage report can be viewed in html, which I find easier to read than the term coverage reort the docker build will print. + Installation ============