ruby--ruby/man/bundle-outdated.1.txt

BUNDLE-OUTDATED(1)                                          BUNDLE-OUTDATED(1)



NAME
       bundle-outdated - List installed gems with newer versions available

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

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
              Check against a specific source.

       --strict
              Only list newer versions allowed by your Gemfile requirements.

       --parseable, --porcelain
              Use minimal formatting for more parseable output.

       --group
              List gems from a specific group.

       --groups
              List gems organized by groups.

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

       --minor
              Prefer updating only to next minor version.

       --major
              Prefer updating to next 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.

PATCH LEVEL OPTIONS
       See bundle update(1) bundle-update.1.html for details.

       One  difference  between  the  patch level options in bundle update and
       here is the --strict option. --strict was already an option on outdated
       before the patch level options were added. --strict wasn't altered, and
       the --update-strict option on outdated reflects what --strict  does  on
       bundle update.

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:



           * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
           * hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
           * headless (newest 2.3.1, installed 2.2.3) in groups "test"



       --filter-major would only show:



           * hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"



       --filter-minor would only show:



           * headless (newest 2.3.1, installed 2.2.3) in groups "test"



       --filter-patch would only show:



           * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"



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



           * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
           * headless (newest 2.3.1, installed 2.2.3) in groups "test"



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



                                   July 2020                BUNDLE-OUTDATED(1)