VhL"ddlmZddlZddlZddlZddlZddlmZddlm Z ddl m Z ddlm Z ddl mZddlmZdd lmZdd lmZmZmZd Zdd Zd d Zd dZd dZd dZd dZd dZd dZd!dZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*y)") annotationsN) literal_eval) to_native) is_iterable)jsonify)human_to_bytes) deprecate)boolean) binary_type string_types text_typecdt|s|g}tt|j|S)aCount the number of occurrences of a key in a given dictionary :arg terms: String or iterable of values to check :arg parameters: Dictionary of parameters :returns: An integer that is the number of occurrences of the terms values in the provided dictionary. )rlenset intersection)terms parameterss V/home/dcms/DCMS/lib/python3.12/site-packages/ansible/module_utils/common/validation.py count_termsrs- u  s5z&&z2 33c2tddt|ts|r|dfS|Stjd|r|r|dfS|Stjd|r|r|dfS|S t |}|r|dfS|S#t $r}|r ||fcYd}~S|cYd}~Sd}~wwxYw)Nz*The safe_eval function should not be used.z2.21)versionz \w\.\w+\(z import \w+)r isinstancer researchr Exception)valuelocalsinclude_exceptionsresultes r safe_evalr"*s 4 e\ * 4=   yyu% 4=   yy& 4=   e$ D> !M  1:  s0#A64A66 B?BB B BBcFg}||S|D]%}t||}|dkDs|j|'|ri|Dcgc]}dj|}}ddj|z}|r!dj|dj|}t t ||Scc}w)aCheck mutually exclusive terms against argument parameters Accepts a single list or list of lists that are groups of terms that should be mutually exclusive with one another :arg terms: List of mutually exclusive parameters :arg parameters: Dictionary of parameters :kwarg options_context: List of strings of parent key names if ``terms`` are in a sub spec. :returns: Empty list or raises :class:`TypeError` if the check fails. |z%parameters are mutually exclusive: %s, {0} found in {1} -> rappendjoinformat TypeErrorr)rroptions_contextresultscheckcount full_listmsgs rcheck_mutually_exclusiver4JsG }"E:. 19 NN5 !" 29:SXXe_: :5 )8LL $++C_1MNC #'' N ;sBc g}||S|D]%}t||}|dk(s|j|'|rQ|D]L}ddj|z}|r!dj|dj|}t t ||S)aCheck each list of terms to ensure at least one exists in the given module parameters Accepts a list of lists or tuples :arg terms: List of lists of terms to check. For each list of terms, at least one is required. :arg parameters: Dictionary of parameters :kwarg options_context: List of strings of parent key names if ``terms`` are in a sub spec. :returns: Empty list or raises :class:`TypeError` if the check fails. rz$one of the following is required: %sr&r'r(r))rrr.r/termr1r3s rcheck_required_one_ofr7ksG }!D*- A: NN4 !  ,D8499T?JC(//V[[5QRIcN+ +  , Nrcg}||S|D]U}|Dcgc]}t||}}|Dcgc] }|dkDs | }}t|dkDs@d|vsE|j|W|rQ|D]L}ddj|z} |r!dj | dj|} t t | |Scc}wcc}w)aCheck each list of terms to ensure every parameter in each list exists in the given parameters. Accepts a list of lists or tuples. :arg terms: List of lists of terms to check. Each list should include parameters that are all required when at least one is specified in the parameters. :arg parameters: Dictionary of parameters :kwarg options_context: List of strings of parent key names if ``terms`` are in a sub spec. :returns: Empty list or raises :class:`TypeError` if the check fails. rz$parameters are required together: %sr&r'r()rrr*r+r,r-r) rrr.r/r6fieldcountscnon_zeror3s rcheck_required_togetherr=s G }%>BCU+eZ0CC%/!QA// x=1 F{t$ %  ,D8499T?JC(//V[[5QRIcN+ +  , ND/sB6 B;B;ci}||S|jD]L\}}||vs||g||<t|tr|g}|D] }||vs|| ||j|"N|rt|jD]a\}}t |dkDsd|ddj |}|r!dj |dj |}tt||S)aFor each key in requirements, check the corresponding list to see if they exist in parameters. Accepts a single string or list of values for each key. :arg requirements: Dictionary of requirements :arg parameters: Dictionary of parameters :kwarg options_context: List of strings of parent key names if ``requirements`` are in a sub spec. :returns: Empty dictionary or raises :class:`TypeError` if the rz"missing parameter(s) required by 'z': r&r'r() itemsrr r*rr+r,r-r) requirementsrr.r keyrrequiredmissingr3s rcheck_required_byrDsF $**, - e j JsO$; s e\ *GE -Hz)Z-A-Is ""8, - -"LLN 0LC7|aEH$))T[J\]",33C_9UVC #//  0 MrcDg}||S|jD]0\}}|jdd}|s||vs |j|2|rTddjt |z}|r!dj |dj|}t t||S)aCheck all parameters in argument_spec and return a list of parameters that are required but not present in parameters. Raises :class:`TypeError` if the check fails :arg argument_spec: Argument spec dictionary containing all parameters and their specification :arg parameters: Dictionary of parameters :kwarg options_context: List of strings of parent key names if ``argument_spec`` are in a sub spec. :returns: Empty list or raises :class:`TypeError` if the check fails. rBFmissing required arguments: %sr&r'r()r?getr*r+sortedr,r-r) argument_specrr.rCkvrBr3s rcheck_required_argumentsrLsG%%'A55U+ + NN1  .6'?1KK $++C_1MNC #'' Nrc `g}||S|D]}i}g|d<d}d}t|dk(r|\}} }}n|\}} }|rt|}d|d<nd|d<||vr5||| k(r-|D](} t| |} | dk(s|dj| *t|dst|d|k\s||d<| |d <||d <|j||re|D]`}|dd |d d |dd dj|d} |r!dj | dj|} t t | |S)aTCheck parameters that are conditionally required Raises :class:`TypeError` if the check fails :arg requirements: List of lists specifying a parameter, value, parameters required when the given parameter is the specified value, and optionally a boolean indicating any or all parameters are required. :Example: .. code-block:: python required_if=[ ['state', 'present', ('path',), True], ['someint', 99, ('bool_param', 'string_param')], ] :arg parameters: Dictionary of parameters :returns: Empty list or raises :class:`TypeError` if the check fails. The results attribute of the exception contains a list of dictionaries. Each dictionary is the result of evaluating each item in requirements. Each return dictionary contains the following keys: :key missing: List of parameters that are required but missing :key requires: 'any' or 'all' :key parameter: Parameter name that has the requirement :key value: Original value of the parameter :key requirements: Original required parameters :Example: .. code-block:: python [ { 'parameter': 'someint', 'value': 99 'requirements': ('bool_param', 'string_param'), 'missing': ['string_param'], 'requires': 'all', } ] :kwarg options_context: List of strings of parent key names if ``requirements`` are in a sub spec. rCrFanyrequiresall parameterrr@z is z but z of the following are missing: r&r'r()rrr*r+r,r-r) r@rr.r/reqrCmax_missing_count is_one_ofrAvalr0r1r3s rcheck_required_ifrWs`G$  s8q=03 -ClI%( "Cl  #L 1 "'GJ "'GJ  * CC!7% 5#E:6A:I&--e4 5 wy! "s79+='>BS'S#&GK "GG &2GN # NN7 #7$: ,G $gg&6 8KTYYW^_hWiMjlC(//V[[5QRIcN+ +  , Nrcg}||S|D]%}|j|r|j|'|r(ddj|z}tt ||S)aThis is for checking for required params when we can not check via argspec because we need more information than is simply given in the argspec. Raises :class:`TypeError` if any required parameters are missing :arg parameters: Dictionary of parameters :arg required_parameters: List of parameters to look for in the given parameters. :returns: Empty list or raises :class:`TypeError` if the check fails. rFr&)rGr*r+r-r)rrequired_parametersmissing_paramsparamr3s rcheck_missing_parametersr\VskN"$)~~e$  ! !% ().>1JJ #'' rct|tr|S|r| t|dSdj|}t t|)asVerify that the value is a string or convert to a string. Since unexpected changes can sometimes happen when converting to a string, ``allow_conversion`` controls whether or not the value will be converted or a TypeError will be raised if the value is not a string and would be converted :arg value: Value to validate or convert to a string :arg allow_conversion: Whether to convert the string and return it or raise a TypeError :returns: Original value if it is a string, the value converted to a string if allow_conversion=True, or raises a TypeError if allow_conversion=False. surrogate_or_strict)errorsz5'{0!r}' is not a string and conversion is not allowed)rr rr,r-)rallow_conversionr[prefixr3s rcheck_type_strrbssH%& E-'<== A H H OC IcN ##rct|tr|St|tr|jdSt|tst|t r t |gStdt|z)aVerify that the value is a list or convert to a list A comma separated string will be split into a list. Raises a :class:`TypeError` if unable to convert to a list. :arg value: Value to validate or convert to a list :returns: Original value if it is already a list, single item list if a float, int, or string without commas, or a multi-item list if a comma-delimited string. ,z %s cannot be converted to a list) rlistr splitintfloatstrr-typers rcheck_type_listrls`% %&{{3 E3 :eU#;E | 6eD EErc8t|tr|St|tr|jdr t j |Sd|vrg}g}d}d}|jD]q}|r|j|d}|dk(rd}!|s|dvr|}*|r||k(rd}4|s+|dvr'd j|}|r|j|g}a|j|sd j|}|r|j| td |DStd td t|z#t $rE t|}t|tr|cYS#t $r YtdwxYwtdwxYw#t$r td wxYw)aVerify that value is a dict or convert it to a dict and return it. Raises :class:`TypeError` if unable to convert to a dict :arg value: Dict or string to convert to a dict. Accepts ``k1=v2, k2=v2`` or ``k1=v2 k2=v2``. :returns: value converted to a dictionary {z'unable to evaluate string as dictionary=F\T)'")rd c3@K|]}|jddyw)ror$N)rf).0xs r z"check_type_dict..s<AGGCOsO%)[12{{} ED%. /u~ =U K LLr)NF)N)TNrt)+ __future__rrr{rrastr+ansible.module_utils.common.text.convertersr'ansible.module_utils.common.collectionsrr+ansible.module_utils.common.text.formattersr$ansible.module_utils.common.warningsr )ansible.module_utils.parsing.convert_boolr ansible.module_utils.sixr r r rr"r4r7r=rDrLrWr\rbrlrrrrrrrrrrrrrs # A??F:= 4 @BD!H%PBYx:$0F.;F|F&*"9 P O Mr