.. _semver2-to-3:

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 :ref:`changelog`.


Use Version instead of VersionInfo
----------------------------------

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

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

.. code-block:: python

   from semver.version import Version as VersionInfo



Use semver.cli instead of semver
--------------------------------

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

.. code-block:: python

   from semver.cli import cmd_bump