File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/states/__pycache__/test.cpython-310.pyc
Back
o ;j?4 � @ s� d Z ddlZddlZddlmZ ddlmZ dd� Zdd� Z d d � Z d d � Z d d� Z d dd�Z d dd�Zd dd�Zd dd�Zdd� Z d d d �ZdS )!a� Test States =========== Provide test case states that enable easy testing of things to do with state calls, e.g. running, calling, logging, output filtering etc. .. code-block:: yaml always-passes-with-any-kwarg: test.nop: - name: foo - something: else - foo: bar always-passes: test.succeed_without_changes: - name: foo always-fails: test.fail_without_changes: - name: foo always-changes-and-succeeds: test.succeed_with_changes: - name: foo always-changes-and-fails: test.fail_with_changes: - name: foo my-custom-combo: test.configurable_test_state: - name: foo - changes: True - result: False - comment: bar.baz - warnings: A warning is-pillar-foo-present-and-bar-is-int: test.check_pillar: - present: - foo - integer: - bar You may also use these states for controlled failure in state definitions, for example if certain conditions in pillar or grains do not apply. The following state definition will fail with a message "OS not supported!" when `grains['os']` is neither Ubuntu nor CentOS: .. code-block:: jinja {% if grains['os'] in ['Ubuntu', 'CentOS'] %} # Your state definitions go here {% else %} failure: test.fail_without_changes: - name: "OS not supported!" - failhard: True {% endif %} � N��SaltInvocationError)�_gen_tagc K s t | �S )a .. versionadded:: 2015.8.1 A no-op state that does nothing. Useful in conjunction with the ``use`` requisite, or in templates which could otherwise be empty due to jinja rendering. name A unique string to serve as the state's ID )�succeed_without_changes)�name�kwargs� r �D/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/test.py�nopI s r c K s |� dd�}| i d|d�}|S )zy .. versionadded:: 2014.7.0 Returns successful name A unique string to serve as the state's ID �comment�Success!T�r �changes�resultr )�get�r r r �retr r r r W s r c K s6 |� dd�}| i d|d�}td rd|d< d|d< |S )zv .. versionadded:: 2014.7.0 Returns failure name A unique string to serve as the state's ID r �Failure!Fr �testr z/If we weren't testing, this would be a failure!�r �__opts__r r r r �fail_without_changesf s r c K �H |� dd�}| i d|d�}dddd�i|d < td r"d |d < d |d< |S )z� .. versionadded:: 2014.7.0 Returns ``True`` with an non-empty ``changes`` dictionary. Useful for testing requisites. name A unique string to serve as the state's ID r r Tr �testing� Unchanged� Something pretended to change��old�newr r Nr z<If we weren't testing, this would be successful with changesr r r r r �succeed_with_changesz � �r c K r )z� .. versionadded:: 2014.7.0 Returns ``False`` with an non-empty ``changes`` dictionary. Useful for testing requisites. name A unique string to serve as the state's ID r r Fr r r r r r r Nr z8If we weren't testing, this would be failed with changesr r r r r �fail_with_changes� r r! T� c C s | i d|d�}dddd�i}|du r||d< n |du r nt |��� d kr.t�d �r-||d< nd }t|��t|t�r>||d < nt |��� d krNt�d �|d < ntd ��|du rWnt|t �rb|g|d< nt|t�rl||d< ntd��td r�|du rzdnd|d < |s�dn||d< |S )a .. versionadded:: 2014.7.0 A configurable test state which allows for more control over the return data name A unique string to serve as the state's ID changes : True Controls whether or not the state reports that there were changes. There are three supported values for this argument: - If ``True``, the state will report changes - If ``False``, the state will report no changes - If ``"Random"``, the state will randomly report either changes or no changes. result : True Controls the result for for the state. Like ``changes``, there are three supported values for this argument: - If ``True``, the state will report a ``True`` result - If ``False``, the state will report a ``False`` result - If ``"Random"``, the state will randomly report either ``True`` .. note:: The result will be reported as ``None`` if *all* of the following are true: 1. The state is being run in test mode (i.e. ``test=True`` on the CLI) 2. ``result`` is ``True`` (either explicitly, or via being set to ``"Random"``) 3. ``changes`` is ``True`` (either explicitly, or via being set to ``"Random"``) comment : "" Comment field field for the state. By default, this is an empty string. warnings A string (or a list of strings) to fill the warnings field with. Default is None .. versionadded:: 3000 Fr r r r r Tr �random)TFzpYou have specified the state option 'changes' with invalid arguments. It must be either True, False, or 'Random'r zoYou have specified the state option 'result' with invalid arguments. It must be either True, False, or 'Random'N�warningszoYou have specified the state option 'warnings' with invalid arguments. It must be a string or a list of stringsr zThis is a testr ) �str�lowerr# �choicer � isinstance�bool�listr )r r r r r$ r Z change_data�errr r r �configurable_test_state� sD 1 � �� � �r, c K s |st d��| i d|d�}|S )z� .. versionadded:: 2015.8.0 Simple notification using text argument. name A unique string to serve as the state's ID text Text to return in the comment field � Missing required argument text.Tr r )r �textr r r r r �show_notification s r/ c K sv g }dt v r$t d d D ]}t|�}t| d r#|�djd i |��� q | |�dd�|�dd�|�dd |i�d �}|S ) aM Call this function via a watch statement .. versionadded:: 2014.7.0 Any parameters in the state return dictionary can be customized by adding the keywords ``result``, ``comment``, and ``changes``. .. code-block:: yaml this_state_will_return_changes: test.succeed_with_changes this_state_will_NOT_return_changes: test.succeed_without_changes this_state_is_watching_another_state: test.succeed_without_changes: - comment: 'This is a custom comment' - watch: - test: this_state_will_return_changes - test: this_state_will_NOT_return_changes this_state_is_also_watching_another_state: test.succeed_without_changes: - watch: - test: this_state_will_NOT_return_changes Z__reqs__Zwatchr z{state}: {__id__}r Tr zWatch statement fired.zRequisites with changes)r r r r Nr )Z__low__r Z __running__�append�formatr )r Zsfunr Z has_changes�req�tagr r r r � mod_watch2 s � �r4 c C s4 t d | d�}|du r dS |durt||�sdS dS )z� Helper function to get pillar[key_str] and check if its type is key_type Returns None if the pillar key is missing. If present True or False depending on match of the values type. Can't check for None. z pillar.getNFT)Z__salt__r( )Zkey_str�key_type�valuer r r �_check_key_type_ s r7 c C s6 t | t�r tjj�| �gS t | t�st�tjj� | �S )z Checks if its argument is a list or a str. A str will be turned into a list with the str as its only element. ) r( r% �salt�utilsZ stringutilsZ to_unicoder* � TypeError�dataZ decode_list)�listingr r r �_if_str_then_lists s r= Fc C s� |s|s|s|s|s|st d��|pg }|pg }|pg }|p g }|p#g }|p'g }| i ddd�}i } i } i } t|�}|| d< t|�}|| t< t|�}|| t< t|�}|| tf< t|�}|| t< t|�}|| t< | �� D ],\} } | D ]%}t|| �}|du r�d| |< d|d< qp|s�| | |< d|d< qp|r�| | |< qpqj| �� D ]#\}} d|� d �}| du r�|d 7 }n|d | � d �7 }|d |7 < q�|r�| r�d}| �� D ]\}} |d|� d| � d�7 }q�|d |7 < |S )a� Checks the presence and, optionally, the type of given keys in Pillar Supported kwargs for types are: - boolean (bool) - integer (int) - string (str) - listing (list) - dictionary (dict) Checking for None type pillars is not implemented yet. .. code-block:: yaml is-pillar-foo-present-and-bar-is-int: test.check_pillar: - present: - foo - integer: - bar r- Tr" r NFr z Pillar key "z" z is missing. zis not z. r z Those keys passed the check: z- z (z) ) r r= r) �intr% r* �dict�itemsr7 )r ZpresentZboolean�integer�stringr< Z dictionary�verboser ZchecksZfineZfailedr5 �keys�keyr r r r r � check_pillar� sb �� rF )TTr" N)N)NNNNNNF)�__doc__r# Zsalt.utils.datar8 Zsalt.exceptionsr Z salt.stater r r r r r! r, r/ r4 r7 r= rF r r r r �<module> s. A m -�
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings