Na}{

File Content: `meta.py`

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

# Copyright: (c) 2016, Ansible, a Red Hat company
# 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: meta
short_description: Execute Ansible 'actions'
version_added: '1.2'
description:
    - Meta tasks are a special kind of task which can influence Ansible internal execution or state.
    - Meta tasks can be used anywhere within your playbook.
    - This module is also supported for Windows targets.
options:
  free_form:
    description:
        - This module takes a free form command, as a string. There is not an actual option named "free form".  See the examples!
        - C(flush_handlers) makes Ansible run any handler tasks which have thus far been notified. Ansible inserts these tasks internally at certain
          points to implicitly trigger handler runs (after pre/post tasks, the final role execution, and the main tasks section of your plays).
        - C(refresh_inventory) (added in Ansible 2.0) forces the reload of the inventory, which in the case of dynamic inventory scripts means they will be
          re-executed. If the dynamic inventory script is using a cache, Ansible cannot know this and has no way of refreshing it (you can disable the cache
          or, if available for your specific inventory datasource (e.g. aws), you can use the an inventory plugin instead of an inventory script).
          This is mainly useful when additional hosts are created and users wish to use them instead of using the M(ansible.builtin.add_host) module.
        - C(noop) (added in Ansible 2.0) This literally does 'nothing'. It is mainly used internally and not recommended for general use.
        - C(clear_facts) (added in Ansible 2.1) causes the gathered facts for the hosts specified in the play's list of hosts to be cleared,
          including the fact cache.
        - C(clear_host_errors) (added in Ansible 2.1) clears the failed state (if any) from hosts specified in the play's list of hosts.
        - C(end_play) (added in Ansible 2.2) causes the play to end without failing the host(s). Note that this affects all hosts.
        - C(reset_connection) (added in Ansible 2.3) interrupts a persistent connection (i.e. ssh + control persist)
        - C(end_host) (added in Ansible 2.8) is a per-host variation of C(end_play). Causes the play to end for the current host without failing it.
        - C(end_batch) (added in Ansible 2.12) causes the current batch (see C(serial)) to end without failing the host(s).
          Note that with C(serial=0) or undefined this behaves the same as C(end_play).
    choices: [ clear_facts, clear_host_errors, end_host, end_play, flush_handlers, noop, refresh_inventory, reset_connection, end_batch ]
    required: true
extends_documentation_fragment:
    - action_common_attributes
    - action_common_attributes.conn
    - action_common_attributes.flow
    - action_core
attributes:
    action:
      support: none
    bypass_host_loop:
      details: Some of the subactions ignore the host loop, see the description above for each specific action for the exceptions
      support: partial
    bypass_task_loop:
      details: Most of the subactions ignore the task loop, see the description above for each specific action for the exceptions
      support: partial
    check_mode:
      details: While these actions don't modify the targets directly they do change possible states of the target within the run
      support: partial
    delegation:
      support: none
    diff_mode:
      support: none
    ignore_conditional:
      details: Only some options support conditionals and when they do they act 'bypassing the host loop', taking the values from first available host
      support: partial
    connection:
      details: Most options in this action do not use a connection, except C(reset_connection) which still does not connect to the remote
      support: partial
notes:
    - C(clear_facts) will remove the persistent facts from M(ansible.builtin.set_fact) using C(cacheable=True),
      but not the current host variable it creates for the current run.
    - Skipping C(meta) tasks with tags is not supported before Ansible 2.11.
seealso:
- module: ansible.builtin.assert
- module: ansible.builtin.fail
author:
    - Ansible Core Team
'''

EXAMPLES = r'''
# Example showing flushing handlers on demand, not at end of play
- ansible.builtin.template:
    src: new.j2
    dest: /etc/config.txt
  notify: myhandler

- name: Force all notified handlers to run at this point, not waiting for normal sync points
  ansible.builtin.meta: flush_handlers

# Example showing how to refresh inventory during play
- name: Reload inventory, useful with dynamic inventories when play makes changes to the existing hosts
  cloud_guest:            # this is fake module
    name: newhost
    state: present

- name: Refresh inventory to ensure new instances exist in inventory
  ansible.builtin.meta: refresh_inventory

# Example showing how to clear all existing facts of targeted hosts
- name: Clear gathered facts from all currently targeted hosts
  ansible.builtin.meta: clear_facts

# Example showing how to continue using a failed target
- name: Bring host back to play after failure
  ansible.builtin.copy:
    src: file
    dest: /etc/file
  remote_user: imightnothavepermission

- ansible.builtin.meta: clear_host_errors

# Example showing how to reset an existing connection
- ansible.builtin.user:
    name: '{{ ansible_user }}'
    groups: input

- name: Reset ssh connection to allow user changes to affect 'current login user'
  ansible.builtin.meta: reset_connection

# Example showing how to end the play for specific targets
- name: End the play for hosts that run CentOS 6
  ansible.builtin.meta: end_host
  when:
  - ansible_distribution == 'CentOS'
  - ansible_distribution_major_version == '6'
'''

Name	Size	Permission
__pycache__	---	0755
__init__.py	0 bytes	0644
_include.py	3138 bytes	0644
add_host.py	3909 bytes	0644
apt.py	58779 bytes	0644
apt_key.py	17865 bytes	0644
apt_repository.py	29068 bytes	0644
assemble.py	8971 bytes	0644
assert.py	2816 bytes	0644
async_status.py	4392 bytes	0644
async_wrapper.py	11701 bytes	0644
blockinfile.py	13611 bytes	0644
command.py	12945 bytes	0644
copy.py	35588 bytes	0644
cron.py	26181 bytes	0644
debconf.py	7732 bytes	0644
debug.py	2958 bytes	0644
dnf.py	59551 bytes	0644
dpkg_selections.py	2408 bytes	0644
expect.py	8527 bytes	0644
fail.py	1710 bytes	0644
fetch.py	4267 bytes	0644
file.py	40890 bytes	0644
find.py	19182 bytes	0644
gather_facts.py	2560 bytes	0644
get_url.py	26845 bytes	0644
getent.py	5695 bytes	0644
git.py	56545 bytes	0644
group.py	20040 bytes	0644
group_by.py	2467 bytes	0644
hostname.py	28795 bytes	0644
import_playbook.py	2107 bytes	0644
import_role.py	3345 bytes	0644
import_tasks.py	2188 bytes	0644
include_role.py	4251 bytes	0644
include_tasks.py	2703 bytes	0644
include_vars.py	6609 bytes	0644
iptables.py	33048 bytes	0644
known_hosts.py	13819 bytes	0644
lineinfile.py	23950 bytes	0644
meta.py	5979 bytes	0644
package.py	3415 bytes	0644
package_facts.py	18133 bytes	0644
pause.py	3527 bytes	0644
ping.py	2372 bytes	0644
pip.py	30718 bytes	0644
raw.py	3651 bytes	0644
reboot.py	4750 bytes	0644
replace.py	11462 bytes	0644
rpm_key.py	8688 bytes	0644
script.py	4128 bytes	0644
service.py	65380 bytes	0644
service_facts.py	17134 bytes	0644
set_fact.py	5755 bytes	0644
set_stats.py	2667 bytes	0644
setup.py	11054 bytes	0644
shell.py	6730 bytes	0644
slurp.py	3269 bytes	0644
stat.py	20087 bytes	0644
subversion.py	13534 bytes	0644
systemd.py	23371 bytes	0644
systemd_service.py	23371 bytes	0644
sysvinit.py	13798 bytes	0644
tempfile.py	3502 bytes	0644
template.py	3171 bytes	0644
unarchive.py	43815 bytes	0644
uri.py	28451 bytes	0644
user.py	116918 bytes	0644
validate_argument_spec.py	3066 bytes	0644
wait_for.py	26530 bytes	0644
wait_for_connection.py	3461 bytes	0644
yum.py	73777 bytes	0644
yum_repository.py	25420 bytes	0644

File Content: meta.py

File Content: `meta.py`