+ Bi Rt^RIt^RIt^RIHt]P Uu/uF(pV]!]V]P]PV44bK* upt ^RI t ] PRUu/uFpV]!] VR4bK up4] P4UUu/uF wrVfK WbK uppt RRltRtR RltR RltR#uupiuupiuuppi ] dL-i;i) z' Calculating and checking file hashes. N)Pathc V\9d.\RV R\\P44 R24hRpV\P 9d\V,!RR7M\V,!4p\ VR4;_uu_4pVPV4pV'd%VPV4VPV4pK,RRR4VP4# +'giTP4#;i) a  Calculate the hash of a given file. Useful for checking if a file has changed or been corrupted. Parameters ---------- fname : str The name of the file. alg : str The type of the hashing algorithm Returns ------- hash : str The hash of the file. Examples -------- >>> fname = "test-file-for-hash.txt" >>> with open(fname, "w") as f: ... __ = f.write("content of the file") >>> print(file_hash(fname)) 0fc74468e6a9a829f103d069aeb2bb4f8646bad58bf146bb0e3379b759ec4a00 >>> import os >>> os.remove(fname) z Algorithm 'zR' not available to the pooch library. Only the following algorithms are available .iF)usedforsecurityrbN) ALGORITHMS_AVAILABLE ValueErrorlistkeyshashlibalgorithms_availableopenreadupdate hexdigest)fnamealg chunksizehasherfinbuffs&& J/var/www/html/photoedit/myenv/lib/python3.14/site-packages/pooch/hashes.py file_hashr+s< &&#;(--/01 4  I '.. . S!%8 !# & ( eT  cxx " MM$ 88I&D           s C!$$C!! D cRpVfTpVP4#RV9dTpVP4#VPR4^,pVP4#)az Parse the name of the hash method from the hash string. The hash string should have the following form ``algorithm:hash``, where algorithm can be the name of any algorithm known to :mod:`hashlib`. If the algorithm is omitted or the hash string is None, will default to ``"sha256"``. Parameters ---------- hash_string : str The hash string with optional algorithm prepended. Returns ------- hash_algorithm : str The name of the algorithm. Examples -------- >>> print(hash_algorithm("qouuwhwd2j192y1lb1iwgowdj2898wd2d9")) sha256 >>> print(hash_algorithm("md5:qouuwhwd2j192y1lb1iwgowdj2898wd2d9")) md5 >>> print(hash_algorithm("sha256:qouuwhwd2j192y1lb1iwgowdj2898wd2d9")) sha256 >>> print(hash_algorithm("SHA256:qouuwhwd2j192y1lb1iwgowdj2898wd2d9")) sha256 >>> print(hash_algorithm("xxh3_64:qouuwhwd2j192y1lb1iwgowdj2898wd2d9")) xxh3_64 >>> print(hash_algorithm(None)) sha256 sha256:)splitlower) hash_stringdefault algorithms& rhash_algorithmr!`sfJG ??  K   ??  %%c*1- ?? c 6VfR#\V4p\WR7pVP4VPR4R,P48HpV'd=V'g5Vf \ V4p\ VP 4 RV RV RV R24hV#) a Check if the hash of a file matches a known hash. If the *known_hash* is None, will always return True. Coverts hashes to lowercase before comparison to avoid system specific mismatches between hashes in the registry and computed hashes. Parameters ---------- fname : str or PathLike The path to the file. known_hash : str The known hash. Optionally, prepend ``alg:`` to the hash to specify the hashing algorithm. Default is SHA256. strict : bool If True, will raise a :class:`ValueError` if the hash does not match informing the user that the file may be corrupted. source : str The source of the downloaded file (name or URL, for example). Will be used in the error message if *strict* is True. Has no other use other than reporting to the user where the file came from in case of hash mismatch. If None, will default to *fname*. Returns ------- is_same : bool True if the hash matches, False otherwise. T)rrz hash of downloaded file (z*) does not match the known hash: expected z but got zm. Deleted download for safety. The downloaded file may have been corrupted or the known hash may be outdated.)r!rrrstrrupper)r known_hashstrictsourcer new_hashmatchess&&&& r hash_matchesr,s>z*I.Hnn*"2"23"7";"A"A"CCG g >ZF !!;F8D))3 IhZH/ /  Nr"c a\S4oV'dRpMRp\V3RlSPV444pVUu.uFp\\ SV, 44NK pp\ VRRR7;_uu_4p\ WF4F6wrXVPRPVPRR 4V44K8 R R R 4R #uupi +'giR #;i) a Make a registry of files and hashes for the given directory. This is helpful if you have many files in your test dataset as it keeps you from needing to manually update the registry. Parameters ---------- directory : str Directory of the test data to put in the registry. All file names in the registry will be relative to this directory. output : str Name of the output registry file. recursive : bool If True, will recursively look for files in subdirectories of *directory*. z**/**c3<"TF7pVP4'gK\VPS44xK9 R#5i)N)is_filer% relative_to).0path directorys& r make_registry..s6+D <<> )D  Y '((+s A"Awzutf-8)encodingz{} {} \/N) rsortedglobrr%r zipwriteformatreplace) r4output recursivepatternfilesrhashesoutfilefhashs f&& r make_registryrHs&YI NN7+ E >C CUEiI-./UF C fcG , ,.LE MM)**5==s+CUK L/ - ,D , , ,s$C>AC C$ )xxh128xxh64xxh32xxh3_128xxh3_64)r)FN)T)__doc__r functoolspathlibrr getattrpartialnewrxxhashritems ImportErrorrr!r,rH)rfuncs00rrXs+++#y00cB CC+  K J d+ +J $8#=#=#?#?ic4  #?2j,^-`%M[   s;.B=C $C8C CC%C  C CC