Vh>dZddlmZmZmZddlZddlmZddlm Z  ddl Z dZ e ZdZd Zd Zed ZGd d eZy#e $rdZ Y%wxYw)z0 Test plugin file for netaddr tests: resolvable )absolute_importdivisionprint_functionN)_need_ipaddress)_validate_argsTFa- name: resolvable author: Priyam Sahoo (@priyamsahoo) version_added: "2.2.0" short_description: Test if an IP or name can be resolved via /etc/hosts or DNS description: - This plugin checks if the provided IP address of host name can be resolved using /etc/hosts or DNS options: host: description: - A string that represents the IP address or the host name - 'For example: C("docs.ansible.com"), C(127.0.0.1), or C(::1)' type: str required: True notes: a #### Simple examples - name: Check if docs.ansible.com is resolvable or not ansible.builtin.set_fact: data: "{{ 'docs.ansible.com' is ansible.utils.resolvable }}" # TASK [Check if docs.ansible.com is resolvable or not] ********************************** # ok: [localhost] => { # "ansible_facts": { # "data": true # }, # "changed": false # } - name: Set host name variables ansible.builtin.set_fact: good_name: www.google.com bad_name: foo.google.com - name: Assert good_name's resolvability assert: that: "{{ 'www.google.com' is ansible.utils.resolvable }}" - name: Assert bad_name's resolvability assert: that: "{{ 'foo.google.com' is not ansible.utils.resolvable }}" # TASK [Assert good_name's resolvability] ************************************************ # ok: [localhost] => { # "changed": false, # "msg": "All assertions passed" # } # TASK [Assert bad_name's resolvability] ************************************************* # ok: [localhost] => { # "changed": false, # "msg": "All assertions passed" # } - name: Set ip variables ansible.builtin.set_fact: ipv4_localhost: "127.0.0.1" ipv6_localhost: "::1" - name: Assert ipv4_localhost's resolvability assert: that: "{{ ipv4_localhost is ansible.utils.resolvable }}" - name: Assert ipv6_localhost's resolvability assert: that: "{{ ipv6_localhost is ansible.utils.resolvable }}" # TASK [Assert ipv4_localhost's resolvability] ******************************************* # ok: [localhost] => { # "changed": false, # "msg": "All assertions passed" # } # TASK [Assert ipv6_localhost's resolvability] ******************************************* # ok: [localhost] => { # "changed": false, # "msg": "All assertions passed" # } z data: description: - If jinja test satisfies plugin expression C(true) - If jinja test does not satisfy plugin expression C(false) cd|i}tdt| tj|d}|r t j |y t j|dy#t$rd}Y>wxYw#t$rYywxYw#t$rYywxYw)z;Test if an IP or name can be resolved via /etc/hosts or DNShost resolvableTFN)r DOCUMENTATION ipaddress ip_address Exceptionsocket gethostbyaddr getaddrinfo)r paramsips i/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/ansible/utils/plugins/test/resolvable.py _resolvablerxsd^F<7T"      &    tT *        s4AA0A? A-,A-0 A<;A<? B  B ceZdZdZdeiZdZy) TestModuleznetwork jinja testsr c|jS)N)test_map)selfs rtestszTestModule.testss }}N)__name__ __module__ __qualname____doc__rrrrrrrsk*Hrr)r __future__rrrrKansible_collections.ansible.utils.plugins.plugin_utils.base.ipaddress_utilsrAansible_collections.ansible.utils.plugins.plugin_utils.base.utilsrr HAS_IPADDRESS ImportErrortype __metaclass__r EXAMPLESRETURNrobjectrr!rrr,s A@ ]M  "A F 2wMsAA  A