feat: Read Minion ID from Client's salt conf

Author: santhoshramaraj

examples/general/read_minion_id.py

@@ -0,0 +1,11 @@
+"""Example to demonstrate reading the minion ID from the Salt configuration."""
+
+from nisystemlink.clients.core.helpers import read_minion_id
+
+# Read the minion ID from the Salt configuration file
+minion_id = read_minion_id()
+
+if minion_id:
+    print(f"Minion ID: {minion_id}")
+else:
+    print("Minion ID not found. Please ensure the SystemLink client is connected to the Server.")

nisystemlink/clients/core/helpers/__init__.py

@@ -1,3 +1,4 @@
 from ._iterator_file_like import IteratorFileLike
+from ._minion_id import read_minion_id
 
 # flake8: noqa

nisystemlink/clients/core/helpers/_minion_id.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+
+"""Helper function to get minion ID from Salt configuration."""
+
+from typing import Optional
+
+from nisystemlink.clients.core._internal._path_constants import PathConstants
+
+
+def read_minion_id() -> Optional[str]:
+    """Read the minion ID from the Salt configuration.
+
+    Returns:
+        str | None: The minion ID content if the file exists, None otherwise.
+    """
+    minion_id_path = PathConstants.salt_data_directory / "conf" / "minion_id"
+
+    if not minion_id_path.exists():
+        return None
+
+    try:
+        with open(minion_id_path, "r", encoding="utf-8") as fp:
+            return fp.read().strip()
+    except (OSError, PermissionError):
+        return None