cheatsheets/semver.md

title	layout	updated	weight
Semver	2017/sheet	2017-08-26	-3

Semver

Given a version number MAJOR.MINOR.PATCH: {: .-setup}

| MAJOR | incompatible API changes | | MINOR | add functionality (backwards-compatible) | | PATCH | bug 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

Range	Description	Notes
~1.2.3	is >=1.2.3 <1.3.0
---	---	---
^1.2.3	is >=1.2.3 <2.0.0
^0.2.3	is >=0.2.3 <0.3.0	(0.x.x is special)
^0.0.1	is =0.0.1	(0.0.x is special)
---	---	---
^1.2	is >=1.2.0 <2.0.0	(like ^1.2.0)
~1.2	is >=1.2.0 <1.3.0	(like ~1.2.0)
---	---	---
^1	is >=1.0.0 <2.0.0
~1	same
1.x	same
1.*	same
1	same
---	---	---
*	any version
x	same
{: .-shortcuts}

Pre-releases

1.2.3-prerelease+build

Explanation

| ^ | means "compatible with" | | ~ | means "reasonably close to" | | 0.x.x | is for "initial development" | | 1.x.x | means public API is defined | {: .-shortcuts}

References

{: .-one-column}

• http://semver.org/
• https://www.npmjs.org/doc/misc/semver.html