ما هي Gems و Bundler؟

Question

Accepted Answer

**Gems** هي حزم Ruby (مكتبات) موزعة عبر RubyGems. **Bundler** يدير اعتماديات gem المشروع — تثبيت الإصدارات الصحيحة وضمان بيئات **متسقة وقابلة للتكرار** عبر الآلات من خلال ملف Lockfile. معاً، هما كيفية إدارة Ruby للمشاريع لاعتمادياتها.

## Gems — حزم 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 عبارة عن مكتبة Ruby معبأة (كود + بيانات وصفية). RubyGems هو مدير الحزم و rubygems.org هو السجل — معادل Ruby لـ npm/pip.

## Bundler — إدارة اعتماديات المشروع

```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`** يعلن اعتماديات مشروعك مع قيود الإصدار. `bundle install` يثبتها وينتج **`Gemfile.lock`**.

## ملف Lockfile — تثبيتات قابلة للتكرار

```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`** يثبت الإصدارات الدقيقة لكل gem (بما في ذلك الاعتماديات المتعدية)، لذا التزام به يضمن أن جميع المطورين و CI والإنتاج يثبتون *نفس* شجرة الاعتماديات بالضبط — بيئات قابلة للتكرار ومتسقة. التزم به دائماً.

## bundle exec — استخدم إصدارات المشروع

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

## لماذا يهم هذا

Gems و Bundler أساسيان لتطوير Ruby — هما كيفية إدارة اعتماديات كل مشروع Ruby فعلي تقريباً، لذا فهمهما ضروري. **Gems** (حزم Ruby من rubygems.org) توفر المكتبات والأطر (Rails, RSpec, وغيرها) التي تعتمد عليها التطبيقات الحقيقية، و **Bundler** هو الأداة القياسية لإدارتها في المشروع.

القيمة الرئيسية التي يوفرها Bundler — والمفهوم الأكثر أهمية للفهم — هي **بيئات قابلة للتكرار ومتسقة**: ملف **`Gemfile`** يعلن الاعتماديات مع قيود الإصدار، و **`Gemfile.lock`** يثبت *الإصدارات الدقيقة* لكل gem (بما في ذلك الاعتماديات المتعدية) التي تم تثبيتها.

التزام `Gemfile.lock` يضمن أن الجميع — الفريق بأكمله و CI والإنتاج — يثبتون شجرة الاعتماديات المتطابقة، مما يمنع أخطاء "يعمل على جهازي" التي تنشأ من اختلافات الإصدار.

هذا التكرار حاسم للتطوير والنشر الموثوق والتعاوني.

فهم gems (حزم Ruby)، و Gemfile (إعلان الاعتماديات)، و `bundle install`، و **ملف Lockfile ولماذا تلتزم به** (تثبيتات قابلة للتكرار — الفائدة المركزية)، و `bundle exec` (تشغيل الأوامر مع الإصدارات الدقيقة للمشروع) هو معرفة مهمة يومية لأي مشروع Ruby.

حيث أن إدارة الاعتماديات أساسية للتطبيقات الحقيقية، وحيث أن استنساخ Bundler القائم على Lockfile هو كيفية فرق Ruby في ضمان بيئات متسقة عبر التطوير و CI والإنتاج، فإن إتقان gems و Bundler — المعادل لـ npm/package-lock.json في Node — معرفة أساسية وتُطبق بشكل متكرر لتطوير Ruby المهني.