Skip to content

Setting up your development environment

Niklas Dewally edited this page Oct 10, 2024 · 5 revisions

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: sudo apt install build-essential libclang-dev
  • 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)
  • 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.