Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 9, 2022
 
 

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]  [--fil-
ter-minor] [--filter-patch] [--only-explicit]

Description

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]  [--fil-
       ter-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  dependen-
              cies.

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 provid-
       ing none of them.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/ruby-26  |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source       was       downloaded       from         http://cache.ruby-
       lang.org/pub/ruby/2.6/ruby-2.6.8.tar.gz.

       Further information about this software can be found on the open source
       community website at http://www.ruby-lang.org/.



                                 November 2018              BUNDLE-OUTDATED(1)