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] [--patch|--mi‐
11 nor|--major] [--filter-major] [--filter-minor] [--filter-patch]
12 [--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 also respecting conservative update flags (--patch, --minor,
34 --major).
35
36 --parseable, --porcelain
37 Use minimal formatting for more parseable output.
38
39 --group
40 List gems from a specific group.
41
42 --groups
43 List gems organized by groups.
44
45 --minor
46 Prefer updating only to next minor version.
47
48 --major
49 Prefer updating to next major version (default).
50
51 --patch
52 Prefer updating only to next patch version.
53
54 --filter-major
55 Only list major newer versions.
56
57 --filter-minor
58 Only list minor newer versions.
59
60 --filter-patch
61 Only list patch newer versions.
62
63 --only-explicit
64 Only list gems specified in your Gemfile, not their dependen‐
65 cies.
66
68 See bundle update(1) bundle-update.1.html for details.
69
71 The 3 filtering options do not affect the resolution of versions,
72 merely what versions are shown in the output.
73
74 If the regular output shows the following:
75
76
77
78 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
79 * hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
80 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
81
82
83
84 --filter-major would only show:
85
86
87
88 * hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
89
90
91
92 --filter-minor would only show:
93
94
95
96 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
97
98
99
100 --filter-patch would only show:
101
102
103
104 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
105
106
107
108 Filter options can be combined. --filter-minor and --filter-patch would
109 show:
110
111
112
113 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
114 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
115
116
117
118 Combining all three filter options would be the same result as provid‐
119 ing none of them.
120
121
122
123 February 2023 BUNDLE-OUTDATED(1)