Ludovic Marie
9a3237c5ac
docs/versioning.md: with .github/release-line.txt (MAJOR.MINOR) the train tags game releases vMAJOR.MINOR.PATCH and launcher releases launcher@MAJOR.MINOR.PATCH, the patch after the newest release on the line; the line's first release goes out at once (still not while RELEASES_PAUSED is set). Without the file nothing changes: vYYYY.MM.DD[.N] and launcher-vX.Y.Z. The file is not added here; the switch to 0.2 is a separate one-line pull request for the day Ludovic says go. - tag_key: every 0.2 tag ranks above every dated or launcher-v tag; semver order within, a pre-release before its release. release_channels.py uses the same key and tag test, so promotion and "latest only moves forward" work across the switch. - A line's first release says so in its notes; 0.2.0's explains the numbering and how a server that says it is up to date takes it (horizon-server update --version v0.2.0). - launcher.yml strips either prefix for HORIZON_LAUNCHER_VERSION and passes HORIZON_LAUNCHER_TAG, which the launcher uses to know its own line. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
125 lines
7.2 KiB
Python
125 lines
7.2 KiB
Python
import datetime as dt
|
|
import unittest
|
|
|
|
from tools import release_channels as channels
|
|
from tools import release_train as train
|
|
|
|
NOW = dt.datetime(2026, 10, 19, 18, 0, tzinfo=dt.timezone.utc)
|
|
|
|
|
|
def release(tag, hours_ago, prerelease=True, smoke=True, draft=False):
|
|
published = (NOW - dt.timedelta(hours=hours_ago)).isoformat().replace("+00:00", "Z")
|
|
assets = [{"name": "horizon-linux-x86_64.tar.gz"}] + ([{"name": channels.SMOKE_ASSET}] if smoke else [])
|
|
return {"tag_name": tag, "published_at": published, "prerelease": prerelease, "draft": draft, "assets": assets}
|
|
|
|
|
|
def blocker(number, title, body="", state="open", reason=None, closed_hours_ago=None):
|
|
closed = None if closed_hours_ago is None else (NOW - dt.timedelta(hours=closed_hours_ago)).isoformat()
|
|
return {"number": number, "title": title, "body": body, "state": state, "state_reason": reason, "closed_at": closed}
|
|
|
|
|
|
STABLE = release("v2026.10.18.04", 30, prerelease=False)
|
|
|
|
|
|
class ReleaseChannelTests(unittest.TestCase):
|
|
def test_the_newest_beta_out_six_hours_with_a_smoke_test_is_promoted(self):
|
|
releases = [STABLE, release("v2026.10.19", 9), release("v2026.10.19.01", 7), release("v2026.10.19.02", 2)]
|
|
chosen, why = channels.choose(releases, [], NOW)
|
|
self.assertEqual(chosen["tag_name"], "v2026.10.19.01")
|
|
self.assertIn("6 h", why)
|
|
|
|
def test_nothing_is_due_before_six_hours(self):
|
|
chosen, why = channels.choose([STABLE, release("v2026.10.19", 5.5)], [], NOW)
|
|
self.assertIsNone(chosen)
|
|
self.assertIn("0 h 30 min to go", why)
|
|
|
|
def test_a_beta_without_its_smoke_test_waits_for_a_hand(self):
|
|
releases = [STABLE, release("v2026.10.19", 8, smoke=False)]
|
|
self.assertIsNone(channels.choose(releases, [], NOW)[0])
|
|
self.assertIsNone(channels.choose(releases, [], NOW, tag="v2026.10.19")[0])
|
|
self.assertEqual(channels.choose(releases, [], NOW, tag="v2026.10.19", force=True)[0]["tag_name"], "v2026.10.19")
|
|
|
|
def test_by_hand_skips_the_wait_but_not_a_blocker(self):
|
|
releases = [STABLE, release("v2026.10.19.02", 1)]
|
|
self.assertEqual(channels.choose(releases, [], NOW, tag="v2026.10.19.02")[0]["tag_name"], "v2026.10.19.02")
|
|
blocked = [blocker(5, "Crash on start in 2026.10.19.2")]
|
|
chosen, why = channels.choose(releases, blocked, NOW, tag="v2026.10.19.02")
|
|
self.assertIsNone(chosen)
|
|
self.assertIn("#5", why)
|
|
self.assertIsNotNone(channels.choose(releases, blocked, NOW, tag="v2026.10.19.02", force=True)[0])
|
|
|
|
def test_stable_releases_and_drafts_are_never_promoted(self):
|
|
self.assertIsNone(channels.choose([STABLE], [], NOW, tag=STABLE["tag_name"])[0])
|
|
withdrawn = release("v2026.10.19", 9, draft=True)
|
|
self.assertIsNone(channels.choose([STABLE, withdrawn], [], NOW)[0])
|
|
older = release("v2026.10.18.03", 40)
|
|
self.assertIsNone(channels.choose([STABLE, older], [], NOW)[0])
|
|
|
|
def test_an_open_blocker_holds_every_beta_whatever_its_text_says(self):
|
|
releases = [STABLE, release("v2026.10.19", 12), release("v2026.10.19.01", 10), release("v2026.10.19.02", 8)]
|
|
# The issue's author can edit its text after it is labelled: naming a later version must not free a beta.
|
|
for text in ("Something is badly wrong", "Only in v2099.01.01", "Since v2026.10.19.01 the chests…"):
|
|
chosen, why = channels.choose(releases, [blocker(7, text, body=text)], NOW)
|
|
self.assertIsNone(chosen, text)
|
|
self.assertIn("release-blocker #7", why)
|
|
|
|
def test_a_fixed_blocker_still_holds_the_betas_published_before_the_fix(self):
|
|
fixed = blocker(9, "Crash", state="closed", reason="completed", closed_hours_ago=7.5)
|
|
releases = [STABLE, release("v2026.10.19", 12), release("v2026.10.19.01", 7)]
|
|
self.assertEqual(channels.choose(releases, [fixed], NOW)[0]["tag_name"], "v2026.10.19.01")
|
|
self.assertIsNone(channels.choose(releases[:2], [fixed], NOW)[0])
|
|
not_planned = blocker(10, "Crash", state="closed", reason="not_planned", closed_hours_ago=1)
|
|
self.assertEqual(channels.choose(releases[:2], [not_planned], NOW)[0]["tag_name"], "v2026.10.19")
|
|
|
|
def test_force_never_moves_latest_backwards(self):
|
|
# horizon-server update and install.sh download GitHub's latest: an older beta must never become it.
|
|
older = release("v2026.10.18.03", 40, smoke=False)
|
|
chosen, why = channels.choose([STABLE, older], [blocker(3, "x")], NOW, tag="v2026.10.18.03", force=True)
|
|
self.assertIsNone(chosen)
|
|
self.assertIn("not newer than the stable v2026.10.18.04", why)
|
|
same = release("v2026.10.18.04", 30, prerelease=False)
|
|
self.assertIsNone(channels.choose([same], [], NOW, tag="v2026.10.18.04", force=True)[0])
|
|
|
|
def test_0_2_follows_the_dated_releases(self):
|
|
bridge = release("v2026.10.21", 30, prerelease=False)
|
|
first = release("v0.2.0", 7)
|
|
chosen, why = channels.choose([bridge, first], [], NOW)
|
|
self.assertEqual(chosen["tag_name"], "v0.2.0", why)
|
|
stable = release("v0.2.0", 30, prerelease=False)
|
|
older = release("v2026.10.22", 8)
|
|
self.assertIsNone(channels.choose([stable, older], [], NOW)[0], "a dated beta never follows 0.2")
|
|
chosen, why = channels.choose([stable, older], [], NOW, tag="v2026.10.22", force=True)
|
|
self.assertIsNone(chosen)
|
|
self.assertIn("not newer than the stable v0.2.0", why)
|
|
patch = release("v0.2.1", 7)
|
|
self.assertEqual(channels.choose([stable, older, patch], [], NOW)[0]["tag_name"], "v0.2.1")
|
|
self.assertEqual(channels.stable([stable, bridge])["tag_name"], "v0.2.0")
|
|
launcher = release("launcher@0.2.0", 7)
|
|
self.assertIsNone(channels.choose([bridge, launcher], [], NOW)[0], "launcher releases are never game betas")
|
|
|
|
def test_a_stall_is_reported_once_the_oldest_waiting_beta_is_a_day_old(self):
|
|
self.assertIsNone(channels.stalled([STABLE, release("v2026.10.19", 23), release("v2026.10.19.01", 2)], NOW))
|
|
releases = [STABLE, release("v2026.10.19", 25), release("v2026.10.19.01", 2)]
|
|
oldest, age = channels.stalled(releases, NOW)
|
|
self.assertEqual(oldest["tag_name"], "v2026.10.19")
|
|
title, body = channels.stall_issue(releases, (oldest, age), "no beta is due (release-blocker #4)")
|
|
self.assertEqual(title, "Promotion to stable has stalled: v2026.10.19 has waited 25 h")
|
|
self.assertIn("v2026.10.18.04", body)
|
|
self.assertIn("release-blocker #4", body)
|
|
# Betas older than the stable release are contained in it: they aren't waiting.
|
|
self.assertIsNone(channels.stalled([STABLE, release("v2026.10.18.03", 40)], NOW))
|
|
self.assertIsNone(channels.stalled([STABLE], NOW))
|
|
|
|
def test_beta_notes_say_so_and_stable_notes_do_not(self):
|
|
pr = {"number": 1, "title": "Fix a thing", "labels": [], "paths": ["crates/x.rs"], "issues": [], "author": "ludovic111"}
|
|
_, beta = train.notes("game", "v2026.10.19", [pr], [], beta=True)
|
|
_, stable = train.notes("game", "v2026.10.19", [pr], [], beta=False)
|
|
self.assertIn("beta build", beta)
|
|
self.assertNotIn("beta build", stable)
|
|
_, launcher = train.notes("launcher", "launcher-v0.9.0", [pr], [], beta=True)
|
|
self.assertNotIn("beta build", launcher)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|