g%SrSSKJr SSKr\R"\5rSSKJr SSK J r SSK J r SSK Jr SS /rS rS rS rS rSrSSjrSqSqSSjrSrSrSrSr\"\\\S9rSSjr\"S5 Sr g)zg passlib.utils.scrypt -- scrypt hash frontend and help utilities XXX: add this module to public docs? )absolute_importN)warn)exc)to_bytes)PYPYvalidatescryptli?cUS:a[SU-5eUS:a[SU-5eX-[:a[SU<SU<35eUS:d XS- -(a[SU-5eg) a- helper which validates a set of scrypt config parameters. scrypt will take ``O(n * r * p)`` time and ``O(n * r)`` memory. limitations are that ``n = 2**``, ``n < 2**(16*r)``, ``r * p < 2 ** 30``. :param n: scrypt rounds :param r: scrypt block size :param p: scrypt parallel factor zr must be > 0: r=%rzp must be > 0: p=%rzr * p must be < 2**30: r=z, p=z%n must be > 1, and a power of 2: n=%rT) ValueErrorMAX_RP)nrps W/home/matz/Project1/venv/lib/python3.13/site-packages/passlib/crypto/scrypt/__init__.pyrr)sr 1u.2331u.233uv~!DEE1uU @1DEE cPUSU-SUS--[---n[XC-5nU$)a# calculate memory required for parameter combination. assumes parameters have already been validated. .. warning:: this is derived from OpenSSL's scrypt maxmem formula; and may not be correct for other implementations (additional buffers, different parallelism tradeoffs, etc). r ) UINT32_SIZEint)rrrfudgemaxmems restimate_maxmemrHs5"#'B!a%L;66 7F  F Mrc[X#U5 [USS9n[USS9nUS:a [S5eU[:a[S[-5e[ XX#XE5$)arun SCrypt key derivation function using specified parameters. :arg secret: passphrase string (unicode is encoded to bytes using utf-8). :arg salt: salt string (unicode is encoded to bytes using utf-8). :arg n: integer 'N' parameter :arg r: integer 'r' parameter :arg p: integer 'p' parameter :arg keylen: number of bytes of key to generate. defaults to 32 (the internal block size). :returns: a *keylen*-sized bytes instance SCrypt imposes a number of constraints on it's input parameters: * ``r * p < 2**30`` -- due to a limitation of PBKDF2-HMAC-SHA256. * ``keylen < (2**32 - 1) * 32`` -- due to a limitation of PBKDF2-HMAC-SHA256. * ``n`` must a be a power of 2, and > 1 -- internal limitation of scrypt() implementation :raises ValueError: if the provided parameters are invalid (see constraints above). .. warning:: Unless the third-party ``scrypt ``_ package is installed, passlib will use a builtin pure-python implementation of scrypt, which is *considerably* slower (and thus requires a much lower / less secure ``n`` value in order to be usuable). Installing the :mod:`!scrypt` package is strongly recommended. secret)paramsaltr zkeylen must be at least 1zkeylen too large, must be <= %d)rrr MAX_KEYLEN_scrypt)rr!rrrkeylens rr r ksbR Q1 fH -F D 'D z455 :ZGHH 6q 11rc~[(aSOSn[SU-[R5 SSKJn UR $)z< Load pure-python scrypt implementation built into passlib. dzUsing builtin scrypt backend, which is %dx slower than is required for adequate security. Installing scrypt support (via 'pip install scrypt') is strongly recommendedr ) ScryptEngine)rrrPasslibSecurityWarning_builtinr(execute)slowdownr(s r_load_builtin_backendr-s?TrsH #%- ./2/I/IK'   rcSSKJn U$![a Of=fSSKn[S[R 5 g![a3nS[ U5;a[S[R 5 SnAgSnAff=f)z Try to import the ctypes-based scrypt hash function provided by the ``scrypt ``_ package. r)hashNz5'scrypt' package is too old (lacks ``hash()`` method)r zJ'scrypt' package failed to import correctly (possible installation issue?))r r/ ImportErrorrrPasslibWarningstr)r/r errs r_load_cffi_backendr4sz       Z DcFXFXY  % 3s8 # ]## % %s! : A7)A22A7cB^SSKJm U4SjnU$![a gf=f)zZ Attempt to load stdlib scrypt() implement and return wrapper. Returns None if not found. r)r Nc F>[nUS:a [X#U5nT"XX#XEUS9$)Nr)passwordr!rrrdklenr) SCRYPT_MAXMEMr)rr!rrrr$r stdlib_scrypts rstdlib_scrypt_wrapper3_load_stdlib_backend..stdlib_scrypt_wrappers3 A:$Q1-Ff1Q$*, ,r)hashlibr r0)r;r:s @r_load_stdlib_backendr>s, 3,$ ! + s  )stdlibr builtincjUS:XagUS:Xa-[H n[XS9s $ [R"S5e[R U5nU(d[ SU<35eU"5nU(d[R"SU-5eU(agUqUqg![Ra Mf=f)z set backend for scrypt(). if name not specified, loads first available. :raises ~passlib.exc.MissingBackendError: if backend can't be found .. note:: mainly intended to be called by unittests, and scrypt hash handler anyNdefaultdryrunzno scrypt backends availablezunknown scrypt backend: zscrypt backend %r not available) backend_values _set_backendrMissingBackendError_backend_loadersgetrbackendr#)namerEloaderr/s rrGrGs u}  "D #D88# %%&DEE!%%d+TCD Dx))*Kd*RS S  **  sBB21B2rCcN[USS9 g![Ra gf=f)NTrDF)rGrrH)rLs r _has_backendrOs,T$'  " "s $$)g?)r r)F)!__doc__ __future__rlogging getLogger__name__logwarningsrpasslibr passlib.utilsrpasslib.utils.compatr__all__r9r"rrrrr#rKr r-r4r>rFdictrIrGrOrrr]s'g''1"%   "  8 <  02f  2!B1   !> Yr