Metadata-Version: 2.1
Name: setuptools-git-versioning
Version: 1.1.7
Summary: Automatically set package version using git tag/hash
Home-page: https://github.com/dolfinus/setuptools-git-versioning
Author: Camas
Author-email: camas@hotmail.co.uk
License: UNKNOWN
Description: # setuptools-git-versioning
        
        [![PyPI version](https://badge.fury.io/py/setuptools-git-versioning.svg)](https://badge.fury.io/py/setuptools-git-versioning)
        [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/setuptools-git-versioning)](https://badge.fury.io/py/setuptools-git-versioning)
        [![Build Status](https://travis-ci.com/dolfinus/setuptools-git-versioning.svg?branch=master)](https://travis-ci.com/dolfinus/setuptools-git-versioning)
        
        Automatically set package version using git tag/hash
        
        ## Compairing with other packages
        
        | Package/Function                                                                                    | Lastest release | Python2 support | Python3 support | PEP 440 compatible | Separated template for not tagged HEAD | Separated template for dirty run | Using functions outside setup.py | Returning starting_version if no tags |
        |:----------------------------------------------------------------------------------------------------|----------------:|:---------------:|:---------------:|:------------------:|:--------------------------------------:|:--------------------------------:|:--------------------------------:|:--------------------------------:|
        | [setuptools-git-versioning](https://github.com/dolfinus/setuptools-git-versioning)                  |            2020 |        +        |        +        |         +          |                   +                    |                +                 |                +                 |                +                 |
        | [setuptools-git-ver](https://github.com/camas/setuptools-git-ver) (Base package)                    |            2020 |        -        |        +        |         +          |                   +                    |                +                 |                -                 |                -                 |
        | [even-better-setuptools-git-version](https://github.com/ktemkin/even-better-setuptools-git-version) |            2019 |        -        |        +        |         +          |                   -                    |                -                 |                +                 |                +                 |
        | [better-setuptools-git-version](https://github.com/vivin/better-setuptools-git-version)             |            2018 |        -        |        +        |         +          |                   -                    |                -                 |                +                 |                +                 |
        | [very-good-setuptools-git-version](https://github.com/Kautenja/very-good-setuptools-git-version)    |            2018 |        -        |        +        |         -          |                   -                    |                -                 |                +                 |                -                 |
        | [setuptools-git-version](https://github.com/pyfidelity/setuptools-git-version)                      |            2018 |        +        |        +        |         -          |                   -                    |                -                 |                -                 |                -                 |
        
        ## Installation
        
        No need.
        
        Adding `setup_requires=['setuptools-git-versioning']` somewhere in `setup.py` will automatically download the latest version from PyPi and save it in the `.eggs` folder when `setup.py` is run.
        
        ## Usage
        
        To just use the default templates for versioning:
        
        ```python
        setuptools.setup(
            ...
            version_config=True,
            ...
            setup_requires=['setuptools-git-versioning'],
            ...
        )
        ```
        
        Changing templates (also shows the defaults):
        
        ```python
        setuptools.setup(
            ...
            version_config={
                "template": "{tag}",
                "dev_template": "{tag}.dev{ccount}+git.{sha}"
                "dirty_template": "{tag}.dev{ccount}+git.{sha}.dirty",
                "starting_version": "0.0.1"
            },
            ...
            setup_requires=['setuptools-git-versioning'],
            ...
        )
        ```
        
        ### Templates
        
        - `template`: used if no untracked files and latest commit is tagged
        
        - `dev_template`: used if no untracked files and latest commit isn't tagged
        
        - `dirty_template`: used if untracked files exist or uncommitted changes have been made
        
        - `starting_version`: static value, used if not tags exist in repo
        
        ### Format Options
        
        - `{tag}`: Latest tag in the repository
        
        - `{ccount}`: Number of commits since last tag
        
        - `{sha}`: First 8 characters of the sha hash of the latest commit
        
        - `{branch}`: Current branch name
        
Keywords: setuptools git version-control
Platform: UNKNOWN
Classifier: Framework :: Setuptools Plugin
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=2.7
Description-Content-Type: text/markdown
