404 Not Found

PATH: opt / alt / ruby30 / share / gems / gems / bundler-2.2.33 / lib / bundler / man

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

[-] gemfile.5 [edit]
[-] bundle-info.1.ronn [edit]
[-] bundle-cache.1 [edit]
[-] bundle-remove.1 [edit]
[-] bundle-clean.1 [edit]
[-] bundle-open.1 [edit]
[-] bundle-gem.1 [edit]
[-] bundle-doctor.1 [edit]
[-] bundle-outdated.1 [edit]
[-] bundle-show.1 [edit]
[-] bundle-platform.1.ronn [edit]
[-] bundle-show.1.ronn [edit]
[-] bundle-add.1.ronn [edit]
[-] bundle.1 [edit]
[-] bundle-viz.1.ronn [edit]
[-] bundle.1.ronn [edit]
[-] bundle-platform.1 [edit]
[-] bundle-remove.1.ronn [edit]
[-] bundle-doctor.1.ronn [edit]
[-] bundle-check.1 [edit]
[-] bundle-cache.1.ronn [edit]
[-] bundle-exec.1 [edit]
[-] bundle-info.1 [edit]
[-] bundle-update.1.ronn [edit]
[-] bundle-install.1.ronn [edit]
[-] bundle-viz.1 [edit]
[-] bundle-outdated.1.ronn [edit]
[-] bundle-clean.1.ronn [edit]
[-] bundle-pristine.1 [edit]
[-] bundle-config.1 [edit]
[-] bundle-exec.1.ronn [edit]
[-] bundle-inject.1 [edit]
[-] bundle-init.1.ronn [edit]
[-] gemfile.5.ronn [edit]
[-] bundle-update.1 [edit]
[+] ..
[-] bundle-lock.1.ronn [edit]
[-] bundle-config.1.ronn [edit]
[-] bundle-open.1.ronn [edit]
[-] bundle-check.1.ronn [edit]
[-] bundle-lock.1 [edit]
[-] bundle-add.1 [edit]
[-] bundle-init.1 [edit]
[-] bundle-list.1 [edit]
[-] bundle-pristine.1.ronn [edit]
[-] bundle-inject.1.ronn [edit]
[-] bundle-gem.1.ronn [edit]
[-] bundle-binstubs.1 [edit]
[-] bundle-install.1 [edit]
[-] bundle-binstubs.1.ronn [edit]
[-] bundle-list.1.ronn [edit]