Hatch plugin for ci system versioning
Project description
hatch-ci
Introduction
This is a hatch-vcs heavily inspired plugin: it captures values from the build environment (eg. github) and uses them to modify files during the wheel build phase.
In the simplest way all you have to do is setting up the pyproject.toml as:
[build-system]
requires = ["hatchling", "hatch-ci"]
build-backend = "hatchling.build"
[project]
dynamic = ["version"]
[tool.hatch.version]
version-file = "src/package/__init__.py"
wheel version
During the wheel build the version is dynamically updated with information taken from
the version-file
field (see "Version source options").
Two variables will be overwritten/modified in version-file
: the version
containing the semgrep version and hash with the git commit for the build.
The version information is augmented with:
- a bNNN build number in creating the package foobar-1.0.0bNNNN (this can be sent to PyPi)
- if there's a tag v1.0.0 on the repo, it will build foobar-1.0.0 release (this can be sent to PyPi)
The last two steps are mean to be managed in a CI/CD system (github at the moment), to ensure hands-off releases.
In essence this pluging:
- manages the version information
- allows version replacement in text files using build information
Table of Contents
Global dependency
Ensure hatch-ci
is defined within the build-system.requires
field in your pyproject.toml
file.
[build-system]
requires = ["hatchling", "hatch-ci"]
build-backend = "hatchling.build"
Version source
The version source plugin name is ci
.
This will enable the hatch-ci pluging:
-
pyproject.toml
[project] .. dynamic = ["version"] # this rerieves the version dynamically ..
Version source options
-
pyproject.toml
[tool.hatch.version] source = "ci" # this pulls the version using the hatch-ci hook # this will put/update __version__ and __hash__ info in version-file version-file = "src/hatch_ci/__init__.py" # these files will be jinja2 processed, the environment will # contains variables as: branch, build, current, ref, runid, # sha, version, workflow etc. paths = [ "README.md" ] # the listed paths will undergo replacement before jinja2 processing and # the variables 'a' & 'b' listed below wil be replaced with ctx attributes. fixers = [ { 'a': '{ctx.workflows}' }, { 'd': '{ctx.branch}' } ]
The complete list of attributes is available here TEMPLATE.md.
Option | Type | Default | Description |
---|---|---|---|
version-file |
str |
None | A file where to write version/hash variables |
paths |
`list[str] | str` | None |
fixers |
list[dict[str,str]] |
None | A list of dict, each key is a string to replace with the value |
License
hatch-ci
is distributed under the terms of the MIT license.
Project details
Release history Release notifications | RSS feed
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
Hashes for hatch_ci-0.1.3b48-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e2ab68518b398bd77cd6a365702473fb80d3f6c850ae9b8340f857bc0855e771 |
|
MD5 | e63cd9e1dc09d85fc0308a862e20d86a |
|
BLAKE2b-256 | 58da48d3fde830b11255e342a6362655218fed7451a38363fbffbbb9489094be |