Back to developer page.

Recommended development environment

TODO: keep information here in sync with ObtainingAndRunningFastDownward and ../Requirements

The requirements for building and running the planner are listed under ObtainingAndRunningFastDownward. Our automated tests have additional dependencies that can be installed as follows:

apt-get install clang-tidy-12 python3.8 python3.10 python3-pip valgrind wget
python3 -m pip install tox

We recommend using Ubuntu 20.04 or 22.04 for Fast Downward development since these versions are also used by the core developers and they allow installing many dependencies via the package manager.

Important: We want the code to compile without warnings, but in favour of user-friendliness we did not add the -Werror flag to the build script. Make sure that you compile your code with the -Werror flag, for example by adding export CXXFLAGS+=-Werror to your bashrc. Note that you should build the binary from scratch after this (i.e. remove the builds directory if it exists), since it will not recompile files unless they have been changed.

Running tests

To run all tests under all locally-available Python versions, run tox in the misc/ directory. The command creates Python virtual environments under misc/.tox. The directory uses ~50 MB and is not shown by git status. You can safely delete the directory after the tests have been run. To run a subset of tests, e.g., only the style checks, use tox -e style (see misc/tox.ini for other test environments). Many of the tests that tox executes are Bash/Python scripts or pytest modules, which you can also run individually. To check a pytest module, execute pytest my_module.py.