ENPT

Instalando o Ruby com chruby e ruby-install

Todo desenvolvedor Ruby provavelmente usará um gerenciador de versões do Ruby. Os mais populares são: RVM, rbenv e chruby. Use o que te deixar feliz. Eu fui de chruby e estou feliz com ele.

O que é o chruby

O chruby é uma ferramenta de linha de comando que permite alternar entre diferentes versões do Ruby. Ela permite que você mude entre elas manualmente, ou pode mudar a versão para você automaticamente conforme você navega entre as pastas de projeto.

Ele é capaz apenas de alternar entre versões, não de instalá-las. O mantenedor do chruby tem outra ferramenta para instalá-las, chamada ruby-install.

O que é o ruby-install

O ruby-install também é uma ferramenta de linha de comando que se pode usar para instalar vários sabores de Ruby. Sim, existem muitos: Ruby, JRuby, TruffleRuby e mruby. Foque no primeiro, é o mais popular e foi criado por Yukihiro “Matz” Matsumoto, o criador do Ruby.

Instalando o chruby e o ruby-install

Ambas as ferramentas são mantidas pela mesma pessoa, então seguem o mesmo padrão de instalação, e até os arquivos README são muito parecidos. Elas foram feitas para trabalhar em conjunto.

Arquivo README do chruby vs ruby-install Arquivo README do chruby vs ruby-install

Siga o guia de instalação do README deles, para o ruby-install aqui e para o chruby aqui. Normalmente, eu apenas baixo o tarball via wget e compilo usando make install.

Nota (2024-11-22): Tive um problema ao instalá-lo no WSL Ubuntu 24.04 com zsh e acabei tendo que adicionar manualmente as seguintes linhas ao meu arquivo ~/.zshrc.

source /usr/local/share/chruby/chruby.sh
source /usr/local/share/chruby/auto.sh

Como usá-los juntos

Para obter a versão mais recente do Ruby, execute:

ruby-install --update ruby

Para obter uma versão específica (o que é muito comum), execute:

ruby-install ruby 2.7.5

Depois de ter o ruby (a ferramenta de linha de comando) instalado, é hora de colocá-lo no seu PATH atual (selecionado) usando o chruby.

Liste a versão instalada usando:

chruby
   ruby-2.7.5
 * ruby-3.0.3

O * ao lado da versão significa que ela é a versão selecionada. Se você executar ruby --version, deverá obter essa mesma versão.

Para alternar para uma versão específica, execute:

chruby ruby-2.7.5

A ferramenta chruby não listará a versão do Ruby que vem pré-instalada com o seu sistema operacional. Para voltar a ela, execute:

chruby system

Alternando automaticamente entre versões

O chruby procurará um arquivo chamado .ruby-version toda vez que você navegar entre pastas. Se o arquivo não for encontrado na pasta, ou em um de seus diretórios superiores, o chruby procurará um no diretório home (~/).

Experimente com:

echo "ruby-3.0.3" > ~/.ruby-version

Conclusão

Espero que este post ajude a aliviar um pouco da dor de cabeça que é começar com um ambiente de desenvolvimento Ruby funcional (e que funcione).