Što su gems i Bundler?

Question

Accepted Answer

**Gems** su Ruby paketi (biblioteke) distribuirani putem RubyGems-a. **Bundler** upravlja gem dependencijama projekta — instalira ispravne verzije i osigurava **dosljedne, reproducibilne** okoline između računala putem datoteke za zaključavanje. Zajedno su to način na koji Ruby projekti upravljaju dependencijama.

## Gems — Ruby paketi

```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 pakirana Ruby biblioteka (kod + metapodaci). RubyGems je upravitelj paketa, a rubygems.org je registar — Ruby ekvivalent npm/pip-a.

## Bundler — upravljanje dependencijama projekta

```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`** deklarira dependencije vašeg projekta s ograničenjima verzija. `bundle install` ih instalira i generiše **`Gemfile.lock`**.

## Datoteka za zaključavanje — reproducibilne instalacije

```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`** fiksira točne verzije svakog gem-a (uključujući tranzitivne dependencije), pa commit-ovanje osigurava da svi developeri, CI i production instaliraju *identično* stablo dependencija — reproducibilne, dosljedne okoline. Uvijek ga commit-ujte.

## bundle exec — koristite verzije projekta

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

## Zašto je važno

Gems i Bundler su fundamentalni za Ruby razvoj — to je način na koji gotovo svaki Ruby projekt upravlja dependencijama, pa je razumijevanje njih nužno. **Gems** (Ruby paketi s rubygems.org) pružaju biblioteke i okvire (Rails, RSpec, itd.) na kojima stvarne aplikacije ovise, a **Bundler** je standardni alat za upravljanje njima u projektu.

Ključna vrijednost koju Bundler pruža — i najvažniji koncept koji trebate razumjeti — je **reproducibilne, dosljedne okoline**: **`Gemfile`** deklarira dependencije s ograničenjima verzija, a **`Gemfile.lock`** fiksira *točne* verzije svakog gem-a (uključujući tranzitivne dependencije) koji su bili instalirani.

Commit-ovanje `Gemfile.lock` osigurava da svi — cijeli tim, CI i production — instaliraju identično stablo dependencija, sprječavajući "radi na mom računalu" greške koje proizlaze iz razlika u verzijama.

Ova reproducibilnost je kritična za pouzdani, suradnički razvoj i deployment.

Razumijevanje gems-a (Ruby paketi), Gemfile-a (deklariranje dependencija), `bundle install`-a, **datoteke za zaključavanje i zašto je commit-ovati** (reproducibilne instalacije — centralna korist) i `bundle exec`-a (izvođenje naredbi s točnim verzijama projekta) je važno, svakodnevno znanje za bilo koji Ruby projekt.

Budući da je upravljanje dependencijama fundamentalno za stvarne aplikacije, i budući da je Bundler-ova reproducibilnost temeljana na datoteci za zaključavanje način na koji Ruby timovi osiguravaju dosljedne okoline između razvoja, CI-ja i production-a, ovladavanje gems-om i Bundler-om — analogno npm/package-lock.json-u u Node.js-u — je nužno, često korišteno znanje za profesionalni Ruby razvoj.