Migrating from semver2 to semver3

This chapter describes the visible differences for users and how your code stays compatible for semver3.

Although the development team tries to make the transition to semver3 as smooth as possible, at some point change is inevitable.

For a more detailed overview of all the changes, refer to our Adding a Changelog Entry.

Use Version instead of VersionInfo

The VersionInfo has been renamed to Version to have a more succinct name. An alias has been created to preserve compatibility but using old name has been deprecated.

If you still need the old version, use this line:

from semver.version import Version as VersionInfo

Use semver.cli instead of semver

All functions related to CLI parsing are moved to semver.cli. If you are such functions, like semver.cmd_bump, import it from semver.cli in the future:

from semver.cli import cmd_bump