Surface ray parallel processing up to sdk

Signed-off-by: Rahul Krishna <rkrsn@ibm.com>

Author: rahlk

cldk/analysis/python/codeanalyzer/codeanalyzer.py

@@ -113,6 +113,7 @@ def __init__(
         cache_dir: Union[str, Path, None] = None,
         target_files: List[str] | None = None,
         use_codeql: bool = True,
+        use_ray: bool = False,
     ) -> None:
         """Initialize the Python code analyzer and run analysis.
 
@@ -145,6 +146,10 @@ def __init__(
             use_codeql: If ``True`` (default), uses CodeQL to enhance call
                 graph resolution beyond what Jedi provides. Set to ``False``
                 for faster analysis without CodeQL.
+            use_ray: If ``True``, enables Ray-based parallel processing for
+                analysis. Recommended for very large projects where Jedi/CodeQL
+                analysis would otherwise be slow. Requires Ray to be installed.
+                Defaults to ``False``.
 
         Raises:
             ValueError: If ``project_dir`` is ``None``.
@@ -164,6 +169,7 @@ def __init__(
         self.eager_analysis = eager_analysis
         self.target_files = target_files
         self.use_codeql = use_codeql
+        self.use_ray = use_ray
 
         # codeanalyzer-python owns all caching. CLDK forwards these paths
         # verbatim; when cache_dir is None the backend defaults it to
@@ -212,7 +218,7 @@ def _run_analyzer(self) -> PyApplication:
             output=self.analysis_json_path,
             format=OutputFormat.JSON,
             using_codeql=self.use_codeql,
-            using_ray=False,
+            using_ray=self.use_ray,
             rebuild_analysis=self.eager_analysis,
             skip_tests=True,
             file_name=target_file,

cldk/analysis/python/python_analysis.py

@@ -106,6 +106,7 @@ def __init__(
         target_files: List[str] | None,
         eager_analysis: bool,
         use_codeql: bool = True,
+        use_ray: bool = False,
     ) -> None:
         """Initialize the Python analysis facade.
 
@@ -140,6 +141,10 @@ def __init__(
                 resolution with CodeQL analysis for more complete and accurate
                 call edges. Set to ``False`` for faster analysis using only
                 Jedi, at the cost of potentially missing some call relationships.
+            use_ray: If ``True``, enables Ray-based parallel processing for
+                analysis. Recommended for very large projects where sequential
+                Jedi/CodeQL analysis would be slow. Requires Ray to be installed.
+                Defaults to ``False``.
 
         Raises:
             ValueError: If ``project_dir`` is ``None``. Python analysis requires
@@ -165,6 +170,7 @@ def __init__(
             cache_dir=cache_dir,
             target_files=target_files,
             use_codeql=use_codeql,
+            use_ray=use_ray,
         )
 
     # -----[ treesitter passthrough ]-----

cldk/core.py

@@ -107,6 +107,7 @@ def analysis(
         analysis_json_path: str | Path = None,
         cache_dir: str | Path | None = None,
         use_codeql: bool = True,
+        use_ray: bool = False,
     ) -> JavaAnalysis | PythonAnalysis | CAnalysis:
         """Initialize and return a language-specific analysis facade.
 
@@ -158,6 +159,11 @@ def analysis(
                 Jedi-based call graph resolution with CodeQL analysis for more
                 complete call edges. Set to ``False`` for faster analysis using
                 only Jedi. Ignored for Java and C.
+            use_ray: **Python only.** If ``True``, enables Ray-based parallel
+                processing for analysis. Recommended for very large projects
+                where sequential Jedi/CodeQL analysis would be slow. Requires
+                Ray to be installed. Defaults to ``False``. Ignored for Java
+                and C.
 
         Returns:
             A language-specific analysis facade instance:
@@ -224,6 +230,7 @@ def analysis(
                 target_files=target_files,
                 eager_analysis=eager,
                 use_codeql=use_codeql,
+                use_ray=use_ray,
             )
         elif self.language == "c":
             return CAnalysis(project_dir=project_path)