TSrSSKJr SSKrSSKrSSKrSSKJr SSKJr SSK J r SSK J r SSK Jr SS K Jr "S S \R 5rS rS rSrSSjrSSSjjrSSSjjrSSjrSrSrSrSrg)z'Hashing utilities for storage commands.) annotationsN)errors)fast_crc32c_util)log) installers)files)hashingc \rSrSrSrSrSrSrg) HashAlgorithmz&Algorithms available for hashing data.md5crc32cN)__name__ __module__ __qualname____firstlineno____doc__MD5CRC32C__static_attributes__r3lib/googlecloudsdk/command_lib/storage/hash_util.pyr r s. # &rr cH[R"U5RSS9$)z.Takes bytes and returns base64-encoded string.utf-8)encoding)base64 b64encodedecode) hash_bytess rget_base64_stringr!&s!   * % , ,g , >>rcPURS5n[R"U5$)z.Takes base64-encoded string and returns bytes.r)encoder b64decode) hash_stringr s rget_bytes_from_base64_stringr&+s#!!'**   * %%rc4[UR55$)zATakes hashlib object and returns base64-encoded digest as string.)r!digest) hash_objects rget_base64_hash_digest_stringr*1s ;--/ 00rcU[R:Xa[R"5$U[R:Xa[ R "5$g)z3Returns a hash object for the given hash algorithm.N)r rr get_md5rr get_crc32c)hash_algorithms rget_hash_objectr/6s=}((( ?? }+++  & & (( rc[U[R5(a UcSOUnUcSOX4- nURXUS9 U$)z?Returns the hash for the given path and deferred crc32c object.r)offsetlength) isinstancerDeferredCrc32csum_file)pathr)startstopr1r2s r_get_hash_for_deferred_crc32cr9?sI -<<==-QUF,QDMFV< rc[U5nUcg[U[R5(a [ XX45$UR U5 U$)aOReturns the hash object for the given data chunk or file. For MD5 and FastCRC32C, this function will return a hash object after hashing the given data chunk. For DeferredCRC32C, this function will return the deferred hash object from the given file path. Args: path (str): The file path. data (bytes): The data chunk to hash. hash_algorithm (HashAlgorithm): The algorithm to use for hashing. start (int|None): Optional byte index to start hashing from. stop (int|None): Optional byte index to stop hashing at. Returns: A hash object or None if the algorithm is not supported. N)r/r3rr4r9update)r6datar.r7r8r)s r get_hash_from_data_chunk_or_filer=MsL& /+  -<<== (E HH T rc[U5nUcg[U[R5(a [ XX#5$[ R "U5nU(aURU5 U(aUR5U:aOUb%UR5[R-U:a[RnOX5R5- nURU5nU(dO9[U[5(aURS5nURU5 MSSS5 U$!,(df  U$=f)a=Reads file and returns its hash object. core.util.files.Checksum does similar things but is different enough to merit this function. The primary differences are that this function: -Uses a FIPS-safe MD5 object. -Accomodates gcloud_crc32c, which uses a Go binary for hashing. -Supports start and end index to set byte range for hashing. Args: path (str): File to read. hash_algorithm (HashAlgorithm): Algorithm to hash file with. start (int|None): Byte index to start hashing at. stop (int|None): Stop hashing at this byte index. Returns: Hash object for file. Nr)r/r3rr4r9rBinaryFileReaderseektellrWRITE_BUFFER_SIZEreadstrr#r;)r6r.r7r8r)stream bytes_to_readr<s rget_hash_from_filerGis$ /+  -<<== (E HH d#v  kk%  &++-4'  )E)EEL"44 {{}, [[ 'd  D#  {{7#% $. /$#. s CD.. D=c X:wa[U5n[U5n[R"SUU[R"U5R S5U[R"U5R S55 [R"SRXU55eg![ a [R"SUUU5 NLf=f)zConfirms hashes match for copied objects. Args: object_path (str): URL of object being validated. source_hash (str): Hash of source object. destination_hash (str): Hash of destination object. Raises: HashMismatchError: Hashes are not equal. zFHash mismatch for %s. Source hash (%s): %s, Destination hash (%s): %s.asciizMHash mismatch for %s and could not decode hashes. Source: %s, Destination: %sz@Source hash {} does not match destination hash {} for object {}.N) r&rdebugbinasciihexlifyr ExceptionrHashMismatchErrorformat) object_path source_hashdestination_hashsource_hash_bytesdestination_hash_bytess rvalidate_object_hashes_matchrUs$6{C;Clears the data from every hash object in a dict of digesters.z-Unknown hash algorithm found in digesters: {}N) r rr r,rrr-rErrorrO)rXr.s rreset_digestersr`sg!n***")//"3i =// /"2"="="?i LL 9 @ @ P  "r)r.r )NN)r6rDr)zfast_crc32c_util.DeferredCrc32creturnz int | None)r6rDr<bytesr.r )r __future__rrrKenum"googlecloudsdk.command_lib.storagerrgooglecloudsdk.corergooglecloudsdk.core.updaterrgooglecloudsdk.core.utilrr Enumr r!r&r*r/r9r=rGrUrYr]r`rrrrjs."  5?#2*,DII? & 1     0   MQ ,980f"NJ  r