File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/client/ssh/wrapper/__pycache__/slsutil.cpython-310.pyc
Back
o ;j�5 � @ s� d dl Zd dlZd dlZd dlZd dlZd dlZd dlZd dl ZdZ d%dd�Z d&d d �Z d&d d �Z d'dd�Zdd� Zdd� Zdd� Zd(dd�Zd)dd�Zd*d d �Zd*d d �Zd*d!d"�Zd*d#d$�ZdS )+� NZslsutilTFc C s t jj�| |||�S )a3 Merge ``upd`` recursively into ``dest`` If ``merge_lists=True``, will aggregate list object types instead of replacing. This behavior is only activated when ``recursive_update=True``. CLI Example: .. code-block:: shell salt '*' slsutil.update '{foo: Foo}' '{bar: Bar}' )�salt�utils� dictupdate�update)�destZupdZrecursive_update� merge_lists� r �S/opt/saltstack/salt/lib/python3.10/site-packages/salt/client/ssh/wrapper/slsutil.pyr s r �smart�yamlc C s t jj�| ||||�S )a Merge a data structure into another by choosing a merge strategy Strategies: * aggregate * list * overwrite * recurse * smart CLI Example: .. code-block:: shell salt '*' slsutil.merge '{foo: Foo}' '{bar: Bar}' �r r r �merge)Zobj_aZobj_b�strategy�rendererr r r r r s r c C s( i }| D ] }t jj�|||||�}q|S )av .. versionadded:: 2019.2.0 Merge a list of objects into each other in order :type lst: Iterable :param lst: List of objects to be merged. :type strategy: String :param strategy: Merge strategy. See utils.dictupdate. :type renderer: String :param renderer: Renderer type. Used to determine strategy when strategy is 'smart'. :type merge_lists: Bool :param merge_lists: Defines whether to merge embedded object lists. CLI Example: .. code-block:: shell $ salt-call --output=txt slsutil.merge_all '[{foo: Foo}, {foo: Bar}]' local: {u'foo': u'Bar'} r )�lstr r r �ret�objr r r � merge_all4 s r � jinja|yamlc K s� | s |s t j�d��t j�tt�}| r"td j| d|� dd�d�}n|r*d}||d< t j j |||td td fi |��}t j j �|�rG|�� S |S ) aZ Parse a string or file through Salt's renderer system .. versionchanged:: 2018.3.0 Add support for Salt fileserver URIs. This is an open-ended function and can be used for a variety of tasks. It makes use of Salt's "renderer pipes" system to run a string or file through a pipe of any of the loaded renderer modules. :param path: The path to a file on Salt's fileserver (any URIs supported by :py:func:`cp.get_url <salt.modules.cp.get_url>`) or on the local file system. :param string: An inline string to be used as the file to send through the renderer system. Note, not all renderer modules can work with strings; the 'py' renderer requires a file, for example. :param default_renderer: The renderer pipe to send the file through; this is overridden by a "she-bang" at the top of the file. :param kwargs: Keyword args to pass to Salt's compile_template() function. Keep in mind the goal of each renderer when choosing a render-pipe; for example, the Jinja renderer processes a text file and produces a string, however the YAML renderer processes a text file and produces a data structure. One possible use is to allow writing "map files", as are commonly seen in Salt formulas, but without tying the renderer of the map file to the renderer used in the other sls files. In other words, a map file could use the Python renderer and still be included and used by an sls file that uses the default 'jinja|yaml' renderer. For example, the two following map files produce identical results but one is written using the normal 'jinja|yaml' and the other is using 'py': .. code-block:: jinja #!jinja|yaml {% set apache = salt.grains.filter_by({ ...normal jinja map file here... }, merge=salt.pillar.get('apache:lookup')) %} {{ apache | yaml() }} .. code-block:: python #!py def run(): apache = __salt__.grains.filter_by({ ...normal map here but as a python dict... }, merge=__salt__.pillar.get('apache:lookup')) return apache Regardless of which of the above map files is used, it can be accessed from any other sls file by calling this function. The following is a usage example in Jinja: .. code-block:: jinja {% set apache = salt.slsutil.renderer('map.sls') %} CLI Example: .. code-block:: bash salt '*' slsutil.renderer salt://path/to/file salt '*' slsutil.renderer /path/to/file salt '*' slsutil.renderer /path/to/file.jinja default_renderer='jinja' salt '*' slsutil.renderer /path/to/file.sls default_renderer='jinja|yaml' salt '*' slsutil.renderer string='Inline template! {{ saltenv }}' salt '*' slsutil.renderer string='Hello, {{ name }}.' name='world' z Must pass either path or stringZ fileclient� �saltenv�base)r z:string:Z input_dataZrenderer_blacklistZrenderer_whitelist)r � exceptions�SaltInvocationError�loaderZrender�__opts__�__salt__� __context__Zget_url�get�templateZcompile_templater ZstringioZ is_readable�read)�path�stringZdefault_renderer�kwargsZ renderersZpath_or_stringr r r r r V s( G ���r c C s^ t j�t�}t|| d �}t||d �}|s t j�d| � d���|s-t j�d| � d|� d���|S )Nz Serializer 'z ' not found.z' does not implement �.)r r � serializersr �getattrr �CommandExecutionError)� serializerZfn_namer% Zfns�fnr r r �_get_serialize_fn� s ��r* c K �* t jjjdi |��}t| d�|fi |��S )af Serialize a Python object using one of the available :ref:`all-salt.serializers`. CLI Example: .. code-block:: bash salt '*' --no-parse=obj slsutil.serialize 'json' obj="{'foo': 'Foo!'} Jinja Example: .. code-block:: jinja {% set json_string = salt.slsutil.serialize('json', {'foo': 'Foo!'}) %} � serializeNr �r r �argsZ clean_kwargsr* )r( r � mod_kwargsr# r r r r, � s r, c K r+ )a� Deserialize a Python object using one of the available :ref:`all-salt.serializers`. CLI Example: .. code-block:: bash salt '*' slsutil.deserialize 'json' '{"foo": "Foo!"}' salt '*' --no-parse=stream_or_string slsutil.deserialize 'json' \ stream_or_string='{"foo": "Foo!"}' Jinja Example: .. code-block:: jinja {% set python_object = salt.slsutil.deserialize('json', '{"foo": "Foo!"}') %} � deserializeNr r- )r( Zstream_or_stringr/ r# r r r r0 � s r0 �true�falsec C s | r|S |S )a Convert a boolean value into a string. This function is intended to be used from within file templates to provide an easy way to take boolean values stored in Pillars or Grains, and write them out in the appropriate syntax for a particular file template. :param value: The boolean value to be converted :param true: The value to return if ``value`` is ``True`` :param false: The value to return if ``value`` is ``False`` In this example, a pillar named ``smtp:encrypted`` stores a boolean value, but the template that uses that value needs ``yes`` or ``no`` to be written, based on the boolean value. *Note: this is written on two lines for clarity. The same result could be achieved in one line.* .. code-block:: jinja {% set encrypted = salt[pillar.get]('smtp:encrypted', false) %} use_tls: {{ salt['slsutil.boolstr'](encrypted, 'yes', 'no') }} Result (assuming the value is ``True``): .. code-block:: none use_tls: yes r )�valuer1 r2 r r r �boolstr� s r4 c C sp t }| dd� D ]}||vri ||< || }q|s | d |vr6|s#g }|s'i }|g |�|�R � || d < dS dS )a� Convenience function to set a value in the ``__context__`` dictionary. .. versionadded:: 3004 :param keys: The list of keys specifying the dictionary path to set. This list can be of arbitrary length and the path will be created in the dictionary if it does not exist. :param function: A python function to be called if the specified path does not exist, if the force parameter is ``True``. :param fun_args: A list of positional arguments to the function. :param fun_kwargs: A dictionary of keyword arguments to the function. :param force: If ``True``, force the ```__context__`` path to be updated. Otherwise, only create it if it does not exist. N���)r )�keys�functionZfun_argsZ fun_kwargs�force�target�keyr r r � _set_context s �r; r c C �, t t|dgtd |g� | tt | d v S )ap Return ``True`` if a file exists in the state tree, ``False`` otherwise. .. versionadded:: 3004 :param str path: The fully qualified path to a file in the state tree. :param str saltenv: The fileserver environment to search. Default: ``base`` CLI Example: .. code-block:: bash salt '*' slsutil.file_exists nginx/defaults.yaml Z file_listzcp.list_master�r; � CONTEXT_BASEr r �r! r r r r � file_existsC � �r@ c C r< )aq Return ``True`` if a directory exists in the state tree, ``False`` otherwise. :param str path: The fully qualified path to a directory in the state tree. :param str saltenv: The fileserver environment to search. Default: ``base`` .. versionadded:: 3004 CLI Example: .. code-block:: bash salt '*' slsutil.dir_exists nginx/files Zdir_listzcp.list_master_dirsr= r? r r r � dir_existsY rA rB c C s t | |�p t| |�S )a� Return ``True`` if a path exists in the state tree, ``False`` otherwise. The path could refer to a file or directory. .. versionadded:: 3004 :param str path: The fully qualified path to a file or directory in the state tree. :param str saltenv: The fileserver environment to search. Default: ``base`` CLI Example: .. code-block:: bash salt '*' slsutil.path_exists nginx/defaults.yaml )r@ rB r? r r r � path_existso s rC c C s� | rt �| �} | rt| |�stj�d| � ���t|t�r |g}t|t�s*tj�d�� |D ]}tj j j | p6d|dd�}t||�rD| S q-| sMtj� d��t j �| �} q+)al Find the first path matching a filename or list of filenames in a specified directory or the nearest ancestor directory. Returns the full path to the first file found. .. versionadded:: 3004 :param str startpath: The fileserver path from which to begin the search. An empty string refers to the state tree root. :param filenames: A filename or list of filenames to search for. Searching for directory names is also supported. :param str saltenv: The fileserver environment to search. Default: ``base`` Example: return the path to ``defaults.yaml``, walking up the tree from the state file currently being processed. .. code-block:: jinja {{ salt["slsutil.findup"](tplfile, "defaults.yaml") }} CLI Example: .. code-block:: bash salt '*' slsutil.findup formulas/shared/nginx map.jinja z+Starting path not found in the state tree: z6Filenames argument must be a string or list of stringsTr )Z use_posixpathz*File pattern(s) not found in path ancestry)� posixpath�normpathrC r r r � isinstance�str�listr r! �joinr' �os�dirname)Z startpath� filenamesr �filename�fullnamer r r �findup� s4 � � � �� �rO )TF)r r F)NNr )r1 r2 )NNF)r )Zos.pathrJ rD Zsalt.exceptionsr Z salt.loaderZ salt.templateZsalt.utils.argsZsalt.utils.dictupdateZsalt.utils.stringior> r r r r r* r, r0 r4 r; r@ rB rC rO r r r r �<module> s, "_ & (
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings