Czym są gems i Bundler?

Question

Accepted Answer

**Gems** to pakiety Ruby (biblioteki) dystrybuowane przez RubyGems. **Bundler** zarządza zależnościami gems projektu — instaluje odpowiednie wersje i zapewnia **spójne, powtarzalne** środowiska na różnych maszynach za pomocą pliku blokady. Razem stanowią sposób, w jaki projekty Ruby zarządzają zależnościami.

## Gems — pakiety 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.)
```

Gem to spakowana biblioteka Ruby (kod + metadane). RubyGems to menedżer pakietów, a rubygems.org rejestr — odpowiednik npm/pip dla Ruby.

## Bundler — zarządzanie zależnościami projektu

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

**`Gemfile`** deklaruje zależności projektu z ograniczeniami wersji. `bundle install` je instaluje i generuje **`Gemfile.lock`**.

## Plik blokady — powtarzalne instalacje

```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.
```

**`Gemfile.lock`** przypina dokładne wersje każdego gema (łącznie z zależnościami przechodnimi), więc zacommitowanie go gwarantuje, że wszyscy programiści, CI i produkcja instalują *identyczne* drzewo zależności — powtarzalne, spójne środowiska. Zawsze je zacommituj.

## bundle exec — użyj wersji projektu

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

## Dlaczego to ważne

Gems i Bundler są fundamentem rozwoju Ruby — to sposób, w jaki praktycznie każdy projekt Ruby zarządza zależnościami, więc ich zrozumienie jest niezbędne. **Gems** (pakiety Ruby z rubygems.org) dostarczają bibliotek i frameworków (Rails, RSpec itp.), od których zależy rzeczywiste oprogramowanie, a **Bundler** to standardowe narzędzie do zarządzania nimi w projekcie.

Kluczowa wartość, którą Bundler zapewnia — i najważniejsza koncepcja do zrozumienia — to **powtarzalne, spójne środowiska**: **`Gemfile`** deklaruje zależności z ograniczeniami wersji, a **`Gemfile.lock`** przypina *dokładne* wersje każdego gema (łącznie z zależnościami przechodnimi), które zostały zainstalowane.

Zacommitowanie `Gemfile.lock` gwarantuje, że wszyscy — cały zespół, CI i produkcja — instalują identyczne drzewo zależności, zapobiegając błędom typu "działa u mnie" wynikającym z różnic wersji.

Ta powtarzalność jest krytyczna dla niezawodnego, kolaboracyjnego rozwoju i wdrażania.

Zrozumienie gems (pakietów Ruby), Gemfile (deklaracji zależności), `bundle install`, **pliku blokady i dlaczego go zacommitować** (powtarzalne instalacje — główna korzyść) oraz `bundle exec` (uruchamianie poleceń z dokładnymi wersjami projektu) to ważna, codzienną wiedzę dla każdego projektu Ruby.

Ponieważ zarządzanie zależnościami jest fundamentem rzeczywistych aplikacji, a Bundler's powtarzalność oparta na pliku blokady to sposób, w jaki zespoły Ruby zapewniają spójne środowiska na etapie rozwoju, CI i produkcji, opanowanie gems i Bundler — analogiczne do npm/package-lock.json w Node — jest niezbędnym, często stosowanym Know-How dla profesjonalnego rozwoju Ruby.