Current File : //lib/python2.7/site-packages/salt/modules/random_org.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l m Z d d l Z d d l
m Z d d l
Z d d l Z e j e � Z d Z i i i d d 6d 6i d d 6d 6i d
d 6d
6i d d 6d 6i d d 6d 6i d
d 6d
6i d d 6d 6d 6Z d � Z d � Z d d d � Z d d d � Z d d d � Z d d d � Z d d d � Z d d d � Z d d d � Z d d d � Z d S( u�
Module for retrieving random information from Random.org
.. versionadded:: 2015.5.0
:configuration: This module can be used by either passing an api key and version
directly or by specifying both in a configuration profile in the salt
master/minion config.
For example:
.. code-block:: yaml
random_org:
api_key: 7be1402d-5719-5bd3-a306-3def9f135da5
api_version: 1
i ( t absolute_importt unicode_literalst print_functionN( t six( t urljoinu
random_orgu getUsageu methodu generateIntegersu generateStringsu
generateUUIDsu generateDecimalFractionsu generateGaussiansu
generateBlobsu 1c C@ s t S( uZ
Return virtual name of the module.
:return: The virtual name of the module.
( t __virtualname__( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt __virtual__A s c C@ s t | t j t f � S( u-
Tell whether an argument is numeric
( t
isinstanceR t
integer_typest float( t n( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt _numericJ s c C@ s^ | d k r i } n i t d 6} d } t | d t j | � d � } t j j j | � } t j j j
| d d d i d | d t d
t d i d t �} | j d
d � t j
j j j j k r | d } | j d � r� | j d � S| j d � r| j d � St S| j d
d � t j
j j j j k r4t St | d � rL| j n d | d <| Sd S( u:
Slack object method function to construct and execute on the API URL.
:param api_key: The Random.org api key.
:param api_version: The version of Random.org api.
:param data: The data to be sent for POST method.
:return: The json response from the API call or False.
u resu https://api.random.org/u json-rpc/u /invoket methodu POSTt paramst datat decodet statust header_dictt optsu statusu dictu resultu erroru textu u messageN( t Nonet Truet _urljoinR t text_typet saltt utilst jsont dumpst httpt queryt __opts__t gett extt movest http_clientt OKt Falset
NO_CONTENTt hasattrt text( t api_versionR t rett api_urlt base_urlt resultt _result( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt _queryQ s4
'
'"c C@ s� i t d 6} | s | r� yD t d d � } | sF | j d � } n | s^ | j d � } n Wq� t t t f k
r� t j d � d | d <t | d <| SXn t | t
� r� t j | � } n t
j | � j d � j d
� } i } d | d <d
| d <| | d
<i | d 6| d <t d | d | � } | r�| j d � | d <| j d � | d <| j d � | d <| j d � | d <n t | d <| d | d <| S( uc
Show current usages statistics
:param api_key: The Random.org api key.
:param api_version: The Random.org api version.
:return: The current usage statistics.
CLI Example:
.. code-block:: bash
salt '*' random_org.getUsage
salt '*' random_org.getUsage api_key=peWcBiMOS9HrZG15peWcBiMOS9HrZG15 api_version=1
u resu
config.optionu
random_orgu api_keyu api_versionu No Random.org api key found.u+ No Random.org api key or api version found.u messageu getUsageu methodi�) u idu 2.0u jsonrpcu apiKeyu paramsR' R u bitsLeftu requestsLeftu totalBitsu
totalRequests( R t __salt__R t NameErrort KeyErrort AttributeErrort logt errorR# R t intR R t RANDOM_ORG_FUNCTIONSR- ( t api_keyR' R( t optionst _functionR R+ ( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt getUsage~ s<
!
c K@ sa i t d 6} | s | r� yD t d d � } | sF | j d � } n | s^ | j d � } n Wq� t t t f k
r� t j d � d | d <t | d <| SXn xD d d
d g D]3 } | | k r� t | d <d j | � | d <| Sq� Wt
| d � sd
| d k od k n r2t | d <d | d <| St
| d
� sdd | d
k o^d k n r|t | d <d | d <| St
| d � s�d | d k o�d k n r�t | d <d | d <| Sd | k r| d } | d+ k r t | d <d | d <| Sn d } d | k r t } n
| d } t | t � rIt
j | � } n t j | � j d � j d � } i } d | d <d | d <| | d <i | d! 6| d d" 6| d
d# 6| d d$ 6| d 6| d 6| d% <t d& | d' | � }
t j d( |
� |
rEd) |
k r*|
j d) � j d* � } | | d* <q]t | d <|
d | d <n t | d <|
d | d <| S(, u�
Generate random integers
:param api_key: The Random.org api key.
:param api_version: The Random.org api version.
:param number: The number of integers to generate
:param minimum: The lower boundary for the range from which the
random numbers will be picked. Must be within
the [-1e9,1e9] range.
:param maximum: The upper boundary for the range from which the
random numbers will be picked. Must be within
the [-1e9,1e9] range.
:param replacement: Specifies whether the random numbers should
be picked with replacement. The default (true)
will cause the numbers to be picked with replacement,
i.e., the resulting numbers may contain duplicate
values (like a series of dice rolls). If you want the
numbers picked to be unique (like raffle tickets drawn
from a container), set this value to false.
:param base: Specifies the base that will be used to display the numbers.
Values allowed are 2, 8, 10 and 16. This affects the JSON
types and formatting of the resulting data as discussed below.
:return: A list of integers.
CLI Example:
.. code-block:: bash
salt '*' random_org.generateIntegers number=5 minimum=1 maximum=6
salt '*' random_org.generateIntegers number=5 minimum=2 maximum=255 base=2
u resu
config.optionu
random_orgu api_keyu api_versionu No Random.org api key found.u+ No Random.org api key or api version found.u messageu numberu minimumu maximumu! Rquired argument, {0} is missing.i i' u. Number of integers must be between 1 and 10000i 6e�i ʚ;uA Minimum argument must be between -1,000,000,000 and 1,000,000,000uA Maximum argument must be between -1,000,000,000 and 1,000,000,000u basei i i
i u# Base must be either 2, 8, 10 or 16.u replacementu generateIntegersu methodi�) u idu 2.0u jsonrpcu apiKeyu nu minu maxu paramsR' R u result %su randomu data( i i i
i ( R R. R R/ R0 R1 R2 R3 R# t formatR R R4 R R R5 R- t debug( R6 R' t kwargsR( R7 t itemt baset replacementR8 R R+ t random_data( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt generateIntegers� s� $
2
2
2
!
c
K@ s� i t d 6} | s | r� yD t d d � } | sF | j d � } n | s^ | j d � } n Wq� t t t f k
r� t j d � d | d <t | d <| SXn xD d d
d g D]3 } | | k r� t | d <d j | � | d <| Sq� Wt
| d � sd
| d k od k n r2t | d <d | d <| St
| d
� sdd
| d
k o^d k n r|t | d <d | d <| St | d � d k r�t | d <d | d <| St | t
� r�t j | � } n d | k r�t } n
| d } t j | � j d � j d � } i } d | d <d | d <| | d <i | d 6| d d 6| d
d
6| d d 6| d 6| d <t d | d | � } | r�d | k r�| j d � j d! � }
|
| d! <q�t | d <| d | d <n t | d <| d | d <| S(" uR
Generate random strings.
:param api_key: The Random.org api key.
:param api_version: The Random.org api version.
:param number: The number of strings to generate.
:param length: The length of each string. Must be
within the [1,20] range. All strings
will be of the same length
:param characters: A string that contains the set of
characters that are allowed to occur
in the random strings. The maximum number
of characters is 80.
:param replacement: Specifies whether the random strings should be picked
with replacement. The default (true) will cause the
strings to be picked with replacement, i.e., the
resulting list of strings may contain duplicates (like
a series of dice rolls). If you want the strings to be
unique (like raffle tickets drawn from a container), set
this value to false.
:return: A list of strings.
CLI Example:
.. code-block:: bash
salt '*' random_org.generateStrings number=5 length=8 characters='abcdefghijklmnopqrstuvwxyz'
salt '*' random_org.generateStrings number=10 length=16 characters'abcdefghijklmnopqrstuvwxyz'
u resu
config.optionu
random_orgu api_keyu api_versionu No Random.org api key found.u+ No Random.org api key or api version found.u messageu numberu lengthu
charactersu" Required argument, {0} is missing.i i' u- Number of strings must be between 1 and 10000i u* Length of strings must be between 1 and 20iP u* Length of characters must be less than 80.u replacementu generateStringsu methodi�) u idu 2.0u jsonrpcu apiKeyu nu paramsR' R u randomu data( R R. R R/ R0 R1 R2 R3 R# R: R t lenR R4 R R R5 R- ( R6 R' R< R( R7 R= R? R8 R R+ R@ ( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt generateStrings) sn "
2
2
!
c
K@ s1 i t d 6} | s | r� yD t d d � } | sF | j d � } n | s^ | j d � } n Wq� t t t f k
r� t j d � d | d <t | d <| SXn x> d g D]3 } | | k r� t | d <d
j | � | d <| Sq� Wt
| t � rt j
| � } n t | d � s5d | d k o/d k n rMt | d <d
| d <| St j | � j d � j d � } i } d | d <d | d <| | d <i | d 6| d d 6| d <t d | d | � } | rd | k r�| j d � j d � } | | d <q-t | d <| d | d <n t | d <| d | d <| S( up
Generate a list of random UUIDs
:param api_key: The Random.org api key.
:param api_version: The Random.org api version.
:param number: How many random UUIDs you need.
Must be within the [1,1e3] range.
:return: A list of UUIDs
CLI Example:
.. code-block:: bash
salt '*' random_org.generateUUIDs number=5
u resu
config.optionu
random_orgu api_keyu api_versionu No Random.org api key found.u+ No Random.org api key or api version found.u messageu numberu" Required argument, {0} is missing.i i� u* Number of UUIDs must be between 1 and 1000u
generateUUIDsu methodi�) u idu 2.0u jsonrpcu apiKeyu nu paramsR' R u randomu data( R R. R R/ R0 R1 R2 R3 R# R: R R4 R R R R5 R- (
R6 R' R< R( R7 R= R8 R R+ R@ ( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt
generateUUIDs� sR
2
!
c
K@ s� i t d 6} | s | r� yD t d d � } | sF | j d � } n | s^ | j d � } n Wq� t t t f k
r� t j d � d | d <t | d <| SXn xA d d
g D]3 } | | k r� t | d <d j | � | d <| Sq� Wt
| d t � sd | d k od
k n r2t | d <d | d <| St | d
� sdd | d
k o^d k n r|t | d <d | d <| Sd | k r�t } n
| d } t
| t � r�t
j | � } n t j | � j d � j d � } i } d | d <d | d <| | d <i | d 6| d d 6| d
d
6| d 6| d <t d | d | � } | r�d | k r{| j d � j d � }
|
| d <q�t | d <| d | d <n t | d <| d | d <| S( u�
Generates true random decimal fractions
:param api_key: The Random.org api key.
:param api_version: The Random.org api version.
:param number: How many random decimal fractions
you need. Must be within the [1,1e4] range.
:param decimalPlaces: The number of decimal places
to use. Must be within the [1,20] range.
:param replacement: Specifies whether the random numbers should
be picked with replacement. The default (true)
will cause the numbers to be picked with replacement,
i.e., the resulting numbers may contain duplicate
values (like a series of dice rolls). If you want the
numbers picked to be unique (like raffle tickets drawn
from a container), set this value to false.
:return: A list of decimal fraction
CLI Example:
.. code-block:: bash
salt '*' random_org.generateDecimalFractions number=10 decimalPlaces=4
salt '*' random_org.generateDecimalFractions number=10 decimalPlaces=4 replacement=True
u resu
config.optionu
random_orgu api_keyu api_versionu No Random.org api key found.u+ No Random.org api key or api version found.u messageu numberu
decimalPlacesu" Required argument, {0} is missing.i i' u7 Number of decimal fractions must be between 1 and 10000i u1 Number of decimal places must be between 1 and 20u replacementu generateDecimalFractionsu methodi�) u idu 2.0u jsonrpcu apiKeyu nu paramsR' R u randomu data( R R. R R/ R0 R1 R2 R3 R# R: R R4 R R R R5 R- ( R6 R' R< R( R7 R= R? R8 R R+ R@ ( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt generateDecimalFractions� sd
5
2
!
c
K@ s9 i t d 6} | s | r� yD t d d � } | sF | j d � } n | s^ | j d � } n Wq� t t t f k
r� t j d � d | d <t | d <| SXn xG d d
d d g D]3 } | | k r� t | d <d
j | � | d <| Sq� Wt
| d � s d | d k od k n r5t | d <d | d <| St
| d
� sgd | d
k oad k n rt | d <d | d <| St
| d � s�d | d k o�d k n r�t | d <d | d <| St
| d � s�d | d k o�d k n rt | d <d | d <| St | t � r4t
j | � } n t j | � j d � j d � } i } d | d <d | d <| | d <i | d 6| d d 6| d
d
6| d d 6| d d 6| d <t d! | d" | � } | r d# | k r| j d# � j d$ � } | | d$ <q5t | d <| d | d <n t | d <| d | d <| S(% u�
This method generates true random numbers from a
Gaussian distribution (also known as a normal distribution).
:param api_key: The Random.org api key.
:param api_version: The Random.org api version.
:param number: How many random numbers you need.
Must be within the [1,1e4] range.
:param mean: The distribution's mean. Must be
within the [-1e6,1e6] range.
:param standardDeviation: The distribution's standard
deviation. Must be within
the [-1e6,1e6] range.
:param significantDigits: The number of significant digits
to use. Must be within the [2,20] range.
:return: The user list.
CLI Example:
.. code-block:: bash
salt '*' random_org.generateGaussians number=10 mean=0.0 standardDeviation=1.0 significantDigits=8
u resu
config.optionu
random_orgu api_keyu api_versionu No Random.org api key found.u+ No Random.org api key or api version found.u messageu numberu meanu standardDeviationu significantDigitsu" Required argument, {0} is missing.i i' u7 Number of decimal fractions must be between 1 and 10000i���i@B u< The distribution's mean must be between -1000000 and 1000000uJ The distribution's standard deviation must be between -1000000 and 1000000i i u9 The number of significant digits must be between 2 and 20u generateGaussiansu methodi�) u idu 2.0u jsonrpcu apiKeyu nu paramsR' R u randomu data( R R. R R/ R0 R1 R2 R3 R# R: R R R4 R R R5 R- (
R6 R' R< R( R7 R= R8 R R+ R@ ( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt generateGaussians6 sp
2
2
2
2
!
c K@ s� i t d 6} | s | r� yD t d d � } | sF | j d � } n | s^ | j d � } n Wq� t t t f k
r� t j d � d | d <t | d <| SXn xA d d
g D]3 } | | k r� t | d <d j | � | d <| Sq� Wt
| d � sd | d k od
k n r/t | d <d | d <| St
| d
� sud | d
k o[d k n su| d
d d k r�t | d <d | d <| Sd | k r�| d } | d# k r�t | d <d | d <| Sn d } t | t � r�t
j | � } n t j | � j d � j d � } i } d | d <d | d <| | d <i | d 6| d d 6| d
d
6| d 6| d <t d | d | � } | r�d! | k r�| j d! � j d" � }
|
| d" <q�t | d <| d | d <n t | d <| d | d <| S($ u�
List all Slack users.
:param api_key: The Random.org api key.
:param api_version: The Random.org api version.
:param format: Specifies the format in which the
blobs will be returned. Values
allowed are base64 and hex.
:return: The user list.
CLI Example:
.. code-block:: bash
salt '*' get_integers number=5 min=1 max=6
salt '*' get_integers number=5 min=1 max=6
u resu
config.optionu
random_orgu api_keyu api_versionu No Random.org api key found.u+ No Random.org api key or api version found.u messageu numberu sizeu" Required argument, {0} is missing.i id u) Number of blobs must be between 1 and 100i i i u formatu base64u hexu$ Format must be either base64 or hex.u
generateBlobsu methodi�) u idu 2.0u jsonrpcu apiKeyu nu paramsR' R u randomu data( u base64u hex( R R. R R/ R0 R1 R2 R3 R# R: R R R4 R R R5 R- ( R6 R' R< R( R7 R= t _formatR8 R R+ R@ ( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt
generateBlobs� sl
2
F
!
( t __doc__t
__future__R R R t loggingt salt.extR t salt.ext.six.moves.http_clientR t salt.ext.six.moves.urllib.parseR R t salt.utils.httpt salt.utils.jsont getLoggert __name__R2 R R5 R R R R- R9 RA RC RD RE RF RH ( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/random_org.pyt <module> sR -6 t g F ] `
Mini Shell