Name | python-versioning JSON |
Version |
1.0a1
JSON |
| download |
home_page | |
Summary | A small package for PEP 440-compliant versioning of Python packages. |
upload_time | 2023-07-11 23:17:14 |
maintainer | |
docs_url | None |
author | |
requires_python | >=3.7 |
license | |
keywords |
python
versioning
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# python-versioning
[![](https://results.pre-commit.ci/badge/github/paduszyk/python-versioning/main.svg)](https://results.pre-commit.ci/latest/github/paduszyk/python-versioning/main)
[![](https://img.shields.io/github/actions/workflow/status/paduszyk/python-versioning/ci.yaml?label=CI&logo=github)](https://github.com/paduszyk/python-versioning/actions/workflows/ci.yaml)
[![](https://img.shields.io/codecov/c/github/paduszyk/python-versioning?logo=codecov&label=codecov&token=B68F4Ewt2a)](https://codecov.io/gh/paduszyk/python-versioning)
[![](https://img.shields.io/badge/code%20style-black-black)](https://github.com/psf/black)
[![](https://img.shields.io/badge/linter-flake8-olive)](https://flake8.pycqa.org)
[![](https://img.shields.io/badge/imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort)
## Summary
This project aims to facilitate the incorporation of [PEP 440](https://peps.python.org/pep-0440/)-compliant versioning of Python packages using [Semantic Versioning](https://semver.org) (*SemVer*), without a shadow of a doubt the most popular versioning scheme nowadays.
The rationale behind developing it was to:
- use a cleaner (and thus more *Pythonic*) OOP-based approach as an alternative to the conventional version specification using strings;
- avoid invalid versioning errors during builds thanks to version validation.[^1]
## Installation
The latest version of the package can be installed using `pip`:
```bash
$ pip install python-versioning --upgrade
```
or any other package manager specific to your Python environment.
## License
Released under the [MIT license](LICENSE).
[^1]: In fact, *SemVer* is not fully compatible with PEP 440, especially in the case of the clauses of the former regarding pre-releases (see the [official proposal](https://peps.python.org/pep-0440/#semantic-versioning)).
Raw data
{
"_id": null,
"home_page": "",
"name": "python-versioning",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "python,versioning",
"author": "",
"author_email": "Kamil Paduszy\u0144ski <paduszyk@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/03/9c/f607da4fdd0775f91e37714f839124a93e37d921b72cb4275d15ea25b896/python-versioning-1.0a1.tar.gz",
"platform": null,
"description": "# python-versioning\n\n[![](https://results.pre-commit.ci/badge/github/paduszyk/python-versioning/main.svg)](https://results.pre-commit.ci/latest/github/paduszyk/python-versioning/main)\n[![](https://img.shields.io/github/actions/workflow/status/paduszyk/python-versioning/ci.yaml?label=CI&logo=github)](https://github.com/paduszyk/python-versioning/actions/workflows/ci.yaml)\n[![](https://img.shields.io/codecov/c/github/paduszyk/python-versioning?logo=codecov&label=codecov&token=B68F4Ewt2a)](https://codecov.io/gh/paduszyk/python-versioning)\n\n[![](https://img.shields.io/badge/code%20style-black-black)](https://github.com/psf/black)\n[![](https://img.shields.io/badge/linter-flake8-olive)](https://flake8.pycqa.org)\n[![](https://img.shields.io/badge/imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort)\n\n## Summary\n\nThis project aims to facilitate the incorporation of [PEP 440](https://peps.python.org/pep-0440/)-compliant versioning of Python packages using [Semantic Versioning](https://semver.org) (*SemVer*), without a shadow of a doubt the most popular versioning scheme nowadays.\n\nThe rationale behind developing it was to:\n- use a cleaner (and thus more *Pythonic*) OOP-based approach as an alternative to the conventional version specification using strings;\n- avoid invalid versioning errors during builds thanks to version validation.[^1]\n\n## Installation\n\nThe latest version of the package can be installed using `pip`:\n```bash\n$ pip install python-versioning --upgrade\n```\nor any other package manager specific to your Python environment.\n\n## License\n\nReleased under the [MIT license](LICENSE).\n\n\n[^1]: In fact, *SemVer* is not fully compatible with PEP 440, especially in the case of the clauses of the former regarding pre-releases (see the [official proposal](https://peps.python.org/pep-0440/#semantic-versioning)).\n",
"bugtrack_url": null,
"license": "",
"summary": "A small package for PEP 440-compliant versioning of Python packages.",
"version": "1.0a1",
"project_urls": null,
"split_keywords": [
"python",
"versioning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "93a921695dff526ccb6fa694b09925a5be273b11cc6dbb2f7e07c017eab0da25",
"md5": "0fafb37b9cde9cc5a22eb3e2b515bc8f",
"sha256": "f04b9dc06c4c01edb19b94c95bc5e2848d737a72a5fbfd0fe42aff9ef6a73fde"
},
"downloads": -1,
"filename": "python_versioning-1.0a1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0fafb37b9cde9cc5a22eb3e2b515bc8f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 4392,
"upload_time": "2023-07-11T23:17:12",
"upload_time_iso_8601": "2023-07-11T23:17:12.844693Z",
"url": "https://files.pythonhosted.org/packages/93/a9/21695dff526ccb6fa694b09925a5be273b11cc6dbb2f7e07c017eab0da25/python_versioning-1.0a1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "039cf607da4fdd0775f91e37714f839124a93e37d921b72cb4275d15ea25b896",
"md5": "aa573cb32edb739a3e4f81a5629d8de2",
"sha256": "bbe5ce3d5732150177af207c04da16ac7d8a0c4823cbdbf4401882f822a79b49"
},
"downloads": -1,
"filename": "python-versioning-1.0a1.tar.gz",
"has_sig": false,
"md5_digest": "aa573cb32edb739a3e4f81a5629d8de2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 4947,
"upload_time": "2023-07-11T23:17:14",
"upload_time_iso_8601": "2023-07-11T23:17:14.588993Z",
"url": "https://files.pythonhosted.org/packages/03/9c/f607da4fdd0775f91e37714f839124a93e37d921b72cb4275d15ea25b896/python-versioning-1.0a1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-11 23:17:14",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "python-versioning"
}