1BUNDLE-PRISTINE(1)                                          BUNDLE-PRISTINE(1)
2
3
4

NAME

6       bundle-pristine - Restores installed gems to their pristine condition
7

SYNOPSIS

9       bundle pristine
10

DESCRIPTION

12       pristine  restores  the  installed gems in the bundle to their pristine
13       condition using the local gem cache from  RubyGems.  For  git  gems,  a
14       forced checkout will be performed.
15
16       For  further  explanation,  bundle  pristine  ignores unpacked files on
17       disk. In other words, this command utilizes the local .gem cache or the
18       gem´s git repository as if one were installing from scratch.
19
20       Note:  the  Bundler  gem  cannot be restored to its original state with
21       pristine. One also cannot use bundle pristine on  gems  with  a  ´path´
22       option  in  the  Gemfile,  because  bundler has no original copy it can
23       restore from.
24
25       When is it practical to use bundle pristine?
26
27       It comes in handy when a developer is debugging a gem. bundle  pristine
28       is a great way to get rid of experimental changes to a gem that one may
29       not want.
30
31       Why use bundle pristine over gem pristine --all?
32
33       Both commands are very similar. For context: bundle  pristine,  without
34       arguments,  cleans  all gems from the lockfile. Meanwhile, gem pristine
35       --all cleans all installed gems for that Ruby version.
36
37       If a developer forgets which gems in their project they might have been
38       debugging,  the Rubygems gem pristine [GEMNAME] command may be inconve‐
39       nient. One can avoid waiting for gem pristine --all,  and  instead  run
40       bundle pristine.
41
42
43
44                                  August 2017               BUNDLE-PRISTINE(1)