From 30b7a92ed8f569db1425dd4d071e111901155db6 Mon Sep 17 00:00:00 2001
From: iamashwin99 <ashwin-kumar.karnad@mpsd.mpg.de>
Date: Fri, 9 Jun 2023 14:09:38 +0200
Subject: [PATCH] update doc string

---
 mpsd-software-environment.py | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/mpsd-software-environment.py b/mpsd-software-environment.py
index 7669037..a2651bc 100755
--- a/mpsd-software-environment.py
+++ b/mpsd-software-environment.py
@@ -827,12 +827,27 @@ def start_new_environment(release, from_release, target_dir):
     raise NotImplementedError(msg)
 
 
-def environment_status(mpsd_release, script_dir):
-    """Show status of a release."""
-    msg = f"Showing status of release {mpsd_release} in {script_dir}"
+def environment_status(mpsd_release: str, root_dir: Union[str, Path]) -> dict:
+    """Show status of release in installation.
+
+    Parameters
+    ----------
+    mpsd_release : str
+        A string representing the MPSD release version.
+    root_dir : pathlib.Path
+        A Path object representing the path to the directory where
+        the release and toolchains will be installed.
+
+    Returns
+    -------
+    toolchain_map : dict
+    A dictionary containing available microarchitectures as keys and
+    a list of available toolchains as values for each microarchitecture.
+    """
+    msg = f"Showing status of release {mpsd_release} in {root_dir}"
     logging.info(msg)
     plog = logging.getLogger("print")
-    release_base_dir = script_dir / mpsd_release
+    release_base_dir = root_dir / mpsd_release
     microarch = get_native_microarchitecture()
     toolchain_dir = release_base_dir / microarch
     spack_dir = toolchain_dir / "spack"
-- 
GitLab