NAME¶

bundle-outdated - List installed gems with newer versions available

SYNOPSIS¶

bundle outdated [GEM] [--local] [--pre] [--source] [--filter-strict | --strict] [--update-strict] [--parseable | --porcelain] [--group=GROUP] [--groups] [--patch|--minor|--major] [--filter-major] [--filter-minor] [--filter-patch] [--only-explicit] [--cooldown=NUMBER]

DESCRIPTION¶

Outdated lists the names and versions of gems that have a newer version available in the given source. Calling outdated with [GEM [GEM]] will only check for newer versions of the given gems. Prerelease gems are ignored by default. If your gems are up to date, Bundler will exit with a status of 0. Otherwise, it will exit 1.

OPTIONS¶

--local

Do not attempt to fetch gems remotely and use the gem cache instead.

--pre

Check for newer pre-release gems.

--source=<list>

Check against a specific source.

--filter-strict, --strict

Only list newer versions allowed by your Gemfile requirements, also respecting conservative update flags (--patch, --minor, --major).

--update-strict

Strict conservative resolution, do not allow any gem to be updated past latest --patch | --minor | --major.

--parseable, --porcelain

Use minimal formatting for more parseable output.

--group=GROUP

List gems from a specific group.

--groups

List gems organized by groups.

--minor

Prefer updating only to next minor version.

--major

Prefer updating to latest major version (default).

--patch

Prefer updating only to next patch version.

--filter-major

Only list major newer versions.

--filter-minor

Only list minor newer versions.

--filter-patch

Only list patch newer versions.

--only-explicit

Only list gems specified in your Gemfile, not their dependencies.

--cooldown=<number>

Annotate (rather than hide) versions that are still inside the cooldown window of number days. The prose output appends "in cooldown for Nd more days" and the table form adds "(cooldown Nd)" to the Latest column. When a version outside the window is newer than the installed one, the prose output also appends "newest out of cooldown X" and the table form becomes "(cooldown Nd, X out of cooldown)". With --filter-strict (or --patch, --minor, --major, which imply it), "newest" is already the cooldown-filtered resolved version, so none of these annotations appear. See cooldown in bundle-config(1).

PATCH LEVEL OPTIONS¶

See bundle update(1) bundle-update.1.html for details.

FILTERING OUTPUT¶

The 3 filtering options do not affect the resolution of versions, merely what versions are shown in the output.

If the regular output shows the following:

* Gem       Current  Latest  Requested  Groups              Release Date
* faker     1.6.5    1.6.6   ~> 1.4     development, test   2024-02-05
* hashie    1.2.0    3.4.6   = 1.2.0    default             2023-11-10
* headless  2.2.3    2.3.1   = 2.2.3    test                2022-08-19

--filter-major would only show:

* Gem       Current  Latest  Requested  Groups   Release Date
* hashie    1.2.0    3.4.6   = 1.2.0    default  2023-11-10

--filter-minor would only show:

* Gem       Current  Latest  Requested  Groups  Release Date
* headless  2.2.3    2.3.1   = 2.2.3    test    2022-08-19

--filter-patch would only show:

* Gem       Current  Latest  Requested  Groups              Release Date
* faker     1.6.5    1.6.6   ~> 1.4     development, test   2024-02-05

Filter options can be combined. --filter-minor and --filter-patch would show:

* Gem       Current  Latest  Requested  Groups              Release Date
* faker     1.6.5    1.6.6   ~> 1.4     development, test   2024-02-05

Combining all three filter options would be the same result as providing none of them.