Kaj so gems in Bundler?

Question

Accepted Answer

**Gems** so Ruby paketi (knjižnice), distribuirani prek RubyGems. **Bundler** upravlja odvisnosti gemov projekta — namešča prave verzije in zagotavlja **dosledne, ponovljive** okolje med stroji prek datoteke zaklenjene verzije. Skupaj sta to način, kako Ruby projekti upravljajo odvisnosti.

## 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 spakirana Ruby knjižnica (koda + metapodatki). RubyGems je upravnik paketov, rubygems.org pa register — Ruby ekvivalent npm/pip.

## Bundler — upravljanje odvisnosti 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 odvisnosti projekta z omejitvami verzij. `bundle install` jih namesti in ustvari **`Gemfile.lock`**.

## Datoteka zaklenjene verzije — ponovljive namestitve

```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`** pritrdi točne verzije vsakega gema (vključno s posrednimi odvisnostmi), zato suas povežejo zagotavlja, da vsi razvijalci, CI in produkcija namestijo *identično* drevo odvisnosti — ponovljivo, doslednost okolje. Vedno jo zapiši.

## bundle exec — uporabi 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)
```

## Zakaj je to pomembno

Gems in Bundler so temeljni za Ruby razvoj — to je način, kako praktično vsi Ruby projekti upravljajo odvisnosti, zato je razumevanje le-teh bistveno. **Gems** (Ruby paketi iz rubygems.org) zagotavljajo knjižnice in ogrodja (Rails, RSpec itd.), od katerih so odvisne prave aplikacije, in **Bundler** je standardno orodje za njihovo upravljanje v projektu.

Osrednja vrednost, ki jo Bundler zagotavlja — in najbolj pomemben koncept za razumevanje — je **ponovljivo, doslednost okolje**: **`Gemfile`** deklarira odvisnosti z omejitvami verzij, **`Gemfile.lock`** pa pritrdi *točne* verzije vsakega gema (vključno s posrednimi odvisnostmi), ki so bile nameščene.

Zapisovanje `Gemfile.lock` zagotavlja, da vsi — celoten tim, CI in produkcija — namestijo identično drevo odvisnosti, kar preprečuje napake »deluje na mojem računalniku«, ki nastanejo zaradi razlik v verzijah.

Ta ponovljivost je ključna za zanesljiv, sodelujoč razvoj in postavitev.

Razumevanje gemov (Ruby paketi), Gemfile (deklariranje odvisnosti), `bundle install`, **datoteke zaklenjene verzije in zakaj jo zapisati** (ponovljive namestitve — osrednja prednost) in `bundle exec` (izvajanje ukazov z točnimi verzijami projekta) je pomembno, vsakodnevno znanje za vsak Ruby projekt.

Ker je upravljanje odvisnosti temeljno za prave aplikacije in ker je Bundler zasnovan na datoteki zaklenjene verzije za zagotavljanje doslednosti okolja med razvojem, CI in produkcijo, je obvladovanje gemov in Bundlerja — analogno npm/package-lock.json v Node — bistveno, pogosto uporabljeno znanje za profesionalni Ruby razvoj.