Files

file_copy

Copy a file.

- file_copy:
    src: input/report.xlsx
    dst: archive/report_{{ today }}.xlsx

Move (rename) a file.

- file_move:
    src: temp/output.xlsx
    dst: done/output.xlsx

Delete a file.

- file_delete:
    path: temp/scratch.txt

Rename a file within the same directory.

- file_rename:
    path: report.xlsx
    name: "report_{{ today }}.xlsx"

Check whether a file exists and store the result.

- file_exists:
    path: output/result.xlsx
    save_as: file_found

- if:
    cond: "file_found == true"
  then:
    - type: "File is ready"

Read a text file into a variable.

- file_read:
    path: config.txt
    save_as: config_text
    encoding: utf-8    # optional, default: utf-8

Write a string to a file.

- file_write:
    path: output/log.txt
    content: "Run completed at {{ timestamp }}"
    append: false      # true to append (default: false)

List files in a directory, optionally filtered by glob pattern.

- file_list:
    dir: input/
    pattern: "*.xlsx"
    save_as: xlsx_files   # list of file paths