---
id: charm-refresh-build-version
version: "0.4.1"
license: unclear
license_treatment: unclear
maintenance: active
---

# charm-refresh-build-version — Write `charm` version in refresh_versions.toml from git tag

License: unclear · Maintenance: active · Downloads: 91.1K/mo

## 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 above — 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

pip install charm-refresh-build-version
uv add charm-refresh-build-version
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_current
- Install friction: low
- Maintenance: active
- Downloads: 91.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

charm version management, git tag to toml version, refresh_versions automation, charm build versioning, automated version sync, version-management, build-automation

[View on SkillFed](https://skillfed.io/packages/charm-refresh-build-version) · [View on PyPI](https://pypi.org/project/charm-refresh-build-version/)