&$ "SrSSKrSSKrSSKrSSKrSSKr\R r\Rr\R"S5r SSSSSS S S S .r \ "S 5H-r \ "\ 5r\\ ;dM\\R;dM%S\ -\ \'M/ \R"SR!\ R#5Vs/sHn\R%U5PM sn55r\"S5r\"S5r"SS\5rSrSrSrSrSrSSjrSrSr Sr!gs snf)z*Some common string manipulation utilities.Nz [^\000-\177]z\bz\tz\nz\fz\rz\"z\'z\\)    "'\z\%03o|)truet1yesy)falsef0nonc\rSrSrSrSrg)Base64ValueError1zIllegal Base64-encoded valueN)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r,platform/bq/third_party/pyglib/stringutil.pyrr1s#Ar!rc0[RSU5$)aReplaces each non-ASCII character in s with an escape sequence. Non-ASCII characters are substituted with their 6-character unicode escape sequence \uxxxx, where xxxx is a hex number. The resulting string consists entirely of ASCII characters. Existing escape sequences are unaffected, i.e., this operation is idempotent. Sample usage: >>> UnicodeEscape('asdf\xff') 'asdf\\u00ff' This escaping differs from the built-in s.encode('unicode_escape'). The built-in escape function uses hex escape sequences (e.g., '\xe9') and escapes some control characters in lower ASCII (e.g., '\x00'). Args: s: string to be escaped Returns: escaped string c<S[URS55-$)Nz\u%04xr)ordgroupms r"UnicodeEscape..JsIAGGAJ$?r!) _RE_NONASCIIsub)ss r" UnicodeEscaper.4s,   ? CCr!cF[RSU5n[U5$)aEscapes a string so it can be inserted in a Java string or char literal. Follows the Java Language Specification for "Escape Sequences for Character and String Literals": https://docs.oracle.com/javase/tutorial/java/data/characters.html Escapes unprintable and non-ASCII characters. The resulting string consists entirely of ASCII characters. This operation is NOT idempotent. Sample usage: >>> JavaEscape('single\'double"\n\x00') 'single\\\'double\\"\\n\\000' Args: s: string to be escaped Returns: escaped string c2[URS5$)Nr)_JAVA_ESCAPE_MAPr&r's r"r)JavaEscape..ds(8(Dr!)_JAVA_ESCAPE_REr,r.)r-s_escs r" JavaEscaper5Ms$.   Da H% u r!cb[R"U5nU(dURS5nU$)aPython implementation of the Google C library's WebSafeBase64Escape(). Python implementation of the Google C library's WebSafeBase64Escape() (from strings/strutil.h), using Python's base64 API and string replacement. Args: unescaped: any data (byte) string (example: b"12345~6") do_padding: whether to add =-padding (example: false) Returns: The base64 encoding (with web-safe replacements) of unescaped, with =-padding depending on the value of do_padding (example: b"MTIzNDV-Ng") =)base64urlsafe_b64encoderstrip) unescaped do_paddingescapeds r"WebSafeBase64Escaper>ts*  $ $Y /' nnT"G .r!s!!!!!!!!! !!!!!!!!!!!!!!!!!! !!!!!!!!!!!!+!!0123456789!!!=!!!ABCDEFGHIJKLMNOPQRSTUVWXYZ!!!!/!abcdefghijklmnopqrstuvwxyz!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!cTUR[5nURS5S:a[SU-5eUR S5(d[ U5S-nUSU-- n[ R"U5$![ Ran[U<SU<35eSnAff=f)aPython implementation of the Google C library's WebSafeBase64Unescape(). Python implementation of the Google C library's WebSafeBase64Unescape() (from strings/strutil.h), using Python's base64 API and string replacement. Args: escaped: A base64 binary string using the web-safe encoding (example: b"MTIzNDV-Ng") Returns: The corresponding unescaped string (example: b"12345~6") Raises: Base64ValueError: Invalid character in encoding of string, escaped. !rz(%r: Invalid character in encoded string.r7z: N) translate_BASE64_DECODE_TRANSLATIONfindrendswithlenbinascii a2b_base64Error)r=escaped_standard padding_lenmsgs r"WebSafeBase64UnescaperMs &&'AB4 A% EO PP  " "4 ( (&'!+K{**6   / 00 6 w4 556s&A<<B'B""B'c^^US:a [S5eTS::a [S5eUU4Sj[U[T5T55$)aZBreak a string into chunks of a given size. Args: value: The value to split. size: The maximum size of a chunk. start: The index at which to start (defaults to 0). Returns: Iterable over string slices of as close to the given size as possible. Chunk('hello', 2) => 'he', 'll', 'o' Raises: ValueError: If start < 0 or if size <= 0. rzinvalid starting positioninvalid chunk sizec32># UH nTXT-v M g7f)Nr).0isizevalues r" Chunk..s D%C%d( %Cs) ValueErrorrangerF)rTrSstarts`` r"ChunkrZsC QY 0 11 QY ) ** DU5#e*d%C DDr!cD^^TS::a [S5eUU4SjnU"5$)apBreak a string into chunks of a given size, starting at the rear. Like chunk, except the smallest chunk comes at the beginning. Args: value: The value to split. size: The maximum size of a chunk. Returns: Iterable over string slices of as close to the given size as possible. ReverseChunk('hello', 2) => 'h', 'el', 'lo' Raises: ValueError: If size <= 0. rrOc3># Sn[T5T-(a!TS[T5T-v [T5T-n[TTUS9HnUv M g7f)zActually perform the chunking.rN)rY)rFrZ)rYchunkrSrTs r"DoChunkReverseChunk..DoChunksV E 5zD $3u:$ %%%j4eud%0 k1sAA)rW)rTrSr^s`` r" ReverseChunkr`s'$ QY ) **  r!cUcg[U[5(d[S[U5-5eU(a%UR 5R 5[ ;$g)aChecks if the string is a commonly accepted True value. Useful if you want most strings to default to False except a few accepted values. This method is case-insensitive. Args: value: The string to check for true. Or None. Returns: True if the string is one of the commonly accepted true values. False if value is None. False otherwise. Raises: ValueError: when value is something besides a string or None. Fz5IsCommonTrue() called with %s type. Expected string.) isinstancestrrWtypestriplower_COMMON_TRUE_STRINGSrTs r" IsCommonTruerisV  ]  E3   LE{# $$ ;;=   $8 88 r!cUcg[U[5(d[S[U5-5eU(a%UR 5R 5[ ;$g)aChecks if the string is a commonly accepted False value. Useful if you want most strings to default to True except a few accepted values. This method is case-insensitive. Args: value: The string to check for true. Or None. Returns: True if the string is one of the commonly accepted false values. True if value is None. False otherwise. Raises: ValueError: when value is something besides a string or None. Tz6IsCommonFalse() called with %s type. Expected string.)rbrcrWrdrerf_COMMON_FALSE_STRINGSrhs r" IsCommonFalserlsV  ]  E3   ME{# $$ ;;=   $9 99 r!)r)"rr8rGrestringsix ensure_str ensure_binarycompiler+r1rXrRchrc printablejoinkeysescaper3 frozensetrgrk Exceptionrr.r5r>rCrMrZr`rirl)rts0r"r{s?1  ^^ !! zz/*          sA !f!1F,<,<#<"Q,Q  **SXX+00232aRYYq\2356!!?@!"@AByAD2N:(6BE,D4G4s.D