Sha256: 845c8ebb704b78b83f0fac5ab3d94d14f1894876a8a14dec68cf0034d88908fb

Contents?: true

Size: 1.46 KB

Versions: 367

Compression:

Stored size: 1.46 KB

Contents

bundle-pristine(1) -- Restores installed gems to their pristine condition
===========================================================================

## SYNOPSIS

`bundle pristine`

## DESCRIPTION

`pristine` restores 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, `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.

Note: the Bundler gem cannot be restored to its original state with `pristine`.
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.

When is it practical to use `bundle pristine`?

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.

Why use `bundle pristine` over `gem pristine --all`?

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.

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`.

Version data entries

367 entries across 367 versions & 7 rubygems

Version Path
harbr-0.1.91 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.90 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.89 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.88 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.87 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.86 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.85 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.84 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.83 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.82 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.81 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.4 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.4 lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.80 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.79 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.78 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.77 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.76 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.75 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
harbr-0.1.74 vendor/bundle/ruby/3.2.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn