Current File : //lib/python2.7/site-packages/salt/modules/test.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l
Z
d d l Z d d l
Z d d l Z d d l Z d d l Z d d l 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 g Z i d d 6d
d 6d d
6Z e j e � Z e d � d � � Z d � Z d � Z! d � Z" d � Z# d � Z$ d d � Z% d � Z& d � Z' d � Z( e j) j* j+ e( d � Z, d � Z- d � Z. d d � Z0 d � Z1 d � Z2 d � Z3 d! � Z4 d" � Z5 d# � Z6 d$ � Z7 d% � Z8 d& d' � Z9 d( � Z: d) � Z; d* � Z< d+ � Z= d, d d- � Z> d, d d. � Z? d/ d0 � Z@ d1 � ZA d2 � ZB eC d3 � ZD d4 � ZE d5 � ZF d6 � ZG d7 � ZH d S(8 u$
Module for running arbitrary tests
i ( t absolute_importt print_functiont unicode_literalsN( t six( t builtins( t dependsu *u trueu true_u falseu false_u tryu try_u non_existantmodulenamec C@ s d S( Nu foo( ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt missing_func( s c C@ s
t j j � S( uz
Call grains.items via the attribute
CLI Example:
.. code-block:: bash
salt '*' test.attr_call
( t __salt__t grainst items( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt attr_call- s
c C@ st i g d 6g d 6g d 6g d 6g d 6g d 6g d 6} x� t D]� } d | k rd | d j | � q> | d j | � t t | � r� | d j | � n xt t | D]h } d j | | � } t t t | � | � r� | d j | � n | t | k r� | d j | � q� q� Wq> WxZ | d D]N } | | d k rH| d j | � n | | d k r | d j | � q q W| S(
u�
Return a dict containing all of the execution modules with a report on
the overall availability via different references
CLI Example:
.. code-block:: bash
salt '*' test.module_report
u functionsu function_attrsu
function_subsu modulesu module_attrsu
missing_attrsu missing_subsu .u {0}.{1}( R t appendt hasattrt formatt getattr( t rett reft funct full( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt
module_report: s2
c C@ s | S( u�
Return a string - used for testing the connection
CLI Example:
.. code-block:: bash
salt '*' test.echo 'foo bar baz quo qux'
( ( t text( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt echoa s
c C@ sq t j j j � s/ t j d t j d � � t St d d d } t j d t � rb t d | � St
| � Sd S( u�
Used to make sure the minion is up and responding. Not an ICMP ping.
Returns ``True``.
CLI Example:
.. code-block:: bash
salt '*' test.ping
u" test.ping received for minion '%s'u idu proxyu proxytypeu .pingu add_proxymodule_to_optsu proxymoduleN( t saltt utilst platformt is_proxyt logt debugt __opts__t gett Truet Falset __proxy__( t ping_cmd( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt pingn s
c C@ s t j t | � � t S( u�
Instruct the minion to initiate a process that will sleep for a given
period of time.
CLI Example:
.. code-block:: bash
salt '*' test.sleep 20
( t timet sleept intR ( t length( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyR$ � s i< c C@ s t j t j d | � � t S( u�
Sleep for a random number of seconds, used to test long-running commands
and minions returning at differing intervals
CLI Example:
.. code-block:: bash
salt '*' test.rand_sleep 60
i ( R# R$ t randomt randintR ( t max( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt
rand_sleep� s c C@ s
t j j S( u}
Return the version of salt on the minion
CLI Example:
.. code-block:: bash
salt '*' test.version
( R t versiont __version__( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyR+ � s
c C@ s
t j j � S( u�
Report the versions of dependent and system software
CLI Example:
.. code-block:: bash
salt '*' test.versions_information
( R R+ t versions_information( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyR- � s
c C@ s d j t j j � � S( u�
Returns versions of components used by salt
CLI Example:
.. code-block:: bash
salt '*' test.versions_report
u
( t joinR R+ t versions_report( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyR/ � s
u versionsc C@ s t d d � S( u�
Return the value for test.foo in the minion configuration file, or return
the default value
CLI Example:
.. code-block:: bash
salt '*' test.conf_test
u
config.optionu test.foo( R ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt conf_test� s c C@ s t S( u�
Return the configuration options passed to this minion
CLI Example:
.. code-block:: bash
salt '*' test.get_opts
( R ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt get_opts� s
c C@ s# | d k r g } n t | | � S( u
Execute a minion function via the __salt__ object in the test
module, used to verify that the minion functions can be called
via the __salt__ module.
CLI Example:
.. code-block:: bash
salt '*' test.cross_test file.gid_to_group 0
N( t NoneR ( R t args( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt
cross_test� s c K@ s | S( uN
Print out the data passed into the function ``**kwargs``, this is used to
both test the publication data and cli kwarg passing, but also to display
the information available within the publication data.
CLI Example:
.. code-block:: bash
salt '*' test.kwarg num=1 txt="two" env='{a: 1, b: "hello"}'
( ( t kwargs( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt kwarg� s c O@ s i | d 6| d 6S( u�
Print out the data passed into the function ``*args`` and ```kwargs``, this
is used to both test the publication data and cli argument passing, but
also to display the information available within the publication data.
Returns {"args": args, "kwargs": kwargs}.
CLI Example:
.. code-block:: bash
salt '*' test.arg 1 "two" 3.1 txt="hello" wow='{a: 1, b: "hello"}'
u argsu kwargs( ( R3 R5 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt arg s
c O@ s� i g d 6i d 6} x. | D]& } | d j t j t | � � � q Wx: t j | � D]) \ } } t j t | � � | d | <qU W| S( u�
Print out the types of the args and kwargs. This is used to test the types
of the args and kwargs passed down to the minion
CLI Example:
.. code-block:: bash
salt '*' test.arg_type 1 'int'
u argsu kwargs( R R t text_typet typet iteritems( R3 R5 R t argumentt keyt val( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt arg_type s
$ !c O@ s i t | � d 6t | � d 6S( u�
Print out the data passed into the function ``*args`` and ```kwargs``, this
is used to both test the publication data and cli argument passing, but
also to display the information available within the publication data.
Returns {"args": repr(args), "kwargs": repr(kwargs)}.
CLI Example:
.. code-block:: bash
salt '*' test.arg_repr 1 "two" 3.1 txt="hello" wow='{a: 1, b: "hello"}'
u argsu kwargs( t repr( R3 R5 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt arg_repr0 s
c O@ s" t d | d t j j j | � � S( u�
Like test.arg but cleans kwargs of the __pub* items
CLI Example:
.. code-block:: bash
salt '*' test.arg_clean 1 "two" 3.1 txt="hello" wow='{a: 1, b: "hello"}'
R3 R5 ( t dictR R R3 t clean_kwargs( R3 R5 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt arg_clean@ s c C@ s� t | � } | d k r' t d � � n t j � } | d k rS | t j � | f Sd } d } d } x+ | | k r� | | | } } | d 7} qh W| t j � | f S( u�
Return the num-th Fibonacci number, and the time it took to compute in
seconds. Used for performance tests.
This function is designed to have terrible performance.
CLI Example:
.. code-block:: bash
salt '*' test.fib 3
i u Negative number is not allowed!i i ( R% t
ValueErrorR# ( t numt startt prevt currt i( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt fibL s
c C@ s� t | � } t j � } g } xW | d k rw | j | � | d k r! | d d k rc | d } qt | d d } q! q! W| t j � | f S( u�
Execute the collatz conjecture from the passed starting number,
returns the sequence and the time it took to compute. Used for
performance tests.
CLI Example:
.. code-block:: bash
salt '*' test.collatz 3
i i i i ( R% R# R ( RF t begint steps( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt collatzj s
c C@ s | S( u�
Test the outputter, pass in data to return
CLI Example:
.. code-block:: bash
salt '*' test.outputter foobar
( ( t data( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt outputter� s
i* c C@ s | t d <t S( u�
Test that the returncode system is functioning correctly
CLI Example:
.. code-block:: bash
salt '*' test.retcode 42
u retcode( t __context__R ( t code( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt retcode� s
c C@ s� d } x3 t D]+ } | j d j | � � s1 q
n | } Pq
W| sF d St j t | j j } t j j | � } | | j
d � S( u�
Pass in a function name to discover what provider is being used
CLI Example:
.. code-block:: bash
salt '*' test.provider service
u u {0}.u .( R t
startswithR
t syst modulest
__module__t __file__t ost patht basenamet rindex( t moduleR R< t pfn( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt provider� s
c C@ sM i } x@ t D]8 } | j d � d } | | k r
| | t | � <q
q
W| S( u�
Return a dict of the provider names and the files that provided them
CLI Example:
.. code-block:: bash
salt '*' test.providers
u .i ( R t splitR^ ( R t funcnamet modname( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt providers� s
c C@ s� t � } t � } x� t j j t d d � D]� } t j j | � sI q+ n t j j | � sa q+ n x[ t j
| � D]J } | j d � r� qq n | j d � d } | | k rq | j
| � qq qq Wq+ Wt | � S( u�
List the modules that were not loaded by the salt loader system
CLI Example:
.. code-block:: bash
salt '*' test.not_loaded
u modulesu moduleu _u .i ( Rb t setR t loadert _module_dirsR RX RY t isabst isdirt listdirRS R_ t addt sorted( t provR t mod_dirt fn_t name( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt
not_loaded� s
c C@ s! i } | j t � t | d <| S( u�
Return an opts package with the grains and opts for this minion.
This is primarily used to create the options used for master side
state compiling routines
CLI Example:
.. code-block:: bash
salt '*' test.opts_pkg
u grains( t updateR t
__grains__( R ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt opts_pkg� s
I�� T c C@ s) t j j j d d � t d | d | � S( Nu Neonu2 test.rand_str has been renamed to test.random_hasht sizet hash_type( R R t versionst
warn_untilt random_hash( Rs Rt ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt rand_str� s c C@ s7 | s t j d d � } n t j j j d | d | � S( u�
.. versionadded:: 2015.5.2
.. versionchanged:: 2018.3.0
Function has been renamed from ``test.rand_str`` to
``test.random_hash``
Generates a random number between 1 and ``size``, then returns a hash of
that number. If no ``hash_type`` is passed, the hash_type specified by the
minion's :conf_minion:`hash_type` config option is used.
CLI Example:
.. code-block:: bash
salt '*' test.random_hash
salt '*' test.random_hash hash_type=sha512
u hash_typeu md5Rs Rt ( R R R R t hashutilsRw ( Rs Rt ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyRw � s u Test Exceptionc C@ s t | � � d S( u�
Raise an exception
Optionally provide an error message or output the full stack.
CLI Example:
.. code-block:: bash
salt '*' test.exception 'Oh noes!'
N( t Exception( t message( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt exception s c C@ s d j t j � � S( uq
Return the current stack trace
CLI Example:
.. code-block:: bash
salt '*' test.stack
u ( R. t tracebackt format_stack( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt stack! s
c O@ s d S( u�
Deprecated! Moved to cmdmod.
CLI Example:
.. code-block:: bash
salt '*' test.tty tty0 'This is a test'
salt '*' test.tty pts3 'This is a test'
u. ERROR: This function has been moved to cmd.tty( ( R3 R5 ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt tty. s c K@ s6 y t | | � SWn t k
r1 } | r2 | Sn Xd S( u�
Try to run a module command. On an exception return None.
If `return_try_exception` is set True return the exception.
This can be helpful in templates where running a module might fail as expected.
CLI Example:
.. code-block:: bash
<pre>
{% for i in range(0,230) %}
{{ salt['test.try'](module='ipmi.get_users', bmc_host='172.2.2.'+i)|yaml(False) }}
{% endfor %}
</pre>
N( R Rz R2 ( R\ t return_try_exceptionR5 t e( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt try_< s c C@ s | s t � d S( uv
Assert the given argument
CLI Example:
.. code-block:: bash
salt '*' test.assertion False
N( t AssertionError( t assertion( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyR� T s
c C@ s t S( ud
Always return True
CLI Example:
.. code-block:: bash
salt '*' test.true
( R ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt true_a s
c C@ s t S( uf
Always return False
CLI Example:
.. code-block:: bash
salt '*' test.false
( R ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt false_n s
c @ s� � f d � � y| | j d � r: t t j | d � } n t t | � } � | � rv | | t j j j | � � � n t j d | � t
SWn" t k
r� t j d | � t
SXd S( u
Raise an exception. Built-in exceptions and those in ``salt.exceptions``
can be raised by this test function. If no matching exception is found,
then no exception will be raised and this function will return ``False``.
This function is designed to test Salt's exception and return code
handling.
CLI Example:
.. code-block:: bash
salt '*' test.raise_exception TypeError "An integer is required"
salt '*' test.raise_exception salt.exceptions.CommandExecutionError "Something went wrong"
c @ s6 x/ | j D] } | t k r Pq
� | � Sq
Wt St S( N( t __bases__t
BaseExceptionR R ( t clst base( t _is_exc( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyR� � s u salt.exceptions.i u %s is not an exceptionu No such exception: %sN( RS R R t
exceptionsR R R3 RB R t errorR t AttributeError( Rn R3 R5 t exc( ( R� s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt raise_exception{ s
!
(I t __doc__t
__future__R R R t loggingRX RT R# R} R' t salt.exceptionsR t salt.utils.argst salt.utils.functoolst salt.utils.hashutilst salt.utils.platformt salt.utils.versionst salt.versiont salt.loadert salt.extR t salt.ext.six.movesR t salt.utils.decoratorsR t __proxyenabled__t __func_alias__t getLoggert __name__R R R
R R R" R$ R* R+ R- R/ R t functoolst alias_functionRu R0 R1 R2 R4 R6 R7 R> R@ RC RJ RM RO RR R^ Rb Ro Rr Rx Rw R| R R� R R� R� R� R� R� ( ( ( s5 /usr/lib/python2.7/site-packages/salt/modules/test.pyt <module> sz
'
Mini Shell