test
Read-only
Evaluate file predicates such as existence, type, and permissions. Returns structured JSON with boolean result and exit code for conditional logic in scripts.
Instructions
Evaluate file predicates (exists, is_file, is_dir, is_executable, is_symlink, is_readable, is_writable) and return structured JSON with the boolean result. Read-only, no side effects. Returns JSON indicating test result and exit code (0 for true, 1 for false). Use for conditional branching based on file properties in scripts. Not for detailed file inspection — use 'stat' for full metadata. See also 'stat', '['.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | No | Path is a regular file. | |
| path | Yes | Path to test. | |
| empty | No | Path is an empty regular file. | |
| exists | No | Path exists. This is the default predicate. | |
| symlink | No | Path is a symbolic link. | |
| readable | No | Path is readable. | |
| writable | No | Path is writable. | |
| directory | No | Path is a directory. | |
| exit_code | No | Return exit code 1 when predicates do not match. | |
| non_empty | No | Path is a non-empty regular file. | |
| executable | No | Path is executable. |