k7iCSSKrSSKJr SrSrSrSrSrSrS r \\-\ -r \4S \ S \ S \ 4S jjr "SS\ \5rS \ S\ S\ S \ 4SjrS\\\R \4S \ S\ S\ S-S\ S\ S\S\ S \ 4SjjrS \ S\ S \ 4Sjrg)N)Enum-_abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789valuesizereturncl[R"UR55R5SU$)z&Generate a hash fragment of the value.N)hashlibsha256encode hexdigestr r s Y/home/james-whalen/.local/lib/python3.13/site-packages/key_value/shared/utils/sanitize.pygenerate_hash_fragmentrs) >>%,,. ) 3 3 5et <<c \rSrSrSrSrSrSrg)HashFragmentModealwaysneveronly_if_changedN)__name__ __module__ __qualname____firstlineno__ALWAYSNEVERONLY_IF_CHANGED__static_attributes__rrrrrs F E'Orrallowed_characters replace_withcSnSnUHnXQ;aX5- nSnMU(aMX2- nSnM! [U5S:XaU(agU$)aqReplace 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~5 r max_lengthreplacement_characterhash_fragment_separatorhash_fragment_modehash_fragment_lengthcU[:aS[3n[U5eXaS-:a Sn[U5e[XS9n[U5[U5-n U(a [ XUS9OUn U[ R :XaX- n U SU n U (dU$X-U-$U[ R:Xa%U SUn X :XaU$X- n U SU n U (dU$X-U-$U (d Sn[U5eU $)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 r0r&r1r2r3r4msg hash_fragmenthash_fragment_size_requiredsanitized_valueactual_max_lengths rsanitize_stringr>>s#.&&<=O2<<>M'+  00r)renumrr7DEFAULT_HASH_FRAGMENT_SIZEDEFAULT_HASH_FRAGMENT_SEPARATORDEFAULT_REPLACEMENT_CHARACTERLOWERCASE_ALPHABETUPPERCASE_ALPHABETNUMBERSALPHANUMERIC_CHARACTERSstrintrrr/r$r>rCrrrrNs+"% #11 ,/AAGK += = = =(sD( #UX]`B&*!>#B+;+K+K :G GGd G G ! G ) GG GT1c1s1s1r