Metadata-Version: 2.1
Name: poetry-git-version-plugin
Version: 0.0.5
Summary: Poetry plugin to get package version from git
Home-page: https://gitlab.com/rocshers/python/poetry-git-version-plugin
License: MIT
Author: irocshers
Author-email: develop.iam@rocshers.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Topic :: System :: Archiving :: Packaging
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Software Distribution
Requires-Dist: gitpython (>=3.1.29,<4.0.0)
Requires-Dist: poetry (>=1.2.0,<2.0.0)
Project-URL: Repository, https://gitlab.com/rocshers/python/poetry-git-version-plugin
Description-Content-Type: text/markdown

# Poetry Git Version Plugin

Poetry plugin to get package version from git.

> Descendant of `poetry-version-plugin`, which **does not work** on `poetry 1.2.0`.

## Functionality

- Project tag parsing
- Substitution of the project tag (if any) in the poetry.version value
- Maintenance of PEP 440
- Command to output a new version

## Quick start

```bash
poetry self add poetry-git-version-plugin
poetry git-version # Write your git tag
poetry -v git-version # print process
```

## Dependencies

```toml
[tool.poetry.dependencies]
python = ">=3.10"
poetry = ">=1.2.0"
```

## Setup

```toml
[tool.poetry-git-version-plugin]
# Ignore "tag missing" errors
ignore_exception = true

# If the tag is missing.
# Returns a version, computed from the latest version tag.
# It takes the version tag, increases the version tag by the number of commits since, adds a local label specifying the git commit hash and the dirty status.
# Example: 1.3.2+5-5babef6
use_last_tag = true
```

## Contribute

Issue Tracker: <https://gitlab.com/rocshers/python/poetry-git-version-plugin/-/issues>  
Source Code: <https://gitlab.com/rocshers/python/poetry-git-version-plugin>

