skillfed

charm-refresh-build-version

Write `charm` version in refresh_versions.toml from git tag

charm-refresh-build-version v0.4.1 91.1K downloads/30d#13,542 on PyPI
License unclear Active released

What it is and what it does

charm-refresh-build-version is a build-time utility that reads version information from git tags and writes it into a refresh_versions.toml file, designed to keep charm project versions synchronized. It depends on dunamai for git tag parsing and tomlkit for TOML file manipulation, making it a lightweight addition to build workflows.

The package targets Python 3.8 through 3.13 and is actively maintained. It solves the problem of manual version synchronization in projects that use both git tags and TOML-based version configuration, automating a repetitive step in builds.

Use it for:

  • Automate version updates in charm projects by syncing git tags to refresh_versions.toml during builds
  • Integrate version management into CI/CD pipelines for charm-based applications
  • Maintain consistent versioning across charm metadata and build configuration files

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Writes charm version information into refresh_versions.toml by reading from git tags, automating version synchronization for charm-based projects.

Yes, if you are building projects that use git tags and refresh_versions.toml. Low install friction, active maintenance, and no known vulnerabilities make it a safe choice for that workflow. The unclear license status is worth checking before production use.

Install

charm-refresh-build-version on PyPI

pip

pip install charm-refresh-build-version

uv

uv add charm-refresh-build-version

poetry

poetry add charm-refresh-build-version

Installing charm-refresh-build-version

Before you install

Low install friction with a pure Python wheel and only two lightweight runtime dependencies. Actively maintained with a release within the last 130 days.

Quickstart

pip install charm-refresh-build-version

from charm_refresh_build_version import ...
# Reads git tag and writes version to refresh_versions.toml

Requires Python 3.8 or later; intended for projects using git tags and refresh_versions.toml workflow.

Verify before relying

  • Whether this package is intended for Juju charm development specifically or has broader applicability
  • What 'charm' refers to in the context of refresh_versions.toml and whether it requires external tooling
  • Whether dunamai and tomlkit are stable, well-maintained dependencies suitable for production use
  • What the unclear license status means for commercial or proprietary use

Package facts

License not declared (unclear)
Python support supports the current Python release (>=3.8)
Install friction low — pure-Python wheel
Runtime dependencies 2 — dunamai, tomlkit
Maintenance actively maintained — 130 days since the last release
First released
Downloads 91,084/month — #13,542 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: charm_refresh_build_version-0.4.1-py3-none-any.whl

Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9

Tags

charm version managementgit tag to toml versionrefresh_versions automationcharm build versioningautomated version sync
version-managementbuild-automation

More Build Tools packages