Semver cheatsheet

Semver cheatsheet

Semver

Given a version number MAJOR.MINOR.PATCH:

MAJORincompatible API changes
MINORadd functionality (backwards-compatible)
PATCHbug fixes (backwards-compatible)

Simple ranges

  1.2.3
 =1.2.3
 >1.2.3
 <1.2.3
>=1.2.3

Note that suffixed versions (1.2.3-rc1) are not matched.

Ranges

~1.2.3is >=1.2.3 <1.3.0 
^1.2.3is >=1.2.3 <2.0.0 
^0.2.3is >=0.2.3 <0.3.0(0.x.x is special)
^0.0.1is =0.0.1(0.0.x is special)
^1.2is >=1.2.0 <2.0.0(like ^1.2.0)
~1.2is >=1.2.0 <1.3.0(like ~1.2.0)
^1is >=1.0.0 <2.0.0 
~1same 
1.xsame 
1.*same 
1same 
*any version 
xsame 

Hyphenated ranges

1.2.3 - 2.3.0is >=1.2.3 <=2.3.4

Partial right

1.2.3 - 2.3is >=1.2.3 <2.4.0
1.2.3 - 2is >=1.2.3 <3.0.0

Partial left

1.2 - 2.3.0is 1.2.0 - 2.3.0

When the right is partial (eg, 2.3), missing pieces are assumed to be x (eg, 2.3.x).

When the left is partial (eg, 1.2), missing pieces are assumed to be 0 (eg, 1.2.0).

Combining ranges

>=0.14 <16And (space-separated)
0.14.x || 15.x.xOr (pipe-separated)

Pre-releases

1.2.3-prerelease+build

Explanation

^means “compatible with”
~means “reasonably close to”
0.x.xis for “initial development”
1.x.xmeans public API is defined

References

Share this post

Leave a Reply

Your email address will not be published. Required fields are marked *