vfox-elixir plugin

Elixir vfox plugin. Use the vfox to manage multiple Elixir versions in Linux/MacOS/Windows.

Usage

# install plugin
vfox add --source https://github.com/knevan/vfox-elixir/releases/download/v1.0.0/vfox-elixir-1.0.0.zip elixir

# install an available version
vfox search elixir
# or specific version 
vfox install elixir@1.18.0

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 22.04 and MacOS 13.

install in Linux (Ubuntu 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 erlang
vfox install erlang@27.3.4
vfox use -g erlang@27.3.4

# install Elixir
vfox add elixir
vfox install elixir@1.18.0
vfox use -g elixir@1.18.0

install in Darwin (MacOS 13)

# install utilities
brew install autoconf libxslt fop wxwidgets openssl

# install Erlang/OTP
vfox add erlang
vfox install erlang@27.3.4
vfox use -g erlang@27.3.4

# install Elixir
vfox add elixir
vfox install elixir@1.18.0
vfox use -g elixir@1.18.0

install Elixir in Windows platform

You should use vfox 1.0.0+ 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 erlang@27.3.4

# Get avaliable version
vfox search elixir

# install an specific version
vfox install elixir@1.18.0-elixir-otp-27

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-27

Usage with mise

The plugin can also be used with mise:

# Elixir need Erlang/OTP, so install Erlang/OTP first
mise install vfox:version-fox/vfox-erlang@27.3.4
mise use -g vfox:version-fox/vfox-erlang@27.3.4

# Install an available version
mise plugin install vfox-elixir https://github.com/knevan/vfox-elixir
mise install vfox-elixir:elixir@1.18.0
mise use -g vfox-elixir:elixir@1.18.0