File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/args.cpython-310.pyc
Back
o ;j�H � @ s* d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl Z ddl Z ddl Z ddlZ ddlZ ddlmZ e�e�Ze�dej�Zdd� Zd)d d �Zd d � Zd*d d�Zdd� Z dd� Z e dd�Z d+dd�Z dd� Z d+dd�Z!d,d d �Z"d+d d �Z#d d!� Z$ d-d#d$�Z%d%d&� Z&d'd(� Z'dS ).z* Functions used for CLI argument handling � N)� namedtuple)�SaltInvocationErrorz ^([^\d\W][\w.-]*)=(?!=)(.*)$c K s, i }| � � D ] \}}|�d�s|||< q|S )a� Return a dict without any of the __pub* keys (or any other keys starting with a dunder) from the kwargs dict passed into the execution module functions. These keys are useful for tracking what was used to invoke the function call, but they may not be desirable to have if passing the kwargs forward wholesale. Usage example: .. code-block:: python kwargs = __utils__['args.clean_kwargs'](**kwargs) �__)�items� startswith)�kwargs�ret�key�val� r �C/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/args.py� clean_kwargs s �r Tc C sD | rt | t�rdd� | �� D �}|} d�d�| ��}|r t|��|S )zD Raise a SaltInvocationError if invalid_kwargs is non-empty c S s g | ] \}}|� d |� ��qS )�=r )�.0�x�yr r r � <listcomp>6 s z"invalid_kwargs.<locals>.<listcomp>z1The following keyword arguments are not valid: {}�, )� isinstance�dictr �format�joinr )�invalid_kwargsZ raise_excZ new_invalid�msgr r r r 0 s �r c C s� g }| D ] }t |t�r tjj�t|��r |�t|�� q|�|� qt |t�r?|r?ddi}|� � D ]\}}|||< q1||g S |S )zG Return a single arg structure for the publisher to safely use � __kwarg__T) r �int�salt�utilsZjidZis_jid�str�appendr r )�argsr r �argZkw_r r r r r �condition_inputA s r" c C s� |du rd}g }i }| D ]B}t |t�r0t|�\}}|r(||vr#t|�n|||< q |�t|�� q t |t�rI|�dd�du rC|�|� q |�|� q |�|� q |rVt||�S ||fS )z� Parse out the args and kwargs from a list of input values. Optionally, return the args and kwargs without passing them to condition_input(). Don't pull args with key=val apart if it has a newline in it. Nr r FT) r r � parse_kwarg� yamlify_argr r �pop�updater" )r Z conditionZno_parse�_args�_kwargsr! Zarg_nameZ arg_valuer r r � parse_inputS s& � r) c C s& zt �| ��� W S ty Y dS w )z� Parses the string and looks for the following kwarg format: "{argument name}={argument value}" For example: "my_message=Hello world" Returns the kwarg name and value, or (None, None) if the regex was not matched. )NN)� KWARG_REGEX�match�groups�AttributeError)Zstring_r r r r# v s �r# c s� t � t�s� S � �� dv r� S d� v r tdd� � �� D ��r � S t� fdd�dD ��r-� S z�dd l}� }d � v rN|jj�� �}t |t�sH|d u rK� W S |W S � d krUd � n|jj�� �� t � t �rqt |t�rn|� d �sn|W S � W S t � t �r�t |t�r�|� d �s�|W S � W S � d u s�t � t t t tf�r�� dkr�|dv r�|W S � d u r�|�� � d �r�|W S � d u r�|dkr�|W S � W S |W S ty� | Y S w )z yaml.safe_load the arg )� z---z...�_c S s g | ]}|d v �qS )Z 0123456789_r �r r r r r r � � z yamlify_arg.<locals>.<listcomp>c 3 s � | ]}|� v V qd S �Nr )r Znp_char�r! r r � <genexpr>� s � z yamlify_arg.<locals>.<genexpr>)� � � r N�#�None�{�[r. )�|�!r= )r r �strip�all�any�salt.utils.yamlr ZyamlZ safe_loadr r �list�floatr � Exception)r! r Z original_argZ parsed_argr r3 r r$ � sN �r$ ZArgSpecz args varargs keywords defaultsc C s� t | �s t| � d���t| d�r| j} t| d�szt�| �}W n ty. td| � d���w g }g }d }}|j�� D ].}|j|j krW|� |j � |j tj urV|� |j � q<|j|jkra|j }q<|j|jkrj|j }q<|rp|d= t|||t|�pyd�S )a� A small wrapper around inspect.signature that also supports callable objects and wrapped functions If the given function is a wrapper around another function (i.e. has a ``__wrapped__`` attribute), return the functions specification of the underlying function. :param is_class_method: Pass True if you are sure that the function being passed is an unbound method. The reason for this is that on Python 3 unbound methods are classified as functions and not methods, so ``self`` will not be removed from the argspec unless ``is_class_method`` is True. z is not a callable� __wrapped__z"Cannot inspect argument list for '�'Nr )�callable� TypeError�hasattrrE �inspectZ signature� parameters�values�kindZPOSITIONAL_OR_KEYWORDr �name�defaultZ_emptyZVAR_POSITIONALZ VAR_KEYWORD�_ArgSpec�tuple)�func�is_class_method�sigr �defaults�varargs�keywords�paramr r r �get_function_argspec� s6 � � � �rY c K s8 t | t�rtjdkrtjj�| �S tj | fi |��S | S )z0 Only split if the variable is a string �win32) r r �sys�platformr r Z win_functions� shlex_split�shlex�split)�sr r r r r] s r] c sd di i� |du r t | �}|jr$tt|jddd� |jddd� ��� d< � fdd�|jD �� d< � S )z[ Return a dict containing the arguments and default arguments to the function. r N���c s g | ] }|� d vr|�qS )r r )r r! �r r r r ' s z arg_lookup.<locals>.<listcomp>r )rY rU r �zipr )�fun�aspecr rb r � arg_lookup s *rf r. c C sZ i }d|v s d|v rYt �| |�D ]F}zt| | �}W n ty# Y qw |\}}}}i ||< |r2|nd|| d< |r<|nd|| d< |rFdnd|| d< |rPdnd|| d< q|S |d } | D ]K}|�| �r�zt| | �}W n tyw Y q_w |\}}}}i ||< |r�|nd|| d< |r�|nd|| d< |r�dnd|| d< |r�dnd|| d< q_|S ) zs Pass in a functions dict as it is returned from the loader and return the argspec function signatures �*�.Nr rU TrV r )�fnmatch�filterrY rH r ) Z functions�moduler rd re r rV r rU Z module_dotr r r �argspec_report+ s> � � � �rl c C s~ |du rdd� }t | t�rtt|| ��S ztt|dd� | �d�D ���W S ty> tt|dd� t| ��d�D ��� Y S w )zT Take an input value and split it into a list, returning the resulting list Nc S s | S r2 r )r r r r �mapper^ s zsplit_input.<locals>.mapperc S � g | ]}|� � �qS r �r> r0 r r r r d r1 z split_input.<locals>.<listcomp>�,c S rn r ro r0 r r r r f r1 )r rB �mapr_ r- r )r rm r r r � split_inputX s &�rr c K sV ddl }| �� D ] \}}z|�� dkr |jj�|�r W dS W q ty( Y qw dS )z� Examines the kwargs passed and returns True if any kwarg which matching "Test" in any variation on capitalization (i.e. "TEST", "Test", "TeSt", etc) contains a True value (as determined by salt.utils.data.is_true). r N�testTF)Z salt.utilsr �lowerr �dataZis_truer- )r r r! �valuer r r � test_modei s � �rw r c C s |dur|pi }g |d< i |d< t | |d�}t| |�}|d }|d } |�� }g } | D ]} z |�| �| | < W q+ ty? Y q+w |rd|�d�} z |d �|�| �� W n tya | �| � Y nw |sB| r�t|d �t|� } | t| � }td�| j ||dkr�dp�d | ���|d � | � |j r�|� � D ]\} }| |v r�q�||d | < q�|S i }|� � D ]\} }| |v r�q�t� |�|| < q�|�rt|�dkr�d �t|�� �|�d | j� d | j � ���}t|��d �d�dd� |D �dd� �t|�� �d |�d | j� d | j � ���}t|��|S )a� Build the required arguments and keyword arguments required for the passed function. :param fun: The function to get the argspec from :param data: A dictionary containing the required data to build the arguments and keyword arguments. :param initial_ret: The initial return data pre-populated as dictionary or None :param expected_extra_kws: Any expected extra keyword argument names which should not trigger a :ref:`SaltInvocationError` :param is_class_method: Pass True if you are sure that the function being passed is a class method. The reason for this is that on Python 3 ``inspect.ismethod`` only returns ``True`` for bound methods, while on Python 2, it returns ``True`` for bound and unbound methods. So, on Python 3, in case of a class method, you'd need the class to which the function belongs to be instantiated and this is not always wanted. :returns: A dictionary with the function required arguments and keyword arguments. Nr r )rS r z*{} takes at least {} argument{} ({} given)� r` r. z1'{0[0]}' is an invalid keyword argument for '{1}'�fullrh z2{} and '{}' are invalid keyword arguments for '{}'r c S s g | ]}d |� d ��qS )rF r )r �er r r r � s z format_call.<locals>.<listcomp>ra )rY rf �copyr% �KeyErrorr �lenr r �__name__r& rW r �deepcopyrB �keys�get� __module__r )rd ru Z initial_retZexpected_extra_kwsrS r re Zarg_datar r Z missing_argsr r! Zused_args_countZ args_countrv �extrar r r r � format_call{ s~ � �� �� ����� r� c C s\ t j | dd�}d|_g }g }i }g }d}d}|D ] }|dkr n|�|� q|r,|dkr.dS d�|�}g }d} |D ]k}|d v rJ|�|� |�|� q9|d ksR|d kru|su|r^d�|�||< n |rh|�d�|�� |d krpd} n5d}g }q9|d v r�d dd d�} |r�|| |�� kr� n|�|� q9|dkr�|s�d�|�}g }q9|�|� q9| r�|||fS dS )a� Parse a python-like function call syntax. For example: module.function(arg, arg, kw=arg, kw=arg) This function takes care only about the function name and arguments list carying on quoting and bracketing. It doesn't perform identifiers and other syntax validity check. Returns a tuple of three values: function name string, arguments list and keyword arguments dictionary. T)�posixz"'N�()NNNr. Fz[{(rp �)z]})�]�})r; r: r� r )r^ Z escapedquotesr r r% ) r` �sh�wordr r Zbracketsr �token�fnameZgoodZ _bracketsr r r �parse_function� sX r� c C sL i }i }| � � D ]\}}||vr|dur|||< q|dur!|||< q||fS )a Filter out the kwargs used for the init of the class and the kwargs used to invoke the command required. all_kwargs All the kwargs the Execution Function has been invoked. class_init_kwargs The kwargs of the ``__init__`` of the class. N)r )Z all_kwargsZclass_init_kwargsZ fun_kwargsZ init_kwargsZkargZwargr r r �prepare_kwargs( s �r� )T)TNr2 )r. )Nr N)(�__doc__r{ ri rJ �logging�rer^ r[ � collectionsr Zsalt.utils.datar Zsalt.utils.jidZsalt.utils.versionsZsalt.utils.win_functionsrA Zsalt.exceptionsr � getLoggerr~ �log�compile�UNICODEr* r r r" r) r# r$ rP rY r] rf rl rr rw r� r� r� r r r r �<module> sD # [ + - �q <
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings