Function apply_patch

src/sandbox_vm/tools/code/patch.py:488–636

Apply a pseudo-patch file to target files with fuzzy matching. This function parses a structured patch file and applies changes to the specified files. It uses fuzzy matching to find the best location for each change, making it robust to minor variations in the target files. A

(
    patch_path: str, threshold: float = 0.75, dry_run: bool = False, backup: bool = True
)

# --- Main Function ---
async def apply_patch(
    patch_path: str, threshold: float = 0.75, dry_run: bool = False, backup: bool = True
) -> dict:
    """
    Apply a pseudo-patch file to target files with fuzzy matching.

    This function parses a structured patch file and applies changes to the
    specified files. It uses fuzzy matching to find the best location for
    each change, making it robust to minor variations in the target files.

    Args:
        patch_path: Path to the patch file
        threshold: Minimum similarity score for fuzzy matching (0.0 to 1.0)
                Default: 0.75 (75% similarity required)
        dry_run: If True, parse and match but don't write changes
        backup: If True, create .bak backup before modifying files

    Returns:
        dict: Result containing:
            - patches_applied (int): Number of hunks successfully applied
            - files_modified (list): List of modified file paths
            - details (list): Detailed info for each hunk
            - error (str): Error message if failed
    """
    result = {
        "patches_applied": 0,
        "files_modified": [],
        "details": [],
    }

    try:
        # Read and parse patch file
        patch_file = filename_to_path(patch_path)
        if not patch_file.exists():
            result["error"] = f"Patch file not found: {patch_path}"
            return result

        patch_content = patch_file.read_text(encoding="utf-8")

        # Parse hunks
        hunks = _parse_patch_file(patch_content)

        if not hunks:
            result["error"] = "No valid patch hunks found in file"
            return result

        result["details"].append(f"Parsed {len(hunks)} hunk(s) from patch file")

        # Group hunks by file
        files_to_modify: Dict[str, List[PatchHunk]] = {}
        for hunk in hunks:
            if hunk.filepath not in files_to_modify:
                files_to_modify[hunk.filepath] = []
            files_to_modify[hunk.filepath].append(hunk)

        # Process each file
        for filepath, file_hunks in files_to_modify.items():
            try: