Output Text File

2 VersionsOutput

Writes each upstream String (or every element of a [String]) to disk under output_path. Rotate writes one file per input; append accumulates inputs into a single file joined by line_separator.

How it fits

Typical backends

Transcript archive. Decode audio, transcribe it, and write each transcript to its own text file.

OCR dump. Read images, extract their text, and append every page into one growing log file.

Caveats

Hard constraintmode must be rotate or append and every_n must be at least one; either violation aborts startup.
I/O contractA leading dot on file_extension is stripped, and an empty extension produces files with no suffix.
I/O contractIn append mode the file is opened for appending on every call, so a restart continues the existing file rather than truncating it; the configured line_separator is written verbatim between entries.
State lifetimeIn rotate mode the filename index is a process-local counter that resets on restart, so reusing output_path overwrites earlier files unless max_files turns it into a fixed-size ring.
State lifetimeOnly every_n and max_files can be retuned mid-run; every other key is captured at startup.

Versions

ebd5b9acdefault
Automated release
8/1/2026