bidZddlmZddlmZddlmZmZddlm Z m Z ddl m Z m Z mZgdZe j Z Gd d eZef dd Zef dd Zdd ZddZddZy)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)AnyLiteral)ffilib) HashingErrorVerificationErrorVerifyMismatchError)ARGON2_VERSIONTyper hash_secrethash_secret_raw verify_secretcXeZdZdZej ZejZejZ y)rzX Enum of Argon2 variants. Please see :doc:`parameters` on how to pick one. N) __name__ __module__ __qualname____doc__rArgon2_dDArgon2_iI Argon2_idIDK/home/cdr/jupyterlab/.venv/lib/python3.12/site-packages/argon2/low_level.pyrr(s$ A A Brrctj|||t|||jdz}t j d|} tj |||t j d|t|t j d|t|tj|| ||j| } | tjk7rtt| t j| 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. Args: secret: Secret to hash. salt: A salt_. Should be random and different for each secret. type: Which Argon2 variant to use. version: Which Argon2 version to use. For an explanation of the Argon2 parameters see :class:`argon2.PasswordHasher`. Returns: An encoded Argon2 hash. Raises: argon2.exceptions.HashingError: If hashing fails. .. versionadded:: 16.0.0 .. _salt: https://en.wikipedia.org/wiki/Salt_(cryptography) r char[] uint8_t[]) rargon2_encodedlenlenvaluernew argon2_hashNULL ARGON2_OKr error_to_strstring) secretsalt time_cost memory_cost parallelismhash_lentypeversionsizebufrvs rrr4sN     I  JJ      ''(D !C   V$ F   T" D      B S]]<+,, ::c?rctjd|}tj|||tjd|t |tjd|t |||tj d|j | } | tjk7rtt| ttj||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%r)r r*bytesbuffer) r,r-r.r/r0r1r2r3r5r6s rrr{s" ''+x (C   V$ F   T" D      B S]]<+,, C* ++rcFtjtjd|tjd|t ||j }|tj k(ry|tjk(rtt|tt|)aB Verify whether *secret* is correct for *hash* of *type*. Args: hash: An encoded Argon2 hash as returned by :func:`hash_secret`. secret: The secret to verify whether it matches the one in *hash*. type: Type for *hash*. Raises: argon2.exceptions.VerifyMismatchError: If verification fails because *hash* is not valid for *secret* of *type*. argon2.exceptions.VerificationError: If verification fails for other reasons. Returns: ``True`` on success, raise :exc:`~argon2.exceptions.VerificationError` otherwise. .. 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%r)ARGON2_VERIFY_MISMATCHr r*r )hashr,r2r6s rrrs}<   $  V$ F   B S]] S ' ''!,r"233 L, --rc.tj||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. Args: context: A CFFI Argon2 context object (i.e. an ``struct Argon2_Context`` / ``argon2_context``). type: Which Argon2 variant to use. You can use the ``value`` field of :class:`Type`'s fields. Returns: An Argon2 error code. Can be transformed into a string using :func:`error_to_str`. .. versionadded:: 16.0.0 )r argon2_ctx)contextr2s rcorerAs: >>'4 ((rcptjtj|j dS)z Convert an Argon2 error code into a native string. Args: error: An Argon2 error code as returned by :func:`core`. Returns: A human-readable string describing the error. .. versionadded:: 16.0.0 ascii)rr+rargon2_error_messagedecode)errors rr*r*s) ::c..u5 6 = =g FFrN)r,r8r-r8r.intr/rGr0rGr1rGr2rr3rGreturnr8)r=r8r,r8r2rrHz Literal[True])r@rr2rGrHrG)rFrGrHstr)r __future__renumrtypingrr_argon2_cffi_bindingsrr exceptionsr r r __all__ARGON2_VERSION_NUMBERr rrrrrAr*rrrrQs!#*LL ** 4 ("D D DD D  D  D DD D^"%, %, %,%, %,  %,  %, %,%, %,P+.\)@ Gr