Antes de começarmos é importante trazer que esse artigo faz parte de uma série de outros artigos, nos quais documentarei a minha experiência pessoal com Elixir e meus primeiros passos.

Vim recentemente do Node.js e todo mundo sabe como é simples configurar o seu setup, baixar o NPM, Snippets no VSCode, etc.

Elixir

No Elixir não é tão difícil, porém tive muita dificuldade de encontrar um passo a passo e acabei pulando etapas, o que me deu muita dor de cabeça depois para consertar.

Dito isto, resolvi trazer um passo a passo para você configurar seu setup do zero, bora lá!

P.S. Utilizarei o Linux Mint e você pode adaptar para o seu SO ok?

ASDF (What?)

A primeira coisa que nós vamos instalar na nossa máquina é esse bichinho chamado ASDF e, se você nunca ouviu falar nele, faço questão de te apresentar.

ASDF é um gerenciador de máquina virtual que nós vamos utilizar para instalar o Elixir e o Erlang.

Então, dê um gole no café ☕ e vamos começar!

Instalando ASDF-Vm

Primeiro, acesse o site oficial.

Clique em ‘Get Started’

Procure o gerenciador de pacotes para o seu SO. No meu caso, como estou usando o Linux Mint e vou usar o Aptitude (o famoso APT).

apt install curl git

Depois disso, vamos clonar o repositório do ASDF na nossa maquina.

git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.9.0

⚠️ Esse passo é muito importante ⚠️ Vamos combinar a instalação com o Shell. No meu caso, como estou usando Oh-My-ZSH, vou nessa opção:

Se você estiver utilizando Oh-My-ZSH, basta seguir o passo-a-passo do repositório do plugin, que é basicamente adicionar essa linha de código ao arquivo ./zshrc

Depois disso, fechar o terminal e abri-lo novamente.

plugins=(git asdf)

Caso você esteja utilizando o terminal puro, vá à opção Bash & Git.

Basta adicionar essas duas linhas de código no arquivo ~/.bashrc

Depois disso, fechar o terminal e abri-lo novamente.

. $HOME/.asdf/asdf.sh
. $HOME/.asdf/completions/asdf.bash

Rode o seguinte comando para testar se deu tudo certo:

asdf --version

Você devera ver algo parecido com isso:

>asdf --version
v0.9.0-9ee24a3

Instalando Plugin Erlang na ASDF

Beleza 👍, com a ASDF instalada chegou a hora de instalar os plugins. Vamos começar pelo Erlang.

Vamos iniciar rodando o seguinte comando no terminal:

asdf plugin-add erlang

Após isso, precisaremos instalar algumas dependências que estão aqui nesse repositório.

No meu caso, como estou rodando no Mint, vou buscar para Ubuntu 20:

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

Instalando Erlang

Com as dependências baixadas vamos procurar as versões do Erlang com o seguinte comando:

asdf list-all erlang

Seu terminal deve ter uma lista parecida com essa:

Vamos instalar a última versão estável que, até o momento desse artigo, é a 24.2.1:

asdf install erlang 24.2.1

Você verá a instalação do Erlang e não se preocupe, ela demora e realmente parece que seu computador travou, tenha calma!

Iniciando o Erlang

Agora com o Erlang instalado vamos rodar o comando para iniciar globalmente:

asdf global erlang 24.2.1

E vamos testar abrindo o Shell do Erlang:

erl

Você deverá ver algo parecido com isso, basta sair dando CTRL + C duas vezes.

Instalando Plugin Elixir na ASDF

Ufa! Cansou? Estamos acabando. Dá mais um gole no café e roda esse comando no terminal:

asdf plugin-add elixir

Vamos ver todas as versões do Elixir, assim como fizemos com Erlang:

asdf list-all elixir

Instalando Elixir

Como instalamos o Erlang 24, temos que instalar o Elixir OTP para versão 24. A versão mais recente, até o momento desse artigo, é a 1.13.3-otp-24.

Vamos rodar o seguinte comando:

asdf install elixir 1.13.3-otp-24

Vamos configurar o Elixir globalmente, assim como fizemos com o Erlang:

asdf global elixir 1.13.3-otp-24

Iniciando o Elixir

Vamos testar se deu tudo certo rodando o IEX:

iex

Você deverá ver algo parecido com isso:

Hello World!

E para começar do jeito certo, não se esqueça de não cair na maldição do Hello World, rodando o seguinte comando no IEX:

IO.puts("Hello World")

Be Cool with Livebook

O Livebook é parecido com o Jupyter Notebook do Python, é uma forma de você aplicar, documentar e testar códigos Elixir e salvar seus arquivos MD.

Instalando Livebook

A primeira coisa que vamos fazer é ir até o repositório do Livebook.

Como já estamos com o Elixir instalado globalmente, vamos rodar o seguinte comando:

mix escript.install hex livebook # mix é um comando global do Elixir

A instalação pode demorar um pouco e pedirá algumas confirmações no processo. No final, ele perguntará se você quer realmente instalar o livebook, vamos responder Y.

Feito isso, como estamos rodando o ASDF, precisamos usar o RESHIM para reconhecer os novos comandos.

asdf reshim

Por fim, podemos iniciar o Livebook com o seguinte comando.

livebook server

Ele rodará na porta 8080 na sua localhost.

Elixir : Conclusão

Nesse artigo, aprendemos a instalar e configurar a ASDF-VM para rodar o Erlang e o Elixir e instalar o Livebook local.

Até a próxima!