Installing rqm

rqm is one program, rqm, and a small crate for Rust projects, rqm-attr. You can build the program with cargo, or download a prebuilt one.

With cargo

cargo install rqm

This builds the latest release from crates.io. It needs Rust 1.89 or newer. Check the result with rqm --version.

A Rust project that binds its tests to requirements with markers needs the attribute crate as a dev-dependency:

cargo add --dev rqm-attr

Binding tests to requirements shows what to write with it.

A prebuilt program

Every release is published on the releases page of the project, with a file of checksums next to each archive:

  • rqm-VERSION-x86_64-unknown-linux-gnu.tar.gz is the program for Linux on x86-64.
  • rqm-VERSION-x86_64-pc-windows-gnu.zip is the program for Windows on x86-64.

Unpack the archive and put rqm where your PATH finds it. To check a download, compare the SHA-256 checksum of the archive with the one in the checksums file.

rqm is developed and tested on Linux. The Windows program is built from Linux and has never been run by the people who make rqm, and there is no program for macOS. Platforms says what is guaranteed where.

What else you need

rqm itself needs nothing else. It runs your tests through the command that you write in rqm.yaml, so that command has to be installed: for a Rust project that is usually cargo-nextest, which rqm init sets up a suite for. git is not needed, though rqm stops looking for rqm.yaml at the first .git entry it meets.