mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-10-26 13:39:47 +00:00
pulse-triage[bot]
56fec40f2d
Use one complete-metadata selector for installer URLs and server archives. Exclude chart and draft releases, reject unusable metadata and transport bodies, and preserve explicit pins, signed assets and downgrade refusal. Exercise the actual selectors with bounded offline controls and retain native installation as separate acceptance. Change-source: pulse-maintainer Contract-Neutral: Restore server-only discovery within existing stable/preview channels; installer authority, signatures, architecture admission, downgrade refusal and state contracts are unchanged.
192 lines
9.3 KiB
Python
192 lines
9.3 KiB
Python
#!/usr/bin/env python3
|
|
"""Execute the server installer's selectors with offline release-list fixtures.
|
|
|
|
These are selector controls only: no download, service or native install proof.
|
|
"""
|
|
|
|
import json
|
|
import os
|
|
from pathlib import Path
|
|
import subprocess
|
|
import tempfile
|
|
import unittest
|
|
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
INSTALLER = Path(os.environ.get("PULSE_INSTALLER_UNDER_TEST", ROOT / "install.sh"))
|
|
|
|
|
|
def release(tag, *, draft=False, prerelease=False):
|
|
return {"tag_name": tag, "draft": draft, "prerelease": prerelease}
|
|
|
|
|
|
HARNESS = r'''
|
|
source "$INSTALLER"
|
|
# No installer main, systemd operation, package install or network call occurs.
|
|
print_info() { :; }
|
|
print_warn() { :; }
|
|
print_error() { printf '%s\n' "$*" >&2; }
|
|
timeout() { shift; "$@"; }
|
|
curl() {
|
|
local url="${@: -1}"
|
|
printf '%s\n' "$url" >> "$FIXTURE/calls"
|
|
case "$url" in
|
|
https://api.github.com/repos/rcourtman/Pulse/releases)
|
|
printf '%s' "$RELEASES_JSON"
|
|
return "$API_EXIT"
|
|
;;
|
|
https://github.com/rcourtman/Pulse/releases/latest)
|
|
[[ -n "$REDIRECT_TAG" ]] || return 22
|
|
printf 'https://github.com/rcourtman/Pulse/releases/tag/%s' "$REDIRECT_TAG"
|
|
;;
|
|
https://api.github.com/repos/rcourtman/Pulse/releases/tags/*) return 0 ;;
|
|
*) printf 'unexpected transport: %s\n' "$url" >&2; return 97 ;;
|
|
esac
|
|
}
|
|
if [[ "$NO_JQ" == true ]]; then
|
|
command() {
|
|
[[ "$*" != '-v jq' ]] || return 1
|
|
builtin command "$@"
|
|
}
|
|
elif [[ "$FAILED_JQ" == true ]]; then
|
|
jq() { printf 'v99.0.0\n'; return 3; }
|
|
fi
|
|
FORCE_VERSION="$PINNED_VERSION"
|
|
FORCE_CHANNEL="$CHANNEL"
|
|
UPDATE_CHANNEL="$CHANNEL"
|
|
LATEST_RELEASE="$CACHED_VERSION"
|
|
CURRENT_VERSION="$INSTALLED_VERSION"
|
|
case "$SELECTOR" in
|
|
parser) latest_pulse_release_tag_from_json "$RELEASES_JSON" "$CHANNEL" ;;
|
|
tag) resolve_latest_release_tag_for_channel "$CHANNEL" ;;
|
|
url) resolve_install_script_download_url ;;
|
|
target) resolve_target_release; printf '%s\n' "$LATEST_RELEASE" ;;
|
|
*) exit 98 ;;
|
|
esac
|
|
'''
|
|
|
|
|
|
class ServerReleaseSelectionTest(unittest.TestCase):
|
|
def exercise(self, data, channel="rc", selector="tag", redirect="", *,
|
|
no_jq=False, failed_jq=False, api_exit=0, pinned="", cached="", installed=""):
|
|
payload = data if isinstance(data, str) else json.dumps(data)
|
|
with tempfile.TemporaryDirectory() as temporary:
|
|
fixture = Path(temporary)
|
|
env = {**os.environ, "FIXTURE": str(fixture), "INSTALLER": str(INSTALLER),
|
|
"PULSE_CONFIG_DIR": str(fixture / "config"), "RELEASES_JSON": payload,
|
|
"CHANNEL": channel, "SELECTOR": selector, "REDIRECT_TAG": redirect,
|
|
"NO_JQ": str(no_jq).lower(), "FAILED_JQ": str(failed_jq).lower(),
|
|
"API_EXIT": str(api_exit), "PINNED_VERSION": pinned,
|
|
"CACHED_VERSION": cached, "INSTALLED_VERSION": installed}
|
|
result = subprocess.run(["bash", "-c", HARNESS], env=env,
|
|
capture_output=True, text=True, timeout=15)
|
|
calls = (fixture / "calls").read_text().splitlines() if (fixture / "calls").exists() else []
|
|
return result, calls
|
|
|
|
def assert_selection(self, data, channel, expected, **kwargs):
|
|
for selector in ("tag", "url", "target"):
|
|
with self.subTest(selector=selector, channel=channel, options=kwargs):
|
|
result, calls = self.exercise(data, channel, selector, **kwargs)
|
|
if expected:
|
|
self.assertEqual(result.returncode, 0, result.stderr)
|
|
want = (f"https://github.com/rcourtman/Pulse/releases/download/{expected}/install.sh"
|
|
if selector == "url" else expected)
|
|
self.assertEqual(result.stdout.strip(), want)
|
|
else:
|
|
self.assertNotEqual(result.returncode, 0, result.stdout)
|
|
self.assertEqual(result.stdout, "")
|
|
# Only release discovery is admitted by the transport double.
|
|
self.assertLessEqual(len(calls), 2, calls)
|
|
self.assertFalse(any("/download/" in url for url in calls), calls)
|
|
|
|
def test_chart_and_draft_entries_never_select_server_or_installer(self):
|
|
data = [release("helm-chart-6.6.0-rc.1", prerelease=True),
|
|
release("v6.7.0-rc.1", draft=True, prerelease=True),
|
|
release("helm-chart-6.5.0"), release("v6.6.0-rc.1", prerelease=True),
|
|
release("v6.5.0")]
|
|
for payload in (data, json.dumps(data, indent=2)):
|
|
self.assert_selection(payload, "rc", "v6.6.0-rc.1")
|
|
self.assert_selection(payload, "stable", "v6.5.0")
|
|
|
|
def test_channel_and_published_order_are_preserved(self):
|
|
for tag in ("v6.6.0-beta.2", "v6.6.0-rc.2", "6.6.0-rc.2", "v6.6.0", "6.6.0"):
|
|
data = [release(tag, prerelease="-" in tag), release("v6.5.0")]
|
|
self.assert_selection(data, "rc", tag)
|
|
self.assert_selection(data, "stable", "v6.5.0" if "-" in tag else tag)
|
|
# Preview permits a newer published stable, not only prereleases.
|
|
self.assert_selection([release("v6.5.0"), release("v6.5.0-rc.1", prerelease=True)], "rc", "v6.5.0")
|
|
# A prerelease-shaped tag is not stable even with a false API flag.
|
|
self.assert_selection([release("v6.6.0-rc.1"), release("v6.5.0")], "stable", "v6.5.0")
|
|
|
|
def test_complete_top_level_metadata_not_tag_shaped_text_is_required(self):
|
|
valid = json.dumps([release("v6.5.0")])
|
|
for data in (valid + " trailing", valid + valid, valid[:-1],
|
|
json.dumps(release("v6.5.0")), "null", "", '"v6.5.0"'):
|
|
for channel in ("stable", "rc"):
|
|
self.assert_selection(data, channel, "", redirect="helm-chart-6.5.0")
|
|
data = [None, False, "v99.0.0", {"nested": release("v99.0.0")},
|
|
release("v99.0.0", draft="false"), release("v99.0.0", prerelease="false"),
|
|
{"tag_name": "v99.0.0", "draft": False}, release(123),
|
|
release("v6.7.0\n"), release("v6.7.0;touch owned"), release("latest"),
|
|
release("v6.7.0-preview.1", prerelease=True), release("v6.5.0")]
|
|
for channel in ("stable", "rc"):
|
|
self.assert_selection(data, channel, "v6.5.0")
|
|
|
|
def test_missing_or_failed_parser_does_not_guess_draft_tag(self):
|
|
data = [release("v99.0.0", draft=True), release("v6.5.0")]
|
|
for options in ({"no_jq": True}, {"failed_jq": True}):
|
|
for channel in ("stable", "rc"):
|
|
self.assert_selection(data, channel, "", **options)
|
|
self.assert_selection(data, channel, "", redirect="helm-chart-6.5.0", **options)
|
|
self.assert_selection(data, channel, "v6.5.0", redirect="v6.5.0", **options)
|
|
|
|
def test_failed_transport_never_admits_even_complete_returned_list(self):
|
|
data = [release("v99.0.0")]
|
|
for channel in ("stable", "rc"):
|
|
self.assert_selection(data, channel, "", api_exit=22)
|
|
self.assert_selection(data, channel, "v6.5.0", redirect="v6.5.0", api_exit=22)
|
|
|
|
def test_redirect_obeys_same_server_and_channel_tag_scope(self):
|
|
for tag in ("helm-chart-6.5.0", "null", "latest", "v6.5"):
|
|
for channel in ("stable", "rc"):
|
|
self.assert_selection("", channel, "", redirect=tag)
|
|
# Preserve the redirect extractor's intermediate-path/query tolerance:
|
|
# only its canonical server tag enters a download URL, not the suffix.
|
|
for tag in ("v6.5.0/other", "v6.5.0?other", "v6.5.0#other"):
|
|
self.assert_selection("", "stable", "v6.5.0", redirect=tag)
|
|
self.assert_selection("", "stable", "", redirect="v6.6.0-rc.1")
|
|
self.assert_selection("", "rc", "v6.6.0-rc.1", redirect="v6.6.0-rc.1")
|
|
self.assert_selection("", "rc", "v6.6.0-beta.1", redirect="v6.6.0-beta.1")
|
|
|
|
def test_unknown_channel_is_rejected_before_transport(self):
|
|
result, calls = self.exercise([release("v6.5.0")], channel="other")
|
|
self.assertNotEqual(result.returncode, 0)
|
|
self.assertEqual(calls, [])
|
|
|
|
def test_explicit_pins_and_cached_target_remain_intentional(self):
|
|
for selector in ("url", "target"):
|
|
result, calls = self.exercise([], selector=selector, pinned="v6.5.0-rc.1")
|
|
self.assertEqual(result.returncode, 0, result.stderr)
|
|
self.assertIn("v6.5.0-rc.1", result.stdout)
|
|
self.assertTrue(all("/releases/tags/" in call for call in calls))
|
|
result, calls = self.exercise([], selector="target", cached="v6.5.0")
|
|
self.assertEqual(result.returncode, 0, result.stderr)
|
|
self.assertEqual(result.stdout.strip(), "v6.5.0")
|
|
self.assertEqual(calls, [])
|
|
|
|
def test_automatic_downgrade_refusal_is_preserved(self):
|
|
result, _ = self.exercise([release("v6.5.0")], selector="target", installed="v6.6.0-rc.1")
|
|
self.assertNotEqual(result.returncode, 0)
|
|
self.assertEqual(result.stdout, "")
|
|
self.assertIn("refusing to downgrade automatically", result.stderr)
|
|
|
|
def test_refused_selection_has_specific_safe_recovery_guidance(self):
|
|
result, _ = self.exercise([], selector="target", redirect="helm-chart-6.5.0")
|
|
self.assertNotEqual(result.returncode, 0)
|
|
self.assertIn("published Pulse server release", result.stderr)
|
|
self.assertIn("rc channel", result.stderr)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|