Metadata-Version: 2.1
Name: version-helper
Version: 0.2.0a0
Summary: Helpers for a better version management in python projects
Home-page: https://github.com/dl6nm/version-helper
License: MIT
Keywords: git,describe,tags,version,__version__.py
Author: DL6NM
Author-email: mail@dl6nm.de
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Version Control
Classifier: Topic :: Software Development :: Version Control :: Git
Project-URL: Repository, https://github.com/dl6nm/version-helper
Description-Content-Type: text/markdown

# Version Helper

`version-helper` is a package for a better version management in python projects.

_This package is still under development. Code may change frequently._

![PyPI](https://img.shields.io/pypi/v/version-helper)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/version-helper)
[![codecov](https://codecov.io/gh/dl6nm/version-helper/branch/main/graph/badge.svg?token=WNOMQ28E5J)](https://codecov.io/gh/dl6nm/version-helper)
![GitHub Workflow Status](https://img.shields.io/github/workflow/status/dl6nm/version-helper/Codecov%20Workflow)
![GitHub](https://img.shields.io/github/license/dl6nm/version-helper)

    from version_helper import Version

    # Parse output from `git describe --tag` and return a semantic versioning compatible `Version` object
    v = Version.get_from_git_describe()

    # Output core version string including major, minor and patch
    print(v.core)

    # Output full Semantic Version string including core, prerelease and build metadata
    print(v.full)

## Table of Contents

- [Version Helper](#version-helper)
  - [Table of Contents](#table-of-contents)
  - [Installing `version-helper`](#installing-version-helper)
  - [Publish](#publish)
  - [Changelog](#changelog)
  - [References](#references)

## Installing `version-helper`

    pip install version-helper

Code example see at the top of this page.

## Publish

    poetry publish --build [-r testpypi]

## Changelog

All notable changes to this project will be documented in the [CHANGELOG.md](CHANGELOG.md).

## References

- [git-describe](https://git-scm.com/docs/git-describe)
- [Poetry](https://python-poetry.org/)
- [Semantic Versioning](https://semver.org/)

