1BUNDLE-OUTDATED(1) BUNDLE-OUTDATED(1)
2
3
4
6 bundle-outdated - List installed gems with newer versions available
7
9 bundle outdated [GEM] [--local] [--pre] [--source] [--strict]
10 [--parseable | --porcelain] [--group=GROUP] [--groups] [--up‐
11 date-strict] [--patch|--minor|--major] [--filter-major] [--filter-mi‐
12 nor] [--filter-patch] [--only-explicit]
13
15 Outdated lists the names and versions of gems that have a newer version
16 available in the given source. Calling outdated with [GEM [GEM]] will
17 only check for newer versions of the given gems. Prerelease gems are
18 ignored by default. If your gems are up to date, Bundler will exit with
19 a status of 0. Otherwise, it will exit 1.
20
22 --local
23 Do not attempt to fetch gems remotely and use the gem cache in‐
24 stead.
25
26 --pre Check for newer pre-release gems.
27
28 --source
29 Check against a specific source.
30
31 --strict
32 Only list newer versions allowed by your Gemfile requirements.
33
34 --parseable, --porcelain
35 Use minimal formatting for more parseable output.
36
37 --group
38 List gems from a specific group.
39
40 --groups
41 List gems organized by groups.
42
43 --update-strict
44 Strict conservative resolution, do not allow any gem to be up‐
45 dated past latest --patch | --minor| --major.
46
47 --minor
48 Prefer updating only to next minor version.
49
50 --major
51 Prefer updating to next major version (default).
52
53 --patch
54 Prefer updating only to next patch version.
55
56 --filter-major
57 Only list major newer versions.
58
59 --filter-minor
60 Only list minor newer versions.
61
62 --filter-patch
63 Only list patch newer versions.
64
65 --only-explicit
66 Only list gems specified in your Gemfile, not their dependen‐
67 cies.
68
70 See bundle update(1) bundle-update.1.html for details.
71
72 One difference between the patch level options in bundle update and
73 here is the --strict option. --strict was already an option on outdated
74 before the patch level options were added. --strict wasn´t altered, and
75 the --update-strict option on outdated reflects what --strict does on
76 bundle update.
77
79 The 3 filtering options do not affect the resolution of versions,
80 merely what versions are shown in the output.
81
82 If the regular output shows the following:
83
84
85
86 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
87 * hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
88 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
89
90
91
92 --filter-major would only show:
93
94
95
96 * hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
97
98
99
100 --filter-minor would only show:
101
102
103
104 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
105
106
107
108 --filter-patch would only show:
109
110
111
112 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
113
114
115
116 Filter options can be combined. --filter-minor and --filter-patch would
117 show:
118
119
120
121 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
122 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
123
124
125
126 Combining all three filter options would be the same result as provid‐
127 ing none of them.
128
129
130
131 January 2021 BUNDLE-OUTDATED(1)