golden hour

/lib/python3.9/site-packages/ansible/plugins/lookup

File/Folder	Size	Actions
__init__.py	4.6 KB
__pycache__	-
config.py	5.75 KB
csvfile.py	6.15 KB
dict.py	2.2 KB
env.py	2.67 KB
file.py	2.93 KB
fileglob.py	2.96 KB
first_found.py	8.52 KB
indexed_items.py	1.55 KB
ini.py	7.6 KB
inventory_hostnames.py	1.73 KB
items.py	1.82 KB
lines.py	2.16 KB
list.py	1.12 KB
nested.py	2.64 KB
password.py	17.67 KB
pipe.py	2.93 KB
random_choice.py	1.54 KB
sequence.py	8.96 KB
subelements.py	6.18 KB
template.py	6.83 KB
together.py	2.11 KB
unvault.py	1.93 KB
url.py	8.8 KB
varnames.py	2.31 KB
vars.py	3.4 KB

Edit: file.py

# (c) 2012, Daniel Hokka Zakrisson <daniel@hozac.com>
# (c) 2017 Ansible Project
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
from __future__ import (absolute_import, division, print_function)
__metaclass__ = type

DOCUMENTATION = """
    name: file
    author: Daniel Hokka Zakrisson (!UNKNOWN) <daniel@hozac.com>
    version_added: "0.9"
    short_description: read file contents
    description:
        - This lookup returns the contents from a file on the Ansible controller's file system.
    options:
      _terms:
        description: path(s) of files to read
        required: True
      rstrip:
        description: whether or not to remove whitespace from the ending of the looked-up file
        type: bool
        required: False
        default: True
      lstrip:
        description: whether or not to remove whitespace from the beginning of the looked-up file
        type: bool
        required: False
        default: False
    notes:
      - if read in variable context, the file can be interpreted as YAML if the content is valid to the parser.
      - this lookup does not understand 'globbing', use the fileglob lookup instead.
"""

EXAMPLES = """
- ansible.builtin.debug:
    msg: "the value of foo.txt is {{lookup('ansible.builtin.file', '/etc/foo.txt') }}"

- name: display multiple file contents
  ansible.builtin.debug: var=item
  with_file:
    - "/path/to/foo.txt"
    - "bar.txt"  # will be looked in files/ dir relative to play or in role
    - "/path/to/biz.txt"
"""

RETURN = """
  _raw:
    description:
      - content of file(s)
    type: list
    elements: str
"""

from ansible.errors import AnsibleError, AnsibleParserError
from ansible.plugins.lookup import LookupBase
from ansible.module_utils._text import to_text
from ansible.utils.display import Display

display = Display()

class LookupModule(LookupBase):

def run(self, terms, variables=None, **kwargs):

ret = []
        self.set_options(var_options=variables, direct=kwargs)

for term in terms:
            display.debug("File lookup term: %s" % term)

# Find the file in the expected search path
            lookupfile = self.find_file_in_search_path(variables, 'files', term)
            display.vvvv(u"File lookup using %s as file" % lookupfile)
            try:
                if lookupfile:
                    b_contents, show_data = self._loader._get_file_contents(lookupfile)
                    contents = to_text(b_contents, errors='surrogate_or_strict')
                    if self.get_option('lstrip'):
                        contents = contents.lstrip()
                    if self.get_option('rstrip'):
                        contents = contents.rstrip()
                    ret.append(contents)
                else:
                    raise AnsibleParserError()
            except AnsibleParserError:
                raise AnsibleError("could not locate file in lookup: %s" % term)

return ret