Skip to content

Setup Guide

RustAnlys edited this page May 29, 2024 · 3 revisions

Getting Started

You can build and install RUPTA into cargo from source code.

Requirement

RUPTA requires Rust nightly, as specified in rust-toolchain.toml.

If you don't currently have Rust installed on your system, you can find the installation instructions here.

Build and Install RUPTA

Clone the repository:

git clone https://github.com/rustanlys/rupta.git
cd rupta

To install RUPTA into Cargo:

cargo --locked install --path .

Or you can build RUPTA only:

cargo build

Running this command produces two binaries cargo-pta and pta at target/debug. To compile in release mode, run cargo build --release instead to put the resulting binaries in target/release.

Troubleshooting

You may encounter error when running RUPTA: dyld: Library not loaded. Try setting the environment variable LD_LIBRARY_PATH in Linux or DYLD_LIBRARY_PATH on Mac OS:

export DYLD_LIBRARY_PATH=/Users/$USER/.rustup/toolchains/nightly-YYYY-MM-DD-TA/lib/

RUPTA works with a specific version of rust toolchain. When multiple toolchains have been installed on the machine, you can specify the toolchain version when running the cargo command:

cargo +toolchain pta  # replace `toolchain` with the channel version in the `rust-toolchain.toml` file

Contributing to RUPTA

If you want to develop RUPTA see the RUPTA Design.


The above installation guide has been tested on MacOs 12.0, Ubuntu 20.04, and Windows Linux Subsystem (WSL v10.0) but it should work on most Linux-based systems.

Clone this wiki locally