&$ dZddlZddlZddlZddlZddlZej ZejZejdZ dddddd d d d Z e d D]&Z e e Zee vseejvsde ze e<(ejdj!e j#Dcgc]}ej%|c}ZedZedZGddeZdZdZdZdZdZddZdZdZ dZ!ycc}w)z*Some common string manipulation utilities.Nz [^\000-\177]z\bz\tz\nz\fz\rz\"z\'z\\)    "'\z\%03o|)truet1yesy)falsef0nonceZdZdZy)Base64ValueErrorzIllegal Base64-encoded valueN)__name__ __module__ __qualname____doc__,platform/bq/third_party/pyglib/stringutil.pyrr1s#Arrc0tjd|S)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<dt|jdzS)Nz\u%04xr)ordgroupms rzUnicodeEscape..JsIAGGAJ$?r) _RE_NONASCIIsub)ss r UnicodeEscaper*4s,   ? CCrcFtjd|}t|S)a/Escapes 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 c2t|jdS)Nr)_JAVA_ESCAPE_MAPr#r$s rr&zJavaEscape..ds(8(Dr)_JAVA_ESCAPE_REr(r*)r)s_escs r JavaEscaper0Ms$.   Da H% u rcVtj|}|s|jd}|S)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 rWebSafeBase64Escaper9ts*  $ $Y /' nnT"G .rs!!!!!!!!! !!!!!!!!!!!!!!!!!! !!!!!!!!!!!!+!!0123456789!!!=!!!ABCDEFGHIJKLMNOPQRSTUVWXYZ!!!!/!abcdefghijklmnopqrstuvwxyz!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!c@|jt}|jddk\rtd|z|j dst |dz}|d|zz } t j|S#t j$r}t|d|d}~wwxYw)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.r2z: N) translate_BASE64_DECODE_TRANSLATIONfindrendswithlenbinascii a2b_base64Error)r8escaped_standard padding_lenmsgs rWebSafeBase64UnescaperHs &&'AB4 A% EO PP  " "4 (&'!+K{**6   / 00 6 w4 556s A55BBBc|dkr tddkr tdfdt|tDS)anBreak 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 sizec3.K|] }||zyw)Nr).0isizevalues r zChunk..s D%C%!d( %Cs) ValueErrorrangerA)rOrNstarts`` rChunkrTsC QY 0 11 QY ) ** DU5#e*d%C DDrc@dkr tdfd}|S)aBreak 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. rrJc3Kd}tzr!dtztz}t|D]}|yw)zActually perform the chunking.rN)rS)rArT)rSchunkrNrOs rDoChunkzReverseChunk..DoChunksW E 5zD $3u:$ %%%j4eud%0 k1sA A )rQ)rOrNrXs`` r ReverseChunkrYs'$ QY ) **  rc|yt|tstdt|z|r$|j j t vSy)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.) isinstancestrrQtypestriplower_COMMON_TRUE_STRINGSrOs r IsCommonTruerbsS  ]  E3  LE{# $$ ;;=   $8 88 rc|yt|tstdt|z|r$|j j t vSy)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.)r[r\rQr]r^r__COMMON_FALSE_STRINGSras r IsCommonFalseresS  ]  E3  ME{# $$ ;;=   $9 99 r)r)"rr3rBrestringsix ensure_str ensure_binarycompiler'r-rRrMchrc printablejoinkeysescaper. frozensetr`rd Exceptionrr*r0r9r>rHrTrYrbre)rms0rrtsC1  ^^ !! rzz/*          sA !f!1F,<,<#<"Q,Q  "**SXX+00232aRYYq\2356!!?@!"@AByAD2N:(6BE,D4G4s&D