B 5‹dôã @sôdZddlmZddlmZddlmZmZddlm Z ddl m Z m Z m Z dd d d d d gZejZGdd „d eƒZefeeeeeeeeedœ dd „Zefeeeeeeeeedœ dd „Zeeee ddœdd „Zeeedœdd„Zeedœdd„ZdS)u@ 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. é)ÚEnum)ÚAny)ÚffiÚlibé)ÚLiteral)Ú HashingErrorÚVerificationErrorÚVerifyMismatchErrorÚARGON2_VERSIONÚTyperÚ hash_secretÚhash_secret_rawÚ verify_secretc@s"eZdZdZejZejZej Z dS)r zX Enum of Argon2 variants. Please see :doc:`parameters` on how to pick one. N) Ú__name__Ú __module__Ú __qualname__Ú__doc__rZArgon2_dÚDZArgon2_iÚIZ Argon2_idZID©rrú]/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/argon2/low_level.pyr 's  ) ÚsecretÚsaltÚ time_costÚ memory_costÚ parallelismÚhash_lenÚtypeÚversionÚreturnc Csˆt |||t|ƒ||j¡d}t d|¡} t |||t d|¡t|ƒt d|¡t|ƒtj|| ||j|¡ } | tjkr~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:`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 rzchar[]z uint8_t[]) rZargon2_encodedlenÚlenÚvaluerÚnewÚ argon2_hashÚNULLÚ ARGON2_OKrÚ error_to_strÚstring) rrrrrrrrÚsizeÚbufÚrvrrrr Gs4"     c Cspt d|¡}t |||t d|¡t|ƒt d|¡t|ƒ||tjd|j|¡ } | tjkr`tt | ƒƒ‚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 z uint8_t[]r) rr#rr$r!r%r"r&rr'ÚbytesÚbuffer) rrrrrrrrr*r+rrrr‰s$     T)Úhashrrr cCs\t t d|¡t d|¡t|ƒ|j¡}|tjkr4dS|tjkrLtt |ƒƒ‚n t t |ƒƒ‚dS)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. zchar[]z uint8_t[]TN) rZ argon2_verifyrr#r!r"r&ZARGON2_VERIFY_MISMATCHr r'r )r.rrr+rrrr±s    )Úcontextrr cCs 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 )rZ argon2_ctx)r/rrrrÚcore×sr0)Úerrorr cCst 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)rr(rZargon2_error_messageÚdecode)r1Úmsgrrrr'ós  r'N)rÚenumrÚtypingrZ_argon2_cffi_bindingsrrZ_typingrÚ exceptionsrr r Ú__all__ZARGON2_VERSION_NUMBERr r r,Úintr rrr0Ústrr'rrrrÚ s(    (A&