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]
11 [--update-strict] [--patch|--minor|--major] [--filter-major] [--fil‐
12 ter-minor] [--filter-patch]
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
24 instead.
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
45 updated 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
66 See [bundle update(1)][bundle-update] for details.
67
68 One difference between the patch level options in bundle update and
69 here is the --strict option. --strict was already an option on outdated
70 before the patch level options were added. --strict wasn´t altered, and
71 the --update-strict option on outdated reflects what --strict does on
72 bundle update.
73
75 The 3 filtering options do not affect the resolution of versions,
76 merely what versions are shown in the output.
77
78 If the regular output shows the following:
79
80
81
82 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
83 * hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
84 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
85
86
87
88 --filter-major would only show:
89
90
91
92 * hashie (newest 3.4.6, installed 1.2.0, requested = 1.2.0) in groups "default"
93
94
95
96 --filter-minor would only show:
97
98
99
100 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
101
102
103
104 --filter-patch would only show:
105
106
107
108 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
109
110
111
112 Filter options can be combined. --filter-minor and --filter-patch would
113 show:
114
115
116
117 * faker (newest 1.6.6, installed 1.6.5, requested ~> 1.4) in groups "development, test"
118 * headless (newest 2.3.1, installed 2.2.3) in groups "test"
119
120
121
122 Combining all three filter options would be the same result as provid‐
123 ing none of them.
124
125
126
127 July 2017 BUNDLE-OUTDATED(1)