A "version" is described by the v2.0.0
specification found at
http://semver.org/.
A leading "="
or "v"
character is stripped off and ignored.
The following range styles are supported:
1.2.3
A specific version. When nothing else will do. Must be a full version number, with major, minor, and patch versions specified. Note that build metadata is still ignored, so1.2.3+build2012
will satisfy this range.>1.2.3
Greater than a specific version.<1.2.3
Less than a specific version. If there is no prerelease tag on the version range, then no prerelease version will be allowed either, even though these are technically "less than".>=1.2.3
Greater than or equal to. Note that prerelease versions are NOT equal to their "normal" equivalents, so1.2.3-beta
will not satisfy this range, but2.3.0-beta
will.<=1.2.3
Less than or equal to. In this case, prerelease versions ARE allowed, so1.2.3-beta
would satisfy.1.2.3 - 2.3.4
:=>=1.2.3 <=2.3.4
~1.2.3
:=>=1.2.3-0 <1.3.0-0
"Reasonably close to1.2.3
". When using tilde operators, prerelease versions are supported as well, but a prerelease of the next significant digit will NOT be satisfactory, so1.3.0-beta
will not satisfy~1.2.3
.^1.2.3
:=>=1.2.3-0 <2.0.0-0
"Compatible with1.2.3
". When using caret operators, anything from the specified version (including prerelease) will be supported up to, but not including, the next major version (or its prereleases).1.5.1
will satisfy^1.2.3
, while1.2.2
and2.0.0-beta
will not.^0.1.3
:=0.1.3
"Compatible with0.1.3
".0.x.x
versions are special: since the semver spec specifies that0.x.x
versions make no stability guarantees, only the version specified is considered valid.^0.0.2
:=0.0.2
"Only the version0.0.2
is considered compatible"~1.2
:=>=1.2.0-0 <1.3.0-0
"Any version starting with1.2
"^1.2
:=>=1.2.0-0 <2.0.0-0
"Any version compatible with1.2
"1.2.x
:=>=1.2.0-0 <1.3.0-0
"Any version starting with1.2
"1.2.*
Same as1.2.x
.1.2
Same as1.2.x
.~1
:=>=1.0.0-0 <2.0.0-0
"Any version starting with1
"^1
:=>=1.0.0-0 <2.0.0-0
"Any version compatible with1
"1.x
:=>=1.0.0-0 <2.0.0-0
"Any version starting with1
"1.*
Same as1.x
.1
Same as1.x
.*
Any version whatsoever.x
Same as*
.""
(just an empty string) Same as*
.
Ranges can be joined with either a space (which implies "and") or a
||
(which implies "or").