%,,.. ) ) 3 3 5 5ete <<ceZdZdZdZdZdS)HashFragmentModealwaysneveronly_if_changedN)__name__ __module__ __qualname__ALWAYSNEVERONLY_IF_CHANGEDrrrrs F E'OOOrrallowed_characters replace_withcrd}d}|D]}||vr||z }d}|r||z }d}t|dkr|rdS|S)aReplace characters in a string. If multiple characters are in a row that are not allowed, only the first one will be replaced. The rest will be removed. If all characters are not allowed, an empty string will be returned. Args: value: The value to replace characters in. to_replace: The characters to replace. replace_with: The characters to replace with. FT)len)r r$r% new_valuelast_char_was_replacedchars rsanitize_characters_in_stringr-"s}I" * * % % %  I%* " "%   %I%) " " 9~~5r r max_lengthreplacement_characterhash_fragment_separatorhash_fragment_modehash_fragment_lengthc|tkrdt}t|||dzkrd}t|t||}t|t|z} |rt |||n|} |t jkr|| z } | d| } | s|S| |z|zS|t jkr-| d|} || kr|S|| z } | d| } | s|S| |z|zS| sd}t|| S)aSanitize the value, replacing characters and optionally adding a fragment a hash of the value if requested. If the entire value is sanitized and hash_fragment_mode is HashFragmentMode.ALWAYS or HashFragmentMode.ONLY_IF_CHANGED, the value returned will be the hash fragment only. If the entire value is sanitized and hash_fragment_mode is HashFragmentMode.NEVER, an error will be raised. Args: value: The value to sanitize. allowed_characters: The allowed characters in the value. max_length: The maximum length of the value (with the hash fragment added). hash_fragment_separator: The separator to add between the value and the hash fragment. hash_fragment_mode: The mode to add the hash fragment. z,max_length must be greater than or equal to zEhash_fragment_length must be less than or equal to half of max_lengthr)r r$r%NzKEntire value was sanitized and hash_fragment_mode is HashFragmentMode.NEVER)MINIMUM_MAX_LENGTH ValueErrorrr)r-rr r") r r.r$r/r0r1r2msg hash_fragmenthash_fragment_size_requiredsanitized_valueactual_max_lengths rsanitize_stringr<@sw0&&&Q=OQQoojAo--Uoo/eBVWWWM'*+B'C'Cc-FXFX'X  %EFXg|}}}} -444&)DD)*<+<*<= ! !88=HH-===)+:+6 O # #L&)DD)*<+<*<= ! !88=HH [oo rc|tkrdt}t|t||kr|S|d|dz }tj|}|dd}||zS)aHash part of the value if it exceeds the maximum length. This operation will truncate the value to the maximum length minus 8 characters and will swap the last 8 characters with the first 8 characters of the generated hash. Args: value: The value to hash. max_length: The maximum length of the value. Must be greater than 32. Returns: The hashed value if the value exceeds the maximum length, otherwise the original value. z max_length must be greater than Nr)r5r6r)rrrr)r r.r7truncated_value hash_of_valuefirst_eight_of_hashs rhash_excess_lengthrAs'''E1CEEoo 5zzZ ,j1n,-ON5<<>>22<<>>M'+ 0 00r)renumr)key_value.shared.type_checking.bear_sprayrr5DEFAULT_HASH_FRAGMENT_SIZEDEFAULT_HASH_FRAGMENT_SEPARATORDEFAULT_REPLACEMENT_CHARACTERLOWERCASE_ALPHABETUPPERCASE_ALPHABETNUMBERSALPHANUMERIC_CHARACTERSstrintrrr-r"r<rAr#rrrMsBBBBBB"% #11 ,/AAGK +== = = ====(((((sD((( #UX]`<&*!>#B+;+K :GG GGd G G ! G ) GG GGGGT1c1s1s111111r