FAQ - Frequency Asked Questions

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

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

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

  2. How can I run pytest faster?

    Glad you asked. While Basilisk is a single threaded simulation, it is possible to run pytest in a multi-threaded manner:

    pip3 install pytest-xdist
    

    After installing this utility you now run the multi-threaded version of pytest for 8 threads using:

    python3 -m pytest -n 8
    
  3. How can I used pytest to generate a Basilisk validation HTML report?

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

    python3 -m pytest --report
    

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

  4. How do I perform a clean build of Basilisk?

    IDE’s like X-Code provide a “clean” function. This will remove some compiled code, but in Basilisk 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 Building the Software Framework

    You can also use the clean flag in the instruction at Building the Software Framework 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 Basilisk. To do this you