c3vm is a bash-script that manages versions of the C3 compiler. It can download versions from GitHub releases, clone a GitHub repo and build from source, or even check in a local compiler from source and build it.

As this is a bash script, and I developped it, this probably will not work on everyones computer. I heard of issues from someone on Arch Linux, and Windows is just outright not supported.

For Linux or MacOS, you can easily edit the script if needed (f.e. changing build steps or the location c3vm stores the data).

If you add stuff that still supports the current supported platform (aka mine :P), and now also supports yours, then please do open a PR to get it merged in.

# Install and enable latest stable release
c3vm install

# Install a specific version but do not enable it
c3vm install --dont-enable v0.6.8

# Install debug compiler from source from a fork
c3vm install --from-source --remote bwindey/c3c --debug

# Enable that previous version
c3vm enable v0.6.8

A quick way to get started with c3vm + c3c you can execute the following three commands (you can copy them and paste them and your shell will execute them in order):

curl -o c3vm https://raw.githubusercontent.com/BWindey/c3vm/refs/heads/main/c3vm.sh
chmod u+x c3vm
./c3vm install

If you want to continue using c3vm, you'll want to move the script to somewhere in your $PATH.

You can also clone this repository and move the script or symlink it to somewhere in your $PATH.

Currently there are bash completions (pretty good ones imo). You can download the script and then in your ~/.bashrc do

source path/to/completion/script

If you're using another shell then Bash, I don't have an answer yet for you, but I'll gladly accept contributions that add completions for your shell.

There also is a manpage. After downloading it (or getting it by cloning this repository), you can copy or symlink it to your manpage folder, usually located in /usr/local/share/man/man1/. See more info here: https://www.baeldung.com/linux/man-pages-manual-install . (You might need to run mandb to update the man database.)

See the manpage. It's too late at the time of writing this to be bothered to explain it to you.

• A 'snapshot' subcommand for installing from-source that will store the currently enabled compiler under an alias (probably git/snapshots//) that allows you to quickly snapshot the version, update and compare behaviour.

There is the undocumented c3vm upgrade command. It will try to update the c3vm script itself, by checking if it is inside a git repo (and then do git pull) or else try to download it from Github with curl.

This upgrade subcommand will remain undocumented, as it is not meant to be used. After all, this c3vm script shouldn't really need to receive any updates anymore after the "beta" tag is lifted (see top of this README).