o ߭h@sdZddlmZddlmZddlmZddlmZm Z ddl m Z ddl m Z mZmZgd Ze jZ Gd d d eZefd(ddZefd(ddZd)ddZd*d!d"Zd+d%d&Zd'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)ffilib)Literal) HashingErrorVerificationErrorVerifyMismatchError)ARGON2_VERSIONTyper hash_secrethash_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__rArgon2_dDArgon2_iI Argon2_idIDrrU/var/www/html/stock_analysis/be/venv/lib/python3.10/site-packages/argon2/low_level.pyr )s  r secretbytessalt time_costint memory_cost parallelismhash_lentypeversionreturnc Cst|||t|||jd}td|} t|||td|t|td|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:`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 rchar[] uint8_t[]) rargon2_encodedlenlenvaluernew argon2_hashNULL ARGON2_OKr error_to_strstring) rrr r"r#r$r%r&sizebufrvrrrr5s<#      rc Csptd|}t|||td|t|td|t|||tjd|j| } | tjkr0tt | 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) rr-rr.r+r/r,r0r r1rbuffer) rrr r"r#r$r%r&r4r5rrrrxs&     rhash Literal[True]cCsVttd|td|t||j}|tjkrdS|tjkr%tt |t t |)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)T) r argon2_verifyrr-r+r,r0ARGON2_VERIFY_MISMATCHr r1r )r7rr%r5rrrrs      rcontextrcCs 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 argon2_ctx)r;r%rrrcores r=errorstrcCstt|dS)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)rr2rargon2_error_messagedecode)r>rrrr1s r1N)rrrrr r!r"r!r#r!r$r!r%r r&r!r'r)r7rrrr%r r'r8)r;rr%r!r'r!)r>r!r'r?)r __future__renumrtypingr_argon2_cffi_bindingsrr_typingr exceptionsr r r __all__ARGON2_VERSION_NUMBERr r rrrr=r1rrrrs$     K ( (