Parver

----------------

Added
~~~~~

- Support for Python 3.12

Removed
~~~~~~~

- Support for Python 3.7

----------------

Added
~~~~~

- Type hints.

Removed
~~~~~~~

- Support for Python 2.7, 3.5, and 3.6.
- ``__version__``, ``__author__``, and ``__email__`` attributes from `parver` module. Use :mod:`importlib.metadata` instead.

------------------

Added
~~~~~

- Grammar is parsed when first used to improve import time.

Fixed
~~~~~

- attrs deprecation warning. The minimum attrs version is now 19.2
- Errors raised for keyword-only argument errors on Python 3 did not
have the right error message.

----------------

Added
~~~~~

- ``Version.truncate`` method to remove trailing zeros from the release
segment.
- ``Version`` now validates each item in the release sequence.
- ``Version.bump_epoch`` method.
- Add ``by`` keyword argument to ``bump_pre``, ``bump_post``, and
``bump_dev`` methods, which e.g. ``.bump_dev(by=-1)``.

Changed
~~~~~~~

- **BREAKING CHANGE**. The ``Version`` constructor now uses an empty
string to represent an implicit zero instead of ``None``.

.. code:: python

>>> Version(release=1, post='')
<Version '1.post'>

Removed
~~~~~~~

- **BREAKING CHANGE**. ``Version.clear`` is no longer necessary. Use
``Version.replace(pre=None, post=None, dev=None)`` instead.


Fixed
~~~~~

- ``Version`` incorrectly allowed an empty release sequence.
- ``Version`` rejects ``bool`` for numeric components.
- ``Version`` rejects negative integers for numeric components.
- The strict parser no longer accepts local versions with ``-`` or
``_`` separators, or uppercase letters.
- The strict parser no longer accepts numbers with leading zeros.
- The local version was only being converted to lowercase when parsing
with ``strict=False``. It is now always converted.
- The local version separators were not being normalized to use ``.``.

------------------

Fixed
~~~~~

- On Python 2, ``Version`` was incorrectly rejecting ``long`` integer
values.

----------------

Added
~~~~~

- ``Version.bump_release_to`` method for control over the value to bump
to, e.g. for `CalVer`_.
- ``Version.set_release`` method for finer control over release values
without resetting subsequent indices to zero.

.. _CalVer: https://calver.org


Changed
~~~~~~~

- **BREAKING CHANGE**. The argument to ``Version.bump_release`` is now
a keyword only argument, e.g. ``Version.bump_release(index=0)``.
- The ``release`` parameter to ``Version`` now accepts any iterable.


Fixed
~~~~~

- Deprecation warnings about invalid escape sequences in ``_parse.py``.