3SrSSKJr SSKJr SSKJr SSKJr SSKrSSKrSSKrSSK r SSK r SSK r SSK r SSK r SSKrSSKrSSKrSSKJr SSKJr SS KJr SS KJr SS KJr SS KJr SS KJr \R:(a\rSSSSSSS.r \"S5r!Sr"Sr#Sr$Sr%Sr&Sr'Sr(Sr)Sr*Sr+Sr,S r-S!r.S"r/S#r0S$r1S&S%jr2g)'z\d+)(\.(?P\d+)(?P.*))?)recompile(platform/gsutil/gslib/utils/text_util.pyr 8sBJJF Grc V[RRU5up4pVn[RRUSS9nUR X45 SR UV V s/sHupU <SU <3PM sn n 5n [RR X4X[U45n U $s sn n f)aiAdds a query parameter to a URL string. Appends a query parameter to the query string portion of a url. If a parameter with the given name was already present, it is not removed; the new name/value pair will be appended to the end of the query string. It is assumed that all arguments will be of type `str` (either ASCII or UTF-8 encoded) or `unicode`. Note that this method performs no URL-encoding. It is the caller's responsibility to ensure proper URL encoding of the entire URL; i.e. if the URL is already URL-encoded, you should pass in URL-encoded values for param_name and param_value. If the URL is not URL-encoded, you should not pass in URL-encoded parameters; instead, you could perform URL-encoding using the URL string returned from this function. Args: url_str: (str or unicode) String representing the URL. param_name: (str or unicode) String key of the query parameter. param_value: (str or unicode) String value of the query parameter. Returns: (str or unicode) A string representing the modified url, of type `unicode` if the url_str argument was a `unicode`, otherwise a `str` encoded in UTF-8. T)keep_blank_values&=)rparseurlsplit parse_qslappendjoin urlunsplit) url_str param_name param_valueschemenetlocpath query_strfragment query_paramskv new_query_strnew_urls rAddQueryParamToUrlr8;s0/5ll.C.CG.L+&$8'' T'J,z/0((<H<!q!,<HI- LL # # tH5 7' . Is$B% c[5R[U55n[5R[U55nU(aU(dg[UR S55nUR S5(a[UR S55OSnUR S5n[UR S55nUR S5(a[UR S55OSnUR S5n XG:agXG:Xa&XX:agXX:Xa[ U 5=(a U(+S4$g) aRCompares the first and second gsutil version strings. For example, 3.33 > 3.7, and 4.1 is a greater major version than 3.33. Does not handle multiple periods (e.g. 3.3.4) or complicated suffixes (e.g., 3.3RC4 vs. 3.3RC5). A version string with a suffix is treated as less than its non-suffix counterpart (e.g. 3.32 > 3.32pre). Args: first: First gsutil version string. second: Second gsutil version string. Returns: (g, m): g is True if first known to be greater than second, else False. m is True if first known to be greater by at least 1 major version, else False. )FFmajminrsuffix)TT)TFF)VERSION_MATCHERmatchstrintgroupbool) firstsecondm1m2 major_ver1 minor_ver1 suffix_ver1 major_ver2 minor_ver2 suffix_ver2s rCompareVersionsrM^s$s5z*"s6{+" 2 288E?#*')xxs288E?#A*"+288E?#*')xxs288E?#A*"+    !;3 OU ;; rc#,# UH nSU-v M g7f)z:A generator that adds '**' to each url string in url_strs.z%s**Nr)url_strsr+s rConvertRecursiveToFlatWildcardrPsg 7 sc[R"[U5SSRS55n[R "U5$)a*Decodes an encoded python long into an ASCII string. This is used for modeling S3 version_id's as apitools generation. Args: long_to_convert: long to convert to ASCII string. If this is already a string, it is simply returned. Returns: String decoded from the input long. NL)binascii unhexlifyhexrstripsix ensure_str)long_to_convertunhexeds rDecodeLongAsStringr\s:   s?3AB7>>sC D'   rcp[R"[R"U5S5n[ US5$)aEncodes an ASCII string as a python long. This is used for modeling S3 version_id's as apitools generation. Because python longs can be arbitrarily large, this works. Args: string_to_convert: ASCII string to convert to a long. Returns: Long that represents the input string. hex_codec)codecsencoderX ensure_binarylong)string_to_convert hex_bytestrs rEncodeStringAsLongrfs/ c//0ABKP+ k2 rc[(a[R"U[5$[R"U[5$)apAttempts to detect Windows CP1252 encoding and convert to UTF8. Windows doesn't provide a way to set UTF-8 for string encodings; you can set the system locale (see http://windows.microsoft.com/en-us/windows/change-system-locale#1TC=windows-7) but that takes you to a "Change system locale" dropdown that just lists languages (e.g., "English (United States)". Instead, we're forced to check if a encoding as UTF8 raises an exception and if so, try converting from CP1252 to Unicode. Args: input_str: (str or bytes) The input string. Returns: (unicode) The converted string or the original, if conversion wasn't needed. )rrX ensure_textr r  input_strs rFixWindowsEncodingIfNeededrks+ Y ??9l 33 ??9d ++rc[R"U5R[5=(d [R"UR5$)z8Returns a short Unicode string describing the exception.)rX text_typerar __class__)excs rGetPrintableExceptionStringrps. s  " "4 ( HCMM#--,HHrcH[SU55(d [U5eg)aQEnsures that the string passed in consists of only ASCII values. Args: string: Union[str, unicode, bytes] Text that will be checked for ASCII values. message: Union[str, unicode, bytes] Error message, passed into the exception, in the event that the check on `string` fails. Returns: None Raises: CommandException c3># UHn[U5S:v M g7f)N)ord).0cs r InsistAscii..s *6aSVc\6sN)allr )stringmessages r InsistAsciir|s% *6 * * * 7 ## +rc"[USU-5 g)zChecks for ASCII-only characters in `header`. Also constructs an error message using `header` if the check fails. Args: header: Union[str, binary, unicode] Text being checked for ASCII values. Returns: None zInvalid non-ASCII header (%s).N)r|)headers rInsistAsciiHeaderrsf6?@rc@[US[U5<SU<S35 g)a+Checks for ASCII-only characters in `value`. Also constructs an error message using `header` and `value` if the check fails. Args: header: Header name, only used in error message in case of an exception. value: Union[str, binary, unicode] Text being checked for ASCII values. Returns: None zInvalid non-ASCII value (z) was provided for header z^. Only ASCII characters are allowed in headers other than x-goog-meta- and x-amz-meta- headersN)r|repr)r~values rInsistAsciiHeaderValuers  $E{F45rc4US:waUS:wa [U5egg)a=Ensures that the value passed in consists of only "on" or "off" Args: value: (unicode) Unicode string that will be checked for correct text. message: Union[str, unicode, bytes] Error message passed into the exception in the event that the check on value fails. Returns: None Raises: CommandException onoffNr )rr{s r InsistOnOrOffrs# d]u~ 7 ##&]rcLUR5nU[;a [UnU$)aReturns a normalized form of the given storage class name. Converts the given string to uppercase and expands valid abbreviations to full storage class names (e.g 'std' would return 'STANDARD'). Note that this method does not check if the given storage class is valid. Args: sc: (str) String representing the storage class's full name or abbreviation. Returns: (str) A string representing the full name of the given storage class. )upper$STORAGE_CLASS_SHORTHAND_TO_FULL_NAME)scs rNormalizeStorageClassrs' xxz" // -b 1B )rcU$)aReturn an UTF8-encoded string type, or None if `input_val` is None. Args: input_val: (unicode, str, or None) A string-like object or None. This method simply calls encode() on `input_val` if it is not None; if `input_val` is not of type "unicode", this will implicitly call decode() with the default encoding for strings (for Python 2, this is ASCII), then call encode(). Returns: (str) A UTF-8 encoded string, or None. r) input_vals r PrintableStrr's  rcSnSnU"S0UD6upEn[R"U5n[R"U5nU"U6nURU5nXu- n[Xg5 g)zA Python 2/3 compatible analogue to the print function. This function writes text to a file descriptor as the builtin print function would, favoring unicode encoding. Aguments and return values are the same as documented in the Python 2 print function. c ,[R"SSS[R4/5nUR 5HHup#X!;a:Sn[ UR USRUR5555eX1U'MJ UR5$)aValidates keyword arguments that would be used in Print Valid keyword arguments, mirroring print(), are 'sep', 'end', and 'file'. These must be of types string, string, and file / file interface respectively. Returns the above kwargs of the above types. )sep )end filez9{} is not a valid keyword argument. Please use one of: {}r) collections OrderedDictsysstdoutitemsKeyErrorformatr)keysvalues)kwargsexpected_keywordskeyr error_msgs r _get_argsprint_to_fd.._get_argsAs$//}28#**1E1GHlln  %- y''(+1B1G1G1I(JLM M"'#%  # # %%rc>/nUHn[U[R[R45(d [ U5n[U[R5(aUR U5 MoUR [R "U55 M U$)zCGets a `bytes` string for each item in a list of printable objects.) isinstancerX binary_typermr?r(rb)objects byte_objectsitems r_get_byte_strings&print_to_fd.._get_byte_stringsXsxL s > ? ?4y D#// * *D! C--d34 rNr)rXrbr) write_to_fd)rrrrrrrdatas r print_to_fdr7se&."&v&.#D ## ## G $$ $$+$ drcT[R(aURU5 g[U[5(a[ US5(aSUR ;d[U[R5(aURU5 g[ US5(aURRU5 gUR[R"U55 gSUR ;a&UR[R"U55 gURU5 g)zGWrite given data to given file descriptor, doing any conversions neededNmodebbuffer) rXPY2writerbyteshasattrrioBytesIOrrhrb)fdrs rrrrsWWHHTN eFrww:b"**3M3Mhhtn X  iioodhhst$% bgg~HHS  t $%HHTNrc2[R"SSU5$)z4Returns the input string with all \n and \r removed.z[\r\n])rsubris rRemoveCRLFFromStringrs  2y ))rc [R"U5 [[U5Vs/sH'n[R"[ R 5PM) sn5n[R"U5n[R"5 U$s snf)aVGenerates binary string representation of a list of ASCII characters. Args: size: Integer quantity of characters to generate. seed: A seed may be specified for deterministic behavior. Int 0 is used as the default value. Returns: Binary encoded string representation of a list of characters of length equal to size argument. ) randomseedr?rchoicerz ascii_lettersrXrb)sizer_contentss rget_random_ascii_charsrs` ++d uT{K{!&-- 4 45{K L(   x ((++- /Ls.B )r)3__doc__ __future__rrrrrTr`osrrrlocalerrrXrz six.movesrrgslib.exceptionr gslib.lazy_wrapperr gslib.utils.constantsr r gslib.utils.system_utilrPY3r@rcrr=r8rMrPr\rfrkrpr|rrrrrrrrrrrrrsC&%'  ,*&.-77 $  )    ($GI F'T ! $,,I $& A5($$ *  8v&* r