[minor] Additional OCP metadata

Author: durera

src/mas/devops/data/__init__.py

@@ -90,3 +90,92 @@ def getNewestCatalogTag(arch="amd64") -> str | None:
         return None
     else:
         return catalogs[-1]
+
+
+def getOCPLifecycleData() -> dict | None:
+    """
+    Load OpenShift Container Platform lifecycle data.
+
+    This function reads the OCP lifecycle YAML file containing General Availability dates,
+    Standard Support end dates, and Extended Update Support (EUS) end dates for various
+    OCP versions.
+
+    Returns:
+        dict: The OCP lifecycle data dictionary with version information.
+              Returns None if the ocp.yaml file doesn't exist.
+
+    Example:
+        >>> data = getOCPLifecycleData()
+        >>> if data:
+        ...     versions = data.get('ocp_versions', {})
+        ...     ocp_416 = versions.get('4.16', {})
+        ...     print(ocp_416.get('ga_date'))
+        'June 27, 2024'
+    """
+    moduleFile = path.abspath(__file__)
+    modulePath = path.dirname(moduleFile)
+    ocpFileName = "ocp.yaml"
+
+    pathToOCP = path.join(modulePath, ocpFileName)
+    if not path.exists(pathToOCP):
+        return None
+
+    with open(pathToOCP) as stream:
+        return yaml.safe_load(stream)
+
+
+def getOCPVersion(version: str) -> dict | None:
+    """
+    Get lifecycle information for a specific OCP version.
+
+    This function retrieves the General Availability date, Standard Support end date,
+    and Extended Update Support (EUS) end date for a specific OpenShift version.
+
+    Args:
+        version (str): The OCP version (e.g., "4.16", "4.17").
+
+    Returns:
+        dict: Dictionary containing 'ga_date', 'standard_support', and 'extended_support'.
+              Returns None if the version is not found or OCP data doesn't exist.
+
+    Example:
+        >>> version_info = getOCPVersion("4.16")
+        >>> if version_info:
+        ...     print(f"GA: {version_info['ga_date']}")
+        ...     print(f"Standard Support: {version_info['standard_support']}")
+        ...     print(f"Extended Support: {version_info['extended_support']}")
+        GA: June 27, 2024
+        Standard Support: December 27, 2025
+        Extended Support: June 27, 2027
+    """
+    ocp_data = getOCPLifecycleData()
+    if not ocp_data:
+        return None
+
+    ocp_versions = ocp_data.get("ocp_versions", {})
+    return ocp_versions.get(version)
+
+
+def listOCPVersions() -> list:
+    """
+    List all OCP versions with lifecycle data available.
+
+    This function returns a sorted list of all OpenShift Container Platform versions
+    that have lifecycle information defined.
+
+    Returns:
+        list: Sorted list of OCP version strings (e.g., ["4.12", "4.13", "4.14", ...]).
+              Returns empty list if OCP data doesn't exist.
+
+    Example:
+        >>> versions = listOCPVersions()
+        >>> print(versions)
+        ['4.12', '4.13', '4.14', '4.15', '4.16', '4.17', '4.18', '4.19']
+    """
+    ocp_data = getOCPLifecycleData()
+    if not ocp_data:
+        return []
+
+    ocp_versions = ocp_data.get("ocp_versions", {})
+    # Sort versions numerically (4.12, 4.13, etc.)
+    return sorted(ocp_versions.keys(), key=lambda v: [int(x) for x in v.split(".")])

src/mas/devops/data/ocp.yaml

@@ -0,0 +1,58 @@
+---
+# OpenShift Container Platform Lifecycle Data
+# -----------------------------------------------------------------------------
+# This file contains the lifecycle information for OpenShift Container Platform
+# versions, including General Availability dates, Standard Support end dates,
+# and Extended Update Support (EUS) end dates.
+#
+# Data source: Red Hat OpenShift Container Platform Life Cycle Policy
+# https://access.redhat.com/support/policy/updates/openshift/
+
+ocp_versions:
+  "4.19":
+    ga_date: "June 17, 2025"
+    standard_support: "December 17, 2026"
+    extended_support: "N/A"
+
+  "4.18":
+    ga_date: "February 25, 2025"
+    standard_support: "GA of 4.19 + 3 Months"
+    extended_support: "August 25, 2026"
+
+  "4.17":
+    ga_date: "October 1, 2024"
+    standard_support: "May 25, 2025"
+    extended_support: "April 1, 2026"
+
+  "4.16":
+    ga_date: "June 27, 2024"
+    standard_support: "December 27, 2025"
+    extended_support: "June 27, 2027"
+
+  "4.15":
+    ga_date: "February 27, 2024"
+    standard_support: "August 27, 2025"
+    extended_support: "N/A"
+
+  "4.14":
+    ga_date: "October 31, 2023"
+    standard_support: "May 1, 2025"
+    extended_support: "October 31, 2026"
+
+  "4.13":
+    ga_date: "May 17, 2023"
+    standard_support: "November 17, 2024"
+    extended_support: "N/A"
+
+  "4.12":
+    ga_date: "January 17, 2023"
+    standard_support: "July 17, 2024"
+    extended_support: "January 17, 2025"
+
+# Notes:
+# - Standard Support: 18 months from GA date
+# - Extended Support (EUS): Additional 6 months available for purchase
+# - EUS is included with Premium subscriptions
+# - Not all versions have EUS available
+
+# Made with Bob