.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "BUNDLE\-PRISTINE" "1" "September 2025" ""
.SH "نام (NAME)"
\fBbundle\-pristine\fR \- بازگردانی gemهای نصب‌شده به وضعیت اولیه و دست‌نخورده
.SH "خلاصه دستور (SYNOPSIS)"
\fBbundle pristine\fR
.SH "توضیحات (DESCRIPTION)"
دستور \fBpristine\fR با استفاده از کَش محلی gem در RubyGems، gemهای نصب‌شده در bundle را به وضعیت دست‌نخورده اولیه آن‌ها بازمی‌گرداند\. برای gemهای git، یک checkout اجباری انجام خواهد شد\.
.P
برای توضیح بیشتر، \fBbundle pristine\fR فایل‌های خارج‌شده از حالت فشرده روی دیسک را نادیده می‌گیرد\. به عبارت دیگر، این دستور از کَش محلی \fB\.gem\fR یا مخزن git مربوط به gem استفاده می‌کند؛ درست مانند آنکه نصب از ابتدا انجام گرفته باشد\.
.P
نکته: gem مربوط به Bundler را نمی‌توان با \fBpristine\fR به حالت اولیه بازگرداند\. همچنین نمی‌توان از \fBbundle pristine\fR برای gemهایی که دارای گزینه \(aqpath\(aq در Gemfile هستند استفاده کرد، زیرا bundler هیچ نسخه اصلی ندارد تا بتواند از روی آن بازگردانی را انجام دهد\.
.P
چه زمانی استفاده از \fBbundle pristine\fR کاربردی است؟
.P
این دستور هنگام اشکال‌زدایی یک gem بسیار کاربردی است\. \fBbundle pristine\fR روشی عالی برای خلاص شدن از شر تغییرات آزمایشی و ناخواسته‌ای است که روی یک gem اعمال شده است\.
.P
چرا به جای \fBgem pristine \-\-all\fR از \fBbundle pristine\fR استفاده کنیم؟
.P
هر دو دستور بسیار مشابه‌اند\. جهت مقایسه: \fBbundle pristine\fR بدون آرگومان، تمام gemهای موجود در lockfile را پاکسازی می‌کند\. در حالی که \fBgem pristine \-\-all\fR تمام gemهای نصب‌شده برای آن نسخه از Ruby را پاکسازی می‌کند\.
.P
اگر توسعه‌دهنده‌ای فراموش کند که در حال اشکال‌زدایی کدام gemها در پروژه خود بوده است، استفاده از دستور Rubygems یعنی \fBgem pristine [GEMNAME]\fR ممکن است دشوار باشد\. در این صورت می‌توان به جای منتظر ماندن برای \fBgem pristine \-\-all\fR، دستور \fBbundle pristine\fR را اجرا کرد\.