Current File : //lib/python2.7/site-packages/salt/states/test.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z d d l
m Z d d l m
Z
d � Z d � Z d � Z d
� Z d � Z e e d d
� Z d d � Z d d � Z d d � Z d � Z d d d d d d e d � Z d S( u�
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
is-pillar-foo-present-and-bar-is-int:
test.check_pillar:
- present:
- foo
- integer:
- bar
i ( t absolute_importt print_functiont unicode_literalsN( t _gen_tag( t six( t SaltInvocationErrorc K@ s
t | � S( u�
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
.. versionadded:: 2015.8.1
( t succeed_without_changes( t namet kwargs( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt nop; s c K@ s& i | d 6i d 6t d 6d d 6} | S( u`
Returns successful.
.. versionadded:: 2014.7.0
name
A unique string.
u nameu changesu resultu Success!u comment( t True( R R t ret( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyR F s
c K@ sG i | d 6i d 6t d 6d d 6} t d rC t | d <d | d <n | S( u^
Returns failure.
.. versionadded:: 2014.7.0
name:
A unique string.
u nameu changesu resultu Failure!u commentu testu/ If we weren't testing, this would be a failure!( t Falset __opts__( R R R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt fail_without_changesX s
c K@ sf i | d 6i d 6t d 6d d 6} i i d d 6d d 6d
6| d <t d rb d
| d <d | d <n | S( uy
Returns successful and changes is not empty
.. versionadded:: 2014.7.0
name:
A unique string.
u nameu changesu resultu Success!u commentu Unchangedu oldu Something pretended to changeu newu testingu testu< If we weren't testing, this would be successful with changesN( R
R
t None( R R R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt succeed_with_changeso s
c K@ sf i | d 6i d 6t d 6d d 6} i i d d 6d d 6d
6| d <t d rb d
| d <d | d <n | S( uw
Returns failure and changes is not empty.
.. versionadded:: 2014.7.0
name:
A unique string.
u nameu changesu resultu Failure!u commentu Unchangedu oldu Something pretended to changeu newu testingu testu8 If we weren't testing, this would be failed with changesN( R R
R ( R R R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt fail_with_changes� s
u c C@ s[ i | d 6i d 6t d 6| d 6} i i d d 6d d 6d 6} | d
k rn t j t t g � r� | | d <q� nD | t k r� | | d <n+ | t k r� i | d <n d } t | � � | d
k r� t j t t g � | d <n> | t k r� t | d <n% | t k r t | d <n t d � � t d
rW| t k r4t n d | d <| sJd n | | d <n | S( uk
A configurable test state which determines its output based on the inputs.
.. versionadded:: 2014.7.0
name:
A unique string.
changes:
Do we return anything in the changes field?
Accepts True, False, and 'Random'
Default is True
result:
Do we return successfully or not?
Accepts True, False, and 'Random'
Default is True
If test is True and changes is True, this will be None. If test is
True and and changes is False, this will be True.
comment:
String to fill the comment field with.
Default is ''
u nameu changesu resultu commentu Unchangedu oldu Something pretended to changeu newu testingu Randomuu You have specified the state option 'Changes' with invalid arguments. It must be either 'True', 'False', or 'Random'us You have specified the state option 'Result' with invalid arguments. It must be either 'True', 'False', or 'Random'u testu This is a testN( R t randomt choiceR
R R
R ( R t changest resultt commentR t change_datat err( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt configurable_test_state� s:
c K@ s; | s t d � � n i | d 6i d 6t d 6| d 6} | S( u�
Simple notification using text argument.
.. versionadded:: 2015.8.0
name
A unique string.
text
Text to return in the comment.
u Missing required argument text.u nameu changesu resultu comment( R R
( R t textR R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt show_notification� s
c K@ s� g } d t k ra xL t d d D]9 } t | � } t | d r! | j d j | � � q! q! Wn i | d 6| j d t � d 6| j d d � d 6| j d i | d 6� d 6} | S(
uM
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
u __reqs__u watchu changesu {state}: {__id__}u nameu resultu commentu Watch statement fired.u Requisites with changes( t __low__R t __running__t appendt formatt getR
( R t sfunR t has_changest reqt tagR ( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt mod_watch s c C@ sK t d | d � } | d k r# d S| d k rC t | | � rC t St Sd S( u�
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.
u
pillar.getN( t __salt__R t
isinstanceR R
( t key_strt key_typet value( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt _check_key_typeC s c C@ sS t | t j � r( t j j j | � g St | t � s@ t � n t j j j
| � S( u
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 t string_typest saltt utilst stringutilst
to_unicodet listt TypeErrort datat decode_list( t listing( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt _if_str_then_listW s
c C@ s� | p! | p! | p! | p! | p! | s3 t d � � n | p< g } | pH g } | pT g } | p` g } | pl g } | px g } i | d 6i d 6t d 6d d 6} i } i }
i } t | � } | | d <t | � } | | t <t | � } | | t <t | � } | | t j <t | � } | | t <t | � } | | t <x� | j
� D] \ } }
xp |
D]h } t | | � } | d k r�d | | <t | d <qV| s�| | | <t | d <qV| rV| |
| <qVqVWqCWxe | j
� D]W \ } } d j
| � } | d k r| d 7} n | d j
| � 7} | d c | 7<q�W| r�|
r�d
} x0 |
j
� D]" \ } } | d j
| | � 7} qMW| d c | 7<n | S(
u�
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
u Missing required argument text.u nameu changesu resultu u commentu Pillar key "{0}" u is missing.
u is not {0}.
u Those keys passed the check:
u - {0} ({1})
N( R R
R6 R t boolt intR R, R1 t dictt itemsR+ R R ( R t presentt booleant integert stringR5 t
dictionaryt verboseR t checkst finet failedR) t keyst keyR R ( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt check_pillard sh
( t __doc__t
__future__R R R R t salt.utils.dataR- t
salt.stateR t salt.extR t salt.exceptionsR R R R R R R
R R R R% R+ R6 R RF ( ( ( s4 /usr/lib/python2.7/site-packages/salt/states/test.pyt <module>. s. ! !I /
Mini Shell