[splunk] Refactor script (#249)

Make the script more readable, mostly by:

- using the Product class,
- a little bit of renaming and documentation.

src/splunk.py

@@ -4,14 +4,11 @@ from common import http
 from common import dates
 from common import endoflife
 
-PRODUCT = "splunk"
+VERSION_DATE_PATTERN = re.compile(r"Splunk Enterprise (?P<version>\d+\.\d+(?:\.\d+)*) was (?:first )?released on (?P<date>\w+\s\d\d?,\s\d{4})\.", re.MULTILINE)
-URL = "https://docs.splunk.com/Documentation/Splunk"
-RELNOTES_URL_TEMPLATE = "https://docs.splunk.com/Documentation/Splunk/{version}/ReleaseNotes/MeetSplunk"
-PATTERN = r"Splunk Enterprise (?P<version>\d+\.\d+(?:\.\d+)*) was (?:first )?released on (?P<date>\w+\s\d\d?,\s\d{4})\."
 
 
 def get_latest_minor_versions(versions):
-    versions_split = [version.split('.') for version in versions]
+    versions_split = [v.split('.') for v in versions]
 
     # Group versions by major and minor version
     version_groups = {}
@@ -34,27 +31,22 @@ def get_latest_minor_versions(versions):
     return latest_versions
 
 
-print(f"::group::{PRODUCT}")
+product = endoflife.Product("splunk")
-versions = dict()
+print(f"::group::{product.name}")
-main = http.fetch_url(URL)
+main = http.fetch_url("https://docs.splunk.com/Documentation/Splunk")
 soup = BeautifulSoup(main.text, features="html5lib")
 
-all_versions = list(map(
+all_versions = list(map(lambda option: option.attrs['value'], soup.select("select#version-select > option")))
-    lambda option: option.attrs['value'],
-    soup.select("select#version-select > option")
-))
 
 # Latest minor release notes contains release notes for all previous minor versions.
 # For example, 9.0.5 release notes also contains release notes for 9.0.0 to 9.0.4.
 latest_minor_versions = get_latest_minor_versions(all_versions)
-latest_minor_versions_urls = [RELNOTES_URL_TEMPLATE.format(version=v) for v in latest_minor_versions]
+latest_minor_versions_urls = [f"https://docs.splunk.com/Documentation/Splunk/{v}/ReleaseNotes/MeetSplunk" for v in latest_minor_versions]
-
 for response in http.fetch_urls(latest_minor_versions_urls):
-    for (version, date_str) in re.findall(PATTERN, response.text, re.MULTILINE):
+    for (version, date_str) in VERSION_DATE_PATTERN.findall(response.text):
         version = f"{version}.0" if len(version.split(".")) == 2 else version  # convert x.y to x.y.0
-        date = dates.parse_date(date_str).strftime("%Y-%m-%d")
+        date = dates.parse_date(date_str)
-        versions[version] = date
+        product.declare_version(version, date)
-        print(f"{version}: {date}")
 
-endoflife.write_releases(PRODUCT, versions)
+product.write()
 print("::endgroup::")