|
| 1 | +# /// script |
| 2 | +# requires-python = ">=3.10" |
| 3 | +# dependencies = ["packaging"] |
| 4 | +# /// |
| 5 | +"""Plan the next version for each selected package. |
| 6 | +
|
| 7 | +Reads PACKAGES_JSON and ACTION from env, computes the next version per package |
| 8 | +using packaging.Version, writes a markdown summary to GITHUB_STEP_SUMMARY and a |
| 9 | +JSON array to GITHUB_OUTPUT for the release matrix. |
| 10 | +""" |
| 11 | + |
| 12 | +from __future__ import annotations |
| 13 | + |
| 14 | +import json |
| 15 | +import operator |
| 16 | +import os |
| 17 | +import pathlib |
| 18 | +import subprocess |
| 19 | +import sys |
| 20 | +from typing import NoReturn |
| 21 | + |
| 22 | +from packaging.version import InvalidVersion, Version |
| 23 | + |
| 24 | +ACTIONS: dict[str, tuple[str, str | None]] = { |
| 25 | + "new-prerelease-patch": ("new-prerelease", "patch"), |
| 26 | + "new-prerelease-minor": ("new-prerelease", "minor"), |
| 27 | + "new-prerelease-major": ("new-prerelease", "major"), |
| 28 | + "continued-prerelease": ("continued-prerelease", None), |
| 29 | + "release-from-prerelease": ("release", "from-prerelease"), |
| 30 | + "release-post": ("release", "post"), |
| 31 | + "release-patch": ("release", "patch"), |
| 32 | + "release-minor": ("release", "minor"), |
| 33 | + "release-major": ("release", "major"), |
| 34 | +} |
| 35 | + |
| 36 | + |
| 37 | +def fail(message: str) -> NoReturn: |
| 38 | + """Print to stderr and exit 1.""" |
| 39 | + sys.stderr.write(f"Error: {message}\n") |
| 40 | + sys.exit(1) |
| 41 | + |
| 42 | + |
| 43 | +def pick_latest(prefix: str) -> str | None: |
| 44 | + """Return the largest PEP 440 tag under prefix (prefix stripped), or None. |
| 45 | +
|
| 46 | + Args: |
| 47 | + prefix: Tag prefix, e.g. ``v`` or ``reflex-base-v``. |
| 48 | + """ |
| 49 | + raw = subprocess.check_output(["git", "tag", "-l", f"{prefix}*"], text=True) |
| 50 | + pairs: list[tuple[Version, str]] = [] |
| 51 | + for line in raw.splitlines(): |
| 52 | + tag = line.removeprefix(prefix).strip() |
| 53 | + if not tag: |
| 54 | + continue |
| 55 | + try: |
| 56 | + pairs.append((Version(tag), tag)) |
| 57 | + except InvalidVersion: |
| 58 | + continue |
| 59 | + if not pairs: |
| 60 | + return None |
| 61 | + _, original = max(pairs, key=operator.itemgetter(0)) |
| 62 | + return original |
| 63 | + |
| 64 | + |
| 65 | +def next_version(latest: str | None, action: str, pkg: str) -> str: |
| 66 | + """Compute the next version for pkg given action and latest. |
| 67 | +
|
| 68 | + Args: |
| 69 | + latest: Current latest version string, or None if the package has no prior tags. |
| 70 | + action: One of the keys in ACTIONS. |
| 71 | + pkg: Package name, used for error messages. |
| 72 | +
|
| 73 | + Returns: |
| 74 | + The next version string. |
| 75 | + """ |
| 76 | + mode, sub = ACTIONS[action] |
| 77 | + |
| 78 | + if latest is None: |
| 79 | + major = minor = patch = alpha_n = post_n = 0 |
| 80 | + is_alpha = False |
| 81 | + else: |
| 82 | + ver = Version(latest) |
| 83 | + major, minor, patch = ver.major, ver.minor, ver.micro |
| 84 | + is_alpha = ver.pre is not None and ver.pre[0] == "a" |
| 85 | + alpha_n = ver.pre[1] if is_alpha and ver.pre is not None else 0 |
| 86 | + post_n = ver.post or 0 |
| 87 | + |
| 88 | + display = latest if latest is not None else "<none>" |
| 89 | + |
| 90 | + if mode == "new-prerelease": |
| 91 | + if sub == "patch": |
| 92 | + return f"{major}.{minor}.{patch + 1}a1" |
| 93 | + if sub == "minor": |
| 94 | + return f"{major}.{minor + 1}.0a1" |
| 95 | + return f"{major + 1}.0.0a1" |
| 96 | + |
| 97 | + if mode == "continued-prerelease": |
| 98 | + if not is_alpha: |
| 99 | + fail( |
| 100 | + f"continued-prerelease requires latest to be an alpha; " |
| 101 | + f"latest for {pkg} is {display!r}" |
| 102 | + ) |
| 103 | + return f"{major}.{minor}.{patch}a{alpha_n + 1}" |
| 104 | + |
| 105 | + if sub == "from-prerelease": |
| 106 | + if not is_alpha: |
| 107 | + fail( |
| 108 | + f"release-from-prerelease requires latest to be an alpha; " |
| 109 | + f"latest for {pkg} is {display!r}" |
| 110 | + ) |
| 111 | + return f"{major}.{minor}.{patch}" |
| 112 | + if sub == "post": |
| 113 | + if latest is None: |
| 114 | + fail(f"release-post requires an existing release; no tags for {pkg}") |
| 115 | + if is_alpha: |
| 116 | + fail( |
| 117 | + f"release-post cannot follow an alpha; latest for {pkg} is {display!r}" |
| 118 | + ) |
| 119 | + return f"{major}.{minor}.{patch}.post{post_n + 1}" |
| 120 | + if sub == "patch": |
| 121 | + return f"{major}.{minor}.{patch + 1}" |
| 122 | + if sub == "minor": |
| 123 | + return f"{major}.{minor + 1}.0" |
| 124 | + return f"{major + 1}.0.0" |
| 125 | + |
| 126 | + |
| 127 | +def tag_exists(tag: str) -> bool: |
| 128 | + """Return whether a local git tag exists.""" |
| 129 | + return ( |
| 130 | + subprocess.run( |
| 131 | + ["git", "rev-parse", "-q", "--verify", f"refs/tags/{tag}"], |
| 132 | + capture_output=True, |
| 133 | + check=False, |
| 134 | + ).returncode |
| 135 | + == 0 |
| 136 | + ) |
| 137 | + |
| 138 | + |
| 139 | +def main() -> None: |
| 140 | + """Entry point.""" |
| 141 | + action = os.environ["ACTION"] |
| 142 | + packages_json = os.environ["PACKAGES_JSON"] |
| 143 | + github_output = os.environ["GITHUB_OUTPUT"] |
| 144 | + github_step_summary = os.environ["GITHUB_STEP_SUMMARY"] |
| 145 | + |
| 146 | + if action not in ACTIONS: |
| 147 | + fail(f"unknown action '{action}'") |
| 148 | + |
| 149 | + packages: list[str] = json.loads(packages_json) |
| 150 | + |
| 151 | + summary_rows = [ |
| 152 | + "## Release plan", |
| 153 | + "", |
| 154 | + f"Action: `{action}`", |
| 155 | + "", |
| 156 | + "| Package | Current | Next | Tag |", |
| 157 | + "|---------|---------|------|-----|", |
| 158 | + ] |
| 159 | + releases: list[dict[str, str]] = [] |
| 160 | + |
| 161 | + for pkg in packages: |
| 162 | + tag_prefix = "v" if pkg == "reflex" else f"{pkg}-v" |
| 163 | + current = pick_latest(tag_prefix) |
| 164 | + next_ver = next_version(current, action, pkg) |
| 165 | + tag = f"{tag_prefix}{next_ver}" |
| 166 | + |
| 167 | + if tag_exists(tag): |
| 168 | + fail(f"tag {tag} already exists") |
| 169 | + |
| 170 | + display = current if current is not None else "<none>" |
| 171 | + summary_rows.append(f"| `{pkg}` | `{display}` | `{next_ver}` | `{tag}` |") |
| 172 | + releases.append({ |
| 173 | + "package": pkg, |
| 174 | + "current": current or "", |
| 175 | + "next": next_ver, |
| 176 | + "tag": tag, |
| 177 | + }) |
| 178 | + |
| 179 | + # reflex is not independently releasable via dispatch: when reflex-base is |
| 180 | + # released, reflex is released alongside it with a matching version. The |
| 181 | + # publish workflow pins reflex-base exactly when building reflex. |
| 182 | + reflex_base_release = next( |
| 183 | + (r for r in releases if r["package"] == "reflex-base"), None |
| 184 | + ) |
| 185 | + if reflex_base_release is not None: |
| 186 | + reflex_version = reflex_base_release["next"] |
| 187 | + reflex_tag = f"v{reflex_version}" |
| 188 | + if tag_exists(reflex_tag): |
| 189 | + fail(f"tag {reflex_tag} already exists") |
| 190 | + current_reflex = pick_latest("v") |
| 191 | + display = current_reflex if current_reflex is not None else "<none>" |
| 192 | + summary_rows.append( |
| 193 | + f"| `reflex` | `{display}` | `{reflex_version}` | `{reflex_tag}` |" |
| 194 | + ) |
| 195 | + releases.append({ |
| 196 | + "package": "reflex", |
| 197 | + "current": current_reflex or "", |
| 198 | + "next": reflex_version, |
| 199 | + "tag": reflex_tag, |
| 200 | + }) |
| 201 | + |
| 202 | + with pathlib.Path(github_step_summary).open("a") as f: |
| 203 | + f.write("\n".join(summary_rows) + "\n") |
| 204 | + with pathlib.Path(github_output).open("a") as f: |
| 205 | + f.write(f"releases={json.dumps(releases)}\n") |
| 206 | + |
| 207 | + |
| 208 | +if __name__ == "__main__": |
| 209 | + main() |
0 commit comments