Skip to content

is_file

Collection Note

This module is part of the ansible.builtin collection. To install the collection, use:

ansible-galaxy collection install ansible.builtin
Added in version 2.5.

Synopsis

  • Check if the provided path maps to an existing file on the controller's filesystem (localhost)

Parameters

Parameter Defaults / Choices Comments
_input
path
A path.

Examples

vars:
  my_etc_hosts_is_a_file: "{{ '/etc/hosts' is file }}"
  list_of_files: "{{ list_of_paths | select('file') }}"

Return Values

Key Data Type Description Returned
_value boolean Returns V(True) if the path corresponds to an existing file on the filesystem on the controller, V(False) if otherwise.

Authors

  • Ansible Core