python-versioning


Namepython-versioning JSON
Version 1.0a1 PyPI version JSON
download
home_page
SummaryA small package for PEP 440-compliant versioning of Python packages.
upload_time2023-07-11 23:17:14
maintainer
docs_urlNone
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"
}
        
Elapsed time: 0.08784s