Usando Ruby

O ServBay oferece aos desenvolvedores Ruby um ambiente de desenvolvimento eficiente e flexível no macOS. Com o sistema de gerenciamento de pacotes do ServBay, você pode instalar e gerenciar facilmente múltiplas versões do Ruby em paralelo. O poderoso arquivo .servbay.config permite especificar a versão do Ruby necessária para cada projeto, simplificando seu fluxo de trabalho e garantindo a consistência do ambiente.

Visão Geral

Introdução à Linguagem Ruby

Ruby é uma linguagem de programação orientada a objetos, dinâmica e de código aberto, conhecida por sua sintaxe elegante e foco na produtividade do desenvolvedor. Criada por Yukihiro "Matz" Matsumoto no Japão na metade dos anos 1990, sua filosofia de design é "tornar a programação mais prazerosa". Ruby foi influenciada por linguagens como Perl, Smalltalk, Eiffel, Ada e Lisp, destacando a legibilidade e simplicidade do código.

Em Ruby, tudo é objeto. Ela suporta múltiplos paradigmas de programação, incluindo orientação a objetos, programação procedural e funcional. O sucesso mundial do Ruby é fortemente atribuído ao lançamento do framework web Ruby on Rails por David Heinemeier Hansson (DHH) em 2004, que revolucionou o desenvolvimento de aplicações web. Atualmente, Ruby é amplamente usada em desenvolvimento web (Rails, Sinatra), scripts, automação, prototipagem, entre outros. Seu ecossistema conta com o RubyGems (gerenciador de pacotes) e o Bundler (gerenciador de dependências).

Suporte do ServBay ao Ruby

O ServBay gerencia diferentes versões do interpretador Ruby como pacotes independentes, oferecendo as seguintes vantagens principais:

1. Múltiplas versões em paralelo: Instale várias versões do Ruby (como Ruby 2.7, 3.0, 3.3, 3.4, etc.) sem se preocupar com conflitos de versão.
2. Controle de versão por projeto: Use o exclusivo arquivo .servbay.config do ServBay para especificar exatamente qual versão do Ruby cada projeto necessita.
3. Gestão simplificada: Veja, instale e desinstale diferentes versões do Ruby de forma visual pela interface gráfica do ServBay.
4. Gerenciamento integrado de Gems: Após a instalação do Ruby, você pode gerenciar RubyGems diretamente com o comando gem.

Isso é essencial para quem desenvolve projetos antigos que exigem versões antigas do Ruby, novos projetos (como aplicações Ruby on Rails) ou ferramentas específicas baseadas em Ruby.

Acessando os Pacotes Ruby

1. Abra o aplicativo do ServBay.
2. No menu de navegação à esquerda, clique em Pacotes (Packages).
3. Na página Pacotes, role para baixo ou selecione na lista à esquerda Languages -> Ruby.
4. À direita, você verá a lista de todos os pacotes Ruby disponíveis.

Instalando o Ruby

A lista de pacotes exibe claramente o status de cada versão do Ruby:

• Nome do Pacote: O nome do pacote, como Ruby 3.3.
• Versão: A versão específica daquele pacote.
• Status: Indica Installed (Instalado) ou Not Installed (Não instalado).
• Controle: Botão para ações.

Para instalar uma versão do Ruby que ainda não está instalada (por exemplo, Ruby 3.3):

1. Encontre a versão desejada na lista.
2. Verifique se o status é Not Installed.
3. Clique no ícone Baixar/Instalar (Download/Install) no canto direito (geralmente uma seta para baixo).
4. O ServBay irá baixar e instalar a versão selecionada do Ruby. O processo pode levar alguns minutos.
5. Quando terminar, o status mudará para Installed e o ícone de controle se tornará o ícone de Desinstalar (Uninstall) (lixeira).

Gerenciando Versões Instaladas do Ruby

• Visualizar versões instaladas: O status Installed na lista indica claramente todas as versões do Ruby disponíveis no seu ambiente atual.
• Desinstalar o Ruby: Se não precisar mais de uma versão do Ruby, basta clicar no ícone de Desinstalar (Uninstall) correspondente (lixeira) e confirmar para removê-la do sistema.

Usando o Ruby Instalado

Quando o Ruby é instalado pelo ServBay, ele é adicionado às variáveis de ambiente gerenciadas pelo ServBay. Ao ativar o ambiente do ServBay no terminal, você pode usar os comandos ruby e gem normalmente.

Exemplos de comandos comuns:

1. Verificar a versão ativa do Ruby: Abra o terminal e execute:

   ruby -v

   Isso exibirá a versão do Ruby ativa na sessão atual. Ela pode ser determinada pelas configurações globais ou pelo arquivo .servbay.config do projeto.

2. Verificar a versão do RubyGems:

   gem -v

3. Instalar um pacote Gem: Exemplo, para instalar o gerador de sites estáticos Jekyll:

   gem install jekyll

   Ou para instalar o framework Ruby on Rails:

   gem install rails

4. Executar um script Ruby: Crie um arquivo chamado hello.rb com o seguinte conteúdo:

   #!/usr/bin/env ruby
   puts "Hello from Ruby in ServBay!"

   Execute no terminal:

   ruby hello.rb

Gerenciamento de Versão por Projeto: .servbay.config

Uma das maiores vantagens do ServBay é o suporte a configurações de ambiente por projeto. Adicionando um arquivo chamado .servbay.config na raiz do projeto, você trava a versão do Ruby necessária para aquele projeto.

Vantagens:

• Gerenciamento de múltiplas linguagens: Defina versões de Ruby, PHP, Node.js, Python, Go, Java, .NET e mais em um único arquivo.
• Consistência garantida: Todos da equipe ou ambientes de deploy usarão exatamente a mesma versão do Ruby.
• Troca automática: Ao acessar uma pasta com .servbay.config usando o comando cd, o ambiente ServBay detecta e aplica automaticamente o valor de RUBY_VERSION definido ali.

Exemplo de configuração:

Crie o arquivo .servbay.config na raiz do projeto Ruby e adicione a variável RUBY_VERSION para especificar a versão principal desejada (por exemplo, 2.7, 3.3). O ServBay usará a revisão instalada mais recente daquela série principal.

# .servbay.config

# Especifica a versão principal do Ruby para o projeto (exemplo: 3.3)
# O ServBay automaticamente seleciona a versão mais recente disponível da série 3.3.x
RUBY_VERSION=3.3

# Você também pode especificar versões de outras linguagens e configurações
NODE_VERSION=18
# ... outras configurações ...

Ao abrir o terminal neste diretório e ativar o ambiente ServBay, usando ruby -v você verá a versão do Ruby especificada no .servbay.config (ou a mais recente daquela série principal instalada).

Exemplo de Uso Simples

Vamos criar um projeto simples para demonstrar a utilidade do .servbay.config:

1. Crie um diretório para o projeto:

   mkdir my-ruby-project
   cd my-ruby-project

2. Crie o .servbay.config: No diretório my-ruby-project, crie um arquivo .servbay.config com o conteúdo:

   RUBY_VERSION=2.7 # Supondo que você já tenha o Ruby 2.7.x instalado

   (Certifique-se de que o Ruby 2.7 está instalado no ServBay)

3. Crie um script Ruby: Crie o arquivo app.rb:

   #!/usr/bin/env ruby
   puts "Project is using Ruby version: #{RUBY_VERSION}"

4. Ative e verifique: (Com o ambiente ServBay ativo) No diretório my-ruby-project, execute:

   ruby -v

   O comando deve exibir a versão Ruby 2.7.x instalada.

5. Execute o script:

   ruby app.rb

   A saída será: Project is using Ruby version: 2.7.x (x corresponde à revisão instalada).

6. Instale as dependências do projeto (exemplo): Se o projeto usa o Bundler para dependências (comum em Rails), rode:

   # Se o bundler não estiver instalado
   # gem install bundler
   bundle install

   O Bundler instalará as dependências do Gemfile, respeitando a versão Ruby ativa (2.7.x).

Agora, se outro projeto exigir Ruby 3.4, basta definir RUBY_VERSION=3.4 no .servbay.config daquele projeto. Ao alternar de diretório, o ServBay ajusta o ambiente do Ruby automaticamente.

Integração com Servidor Web (Rails, Sinatra, etc.)

Para aplicações web desenvolvidas com Ruby on Rails, Sinatra ou outros frameworks, normalmente são usados servidores de aplicação como Puma, Unicorn ou Thin. Você pode:

1. Criar um Website no ServBay para sua aplicação.
2. Configurar o servidor web do ServBay (Nginx, Caddy, Apache) como proxy reverso, redirecionando requisições do domínio desejado para a porta que seu servidor Ruby estiver escutando (por exemplo, http://localhost:3000 ou um socket Unix do Puma/Unicorn).

Esse setup permite tirar proveito do gerenciamento de domínios, HTTPS automático (quando configurado) e acesso centralizado providos pelo ServBay.

Resumo

O ServBay facilita enormemente o desenvolvimento Ruby no macOS. Com sua interface de gerenciamento de pacotes intuitiva e o controle de versões por projeto via .servbay.config, você pode administrar facilmente múltiplas versões do Ruby e seus Gems, garantindo ambientes isolados e consistentes para cada projeto. Isso aumenta a eficiência e a confiabilidade no desenvolvimento com Ruby.