Current File : //lib/python2.7/site-packages/salt/modules/mod_random.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 Z d d l Z d d l
m Z d d l m
Z
e
j r� d Z n d Z d Z d d
� Z d d � Z d d
� Z d d � Z d d d d � Z d d d d � Z d d d � Z d S( ur
Provides access to randomness generators.
=========================================
.. versionadded:: 2014.7.0
i ( t absolute_importt print_functiont unicode_literalsN( t SaltInvocationError( t sixu
algorithmsu algorithms_guaranteedu randomu sha512c C@ s: t j r6 t t d � r6 t t | � r6 t d f Sn t S( u>
Sanity check for compatibility with Python 2.6 / 2.7
u
algorithmsuN The random execution module cannot be loaded: only available in Python >= 2.7.( R t PY2t hasattrt hashlibt Falset __virtualname__( t algorithm( ( s; /usr/lib/python2.7/site-packages/salt/modules/mod_random.pyt __virtual__ s
c C@ s� t j r- t | t j � r- | j t � } n t t t � r| | t t t � k r| t j
| � } | j | � | j � } nF t t | � r� t j
| � } | j | � | j � } n t
d � � | S( uM
.. versionadded:: 2014.7.0
Encodes a value with the specified encoder.
value
The value to be hashed.
algorithm : sha512
The algorithm to use. May be any valid algorithm supported by
hashlib.
CLI Example:
.. code-block:: bash
salt '*' random.hash 'I am a string' md5
u# You must specify a valid algorithm.( R t PY3t
isinstancet string_typest encodet __salt_system_encoding__R R t ALGORITHMS_ATTR_NAMEt getattrt newt updatet hexdigestR ( t valueR
t hashert out( ( s; /usr/lib/python2.7/site-packages/salt/modules/mod_random.pyt hash. s $
u base64c C@ s# t j r[ y | j | � } Wq t k
r; t d � � q t k
rW t d � � q Xn� t | t j � r | j t � } n | d k r� y" t j
| � } | j t � } Wq t k
r� t d � � q XnO y | j | � } Wn9 t k
rt d � � n t k
r t d � � n X| S( u
.. versionadded:: 2014.7.0
value
The value to be encoded.
encoder : base64
The encoder to use on the subsequent string.
CLI Example:
.. code-block:: bash
salt '*' random.str_encode 'I am a new string' base64
u You must specify a valid encoderu# Value must be an encode-able stringu base64(
R R R t LookupErrorR t AttributeErrorR
R R t base64t b64encodet decodet TypeError( R t encoderR ( ( s; /usr/lib/python2.7/site-packages/salt/modules/mod_random.pyt
str_encodeS s,
i c C@ s t j j j | � S( u�
.. versionadded:: 2014.7.0
Returns a random string of the specified length.
length : 20
Any valid number of bytes.
CLI Example:
.. code-block:: bash
salt '*' random.get_str 128
( t saltt utilst pycryptot secure_password( t length( ( s; /usr/lib/python2.7/site-packages/salt/modules/mod_random.pyt get_str} s c C@ s t j j j | | | � S( u�
Generates a salted hash suitable for /etc/shadow.
crypt_salt : None
Salt to be used in the generation of the hash. If one is not
provided, a random salt will be generated.
password : None
Value to be salted and hashed. If one is not provided, a random
password will be generated.
algorithm : sha512
Hash algorithm to use.
CLI Example:
.. code-block:: bash
salt '*' random.shadow_hash 'My5alT' 'MyP@asswd' md5
( R" R# R$ t gen_hash( t
crypt_saltt passwordR
( ( s; /usr/lib/python2.7/site-packages/salt/modules/mod_random.pyt shadow_hash� s i i
c C@ s, | d k r t j | � n t j | | � S( u�
Returns a random integer number between the start and end number.
.. versionadded: 2015.5.3
start : 1
Any valid integer number
end : 10
Any valid integer number
seed :
Optional hashable object
.. versionchanged:: 2019.2.0
Added seed argument. Will return the same result when run with the same seed.
CLI Example:
.. code-block:: bash
salt '*' random.rand_int 1 10
N( t Nonet randomt seedt randint( t startt endR. ( ( s; /usr/lib/python2.7/site-packages/salt/modules/mod_random.pyt rand_int� s c C@ s3 | d k r t d } n t j | � t j | � S( uu
Returns a random number within a range. Optional hash argument can
be any hashable object. If hash is omitted or None, the id of the minion is used.
.. versionadded: 2015.8.0
hash: None
Any hashable object.
range: 10
Any valid integer number
CLI Example:
.. code-block:: bash
salt '*' random.seed 10 hash=None
u idN( R, t
__grains__R- R. t randrange( t rangeR ( ( s; /usr/lib/python2.7/site-packages/salt/modules/mod_random.pyR. � s
( t __doc__t
__future__R R R R R R- t salt.utils.pycryptoR" t salt.exceptionsR t salt.extR R R R R R R! R' R, R+ R2 R. ( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/mod_random.pyt <module> s$ % *
Mini Shell