Sam Hooke

Poetry: Automatically generate package version from git commit

When building a Python package that is stored in git, it can be convenient to automatically generate the package version from the git commit and/or tag. That way there is no need to manually “bump” the version number in your Python code. Instead, each commit in git automatically generates a version such as:


And each tag generates a version such as:


Using build, this could be done using setuptools_scm, but using in this manner is deprecated.

Instead, we can perform our build using Poetry, and use the poetry-dynamic-versioning plugin to replace setuptools_scm.

Steps §

  1. Run poetry self add "poetry-dynamic-versioning[plugin]" to install the poetry-dynamic-versioning plugin.
  2. Add the following to your pyproject.toml:1
enable = true
vcs = "git"
pattern  = "^(?P<base>\\d+\\.\\d+\\.\\d+)(-?((?P<stage>[a-zA-Z]+)\\.?(?P<revision>\\d+)?))?"
format-jinja = """
    {%- if distance == 0 -%}
        {{- base -}}
    {%- else -%}
        {{- base }}.dev{{ distance }}+g{{commit}}
    {%- endif -%}
format-jinja-imports = [
    { module = "datetime", item = "datetime" }
  1. Then just run poetry build and check the output:
$ ls dist/

These are rough notes from whatever I was working on, interested in or thinking about at the time. They vary greatly in quality and length, but prove useful to me, and hopefully to you too!

← Previous: Poetry: example
Next: Shipping e-bike batteries from the USA to the UK →