FAQ - Frequency Asked Questions#

The following Frequency Answer Questions are general and not operating system specific.

  1. Configure PyCharm to auto-complete Xmera commands and provide module variables, see the PyCharm Support web page.

  2. How do I run pytest to ensure all unit and integrated tests still pass

    The following response assumes you have the Xmera soure code. You need to install the python utility pytest if this is not available on your system. Instructions are found at installOptionalPackages. Next, navigate to the folder Xmera\src and run pytest from there.

  3. How can I run pytest faster?

    One can distribute python tests across multiple processes. This is achieved with the pytest-xdist package using:

    pip3 install pytest-xdist

    After installing this package you can now pytest such that it distribute tests across multi-processes. pytest for 8 processes using:

    python3 -m pytest -n 8

    or replace 8 with either the number of processors (virtual or otherwise) of your host machine, or “auto” to use all available processors.

  4. How can I used pytest to generate a Xmera validation HTML report?

    You will need to install pytest-html package, see installOptionalPackages. Then you can do this with:

    python3 -m pytest --report

    This generates an HTML report in a local tests/report folder.

  5. How do I perform a clean build of Xmera?

    IDE’s like X-Code provide a “clean” function. This will remove some compiled code, but in Xmera it does not get rid of all the SWIG’d code, and there can be compiler warnings related to the last CMAKE settings used.

    To do a basic clean build that will cover most odd cases, you can do this manually by

    • delete the folder of dist3 or dist and create a new folder with that name

    • follow the regular configure and build instruction in configureBuild

    You can also use the clean flag in the instruction at configureBuild to do a clean and configure all in one.

    To really have a clean clean build you want to get rid of the .conan file that stores the dependencies for Xmera. To do this you

    • delete the .conan folder in your home directory

    • follow the regular build instructions in configureBuild using the clean flag

This Page