Co jsou gems a Bundler?

Question

Accepted Answer

**Gems** jsou balíčky (knihovny) Ruby distribuované přes RubyGems. **Bundler** spravuje závislosti projektových gemů — instaluje správné verze a zajišťuje **konzistentní, reprodukovatelná** prostředí mezi počítači prostřednictvím zámkovacího souboru. Dohromady jsou to způsob, jak projekty v Ruby spravují závislosti.

## Gems — balíčky 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 je zabalená knihovna Ruby (kód + metadata). RubyGems je správce balíčků a rubygems.org je registr — ekvivalent npm/pip pro Ruby.

## Bundler — správa závislostí projektů

```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 závislosti vašeho projektu s omezeními verzí. `bundle install` je instaluje a generuje **`Gemfile.lock`**.

## Zámkovací soubor — reprodukovatelné instalace

```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`** fixuje přesné verze každého gemu (včetně tranzitivních závislostí), takže jeho commitnutí zaručuje, že všichni vývojáři, CI a produkce instalují *identický* strom závislostí — reprodukovatelná, konzistentní prostředí. Vždy jej commitujte.

## bundle exec — použití verzí projektu

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

## Proč na tom záleží

Gems a Bundler jsou fundamentální pro vývoj v Ruby — jsou to prostředky, kterými prakticky každý Ruby projekt spravuje závislosti, takže jejich pochopení je nezbytné. **Gems** (balíčky Ruby z rubygems.org) poskytují knihovny a frameworky (Rails, RSpec atd.), na kterých reálné aplikace závisí, a **Bundler** je standardní nástroj pro jejich správu v projektu.

Klíčová hodnota, kterou Bundler poskytuje — a nejdůležitější koncept k pochopení — je **reprodukovatelná, konzistentní prostředí**: **`Gemfile`** deklaruje závislosti s omezeními verzí a **`Gemfile.lock`** fixuje *přesné* verze každého gemu (včetně tranzitivních závislostí), které byly nainstalovány.

Commitnutí `Gemfile.lock` zaručuje, že všichni — celý tým, CI a produkce — instalují identický strom závislostí, což brání chybám typu "funguje na mém počítači", které vznikají z rozdílů ve verzích.

Tato reprodukovatelnost je kritická pro spolehlivý, kolaborativní vývoj a nasazování.

Pochopení gemů (balíčků Ruby), Gemfile (deklarování závislostí), `bundle install`, **zámkovacího souboru a proč jej commitovat** (reprodukovatelné instalace — centrální přínos) a `bundle exec` (spouštění příkazů s přesnými verzemi projektu) je důležité, každodenní znalosti pro jakýkoliv projekt Ruby.

Protože správa závislostí je fundamentální pro reálné aplikace a protože reprodukovatelnost zámkovacího souboru Bundleru je to, jak Ruby týmy zajišťují konzistentní prostředí mezi vývojem, CI a produkcí, zvládnutí gemů a Bundleru — analogické npm/package-lock.json v Node — je nezbytné, často používané znalosti pro profesionální vývoj v Ruby.