A Git versioning plugin for PyBuilder
Project description
PyBuilder Git Version Plugin
Summary
This project is a plugin for PyBuilder that sets the project version based on git tags.
Usage
To use the plugin put the following in the plugins section of build.py:
use_plugin('pybuilder_git_version')
The possible properties for use are:
| Property | Value | Default | Usage |
|---|---|---|---|
| use_git_version | True / False | True | Turns off pybuilder_git_version |
| git_version_commit_distance_as_build_number | True / False | True | Uses commit count from tag as build number |
Examples
The following table has examples of repo state and corresponding version number produced.
| Tag | Branch | Clean / Dirty | Number of commits since tag | Version |
|---|---|---|---|---|
| 0.0.1 | master | clean | 0 | 0.0.1 |
| 0.0.1 | master | dirty | 0 | 0.0.2+build.0 |
| 0.2.2 | develop | clean | 5 | 0.2.3+develop.5 |
| 1.2.3 | develop | dirty | 3 | 1.2.4+develop.3 |
| 1.0.0-rc.1 | feature/TICKET-100 | clean | 5 | 1.0.0-rc.1+ticket100.5 |
| 0.0.1 | hotfix/BUG-20 | clean | 0 | 0.0.2+bug20.0 |
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pybuilder-git-version-0.2.0.tar.gz.
File metadata
- Download URL: pybuilder-git-version-0.2.0.tar.gz
- Upload date:
- Size: 3.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.7.1 importlib_metadata/4.9.0 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9ab193bdbebcf7e1d57f70b003730b511fb55ed7ff0a65239a0a922d309b3588 |
|
| MD5 | d2b7869a5600e3551daf127cd641b39f |
|
| BLAKE2b-256 | 34aad0aa3bc8b9011d94600d0843d0e8eb60576f873fb6bfef0109492d8a60aa |
File details
Details for the file pybuilder_git_version-0.2.0-py3-none-any.whl.
File metadata
- Download URL: pybuilder_git_version-0.2.0-py3-none-any.whl
- Upload date:
- Size: 3.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.7.1 importlib_metadata/4.9.0 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c76ce1b69162b6d4ac9c9cbf14ac883f2d5e8f49643692163ae7538fb826d22f |
|
| MD5 | 3e62eb11e6fb5738d8ebf6011a4095ef |
|
| BLAKE2b-256 | afcdeefa8fa5c0ab09d1e1f548a86ba40492e0a003c9962d71287bdf061ba85d |
