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)
• 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.