multicz 0.3.0__tar.gz → 0.4.0__tar.gz

{multicz-0.3.0 → multicz-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: multicz
-Version: 0.3.0
+Version: 0.4.0
 Summary: Multi-component versioning for monorepos: bump apps, charts, and images independently from conventional commits.
 Keywords: semver,monorepo,helm,conventional-commits,release,versioning
 Author: Chris
@@ -960,6 +960,28 @@ exec multicz check "$1"
 * `.properties` — line-based `key=value` substitution (e.g. `gradle.properties`)
 * anything else — treated as a one-line `VERSION` file (`key = ` omitted)
 
+### Regex escape hatch (`key = "regex:..."`)
+
+For files no structured parser handles — Python `__version__`,
+TypeScript `export const VERSION`, Cargo `version = "..."` *outside*
+the `[package]` table, Makefile `VERSION := ...`, shell scripts,
+Dockerfile `LABEL version=...` — prefix the key with `regex:`:
+
+```toml
+[components.api]
+bump_files = [
+    { file = "pyproject.toml", key = "project.version" },
+    { file = "src/api/__init__.py", key = 'regex:^__version__\s*=\s*"([^"]+)"' },
+]
+```
+
+The pattern needs exactly one capture group locating the version
+literal. Matching uses `re.MULTILINE`, and only the *first* match's
+capture group is rewritten — surrounding text (quotes, indentation,
+comments, the rest of the file) is preserved byte-for-byte. Bad
+patterns (uncompilable, no group, no match in file) surface at
+`multicz validate --strict` rather than at bump time.
+
 ### Debian packages (`format = "debian"`)
 
 `multicz` writes a proper `debian/changelog` instead of a markdown

{multicz-0.3.0 → multicz-0.4.0}/README.md

@@ -932,6 +932,28 @@ exec multicz check "$1"
 * `.properties` — line-based `key=value` substitution (e.g. `gradle.properties`)
 * anything else — treated as a one-line `VERSION` file (`key = ` omitted)
 
+### Regex escape hatch (`key = "regex:..."`)
+
+For files no structured parser handles — Python `__version__`,
+TypeScript `export const VERSION`, Cargo `version = "..."` *outside*
+the `[package]` table, Makefile `VERSION := ...`, shell scripts,
+Dockerfile `LABEL version=...` — prefix the key with `regex:`:
+
+```toml
+[components.api]
+bump_files = [
+    { file = "pyproject.toml", key = "project.version" },
+    { file = "src/api/__init__.py", key = 'regex:^__version__\s*=\s*"([^"]+)"' },
+]
+```
+
+The pattern needs exactly one capture group locating the version
+literal. Matching uses `re.MULTILINE`, and only the *first* match's
+capture group is rewritten — surrounding text (quotes, indentation,
+comments, the rest of the file) is preserved byte-for-byte. Bad
+patterns (uncompilable, no group, no match in file) surface at
+`multicz validate --strict` rather than at bump time.
+
 ### Debian packages (`format = "debian"`)
 
 `multicz` writes a proper `debian/changelog` instead of a markdown

{multicz-0.3.0 → multicz-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "multicz"
-version = "0.3.0"
+version = "0.4.0"
 description = "Multi-component versioning for monorepos: bump apps, charts, and images independently from conventional commits."
 readme = "README.md"
 authors = [

{multicz-0.3.0 → multicz-0.4.0}/src/multicz/writers.py

@@ -13,22 +13,54 @@ A ``key`` is a dotted path (``project.version``, ``image.tag``). Passing
 files the dotted-path interpretation is disabled — the key is taken
 verbatim, since properties files routinely use dotted keys (``a.b.c``)
 that are *not* nested.
+
+A ``key`` prefixed with ``regex:`` is a language-agnostic escape hatch:
+the rest of the string is a regex with one capture group locating the
+version literal. Useful for ``__version__ = "X"`` in Python,
+``export const VERSION = "X"`` in TypeScript, ``VERSION := X`` in
+Makefiles, etc. The regex is anchored with :data:`re.MULTILINE`, and
+only the *first* match's capture group is rewritten.
 """
 
 from __future__ import annotations
 
 import io
 import json
+import re
 from pathlib import Path
 
 import tomlkit
 from ruamel.yaml import YAML
 
+REGEX_KEY_PREFIX = "regex:"
+
 
 class WriterError(RuntimeError):
     """Raised when a value cannot be read or written."""
 
 
+def _is_regex_key(key: str | None) -> bool:
+    return key is not None and key.startswith(REGEX_KEY_PREFIX)
+
+
+def _compile_regex_key(key: str) -> re.Pattern[str]:
+    pattern = key[len(REGEX_KEY_PREFIX):]
+    if not pattern:
+        raise WriterError(f"empty regex pattern in key: {key!r}")
+    try:
+        compiled = re.compile(pattern, re.MULTILINE)
+    except re.error as exc:
+        raise WriterError(
+            f"invalid regex {pattern!r} in key {key!r}: {exc}"
+        ) from exc
+    if compiled.groups < 1:
+        raise WriterError(
+            f"regex {pattern!r} must contain exactly one capture "
+            "group locating the version literal"
+        )
+    return compiled
+
+
 def _split_key(key: str) -> list[str]:
     parts = [part for part in key.split(".") if part]
     if not parts:
@@ -121,6 +153,14 @@ def read_value(file: Path, key: str | None) -> str:
     text = file.read_text(encoding="utf-8")
     if key is None:
         return text.strip()
+    if _is_regex_key(key):
+        pattern = _compile_regex_key(key)
+        match = pattern.search(text)
+        if not match:
+            raise WriterError(
+                f"regex {key!r} matched nothing in {file}"
+            )
+        return match.group(1)
     if _is_properties(file):
         result = _read_property(text, key)
         if result is None:
@@ -157,6 +197,22 @@ def write_value(file: Path, key: str | None, value: str) -> None:
         file.write_text(value + "\n", encoding="utf-8")
         return
 
+    if _is_regex_key(key):
+        pattern = _compile_regex_key(key)
+        text = file.read_text(encoding="utf-8")
+        match = pattern.search(text)
+        if not match:
+            raise WriterError(
+                f"regex {key!r} matched nothing in {file}"
+            )
+        # Replace only the first match's capture group, preserving the
+        # surrounding text byte-for-byte (quotes, indentation, comments).
+        g_start, g_end = match.span(1)
+        file.write_text(
+            text[:g_start] + value + text[g_end:], encoding="utf-8"
+        )
+        return
+
     if _is_properties(file):
         text = file.read_text(encoding="utf-8")
         file.write_text(_write_property(text, key, value), encoding="utf-8")