fix(release): centralize pubspec version parsing

2026-07-12 08:42:24 +02:00
parent 2e830d3f97
commit c0d8951677
4 changed files with 146 additions and 5 deletions
@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+"""Read and validate the top-level version from a Flutter pubspec."""
+
+import argparse
+from pathlib import Path
+import re
+import sys
+
+
+_TOP_LEVEL_VERSION = re.compile(r"^version:[ \t]*(.*)$")
+_VERSION = re.compile(
+    r"(?P<version>"
+    r"(?:0|[1-9][0-9]*)\."
+    r"(?:0|[1-9][0-9]*)\."
+    r"(?:0|[1-9][0-9]*)\+"
+    r"(?P<build>[0-9]+)"
+    r")"
+)
+
+
+def parse_pubspec_version(contents: str) -> tuple[str, str]:
+    values = []
+    for line in contents.splitlines():
+        match = _TOP_LEVEL_VERSION.match(line)
+        if match:
+            value = re.sub(r"[ \t]+#.*$", "", match.group(1)).strip()
+            values.append(value)
+
+    if len(values) != 1:
+        raise ValueError(
+            f"expected one top-level 'version:' field, found {len(values)}"
+        )
+
+    match = _VERSION.fullmatch(values[0])
+    if not match:
+        raise ValueError(
+            "top-level version must use major.minor.patch+numeric-build syntax; "
+            f"got {values[0]!r}"
+        )
+
+    return match.group("version"), match.group("build")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="Read and validate the top-level pubspec version."
+    )
+    parser.add_argument(
+        "pubspec",
+        nargs="?",
+        type=Path,
+        default=Path("pubspec.yaml"),
+        help="path to pubspec.yaml (default: ./pubspec.yaml)",
+    )
+    parser.add_argument(
+        "--build-number",
+        action="store_true",
+        help="print only the numeric build metadata",
+    )
+    args = parser.parse_args()
+
+    try:
+        contents = args.pubspec.read_text(encoding="utf-8")
+        version, build = parse_pubspec_version(contents)
+    except (OSError, UnicodeError, ValueError) as error:
+        print(f"Error: {args.pubspec}: {error}", file=sys.stderr)
+        return 1
+
+    print(build if args.build_number else version)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())