summaryrefslogtreecommitdiff
path: root/man/bundle-pristine.1.txt
blob: 38d6dff1c57497b46fe746bbbe57c735504aac1b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
BUNDLE-PRISTINE(1)					    BUNDLE-PRISTINE(1)



1mNAME0m
       1mbundle-pristine 22m- Restores installed gems to their pristine condition

1mSYNOPSIS0m
       1mbundle pristine0m

1mDESCRIPTION0m
       1mpristine  22mrestores	the  installed gems in the bundle to their pristine
       condition using the local gem cache from  RubyGems.  For  git  gems,  a
       forced checkout will be performed.

       For  further  explanation,  1mbundle  pristine  22mignores unpacked files on
       disk. In other words, this command utilizes the local 1m.gem 22mcache or the
       gem's git repository as if one were installing from scratch.

       Note:  the  Bundler  gem  cannot be restored to its original state with
       1mpristine22m. One also cannot use 1mbundle pristine 22mon  gems  with  a  'path'
       option  in  the	Gemfile,  because  bundler has no original copy it can
       restore from.

       When is it practical to use 1mbundle pristine22m?

       It comes in handy when a developer is debugging a gem. 1mbundle	pristine0m
       is a great way to get rid of experimental changes to a gem that one may
       not want.

       Why use 1mbundle pristine 22mover 1mgem pristine --all22m?

       Both commands are very similar. For context: 1mbundle  pristine22m,  without
       arguments,  cleans  all gems from the lockfile. Meanwhile, 1mgem pristine0m
       1m--all 22mcleans all installed gems for that Ruby version.

       If a developer forgets which gems in their project they might have been
       debugging,  the Rubygems 1mgem pristine [GEMNAME] 22mcommand may be inconve-
       nient. One can avoid waiting for 1mgem pristine --all22m,  and  instead	run
       1mbundle pristine22m.



				   May 2018		    BUNDLE-PRISTINE(1)