ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / lib / python3.9 / site-packages / ansible / modules

# -*- coding: utf-8 -*-

# (c) 2012, Michael DeHaan <michael.dehaan@gmail.com>
# 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 = r'''
---
module: slurp
version_added: historical
short_description: Slurps a file from remote nodes
description:
     - This module works like M(ansible.builtin.fetch). It is used for fetching a base64-
       encoded blob containing the data in a remote file.
     - This module is also supported for Windows targets.
options:
  src:
    description:
      - The file on the remote system to fetch. This I(must) be a file, not a directory.
    type: path
    required: true
    aliases: [ path ]
extends_documentation_fragment:
    - action_common_attributes
attributes:
  check_mode:
    support: full
  diff_mode:
    support: none
  platform:
    platforms: posix, windows
notes:
   - This module returns an 'in memory' base64 encoded version of the file, take
     into account that this will require at least twice the RAM as the original file size.
seealso:
- module: ansible.builtin.fetch
author:
    - Ansible Core Team
    - Michael DeHaan (@mpdehaan)
'''

EXAMPLES = r'''
- name: Find out what the remote machine's mounts are
  ansible.builtin.slurp:
    src: /proc/mounts
  register: mounts

- name: Print returned information
  ansible.builtin.debug:
    msg: "{{ mounts['content'] | b64decode }}"

# From the commandline, find the pid of the remote machine's sshd
# $ ansible host -m ansible.builtin.slurp -a 'src=/var/run/sshd.pid'
# host | SUCCESS => {
#     "changed": false,
#     "content": "MjE3OQo=",
#     "encoding": "base64",
#     "source": "/var/run/sshd.pid"
# }
# $ echo MjE3OQo= | base64 -d
# 2179
'''

RETURN = r'''
content:
    description: Encoded file content
    returned: success
    type: str
    sample: "MjE3OQo="
encoding:
    description: Type of encoding used for file
    returned: success
    type: str
    sample: "base64"
source:
    description: Actual path of file slurped
    returned: success
    type: str
    sample: "/var/run/sshd.pid"
'''

import base64
import errno
import os

from ansible.module_utils.basic import AnsibleModule
from ansible.module_utils.common.text.converters import to_native

def main():
    module = AnsibleModule(
        argument_spec=dict(
            src=dict(type='path', required=True, aliases=['path']),
        ),
        supports_check_mode=True,
    )
    source = module.params['src']

try:
        with open(source, 'rb') as source_fh:
            source_content = source_fh.read()
    except (IOError, OSError) as e:
        if e.errno == errno.ENOENT:
            msg = "file not found: %s" % source
        elif e.errno == errno.EACCES:
            msg = "file is not readable: %s" % source
        elif e.errno == errno.EISDIR:
            msg = "source is a directory and must be a file: %s" % source
        else:
            msg = "unable to slurp file: %s" % to_native(e, errors='surrogate_then_replace')

module.fail_json(msg)

data = base64.b64encode(source_content)

module.exit_json(content=data, source=source, encoding='base64')

if __name__ == '__main__':
    main()

[-] getent.py [edit]
[-] pause.py [edit]
[-] iptables.py [edit]
[+] __pycache__
[-] import_playbook.py [edit]
[-] stat.py [edit]
[-] copy.py [edit]
[-] slurp.py [edit]
[-] service_facts.py [edit]
[-] fetch.py [edit]
[-] tempfile.py [edit]
[-] pip.py [edit]
[-] yum_repository.py [edit]
[-] _include.py [edit]
[-] assemble.py [edit]
[-] user.py [edit]
[-] sysvinit.py [edit]
[-] lineinfile.py [edit]
[-] find.py [edit]
[-] replace.py [edit]
[-] blockinfile.py [edit]
[-] meta.py [edit]
[-] hostname.py [edit]
[-] reboot.py [edit]
[-] shell.py [edit]
[-] uri.py [edit]
[-] script.py [edit]
[-] async_status.py [edit]
[-] include_vars.py [edit]
[-] apt_repository.py [edit]
[-] ping.py [edit]
[-] expect.py [edit]
[-] import_tasks.py [edit]
[-] known_hosts.py [edit]
[-] include_role.py [edit]
[-] apt_key.py [edit]
[-] apt.py [edit]
[-] command.py [edit]
[-] assert.py [edit]
[-] subversion.py [edit]
[-] cron.py [edit]
[-] validate_argument_spec.py [edit]
[-] wait_for.py [edit]
[-] wait_for_connection.py [edit]
[-] package.py [edit]
[-] systemd.py [edit]
[-] get_url.py [edit]
[-] import_role.py [edit]
[-] set_fact.py [edit]
[-] group_by.py [edit]
[-] yum.py [edit]
[-] set_stats.py [edit]
[-] dpkg_selections.py [edit]
[-] add_host.py [edit]
[-] fail.py [edit]
[-] debug.py [edit]
[-] debconf.py [edit]
[-] setup.py [edit]
[-] rpm_key.py [edit]
[-] service.py [edit]
[-] gather_facts.py [edit]
[-] git.py [edit]
[-] unarchive.py [edit]
[-] include_tasks.py [edit]
[+] ..
[-] async_wrapper.py [edit]
[-] systemd_service.py [edit]
[-] template.py [edit]
[-] package_facts.py [edit]
[-] raw.py [edit]
[-] group.py [edit]
[-] dnf.py [edit]
[-] __init__.py [edit]
[-] file.py [edit]