Alpha. Vary is under active development and not ready for production use. Syntax, APIs, performance, and behaviour may change between releases.
Linux
Quick install
One command installs varyup (the toolchain manager) and the latest Vary toolchain.
curl -fsSL https://github.com/ccollicutt/vary/releases/latest/download/install.sh | sh
This will download varyup to ~/.vary/bin/, install the latest Vary toolchain, and install the vary compiler shim.
Then add ~/.vary/bin to your PATH. Add this line to ~/.bashrc or ~/.zshrc:
export PATH="$HOME/.vary/bin:$PATH"
Restart your shell, then verify:
vary --version
You should see:
Vary vX-alpha.Y
Options
| Flag | Effect |
|---|---|
--skip-toolchain | Skip automatic toolchain install |
Environment variables VARY_HOME (default: ~/.vary) and VARY_RELEASE_URL can override defaults.
Manual install
If you prefer not to pipe to sh, you can install manually:
1. Download varyup
mkdir -p ~/.vary/bin
curl -fSL "https://github.com/ccollicutt/vary/releases/latest/download/varyup-linux-x64" -o ~/.vary/bin/varyup
chmod +x ~/.vary/bin/varyup
2. Verify checksum
curl -fSL "https://github.com/ccollicutt/vary/releases/latest/download/SHA256SUMS" -o /tmp/SHA256SUMS
cd ~/.vary/bin && grep "varyup-linux-x64$" /tmp/SHA256SUMS | sha256sum -c -
You should see varyup-linux-x64: OK. If the check fails, delete the binary and retry the download.
3. Add to PATH
Add to ~/.bashrc or ~/.zshrc:
export PATH="$HOME/.vary/bin:$PATH"
Reload your shell and install a toolchain:
source ~/.bashrc # or: source ~/.zshrc
varyup toolchain install latest
Managing toolchains
List available versions:
varyup toolchain list-available
Install a specific version:
varyup toolchain install <version>
Short aliases are available:
varyup tc la # list-available
varyup tc i # install
Run varyup with no arguments to see all commands and aliases.
Install VS Code extension
Each toolchain bundles the Vary VS Code extension. Install it with:
varyup vscode install
See VS Code for full extension documentation.
Next steps
| Action | Link |
|---|---|
| Manage versions, update, pin per-project | varyup |
| Write your first program | Getting Started |
Run vary test on examples | Testing |
Run vary mutate on examples | Mutation testing |