Edit file contents by replacing text — tool_edit

Replace a specific text span in an existing file.

Usage

tool_edit_file(path, old_text, new_text, replace_all = FALSE)

Format

A tool definition created with ellmer::tool().

Arguments

path: Path to the file to edit (tool argument)
old_text: Existing text to replace (tool argument)
new_text: Replacement text (tool argument)
replace_all: If TRUE, replace all matches instead of requiring a unique match (tool argument)

Value

When called directly, a character status message describing the edit and replacement count.

Examples

path <- tempfile(fileext = ".txt")
writeLines("alpha", path)
tool_edit_file(path, "alpha", "beta")
#> [1] "Successfully edited /tmp/RtmpJxzN8D/file1b544a19f3cb.txt (1 replacement)"
unlink(path)