|
| 1 | +#!/bin/env python3 |
| 2 | +import argparse |
| 3 | +import requests |
| 4 | +import sys |
| 5 | +import yaml |
| 6 | +import unittest |
| 7 | + |
| 8 | +VERSION_URL = "https://artifacts-api.elastic.co/v1/versions?x-elastic-no-kpi=true" |
| 9 | + |
| 10 | + |
| 11 | +def fetch_version(): |
| 12 | + return requests.get(VERSION_URL).json() |
| 13 | + |
| 14 | + |
| 15 | +def find_oldest_supported_version(kibana_version_condition: str) -> str: |
| 16 | + # The logic of this function is copied from https://github.com/elastic/apm-pipeline-library/blob/main/vars/findOldestSupportedVersion.groovy |
| 17 | + |
| 18 | + if "||" in kibana_version_condition and kibana_version_condition.index("||") >= 0: |
| 19 | + return handle_or(kibana_version_condition) |
| 20 | + |
| 21 | + available_versions = fetch_version() |
| 22 | + version = remove_operator(kibana_version_condition) |
| 23 | + parts = version.split(".") |
| 24 | + |
| 25 | + # If this is specifying a major or a minor only, check with the zero version. |
| 26 | + while len(parts) < 3: |
| 27 | + version += ".0" |
| 28 | + parts.append("0") |
| 29 | + |
| 30 | + major, minor, patch = parts[0], parts[1], parts[2] |
| 31 | + |
| 32 | + # Use the snapshot if this is the last patch version. |
| 33 | + next_patch = ".".join((major, minor, str(int(patch)+1))) |
| 34 | + next_patch_exists = ( |
| 35 | + next_patch in available_versions.get("versions", []) or |
| 36 | + f"{next_patch}-SNAPSHOT" in available_versions.get("versions", []) |
| 37 | + ) |
| 38 | + |
| 39 | + snapshot_version = f"{version}-SNAPSHOT" |
| 40 | + if not next_patch_exists and (snapshot_version in available_versions.get("versions", [])): |
| 41 | + return snapshot_version |
| 42 | + |
| 43 | + # Use the version as is if it exists. |
| 44 | + if version in available_versions.get("version", []): |
| 45 | + return version |
| 46 | + |
| 47 | + # Old minors may not be available in artifacts-api, if it is older |
| 48 | + # than the others in the same major, return the version as is. |
| 49 | + older = True |
| 50 | + for available_version in available_versions.get("versions", []): |
| 51 | + available_parts = available_version.split(".") |
| 52 | + if len(available_parts) < 2: |
| 53 | + continue |
| 54 | + |
| 55 | + available_major = available_parts[0] |
| 56 | + available_minor = available_parts[1] |
| 57 | + if major == available_major and minor > available_minor: |
| 58 | + older = False |
| 59 | + break |
| 60 | + if older: |
| 61 | + return version |
| 62 | + |
| 63 | + # If no version has been found so far, try with the snapshot of the next version |
| 64 | + # in the current major. |
| 65 | + major_snapshot = f"{major}.x-SNAPSHOT" |
| 66 | + if major_snapshot in available_versions.get("aliases", []): |
| 67 | + return major_snapshot |
| 68 | + |
| 69 | + # Otherwise, return it, whatever this is. |
| 70 | + return version |
| 71 | + |
| 72 | + |
| 73 | +def remove_operator(kibana_version_condition: str) -> str: |
| 74 | + if kibana_version_condition[0].isdigit(): |
| 75 | + return kibana_version_condition |
| 76 | + elif kibana_version_condition.startswith("^") or kibana_version_condition.startswith("~"): |
| 77 | + return kibana_version_condition[1:] |
| 78 | + elif kibana_version_condition.startswith(">="): |
| 79 | + return kibana_version_condition[2:] |
| 80 | + raise Exception("kibana version condition supports only ^, ~ and >= operators") |
| 81 | + |
| 82 | + |
| 83 | +def handle_or(kibana_version_condition: str): |
| 84 | + if "||" not in kibana_version_condition: |
| 85 | + raise Exception(f"no conditions found in '{kibana_version_condition}'") |
| 86 | + |
| 87 | + conditions = kibana_version_condition.split("||") |
| 88 | + result = "" |
| 89 | + for cond in conditions: |
| 90 | + candidate = find_oldest_supported_version(cond) |
| 91 | + if result == "" or candidate < result: |
| 92 | + result = candidate |
| 93 | + |
| 94 | + return result |
| 95 | + |
| 96 | + |
| 97 | +def parse_args() -> argparse.Namespace: |
| 98 | + parser = argparse.ArgumentParser(description="Prepare Elastic stack") |
| 99 | + parser.add_argument("--manifest-path", |
| 100 | + required=False, |
| 101 | + default="package/endpoint/manifest.yml", |
| 102 | + help="path of manifest file") |
| 103 | + parser.add_argument("--test", |
| 104 | + required=False, |
| 105 | + action="store_true", |
| 106 | + default=False, |
| 107 | + help="trigger test") |
| 108 | + |
| 109 | + args, unknown = parser.parse_known_args() |
| 110 | + # Set this for unittest |
| 111 | + sys.argv[1:] = unknown |
| 112 | + return args |
| 113 | + |
| 114 | + |
| 115 | +def run(cfg: argparse.Namespace): |
| 116 | + with open(cfg.manifest_path, "r") as src: |
| 117 | + manifest_doc = yaml.safe_load(src) |
| 118 | + |
| 119 | + kibana_version_condition = manifest_doc["conditions"]["kibana.version"] |
| 120 | + print(find_oldest_supported_version(kibana_version_condition), end="") |
| 121 | + |
| 122 | + |
| 123 | +def main(): |
| 124 | + cfg = parse_args() |
| 125 | + |
| 126 | + if cfg.test: |
| 127 | + unittest.main() |
| 128 | + else: |
| 129 | + run(cfg) |
| 130 | + |
| 131 | + |
| 132 | +# Test: meant to run locally with --test |
| 133 | + |
| 134 | +class TestFindOldestSupportVersion(unittest.TestCase): |
| 135 | + """Testcase for find_oldest_supported_version.""" |
| 136 | + |
| 137 | + mock_data = { |
| 138 | + "versions": [ |
| 139 | + "7.17.10", |
| 140 | + "7.17.11", |
| 141 | + "7.17.12", |
| 142 | + "7.17.13-SNAPSHOT", |
| 143 | + "7.17.13", |
| 144 | + "7.17.14-SNAPSHOT", |
| 145 | + "8.7.0", |
| 146 | + "8.7.1", |
| 147 | + "8.8.0", |
| 148 | + "8.8.1", |
| 149 | + "8.8.2", |
| 150 | + "8.9.0", |
| 151 | + "8.9.1-SNAPSHOT", |
| 152 | + "8.9.1", |
| 153 | + "8.9.2-SNAPSHOT", |
| 154 | + "8.9.2", |
| 155 | + "8.10.0-SNAPSHOT", |
| 156 | + "8.10.0", |
| 157 | + "8.10.1-SNAPSHOT", |
| 158 | + "8.11.0-SNAPSHOT" |
| 159 | + ], |
| 160 | + "aliases": [ |
| 161 | + "7.17-SNAPSHOT", |
| 162 | + "7.17", |
| 163 | + "8.7", |
| 164 | + "8.8", |
| 165 | + "8.9-SNAPSHOT", |
| 166 | + "8.9", |
| 167 | + "8.10-SNAPSHOT", |
| 168 | + "8.10", |
| 169 | + "8.11-SNAPSHOT" |
| 170 | + ], |
| 171 | + "manifests": { |
| 172 | + "last-update-time": "Thu, 14 Sep 2023 16:03:46 UTC", |
| 173 | + "seconds-since-last-update": 107 |
| 174 | + } |
| 175 | + } |
| 176 | + |
| 177 | + def setUp(self): |
| 178 | + super().setUp() |
| 179 | + global fetch_version |
| 180 | + self._fetch_version = fetch_version |
| 181 | + def fetch_version(): return self.mock_data |
| 182 | + |
| 183 | + def tearDown(self): |
| 184 | + global fetch_version |
| 185 | + fetch_version = self._fetch_version |
| 186 | + super().tearDown() |
| 187 | + |
| 188 | + def test_next_patch_does_not_exits_and_available_version_contains_snapshot(self): |
| 189 | + self.assertEqual(find_oldest_supported_version("7.17.14"), "7.17.14-SNAPSHOT") |
| 190 | + self.assertEqual(find_oldest_supported_version("8.9.2"), "8.9.2-SNAPSHOT") |
| 191 | + self.assertEqual(find_oldest_supported_version("8.10.1"), "8.10.1-SNAPSHOT") |
| 192 | + self.assertEqual(find_oldest_supported_version("8.11.0"), "8.11.0-SNAPSHOT") |
| 193 | + |
| 194 | + def test_available_version_contains_kibana_version(self): |
| 195 | + self.assertEqual(find_oldest_supported_version("7.17.10"), "7.17.10") |
| 196 | + self.assertEqual(find_oldest_supported_version("7.17.11"), "7.17.11") |
| 197 | + self.assertEqual(find_oldest_supported_version("7.17.12"), "7.17.12") |
| 198 | + self.assertEqual(find_oldest_supported_version("7.17.13"), "7.17.13") |
| 199 | + self.assertEqual(find_oldest_supported_version("8.7.1"), "8.7.1") |
| 200 | + self.assertEqual(find_oldest_supported_version("8.10.0"), "8.10.0") |
| 201 | + |
| 202 | + def test_too_old_to_be_in_api(self): |
| 203 | + self.assertEqual(find_oldest_supported_version("7.16.0"), "7.16.0") |
| 204 | + self.assertEqual(find_oldest_supported_version("8.6.0"), "8.6.0") |
| 205 | + |
| 206 | + def test_or(self): |
| 207 | + self.assertEqual(find_oldest_supported_version("8.6.0||8.7.0"), "8.6.0") |
| 208 | + self.assertEqual(find_oldest_supported_version("8.9.2||8.9.1||7.17.14"), "7.17.14-SNAPSHOT") |
| 209 | + |
| 210 | + def test_mix(self): |
| 211 | + self.assertEqual(find_oldest_supported_version("^8.6.0||~8.7.0"), "8.6.0") |
| 212 | + self.assertEqual(find_oldest_supported_version("8.9.2||8.9.1||7.17.14"), "7.17.14-SNAPSHOT") |
| 213 | + self.assertEqual(find_oldest_supported_version( |
| 214 | + "~8.9.2||>=8.11.0||7.17.14"), "7.17.14-SNAPSHOT") |
| 215 | + |
| 216 | + |
| 217 | +class TestRemoveOperator(unittest.TestCase): |
| 218 | + """Testcase for remove_operator.""" |
| 219 | + |
| 220 | + def test_no_operator(self): |
| 221 | + self.assertEqual(remove_operator("1.0.0"), "1.0.0") |
| 222 | + |
| 223 | + def test_circumflex(self): |
| 224 | + self.assertEqual(remove_operator("^1.0.0"), "1.0.0") |
| 225 | + |
| 226 | + def test_tilda(self): |
| 227 | + self.assertEqual(remove_operator("~1.0.0"), "1.0.0") |
| 228 | + |
| 229 | + def test_greater_or_equal(self): |
| 230 | + self.assertEqual(remove_operator(">=1.0.0"), "1.0.0") |
| 231 | + |
| 232 | + def test_unknown(self): |
| 233 | + with self.assertRaises(Exception): |
| 234 | + remove_operator("<=1.0.0") |
| 235 | + with self.assertRaises(Exception): |
| 236 | + remove_operator("==1.0.0") |
| 237 | + |
| 238 | + |
| 239 | +class TestHandleOr(unittest.TestCase): |
| 240 | + """Testcase for handle_or.""" |
| 241 | + |
| 242 | + def test_single_condition(self): |
| 243 | + with self.assertRaises(Exception): |
| 244 | + handle_or("0.0.1") |
| 245 | + |
| 246 | + def test_happy_path(self): |
| 247 | + # Mock temporarly with the identiy function. |
| 248 | + global find_oldest_supported_version |
| 249 | + old_func = find_oldest_supported_version |
| 250 | + def find_oldest_supported_version(x): return x |
| 251 | + |
| 252 | + self.assertEqual(handle_or("0.1||0.2"), "0.1") |
| 253 | + self.assertEqual(handle_or("0.2||0.2.1||0.2.3-alpha"), "0.2") |
| 254 | + self.assertEqual(handle_or("1.2||1.2.0||3.2.3-alpha"), "1.2") |
| 255 | + |
| 256 | + # restore mock |
| 257 | + find_oldest_supported_version = old_func |
| 258 | + |
| 259 | + |
| 260 | +if __name__ == "__main__": |
| 261 | + try: |
| 262 | + main() |
| 263 | + except KeyboardInterrupt: |
| 264 | + pass |
0 commit comments