Current File : //lib/python2.7/site-packages/salt/modules/hashutil.pyo
�
���^c @@ sI 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 Z d d l
Z d d l Z e j r� d d l m Z e Z n" e j r� d d l m Z m Z n d d � Z d d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d S( u0
A collection of hashing and encoding functions
i ( t absolute_importt print_functiont unicode_literalsN( t six( t StringIO( t BytesIOR u md5c C@ sj i t d d 6t d d 6t d d 6} | j | � } | d k r` t j j d j | � � � n | | � S( u%
Return a checksum digest for a string
instr
A string
checksum : ``md5``
The hashing algorithm to use to generate checksums. Valid options: md5,
sha256, sha512.
CLI Example:
.. code-block:: bash
salt '*' hashutil.digest 'get salted'
u hashutil.md5_digestu md5u hashutil.sha256_digestu sha256u hashutil.sha512_digestu sha512u! Hash func '{0}' is not supported.N( t __salt__t gett Nonet saltt
exceptionst CommandExecutionErrort format( t instrt checksumt
hashing_funcst hash_func( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyt digest s c C@ sl t d | � s. t j j d j | � � � n t j j j | d � � } t d | j � | � } Wd QX| S( ui
Return a checksum digest for a file
infile
A file path
checksum : ``md5``
The hashing algorithm to use to generate checksums. Wraps the
:py:func:`hashutil.digest <salt.modules.hashutil.digest>` execution
function.
CLI Example:
.. code-block:: bash
salt '*' hashutil.digest_file /path/to/file
u file.file_existsu File path '{0}' not found.u rbu hashutil.digestN( R R R
R R t utilst filest fopent read( t infileR t ft file_hash( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyt digest_file8 s c C@ s t j j j | � S( uO
Encode a string as base64 using the "modern" Python interface.
Among other possible differences, the "modern" encoder does not include
newline ('\n') characters in the encoded output.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' hashutil.base64_b64encode 'get salted'
( R R t hashutilst base64_b64encode( R
( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyR S s c C@ s t j j j | � S( u�
Decode a base64-encoded string using the "modern" Python interface
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' hashutil.base64_b64decode 'Z2V0IHNhbHRlZA=='
( R R R t base64_b64decode( R
( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyR e s c C@ s t j j j | � S( u
Encode a string as base64 using the "legacy" Python interface.
Among other possible differences, the "legacy" encoder includes
a newline ('\n') character after every 76 characters and always
at the end of the encoded string.
.. versionadded:: 2014.7.0
CLI Example:
.. code-block:: bash
salt '*' hashutil.base64_encodestring 'get salted'
( R R R t base64_encodestring( R
( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyR t s c C@ s` t � } t j j j | d � � } t j | | � Wd QX| j d � t j j j | j
� � S( u
Read a file from the file system and return as a base64 encoded string
.. versionadded:: 2016.3.0
Pillar example:
.. code-block:: yaml
path:
to:
data: |
{{ salt.hashutil.base64_encodefile('/path/to/binary_file') | indent(6) }}
The :py:func:`file.decode <salt.states.file.decode>` state function can be
used to decode this data and write it to disk.
CLI Example:
.. code-block:: bash
salt '*' hashutil.base64_encodefile /path/to/binary_file
u rbNi ( R R R R R t base64t encodet seekt stringutilst to_strR ( t fnamet encoded_fR ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyt base64_encodefile� s
c C@ s t j j j | � S( u�
Decode a base64-encoded string using the "legacy" Python interface
.. versionadded:: 2014.7.0
CLI Example:
.. code-block:: bash
salt '*' hashutil.base64_decodestring instr='Z2V0IHNhbHRlZAo='
( R R R t base64_decodestring( R
( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyR& � s
c C@ sA t | � } t j j j | d � � } t j | | � Wd QXt S( u�
Decode a base64-encoded string and write the result to a file
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' hashutil.base64_decodefile instr='Z2V0IHNhbHRlZAo=' outfile='/path/to/binary_file'
u wbN( R R R R R R t decodet True( R
t outfileR$ R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyt base64_decodefile� s c C@ s t j j j | � S( u�
Generate an md5 hash of a given string
.. versionadded:: 2014.7.0
CLI Example:
.. code-block:: bash
salt '*' hashutil.md5_digest 'get salted'
( R R R t
md5_digest( R
( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyR+ � s c C@ s t j j j | � S( u�
Generate an sha256 hash of a given string
.. versionadded:: 2014.7.0
CLI Example:
.. code-block:: bash
salt '*' hashutil.sha256_digest 'get salted'
( R R R t
sha256_digest( R
( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyR, � s c C@ s t j j j | � S( u�
Generate an sha512 hash of a given string
.. versionadded:: 2014.7.0
CLI Example:
.. code-block:: bash
salt '*' hashutil.sha512_digest 'get salted'
( R R R t
sha512_digest( R
( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyR- � s c C@ s t j j j | | | � S( uP
Verify a challenging hmac signature against a string / shared-secret
.. versionadded:: 2014.7.0
Returns a boolean if the verification succeeded or failed.
CLI Example:
.. code-block:: bash
salt '*' hashutil.hmac_signature 'get salted' 'shared secret' 'eBWf9bstXg+NiP5AOwppB5HMvZiYMPzEM9W5YMm/AmQ='
( R R R t hmac_signature( t stringt
shared_secrett challenge_hmac( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyR. � s c C@ s� | } | } | j d � \ } } t j rW t j j j | � } t j j j | � } n t j | | t t
| � � } | j � | k S( uo
Verify a challenging hmac signature against a string / shared-secret for
github webhooks.
.. versionadded:: 2017.7.0
Returns a boolean if the verification succeeded or failed.
CLI Example:
.. code-block:: bash
salt '*' hashutil.github_signature '{"ref":....} ' 'shared secret' 'sha1=bc6550fc290acf5b42283fa8deaf55cea0f8c206'
u =( t splitR t text_typeR R R! t to_bytest hmact newt getattrt hashlibt hexdigest( R/ R0 R1 t msgt keyt hashtypet challenget hmac_hash( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyt github_signature
s (! t __doc__t
__future__R R R R R8 R5 t salt.exceptionsR t salt.extR t salt.utils.filest salt.utils.hashutilst salt.utils.stringutilst PY2R R t PY3t ioR R R R R R% R& R* R+ R, R- R. R? ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/hashutil.pyt <module> s6 !
Mini Shell