
    Vh	                    H    d dl mZ dZdZdZd dlmZ d Zedk(  r e        yy)	    )annotationsa  
---
module: ping
version_added: historical
short_description: Try to connect to host, verify a usable python and return V(pong) on success
description:
  - A trivial test module, this module always returns V(pong) on successful
    contact. It does not make sense in playbooks, but it is useful from
    C(/usr/bin/ansible) to verify the ability to login and that a usable Python is configured.
  - This is NOT ICMP ping, this is just a trivial test module that requires Python on the remote-node.
  - For Windows targets, use the M(ansible.windows.win_ping) module instead.
  - For Network targets, use the M(ansible.netcommon.net_ping) module instead.
options:
  data:
    description:
      - Data to return for the RV(ping) return value.
      - If this parameter is set to V(crash), the module will cause an exception.
    type: str
    default: pong
extends_documentation_fragment:
    - action_common_attributes
attributes:
    check_mode:
        support: full
    diff_mode:
        support: none
    platform:
        platforms: posix
seealso:
  - module: ansible.netcommon.net_ping
  - module: ansible.windows.win_ping
author:
  - Ansible Core Team
  - Michael DeHaan
a  
# Test we can logon to 'webservers' and execute python with json lib.
# ansible webservers -m ansible.builtin.ping

- name: Example from an Ansible Playbook
  ansible.builtin.ping:

- name: Induce an exception to see what happens
  ansible.builtin.ping:
    data: crash
zx
ping:
    description: Value provided with the O(data) parameter.
    returned: success
    type: str
    sample: pong
)AnsibleModulec                     t        t        t        dd            d      } | j                  d   dk(  rt        d	      t        | j                  d   
      } | j                  di | y )Nstrpong)typedefault)dataT)argument_specsupports_check_moder
   crashboom)ping )r   dictparams	Exception	exit_json)moduleresults     D/home/dcms/DCMS/lib/python3.12/site-packages/ansible/modules/ping.pymainr   E   sl    5&1
 !	F }}V']]6"F Fv    __main__N)	
__future__r   DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicr   r   __name__r   r   r   <module>r!      s>    #"H

 5$ zF r   