File Operations

Reading and Writing Files

Read Files

(* Read text file *)
Read the <content> from the <file: "./README.md">.

(* Read JSON file - automatically parsed *)
Read the <config: JSON> from the <file: "./config.json">.

(* Read binary file *)
Read the <image: bytes> from the <file: "./logo.png">.

Write Files

(* Write text - creates parent directories automatically *)
Write the <report> to the <file: "./output/report.txt">.

(* Write JSON *)
Write the <data: JSON> to the <file: "./export.json">.

Append to Files

(* Append to log file *)
Append the <log-line> to the <file: "./logs/app.log">.

Directory Operations

List Directory Contents

(* List all entries *)
List the <entries> in the <directory: "./uploads">.

(* Filter with glob pattern *)
List the <aro-files> in the <directory: "./src"> matching "*.aro".

(* List recursively *)
List the <all-files> in the <directory: "./project"> recursively.

Each entry includes:

• name - file or directory name
• path - full path
• size - size in bytes
• isFile / isDirectory - type flags
• modified - last modification date

Check Existence

(* Check if file exists *)
Exists the <found> for the <file: "./config.json">.

when <found> is false {
    Log "Config not found!" to the <console>.
}

(* Check if directory exists *)
Exists the <dir-exists> for the <directory: "./output">.

Create Directories

(* Create directory with all parent directories *)
CreateDirectory the <output-dir> to the <path: "./output/reports/2024">.

Get File Metadata

(* Get detailed file stats *)
Stat the <info> for the <file: "./document.pdf">.

Log <info: size> to the <console>.
Log <info: modified> to the <console>.

Copy and Move

Copy Files

(* Copy a file *)
Copy the <file: "./template.txt"> to the <destination: "./copy.txt">.

(* Copy a directory - recursive by default *)
Copy the <directory: "./src"> to the <destination: "./backup/src">.

Move and Rename

(* Rename a file *)
Move the <file: "./draft.txt"> to the <destination: "./final.txt">.

(* Move to different directory *)
Move the <file: "./inbox/report.pdf"> to the <destination: "./archive/report.pdf">.

Complete Example

Here's a complete example that demonstrates file operations:

(Application-Start: File Operations Demo) {
    Log "=== File Operations ===" to the <console>.

    (* Check and create output directory *)
    Exists the <dir-exists> for the <directory: "./demo-output">.

    when <dir-exists> is false {
        CreateDirectory the <output> to the <path: "./demo-output">.
        Log "Created directory" to the <console>.
    }

    (* Write a file *)
    Write the <content> to the <file: "./demo-output/hello.txt">
        with "Hello from ARO!".

    (* Append to it *)
    Append the <line> to the <file: "./demo-output/hello.txt">
        with "\nAppended line.".

    (* Get stats *)
    Stat the <info> for the <file: "./demo-output/hello.txt">.
    Log "Size: <info: size> bytes" to the <console>.

    (* Copy the file *)
    Copy the <file: "./demo-output/hello.txt">
        to the <destination: "./demo-output/hello-copy.txt">.

    (* List directory *)
    List the <files> in the <directory: "./demo-output">.

    Log "=== Complete ===" to the <console>.
    Return an <OK: status> for the <demo>.
}

Actions Reference