charm-refresh-build-version
Write `charm` version in refresh_versions.toml from git tag
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-versionuv
uv add charm-refresh-build-versionpoetry
poetry add charm-refresh-build-versionInstalling 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
Tags
More Build Tools packages
Provides reusable utilities for Python…
permissive · top 100 on PyPI
tqdmWraps any iterable to display a real-time…
copyleft · top 100 on PyPI
pippip is the standard installer for Python…
permissive · top 100 on PyPI
hatchlingHatchling is a standards-compliant Python build…
permissive · top 100 on PyPI
grpcio-toolsGenerates Python gRPC service stubs and message…
permissive · top 1,000 on PyPI
pre-commitpre-commit is a framework for installing and…
permissive · top 1,000 on PyPI
charmcraftlocalPacks Juju charms with local Python package…
unclear · top 15,000 on PyPI
versioneerVersioneer automates version management in…
permissive · top 5,000 on PyPI
data-platform-helpersProvides version checking and validation…
permissive · top 15,000 on PyPI
setuptools-git-versioningAutomatically generates PEP 440-compliant…
permissive · top 5,000 on PyPI
charmcraftcacheAccelerates charmcraft builds by…
unclear · top 15,000 on PyPI
versioningitAutomatically determines your Python package's…
permissive · top 5,000 on PyPI
cruftcruft creates new projects from Cookiecutter…
permissive · top 15,000 on PyPI
bump-my-versionAutomates version number management in projects…
permissive · top 5,000 on PyPI
coslProvides utilities for COS Lite charms,…
permissive · top 15,000 on PyPI
charmlibs-pathopsProvides a pathlib-like interface for reading…
permissive · top 15,000 on PyPI