which_rust is a utility that reveals which Rust version is active in the current directory, if any.
@1000000000 and I created the first iteration of which_rust in a pair-programming session at The Recurse Center.
We designed it to be included in PS1 in shell profiles, so you can tell, just by looking at the prompt in your shell, which version of Rust you're using. We were inspired by the way pyenv displays the Python version in the command line.
Here's an example of a prompt that includes which_rust.
- These instructions assume you have Rust installed on your machine.
- Clone or download this repository.
- In the root directory of the repository, execute the following commands:
cargo buildcargo install --path .
which_rust takes 2 optional command-line arguments.
-pText to be added before the Rust version.-sText to be added after the Rust version.
which_rust prints 1.39.0-nightly
which_rust -p "<" -s ">" prints <1.39.0-nightly>
Include `which_rust` in PS1 in your shell configuration script (.bash_profile, .bashrc, .zshrc, etc.) if you're using Bash or Zsh. There is thorough information about customing your Bash prompt here. Search the web for instructions if you're using a different shell.
The command line pictured above was produced by the following lines in .bash_profile on OS/X.
GREEN="\[$(tput setaf 2)\]"
MAGENTA="\[$(tput setaf 5)\]"
RED="\[$(tput setaf 1)\]"
RESET="\[$(tput sgr0)\]"
BRIGHT_BLUE="\[$(tput setaf 4)\]\[$(tput bold)\]"
GIT_PS1_SHOWDIRTYSTATE=true
export PS1="${MAGENTA}\w${GREEN}`which_rust -p " <rust " -s ">"`${RED}\$(__git_ps1)${RESET}\n${BRIGHT_BLUE}==>${RESET} "
which_rust will return nothing if the current directory doesn't seem to be part of a Rust project. We assume that a directory that contains Cargo.toml, or is a child of a directory that contains Cargo.toml, is part of a Rust project. (Note that if for some reason there is a Cargo.toml in your home directory, or the root directory of a filesystem, we don't consider every child directory to be part of a Rust project.)
Welcome and encouraged.