O que são gems e Bundler?

Question

Accepted Answer

**Gems** são os pacotes (bibliotecas) do Ruby distribuídos via RubyGems. **Bundler** gerencia as dependências de gems de um projeto — instalando as versões corretas e garantindo ambientes **consistentes e reproduzíveis** entre máquinas por meio de um lockfile. Juntos, eles são como projetos Ruby gerenciam dependências.

## Gems — pacotes Ruby

```bash
gem install rails          # install a gem globally
gem list                   # list installed gems
# gems come from rubygems.org — the central package registry (Rails, RSpec, etc.)
```

Um gem é uma biblioteca Ruby empacotada (código + metadados). RubyGems é o gerenciador de pacotes e rubygems.org é o registro — equivalente do Ruby a npm/pip.

## Bundler — gerenciamento de dependências do projeto

```ruby
# Gemfile — declares your project's gem dependencies
source "https://rubygems.org"

gem "rails", "~> 7.0"        # version constraint (~> allows compatible updates)
gem "pg"                     # PostgreSQL adapter
gem "rspec", group: :test    # only in the test environment
```

```bash
bundle install               # install all gems from the Gemfile (creates Gemfile.lock)
bundle update                # update gems to newer allowed versions
bundle exec rspec            # run a command with the project's exact gem versions
```

O **`Gemfile`** declara as dependências do seu projeto com restrições de versão. `bundle install` as instala e gera o **`Gemfile.lock`**.

## O lockfile — installs reproduzíveis

```text
Gemfile      → declares dependencies with constraints (e.g. rails ~> 7.0)
Gemfile.lock → records the EXACT versions of every gem (and sub-dependency) installed
→ COMMIT Gemfile.lock → everyone (team, CI, production) gets the IDENTICAL versions.
  Prevents "works on my machine" bugs from version differences.
```

O **`Gemfile.lock`** fixa as versões exatas de todos os gems (incluindo dependências transitivas), então fazer commit dele garante que todos os desenvolvedores, CI e produção instalem a *árvore de dependências idêntica* — ambientes reproduzíveis e consistentes. Sempre faça commit dele.

## bundle exec — use as versões do projeto

```bash
bundle exec rspec    # runs rspec using the EXACT versions in Gemfile.lock
# (vs `rspec` which might use a different globally-installed version)
```

## Por que isso importa

Gems e Bundler são fundamentais no desenvolvimento Ruby — é assim que praticamente todo projeto Ruby gerencia dependências, então entendê-los é essencial. **Gems** (pacotes Ruby de rubygems.org) fornecem as bibliotecas e frameworks (Rails, RSpec, etc.) dos quais aplicações reais dependem, e **Bundler** é a ferramenta padrão para gerenciá-los em um projeto.

O valor-chave que Bundler fornece — e o conceito mais importante de entender — é **ambientes reproduzíveis e consistentes**: o **`Gemfile`** declara dependências com restrições de versão, e o **`Gemfile.lock`** fixa as *versões exatas* de todos os gems (incluindo dependências transitivas) que foram instalados.

Fazer commit do `Gemfile.lock` garante que todos — todo o time, CI e produção — instalem a árvore de dependências idêntica, prevenindo os bugs de "funciona na minha máquina" que surgem de diferenças de versão.

Essa reprodutibilidade é crítica para desenvolvimento e deployment confiáveis e colaborativos.

Entender gems (pacotes do Ruby), o Gemfile (declarando dependências), `bundle install`, o **lockfile e por que fazer commit dele** (installs reproduzíveis — o benefício central), e `bundle exec` (executando comandos com as versões exatas do projeto) é conhecimento importante e do dia a dia para qualquer projeto Ruby.

Como gerenciamento de dependências é fundamental para aplicações reais, e como a reprodutibilidade baseada em lockfile do Bundler é como times Ruby garantem ambientes consistentes entre desenvolvimento, CI e produção, dominar gems e Bundler — análogo a npm/package-lock.json em Node — é conhecimento essencial e frequentemente aplicado para desenvolvimento Ruby profissional.