1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
.. _version-policy:
Version Policy
==============
.. |MAINT| replace:: ``maint/v2``
.. _MAINT: https://github.com/python-semver/python-semver/tree/maint/v2
.. |CHANGELOG| replace:: ``Changelog``
.. _CHANGELOG: https://github.com/python-semver/python-semver/blob/maint/v2/CHANGELOG.rst
The move from v2 to v3 introduced many changes and deprecated module functions.
The main functionality is handled by the :class:`~semver.version.Version` class
now. Find more information in the section :ref:`semver2-to-3`.
semver Version 2
----------------
Active development of major version 2 has stopped. No new features nor
backports will be integrated.
We recommend to upgrade your workflow to Python 3 to gain support,
bugfixes, and new features.
If you still need this old version, use the |MAINT|_ branch. There you
can look for the |CHANGELOG|_ if you need some details about the history.
semver Version 3
----------------
We will not intentionally make breaking changes in minor releases of V3.
Methods marked as ``deprecated`` raise a warning message when used from the
:py:mod:`python:warnings` module.
Refer to section :ref:`sec_display_deprecation_warnings` to get more information about how to customize it.
Check section :ref:`sec_replace_deprecated_functions` to make your code
ready for future major releases.
semver Version 3 and beyond
---------------------------
Methods that were marked as deprecated will be very likely be removed.
Support for Python versions
---------------------------
This project will drop support for a Python version when the
following conditions are met:
* The Python version has reached `EOL <https://devguide.python.org/versions/>`_.
|
