نام (NAME)

bundle-pristine - بازگردانی gemهای نصب‌شده به وضعیت اولیه و دست‌نخورده

خلاصه دستور (SYNOPSIS)

bundle pristine

توضیحات (DESCRIPTION)

دستور pristine با استفاده از کَش محلی gem در RubyGems، gemهای نصب‌شده در bundle را به وضعیت دست‌نخورده اولیه آن‌ها بازمی‌گرداند. برای gemهای git، یک checkout اجباری انجام خواهد شد.

برای توضیح بیشتر، bundle pristine فایل‌های خارج‌شده از حالت فشرده روی دیسک را نادیده می‌گیرد. به عبارت دیگر، این دستور از کَش محلی .gem یا مخزن git مربوط به gem استفاده می‌کند؛ درست مانند آنکه نصب از ابتدا انجام گرفته باشد.

نکته: gem مربوط به Bundler را نمی‌توان با pristine به حالت اولیه بازگرداند. همچنین نمی‌توان از bundle pristine برای gemهایی که دارای گزینه 'path' در Gemfile هستند استفاده کرد، زیرا bundler هیچ نسخه اصلی ندارد تا بتواند از روی آن بازگردانی را انجام دهد.

چه زمانی استفاده از bundle pristine کاربردی است؟

این دستور هنگام اشکال‌زدایی یک gem بسیار کاربردی است. bundle pristine روشی عالی برای خلاص شدن از شر تغییرات آزمایشی و ناخواسته‌ای است که روی یک gem اعمال شده است.

چرا به جای gem pristine --all از bundle pristine استفاده کنیم؟

هر دو دستور بسیار مشابه‌اند. جهت مقایسه: bundle pristine بدون آرگومان، تمام gemهای موجود در lockfile را پاکسازی می‌کند. در حالی که gem pristine --all تمام gemهای نصب‌شده برای آن نسخه از Ruby را پاکسازی می‌کند.

اگر توسعه‌دهنده‌ای فراموش کند که در حال اشکال‌زدایی کدام gemها در پروژه خود بوده است، استفاده از دستور Rubygems یعنی gem pristine [GEMNAME] ممکن است دشوار باشد. در این صورت می‌توان به جای منتظر ماندن برای gem pristine --all، دستور bundle pristine را اجرا کرد.