Skip to content

Latest commit

 

History

History
106 lines (79 loc) · 4.05 KB

preliminaries.md

File metadata and controls

106 lines (79 loc) · 4.05 KB
Raw

Preliminaries

This page summarizes the requirements to configure, build, and run mutable, and lists the dependencies of mutable.

Tools

Install the following tools:

  • Git
  • CMake (3.20 or newer)
  • GNU Make / Ninja / some other build tool of your choice
  • Clang 16 or newer (see Build Clang from Source)
  • Doxygen (to generate the documentation)
  • Perl (for our git-hooks)
  • Pipenv (to set up a virtual Python environment and manage packages)

Further, if you wish to build mutable with its WebAssembly-based backend (which is the default), you need to install the following Google tools as well:

Dependencies

mutable depends on several third-parties. We ship most of them indirectly through CMake's "external projects". However, some third-parties are required to be installed on your system.

Mandatory Dependencies

Below is a list of mandatory dependencies, that must be installed:

  • Boost libraries and development header files.
    • On ArchLinux: pacman -S boost
  • Graphviz development headers
    • Make sure gvc.h is found in one your system include directories.
    • On ArchLinux: pacman -S graphviz

Optional Dependencies

The dependencies listed below are optional. Having them available on your system provides new features to mutable or improves working on mutable.

Graphviz

Doxygen can use Graphviz to render inheritance and collaboration diagrams.

  • At least graphviz>=1.8.10 is required by our Doxyfile. If you have an older version set DOT_MULTI_TARGETS = NO.
  • On ArchLinux: pacman -S graphviz
  • On macOS: brew install graphviz.

Python Environment & Packages

We implement our own testing and benchmarking frameworks in Python. We manage our required packages with Pipenv and package versions are specified in the Pipfile.lock file. Ensure that you have a Python provider installed, e.g. pyenv or the currently required version of Python.

To install our required packages, run pipenv sync.

Building with the WebAssembly-based Execution Backend

See Building with V8.

Install our git-hooks

We use perl in our git-hooks. Make sure it is in your $PATH. We implement custom git-hooks to enforce code quality. You must install them locally in your repo with the following commands:

$ cd .git/
$ rm -fr hooks/
$ ln -s ../hooks

This way, our hooks are properly installed and contained in version control.

Troubleshooting

Pipenv

  • On macOS, setting up the Pipenv virtual environment can fail because of a build error in the pygraphviz setup. If the installation of pygraphviz with pipenv fails with the following error: 
    fatal error: 'graphviz/cgraph.h' file not found
    then the problem is that the required header file is not installed in one of the compiler's searched include directories. To resolve the problem, we must manually provide the include directory to the build of pygraphviz.
  1. Run the following command to build pygraphviz with the additional include directory. 
    $ pipenv run pip install --use-pep517 \
                         --config-settings="--global-option=build_ext" \
                         --config-settings="--global-option=-I$(brew --prefix graphviz)/include/" \
                         --config-settings="--global-option=-L$(brew --prefix graphviz)/lib/" \
                         pygraphviz
  2. Run pipenv sync as usual.
  • On macOS, setting up the Pipenv virtual environment may fail while trying to install psycopg2 with the following error. 
    Error: pg_config executable not found
    In this case, the postgresql binaries are not in the PATH.
  1. Install a recent version of PostgreSQL, e.g. postgresql@16. 
    $ brew install postgresql@16
  2. Add the binaries of your install PostgreSQL version, e.g. postgresql@16, to your PATH. 
    $ export PATH="$PATH:$(brew --prefix postgresql@16)/bin"
  3. Run pipenv sync as usual.