Io

env_var

Reads an environment variable.

Inputs:

• name (Text) — environment variable name

Output: value (Text) — variable value (empty if unset)

See also: list_dir

exec

Runs a shell command and returns its output.

Inputs:

• command (Text) — command to execute
• working_dir (Text) — working directory (empty for current)
• timeout_seconds (Number) — seconds before kill (0 for no limit)

Outputs:

• stdout (Text) — standard output
• stderr (Text) — standard error
• exit_code (Number) — process exit code

See also: read_file, env_var

file_exists

Checks whether a file or directory exists at the given path.

Inputs:

• path (Text) — file or directory path to check

Outputs:

• exists (Boolean) — true if the path exists
• is_file (Boolean) — true if the path is a file
• is_dir (Boolean) — true if the path is a directory

See also: read_file, list_dir

list_dir

Lists files in a directory.

Inputs:

• path (Text) — directory path to list
• pattern (Text) — glob pattern (currently unused)

Outputs:

• files (Json) — array of file path strings
• count (Number) — number of entries found

See also: read_file, env_var

path_join

Joins path segments into a single path.

Inputs:

• base (Text) — base path
• segment (Text) — path segment to append

Output: path (Text) — joined path

path_parse

Splits a file path into its components.

Inputs:

• path (Text) — file path to parse

Outputs:

• dirname (Text) — parent directory
• basename (Text) — file name with extension
• stem (Text) — file name without extension
• extension (Text) — file extension without dot

See also: path_join, file_exists

read_file

Reads a text file from disk.

Inputs:

• path (Text) — absolute or relative file path

Output: contents (Text) — file contents as text

See also: write_file

write_file

Writes text to a file on disk.

Inputs:

• path (Text) — destination file path
• contents (Text) — text to write

Output: path (Text) — path that was written to

See also: read_file