Initial attempt at phase 1

Author: misrasaurabh1

codeflash/discovery/functions_to_optimize.py

@@ -135,7 +135,10 @@ class FunctionToOptimize:
         parents: A list of parent scopes, which could be classes or functions.
         starting_line: The starting line number of the function in the file.
         ending_line: The ending line number of the function in the file.
+        starting_col: The starting column offset (for precise location in multi-line contexts).
+        ending_col: The ending column offset (for precise location in multi-line contexts).
         is_async: Whether this function is defined as async.
+        language: The programming language of this function (default: "python").
 
     The qualified_name property provides the full name of the function, including
     any parent class or function names. The qualified_name_with_modules_from_root
@@ -148,7 +151,10 @@ class FunctionToOptimize:
     parents: list[FunctionParent]  # list[ClassDef | FunctionDef | AsyncFunctionDef]
     starting_line: Optional[int] = None
     ending_line: Optional[int] = None
+    starting_col: Optional[int] = None  # Column offset for precise location
+    ending_col: Optional[int] = None    # Column offset for precise location
     is_async: bool = False
+    language: str = "python"  # Language identifier for multi-language support
 
     @property
     def top_level_parent_name(self) -> str:

codeflash/languages/__init__.py

@@ -0,0 +1,55 @@
+"""
+Multi-language support for Codeflash.
+
+This package provides the abstraction layer that allows Codeflash to support
+multiple programming languages while keeping the core optimization pipeline
+language-agnostic.
+
+Usage:
+    from codeflash.languages import get_language_support, Language
+
+    # Get language support for a file
+    lang = get_language_support(Path("example.py"))
+
+    # Discover functions
+    functions = lang.discover_functions(file_path)
+
+    # Replace a function
+    new_source = lang.replace_function(file_path, function, new_code)
+"""
+
+from codeflash.languages.base import (
+    CodeContext,
+    FunctionInfo,
+    HelperFunction,
+    Language,
+    LanguageSupport,
+    ParentInfo,
+    TestInfo,
+    TestResult,
+)
+from codeflash.languages.registry import (
+    detect_project_language,
+    get_language_support,
+    get_supported_extensions,
+    get_supported_languages,
+    register_language,
+)
+
+__all__ = [
+    # Base types
+    "Language",
+    "LanguageSupport",
+    "FunctionInfo",
+    "ParentInfo",
+    "CodeContext",
+    "HelperFunction",
+    "TestResult",
+    "TestInfo",
+    # Registry functions
+    "get_language_support",
+    "detect_project_language",
+    "register_language",
+    "get_supported_languages",
+    "get_supported_extensions",
+]