Metadata-Version: 2.3
Name: poetry-setuptools-scm-support
Version: 0.5.7
Summary: A Poetry plugin that integrates setuptools-scm 
License: MIT
Keywords: poetry,plugin,setuptools-scm
Author: Luca Stretti
Author-email: laxertu@gmail.com
Requires-Python: >=3.10, <3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: cleo (>=2.1.0,<3.0.0)
Requires-Dist: poetry (>=2.0.1,<3.0.0)
Requires-Dist: setuptools-scm (>=8.1.0,<9.0.0)
Project-URL: Issues, https://github.com/laxertu/poetry-setuptools-scm-support/issues
Project-URL: Repository, https://github.com/laxertu/poetry-setuptools-scm-support
Description-Content-Type: text/markdown

A Poetry plugin that integrates [setuptools-scm](https://pypi.org/project/setuptools-scm/) to console

Updates pyproject.toml file version with a calculated one

Versions are calculated taking into account the distance between current commit and last tagged one, and current commit revision hash

Supported schemes are the main ones exposed by setuptools-scm:

**scm**: formats according to setuptools_scm get_version default behavior. e.g. **0.1.dev1+g1e0ede4**    
**date**: formats current date and distance, e.g. **2025.4.1.1.dev1+g9d4edec** . Scheme used is calver_by_date function     
**branch**: Use branch based versioning of library. Scheme used is release_branch_semver_version function     

Prerequisites of projects using this plugin:

* A [tool.setuptools_scm] section declared
* A git tag with your starting version if different from default one is recommended

examples:

    poetry version-calculate
Ouputs something like 1.0.1.dev1+g1e0ede4

    poetry version-calculate date
2025.4.1.1.dev1+g1e0ede4

**Note about date format:**

Two digits year is taken by default, you can change this behaviour making a previous git tag with a different supporten format, in this case for example 

    git tag 2025.4.1

**Set default format**

You can configure default format by adding the following entry (the example sets date format)

    [tool.poetry-setuptools-scm-support]
    default-format = "date"




