`io_append_text`

io_append_text asynchronously appends text to a project-relative file and returns a dependency. Missing parent directories and files are created. Existing content is preserved.

Append operations run asynchronously. Operations targeting the same file must be chained with deps.

Arguments

Argument	Required	Description
`path`	Yes	Project-relative file path to append to.
`text`	Yes	Text appended to the file.
`deps`	No	Dependencies to complete before appending.

Example

load("@io@1", "io_append_text")

log = io_append_text(
    "generated/build.log",
    "build completed\n",
    deps=[build],
)