Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019

bundle-pristine (1)


bundle-pristine - Man page for 'bundle-pristine' in section 1


Please see following description for synopsis


TH  "BUNDLE-PRISTINE"  "1"  "November  2018" "" "" SH "NAME" bun-
dle-pristine - Restores installed gems to their  pristine  condi-
tion  SH "SYNOPSIS" bundle pristine SH "DESCRIPTION" pristine re-
stores the installed gems in the bundle to their pristine  condi-
tion  using  the  local  gem cache from RubyGems. For git gems, a
forced checkout will be performed.  P  For  further  explanation,
bundle  pristine  ignores unpacked files on disk. In other words,
this command utilizes the local  .gem  cache  or  the  gem's  git
repository  as  if one were installing from scratch.  P Note: the
Bundler gem cannot be restored to its original state  with  pris-
tine.  One  also cannot use bundle pristine on gems with a 'path'
option in the Gemfile, because bundler has no  original  copy  it
can restore from.  P When is it practical to use bundle pristine?
P It comes in handy when a developer is debugging a  gem.  bundle
pristine  is  a great way to get rid of experimental changes to a
gem that one may not want.  P Why use bundle  pristine  over  gem
pristine  --all?   P Both commands are very similar. For context:
bundle pristine, without arguments,  cleans  all  gems  from  the
lockfile. Meanwhile, gem pristine --all cleans all installed gems
for that Ruby version.  P If a developer forgets  which  gems  in
their  project  they  might have been debugging, the Rubygems gem
pristine [GEMNAME] command may be  inconvenient.  One  can  avoid
waiting for gem pristine --all, and instead run bundle pristine.

See for descriptions of the following attributes:

|Availability   | runtime/ruby-26  |
|Stability      | Uncommitted      |

This    software    was    built   from   source   available   at
https://github.com/oracle/solaris-userland.  The original  commu-
nity    source    was    downloaded    from    http://cache.ruby-

Further information about this software can be found on the  open
source community website at http://www.ruby-lang.org/.