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
direct7-0.0.18 vendor/bundle/ruby/2.7.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
direct7-0.0.17 vendor/bundle/ruby/2.7.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.23 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.23 lib/bundler/man/bundle-pristine.1.ronn
direct7-0.0.16 vendor/bundle/ruby/2.7.0/gems/bundler-2.4.21/lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.22 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.22 lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.21 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.21 lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.20 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.20 lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.19 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.19 lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.18 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.18 lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.17 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.17 lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.16 bundler/lib/bundler/man/bundle-pristine.1.ronn
bundler-2.5.16 lib/bundler/man/bundle-pristine.1.ronn
rubygems-update-3.5.15 bundler/lib/bundler/man/bundle-pristine.1.ronn