
    Vh=
                    ^    d dl mZ dZdZdZd dlZd dlmZ d dlm	Z	 d dl
mZ  G d	 d
e      Zy)    )annotationsa  
    name: env
    author: Jan-Piet Mens (@jpmens) <jpmens(at)gmail.com>
    version_added: "0.9"
    short_description: Read the value of environment variables
    description:
      - Allows you to query the environment variables available on the
        controller when you invoked Ansible.
    options:
      _terms:
        description:
          - Environment variable or list of them to lookup the values for.
        required: True
      default:
        description: What return when the variable is undefined
        type: raw
        default: ''
        version_added: '2.13'
    notes:
        - You can pass the C(Undefined) object as O(default) to force an undefined error
a  
- name: Basic usage
  ansible.builtin.debug:
    msg: "'{{ lookup('ansible.builtin.env', 'HOME') }}' is the HOME environment variable."

- name: Before 2.13, how to set default value if the variable is not defined
  ansible.builtin.debug:
    msg: "Hello {{ lookup('ansible.builtin.env', 'UNDEFINED_VARIABLE') | default('World', True) }}"

- name: Example how to set default value if the variable is not defined
  ansible.builtin.debug:
    msg: "Hello {{ lookup('ansible.builtin.env', 'UNDEFINED_VARIABLE', default='World') }}"

- name: Fail if the variable is not defined by setting default value to 'Undefined'
  ansible.builtin.debug:
    msg: "Hello {{ lookup('ansible.builtin.env', 'UNDEFINED_VARIABLE', default=Undefined) }}"

- name: Fail if the variable is not defined by setting default value to 'undef()'
  ansible.builtin.debug:
    msg: "Hello {{ lookup('ansible.builtin.env', 'UNDEFINED_VARIABLE', default=undef()) }}"
zY
  _list:
    description:
      - Values from the environment variables.
    type: list
N)	Undefined)AnsibleUndefinedVariable)
LookupBasec                      e Zd Zd Zy)LookupModulec                $   | j                  ||       g }| j                  d      }|D ]d  }|j                         d   }t        j                  j                  ||      }t        |t              rt        d|z        |j                  |       f |S )N)var_optionsdirectdefaultr   z1The "env" lookup, found an undefined variable: %s)
set_options
get_optionsplitosenvironget
isinstancer   r   append)	selfterms	variableskwargsretdtermvarvals	            J/home/dcms/DCMS/lib/python3.12/site-packages/ansible/plugins/lookup/env.pyrunzLookupModule.runB   s    Yv>OOI& 	D**,q/C**..a(C#y)./beh/hiiJJsO	 
    N)__name__
__module____qualname__r    r    r   r   r   A   s    r    r   )
__future__r   DOCUMENTATIONEXAMPLESRETURNr   jinja2.runtimer   ansible.errorsr   ansible.plugins.lookupr   r   r$   r    r   <module>r,      s9    #,,
 
 $ 3 -: r    