Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Setting up your development environment

Conjure Oxide supports Linux and Mac.

Windows users should install WSL and follow the Linux (Ubuntu) instructions below:

Linux (Debian/Ubuntu)

The following software is required:

  • The latest version of stable Rust, installed using Rustup.
  • A C/C++ compilation toolchain and libraries:
    • Debian, Ubuntu and derivatives: sudo apt install build-essential libclang-dev
    • Fedora: sudo dnf group install c-development and sudo dnf install clang-devel
  • Conjure.
    • Ensure that Conjure is placed early in your PATH to avoid conflicts with ImageMagick's conjure command!
MacOS

The following software is required:

  • the latest version of stable Rust, installed using Rustup.
  • an XCode Command Line Tools installation (installable using xcode-select --install)
  • CMake: brew install cmake (for SAT solving)
  • Conjure.
St Andrews CS Linux Systems

  1. Download and install the pre-built binaries for Conjure. Place these in /cs/home/<username>/usr/bin or elsewhere in your $PATH.

  2. Install rustup and the latest version of Rust through rustup. The school provided Rust version does not work.

    • By default, rustup installs to your local home directory; therefore, you may need to re-install rustup and Rust after restarting a machine or when using a new lab PC.

Improving Compilation Speed

Installing sccache improves compilation speeds of this project by caching crates and C/C++ dependencies system-wide.

  • Install sccache and follow the setup instructions for Rust. Minion detects and uses sccache out of the box, so no C++ specific installation steps are required.

This section had been taken from the 'Setting up your development environment' page of the conjure-oxide wiki