rework exceptions for pylint

Author: boulderdaze

cime_config/buildlib

@@ -283,14 +283,28 @@ def _build_musica(clone_dest: str) -> str:
         "-D MUSICA_BUILD_FORTRAN_INTERFACE=ON",
         ".."
     ]
-    result = subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, check=False)
-    if result.returncode != 0:
-        raise Exception(f"Unable to configure the MUSICA CMake project. Error: {result.stderr}")
+    try:
+        subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
+                       text=True, check=False)
+    except subprocess.CalledProcessError as e:
+        raise subprocess.CalledProcessError(f"The subprocess for cmake \
+            to configure the MUSICA CMake project failed.") from e
+    except FileNotFoundError as e:
+        raise FileNotFoundError(f"The 'cmake' command was not found.") from e
+    except OSError as e:
+        raise OSError(f"An error occurred while executing the 'cmake' command.") from e
 
     command = ["cmake", "--build", ".", "--target", "install"]
-    result = subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, check=False)
-    if result.returncode != 0:
-        raise Exception(f"Unable to build the MUSICA library. Error: {result.stderr}")
+    try:
+        subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
+                       text=True, check=False)
+    except subprocess.CalledProcessError as e:
+        raise subprocess.CalledProcessError(f"The subprocess for cmake \
+            to build the MUSICA library failed.") from e
+    except FileNotFoundError as e:
+        raise FileNotFoundError(f"The 'cmake' command was not found.") from e
+    except OSError as e:
+        raise OSError(f"An error occurred while executing the 'cmake' command.") from e
 
     os.chdir(current_dir)
     musica_install_path = os.path.join(bld_path, install_dir)
@@ -321,13 +335,13 @@ def _download_musica_configuration(download_dest: str) -> None:
     try:
         os.rename(original_dir, renamed_dir)
     except FileNotFoundError as e:
-        raise FileNotFoundError(f"The directory '{original_dir}' was not found. Error: {e}")
+        raise FileNotFoundError(f"The directory '{original_dir}' was not found.") from e
     except FileExistsError as e:
-        raise FileExistsError(f"The destination directory '{renamed_dir}' already exists. Error: {e}")
+        raise FileExistsError(f"The destination directory '{renamed_dir}' already exists.") from e
     except PermissionError as e:
-        raise PermissionError(f"Permission denied to rename '{original_dir}'. Error: {e}")
+        raise PermissionError(f"Permission denied to rename '{original_dir}'.") from e
     except OSError as e:
-        raise OSError(f"An error occurred while renaming: {e}")
+        raise OSError(f"An error occurred while renaming.") from e
 
     musica_config_path = os.path.join(download_dest, musica_config_dir_name)
     if os.path.exists(musica_config_path):
@@ -366,11 +380,11 @@ def _set_musica_lib_path(musica_install_path: str, caseroot: str) -> None:
                        text=True, check=False)
     except subprocess.CalledProcessError as e:
         raise subprocess.CalledProcessError(f"The subprocess for xmlchange \
-            to set the MUSICA library path failed with an error.: {e}")
+            to set the MUSICA library path failed.") from e
     except FileNotFoundError as e:
-        raise FileNotFoundError(f"The 'xmlchange' command was not found: {e}")
+        raise FileNotFoundError(f"The 'xmlchange' command was not found.") from e
     except OSError as e:
-        raise OSError(f"An error occurred while running 'xmlchange' command: {e}")
+        raise OSError(f"An error occurred while executing the 'xmlchange' command.") from e
 
     os.chdir(current_dir)
 
@@ -395,17 +409,27 @@ def _clone_and_checkout(repo_url: str, tag_name: str, clone_dest: str) -> None:
     if os.path.exists(repo_path):
         shutil.rmtree(repo_path)
 
-    result = subprocess.run(["git", "clone", repo_url, repo_path],
-                            stderr=subprocess.PIPE, text=True, check=False)
-    if result.returncode != 0:
-        raise Exception(f"Unable to clone the repository: {repo_url}. \
-                        Error: {result.stderr}")
-
-    result = subprocess.run(["git", "-C", repo_path, "checkout", tag_name],
-                            stderr=subprocess.PIPE, text=True, check=False)
-    if result.returncode != 0:
-        raise Exception(f"Unable to checkout the branch: {tag_name}. \
-                        Error: {result.stderr}")
+    try:
+        subprocess.run(["git", "clone", repo_url, repo_path],
+           stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, check=False)
+    except subprocess.CalledProcessError as e:
+        raise subprocess.CalledProcessError(f"The subprocess for git \
+            to clone the repository {repo_url} failed.") from e
+    except FileNotFoundError as e:
+        raise FileNotFoundError(f"The 'git' command was not found.") from e
+    except OSError as e:
+        raise OSError(f"An error occurred while executing the 'git' command.") from e
+
+    try:
+        subprocess.run(["git", "-C", repo_path, "checkout", tag_name],
+           stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, check=False)
+    except subprocess.CalledProcessError as e:
+        raise subprocess.CalledProcessError(f"The subprocess for git \
+            to checkout the branch {tag_name} failed.") from e
+    except FileNotFoundError as e:
+        raise FileNotFoundError(f"The 'git' command was not found.") from e
+    except OSError as e:
+        raise OSError(f"An error occurred while executing the 'git' command.") from e
 
 ###############################################################################