a
    ø£Be  ã                   @  sô   d Z ddlmZ ddlmZ ddlmZ ddlmZm	Z	 ddl
mZ ddlmZmZmZ g d	¢Ze	jZG d
d„ deƒZefddddddddddœ	dd„Zefddddddddddœ	dd„Zdddddœdd„Zddddœdd„Zdddœdd„ZdS ) a>  
Low-level functions if you want to build your own higher level abstractions.

.. warning::
    This is a "Hazardous Materials" module.  You should **ONLY** use it if
    you're 100% absolutely sure that you know what you're doing because this
    module is full of land mines, dragons, and dinosaurs with laser guns.
é    )Úannotations)ÚEnum)ÚAny)ÚffiÚlibé   )ÚLiteral)ÚHashingErrorÚVerificationErrorÚVerifyMismatchError)ÚARGON2_VERSIONÚTyper   Úhash_secretÚhash_secret_rawÚverify_secretc                   @  s"   e Zd ZdZejZejZej	Z
dS )r   zX
    Enum of Argon2 variants.

    Please see :doc:`parameters` on how to pick one.
    N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ZArgon2_dÚDZArgon2_iÚIZ	Argon2_idZID© r   r   úS/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/argon2/low_level.pyr   )   s   r   ÚbytesÚint)	ÚsecretÚsaltÚ	time_costÚmemory_costÚparallelismÚhash_lenÚtypeÚversionÚreturnc                 C  sˆ   t  |||t|ƒ||j¡d }t d|¡}	t  |||t d| ¡t| ƒt d|¡t|ƒtj||	||j|¡}
|
t jkr~t	t
|
ƒƒ‚t |	¡S )aç  
    Hash *secret* and return an **encoded** hash.

    An encoded hash can be directly passed into :func:`verify_secret` as it
    contains all parameters and the salt.

    :param bytes secret: Secret to hash.
    :param bytes salt: A salt_.  Should be random and different for each
        secret.
    :param Type type: Which Argon2 variant to use.
    :param int version: Which Argon2 version to use.

    For an explanation of the Argon2 parameters see
    :class:`argon2.PasswordHasher`.

    :rtype: bytes

    :raises argon2.exceptions.HashingError: If hashing fails.

    .. versionadded:: 16.0.0

    .. _salt: https://en.wikipedia.org/wiki/Salt_(cryptography)
    .. _kibibytes: https://en.wikipedia.org/wiki/Binary_prefix#kibi
    r   úchar[]ú	uint8_t[])r   Zargon2_encodedlenÚlenÚvaluer   ÚnewÚargon2_hashÚNULLÚ	ARGON2_OKr	   Úerror_to_strÚstring)r   r   r   r   r   r    r!   r"   ÚsizeÚbufÚrvr   r   r   r   5   s<    #úøÿ

ó
r   c           
      C  sp   t  d|¡}t |||t  d| ¡t| ƒt  d|¡t|ƒ||t jd|j|¡}	|	tjkr`tt	|	ƒƒ‚t
t  ||¡ƒS )z—
    Hash *password* and return a **raw** hash.

    This function takes the same parameters as :func:`hash_secret`.

    .. versionadded:: 16.0.0
    r%   r   )r   r(   r   r)   r&   r*   r'   r+   r	   r,   r   Úbuffer)
r   r   r   r   r   r    r!   r"   r/   r0   r   r   r   r   x   s&    

ó
r   zLiteral[True])Úhashr   r!   r#   c                 C  sZ   t  t d| ¡t d|¡t|ƒ|j¡}|t jkr4dS |t jkrJtt	|ƒƒ‚t
t	|ƒƒ‚dS )a8  
    Verify whether *secret* is correct for *hash* of *type*.

    :param bytes hash: An encoded Argon2 hash as returned by
        :func:`hash_secret`.
    :param bytes secret: The secret to verify whether it matches the one
        in *hash*.
    :param Type type: Type for *hash*.

    :raises argon2.exceptions.VerifyMismatchError: If verification fails
        because *hash* is not valid for *secret* of *type*.
    :raises argon2.exceptions.VerificationError: If verification fails for
        other reasons.

    :return: ``True`` on success, raise
        :exc:`~argon2.exceptions.VerificationError` otherwise.
    :rtype: bool

    .. versionadded:: 16.0.0
    .. versionchanged:: 16.1.0
        Raise :exc:`~argon2.exceptions.VerifyMismatchError` on mismatches
        instead of its more generic superclass.
    r$   r%   TN)r   Zargon2_verifyr   r(   r&   r'   r+   ZARGON2_VERIFY_MISMATCHr   r,   r
   )r2   r   r!   r0   r   r   r   r       s    

ü

r   r   )Úcontextr!   r#   c                 C  s   t  | |¡S )a�  
    Direct binding to the ``argon2_ctx`` function.

    .. warning::
        This is a strictly advanced function working on raw C data structures.
        Both Argon2's and *argon2-cffi*'s higher-level bindings do a lot of
        sanity checks and housekeeping work that *you* are now responsible for
        (e.g. clearing buffers). The structure of the *context* object can,
        has, and will change with *any* release!

        Use at your own peril; *argon2-cffi* does *not* use this binding
        itself.

    :param context: A CFFI Argon2 context object (i.e. an ``struct
        Argon2_Context`` / ``argon2_context``).
    :param int type: Which Argon2 variant to use.  You can use the ``value``
        field of :class:`Type`'s fields.

    :rtype: int
    :return: An Argon2 error code.  Can be transformed into a string using
        :func:`error_to_str`.

    .. versionadded:: 16.0.0
    )r   Z
argon2_ctx)r3   r!   r   r   r   ÚcoreÈ   s    r4   Ústr)Úerrorr#   c                 C  s   t  t | ¡¡ d¡S )z´
    Convert an Argon2 error code into a native string.

    :param int error: An Argon2 error code as returned by :func:`core`.

    :rtype: str

    .. versionadded:: 16.0.0
    Úascii)r   r-   r   Zargon2_error_messageÚdecode)r6   r   r   r   r,   ä   s    
r,   N)r   Ú
__future__r   Úenumr   Útypingr   Z_argon2_cffi_bindingsr   r   Z_typingr   Ú
exceptionsr	   r
   r   Ú__all__ZARGON2_VERSION_NUMBERr   r   r   r   r   r4   r,   r   r   r   r   Ú<module>   s    			ø Kø ((