vfox-elixir plugin

Elixir vfox plugin. Use the vfox to manage multiple Elixir versions in Linux/Darwin MacOS/Windows. all platform~

Usage

# install plugin
vfox add --source https://github.com/version-fox/vfox-elixir/archive/refs/heads/main.zip elixir

# install an available version
vfox search elixir
# or specific version 
vfox install [email protected]

Before install Elixir

vfox-elixir plugin would install Elixir through the Elixir source code compilation. So you must have the utilities mentioned in the document -> Compiling from source.

The installation of Elixir relies on Erlang/OTP. You can use the vfox-erlang plugin to manage your Erlang/OTP versions.

Ensure that Elixir and Erlang/OTP versions are compatible -> Elixir and Erlang/OTP compatibility.

Here are two examples of installing on Ubuntu 20.04 and MacOS 13.

install in Linux (Ubuntu 20.04/22.04)

# install utilities
sudo apt-get -y install build-essential autoconf m4 libncurses5-dev libwxgtk3.0-gtk3-dev libwxgtk-webview3.0-gtk3-dev libgl1-mesa-dev libglu1-mesa-dev libpng-dev libssh-dev unixodbc-dev xsltproc fop libxml2-utils libncurses-dev openjdk-11-jdk

# install Erlang/OTP
vfox add --source https://github.com/version-fox/vfox-erlang/archive/refs/heads/main.zip erlang
vfox install [email protected]
vfox use -g [email protected]

# install Elixir
vfox add --source https://github.com/version-fox/vfox-elixir/archive/refs/heads/main.zip elixir
vfox install [email protected]
vfox use -g [email protected]

You can reference the E2E test in Ubuntu 20.04: https://github.com/version-fox/vfox-elixir/actions/workflows/e2e_test.yaml

install in Darwin (MacOS 13)

# install utilities
brew install autoconf libxslt fop wxwidgets openssl

# install Erlang/OTP
vfox add --source https://github.com/version-fox/vfox-erlang/archive/refs/heads/main.zip erlang
vfox install [email protected]
vfox use -g [email protected]

# install Elixir
vfox add --source https://github.com/version-fox/vfox-elixir/archive/refs/heads/main.zip elixir
vfox install [email protected]
vfox use -g [email protected]

You can reference the E2E test in MacOS 13: https://github.com/version-fox/vfox-elixir/actions/workflows/e2e_test.yaml

install Elixir in Windows platform

You should use vfox 0.5.3+ to add vfox-elixir plugin in Windows platform. Only support install Elixir versions after v1.15, Elixir versions before v1.15 can also be installed using the deprecated Online Elixir Installer.

# make sure an Erlang/OTP version is installed.
vfox use -g [email protected]

# Get avaliable version
vfox search elixir

# install an specific version
vfox install [email protected]

install a pre-built version from hex.pm

You can also download a pre-built version from hex.pm. vfox-elixir will download it from: https://github.com/hexpm/bob?tab=readme-ov-file#elixir-builds

(1) > VFOX_ELIXIR_MIRROR=hex vfox search elixir
Please select a version of elixir to install [type to search]: 
->  vmain (pre-built from hex.pm)
   vmain-otp-22 (pre-built from hex.pm)
   vmain-otp-23 (pre-built from hex.pm)
   vmain-otp-24 (pre-built from hex.pm)
   vmain-otp-25 (pre-built from hex.pm)
   vmain-otp-26 (pre-built from hex.pm)
   vmain-otp-27 (pre-built from hex.pm)
   vmain-otp-28 (pre-built from hex.pm)
   vmaster (pre-built from hex.pm)

(1) > VFOX_ELIXIR_MIRROR=hex vfox install elixir@main-otp-26