BLD: refactor validate_unwanted_patterns.py

Extract common code for checking a single file path.

Author: plammens

scripts/validate_unwanted_patterns.py

@@ -416,7 +416,7 @@ def main(
     function : Callable
         Function to execute for the specified validation type.
     source_path : str
-        Source path representing path to a file/directory.
+        Source file_path representing file_path to a file/directory.
     output_format : str
         Output format of the error message.
     file_extensions_to_check : str
@@ -437,16 +437,19 @@ def main(
     if not os.path.exists(source_path):
         raise ValueError("Please enter a valid path, pointing to a file/directory.")
 
-    is_failed: bool = False
-    file_path: str = ""
-
     FILE_EXTENSIONS_TO_CHECK: FrozenSet[str] = frozenset(
         file_extensions_to_check.split(",")
     )
-    PATHS_TO_IGNORE = frozenset(excluded_file_paths.split(","))
+    PATHS_TO_IGNORE = frozenset(
+        os.path.abspath(os.path.normpath(path))
+        for path in excluded_file_paths.split(",")
+    )
+
+    is_failed: bool = False
+
+    def check_file(file_path: str):
+        nonlocal is_failed
 
-    if os.path.isfile(source_path):
-        file_path = source_path
         with open(file_path, "r") as file_obj:
             for line_number, msg in function(file_obj):
                 is_failed = True
@@ -456,24 +459,21 @@ def main(
                     )
                 )
 
-    for subdir, _, files in os.walk(source_path):
-        if any(path in subdir for path in PATHS_TO_IGNORE):
-            continue
-        for file_name in files:
-            if not any(
-                file_name.endswith(extension) for extension in FILE_EXTENSIONS_TO_CHECK
-            ):
+    if os.path.isfile(source_path):
+        check_file(source_path)
+    else:
+        for subdir, _, files in os.walk(source_path):
+            if any(path in subdir for path in PATHS_TO_IGNORE):
                 continue
-
-            file_path = os.path.join(subdir, file_name)
-            with open(file_path, "r") as file_obj:
-                for line_number, msg in function(file_obj):
-                    is_failed = True
-                    print(
-                        output_format.format(
-                            source_path=file_path, line_number=line_number, msg=msg
-                        )
-                    )
+            for file_name in files:
+                if not any(
+                    file_name.endswith(extension)
+                    for extension in FILE_EXTENSIONS_TO_CHECK
+                ):
+                    continue
+
+                file_path = os.path.join(subdir, file_name)
+                check_file(file_path)
 
     return is_failed