2SrSSKJr SSKJr SSKJr SSKJr SSKrSSKJr SSKJ r SSK Jr SS K Jr \R"S 5r\R"S 5r"S S \ R$5r"SS\ R$5r"SS\ R$5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\\ R65r"SS\\5r"S S!\\5r"S"S#\\5r"S$S%\ R@5r!"S&S'\\ R65r"S*S(jr#S*S)jr$g)+z;API interface for interacting with cloud storage providers.)absolute_import) annotations)division)unicode_literalsN) exceptions)resource)urllibz(b/(?P.*)/o/(?P.*?)(\?|$)z`^b/(?P[a-z0-9\-_\.]+)(/)?(iam|channels|lockRetentionPolicy|iam/testPermissions|o)?(\?|$)c\rSrSrSrg) CloudApiError/N__name__ __module__ __qualname____firstlineno____static_attributes__r ,lib/googlecloudsdk/api_lib/storage/errors.pyr r /rr c\rSrSrSrg)InsightApiError3r Nrr rrrr3rrrc\rSrSrSrg)StorageBatchOperationsApiError7r Nrr rrrr7rrrc\rSrSrSrSrg)RetryableApiError;z3Error raised to indicate a transient network error.r Nrrrr__doc__rr rrrr;s;rrc\rSrSrSrSrg) NotFoundError@zError raised when the requested resource does not exist. Both GCS and S3 APIs should raise this error if a resource does not exist so that the caller can handle the error in an API agnostic manner. r Nr r rrr#r#@s  rr#c\rSrSrSrSrg)PreconditionFailedErrorJ,Raised when a precondition is not satisfied.r Nr r rrr&r&J4rr&c\rSrSrSrSrg) ConflictErrorNDRaised when a resource cannot be created because one already exists.r Nr r rrr+r+NLrr+c\rSrSrSrSrg)ResumableUploadAbortErrorRz5Raised when a resumable upload needs to be restarted.r Nr r rrr0r0Rs=rr0c,\rSrSrSr\SSj5rSrg) GcsApiErrorWzBase class for GCS API errors.c[US5(a*UR(a[URSS5$gg![a gf=f)zEReturns the status code of the error, or None if it is not available.error status_codeN)hasattrr6getattrKeyError)selfs rr7GcsApiError.status_codeZsKtW$**tzz=$77 #- s= A  A r N)returnz int | None)rrrrr!propertyr7rr rrr3r3Ws&  rr3c8^\rSrSrSrU4SjrSrSrSrU=r $)GcsNotFoundErrorfzsError raised when the requested GCS resource does not exist. Implements custom formatting to avoid messy default. cX>AA[[U] USS9 UR(dgSn[R "UR5u pV[ RU5nU(aURUU5 g[RU5nU(aURUU5 gg)Nz)HTTPError {status_code}: {status_message} error_formatz.gs://{instance_name} not found: {status_code}.) superr@__init__urlrSplitEndpointUrlOBJECT_RESOURCE_PATH_PATTERNsearch_custom_format_object_errorBUCKET_RESOURCE_PATH_PATTERN_custom_format_bucket_error) r;r6argskwargs+custom_error_format_for_buckets_and_objects_ resource_pathmatch_object_resource_pathmatch_bucket_resource_path __class__s rrFGcsNotFoundError.__init__ls f D* A+ B 99  90#33EII>Aq!=!D!D"! && $ 57 !=!D!D"! && $ 57"rcPX lURS5URlg)aSets custom error formatting for buckets resource paths. Args: match_bucket_resource_path (re.Match): Match object that contains the result of searching regex BUCKET_RESOURCE_PATH_PATTERN in a resource path. error_format (str): Custom error format for buckets. bucketN)rDgrouppayload instance_name)r;rTrDs rrM,GcsNotFoundError._custom_format_bucket_errors!%!;!A!A(!KDLLrcURn[RRU5nSU;a SUSS-nOSnX lSR UR S5UR S5U5URlg) aSets custom error formatting for object resource paths. Args: match_object_resource_path (re.Match): Match object that contains the result of searching regex OBJECT_RESOURCE_PATH_PATTERN in a resource path. error_format (str): Custom error format for objects. generation#rz{}/{}{}rXobjectN) stringr parseparse_qsrDformatrYrZr[)r;rSrDrRparamsgeneration_strings rrK,GcsNotFoundError._custom_format_object_errors/55M \\ " "= 1Fv| 4Q 77$!*!1!1"((2"((24E"GDLLrrC) rrrrr!rFrMrKr __classcell__rUs@rr@r@fs  "7H LGGrr@c\rSrSrSrSrg)GcsPreconditionFailedErrorr(r Nr r rrrlrlr)rrlc\rSrSrSrSrg)GcsConflictErrorr-r Nr r rrroror.rroc,^\rSrSrSrU4SjrSrU=r$)S3ErrorPayloadaHAllows using format strings to create strings from botocore ClientErrors. Format strings of the form '{field_name}' will be populated from class attributes. Strings of the form '{.field_name}' will be populated from the self.content JSON dump. See api_lib.util.HttpErrorPayload for more detail and sample usage. Attributes: content (dict): The dumped JSON content. message (str): The human readable error message. status_code (int): The HTTP status code number. status_description (str): The status_code description. status_message (str): Context specific status message. c>[[U] U5 [U5Ul[ US5(aUR UlSUR ;a$UR SRSS5Ul SUR ;a=UR SnURSS5Ul URSS5Ul UR5Ul g g ) zInitializes an S3ErrorPayload instance. Args: client_error (Union[botocore.exceptions.ClientError, str]): The error thrown by botocore, or a string that will be displayed as the error message. responseResponseMetadataHttpStatusCoderErrorCoder`MessageN)rErrrFstrbotocore_error_stringr8rucontentgetr7status_descriptionstatus_message_MakeGenericMessagemessage)r; client_errorr6rUs rrFS3ErrorPayload.__init__s .$(6"%\!2D|Z((!**dl |44 4'001CDHH a! L)) )%%g."'))FB"7#ii 26--/dl)r)r|r}rr7rrrrrrr!rFrrirjs@rrrrrs 00rrrc0^\rSrSrSrSU4SjjrSrU=r$) XmlApiErrorzTranslates a botocore ClientError and allows formatting. Attributes: error: The original ClientError. error_format: An S3ErrorPayload format string. payload: The S3ErrorPayload object. c2>[[U] X[S9 g)N)rD payload_class)rErrFrr)r;r6rDrUs rrFXmlApiError.__init__s +t% &Hrr )z{botocore_error_string}rrjs@rrrsHHrrcUcSnUH5unnn[X5(dMUbUbU"U5U:XdM-U"X5s $ U$)a{Translates error or returns original error if no matches. Note, an error will be translated if it is a child class of a value in translation_list. Also, translations earlier in the list take priority. Args: error (Exception): Error to translate. translation_list (list): List of (Exception, int|None, Exception) tuples. Translates errors that are instances of first error type to second if the status code of the first exception matches the integer value. If the status code argument is None, the entry will translate errors of any status code. format_str (str|None): An api_lib.util.exceptions.FormattableErrorPayload format string. Note that any properties that are accessed here are on the FormattableErrorPayload object, not the object returned from the server. status_code_getter (Exception -> int|None): Function that gets a status code from the exception type raised by the underlying client, e.g. apitools_exceptions.HttpError. If None, only entries with a null status code in `translation_list` will translate errors. Returns: Error (Exception). Translated if match. Else, original error. cg)Nr )rQs r!translate_error..s4r) isinstance)r6translation_list format_strstatus_code_getteruntranslated_erroruntranslated_status_codetranslated_errors rtranslate_errorrs_4'  %,, (  % e $(@ @ e 00  ,rc^^^UUU4SjnU$)aDecorator catches an error and raises CloudApiError with a custom message. Args: translation_list (list): List of (Exception, int|None, Exception) tuples. Translates errors that are instances of first error type to second if the status code of the first exception matches the integer value. If the status code argument is None, the entry will translate errors of any status code. format_str (str|None): An api_lib.util.exceptions.FormattableErrorPayload format string. Note that any properties that are accessed here are on the FormattableErrorPayload object, not the object returned from the server. status_code_getter (Exception -> int|None): Function that gets a status code from the exception type raised by the underlying client, e.g. apitools_exceptions.HttpError. If None, only entries with a null status code in `translation_list` will translate errors. Returns: A decorator that catches errors and raises a CloudApiError with a customizable error message. Example: @catch_error_raise_cloud_api_error( [(apitools_exceptions.HttpError, GcsApiError)], 'Error [{status_code}]') def some_func_that_might_throw_an_error(): c>^UUUU4SjnU$)Nc >T"U0UD6$![a*n[R"[UTTTS95 SnAgSnAff=f)N)rr) Exceptioncore_exceptionsreraiser)rNrOerfunctionrrs rwrapperYcatch_error_raise_cloud_api_error..translate_api_error_decorator..wrapperEsO  (((     %#5      s ? :?r )rrrrrs` rtranslate_api_error_decoratorHcatch_error_raise_cloud_api_error..translate_api_error_decoratorBs    Nrr )rrrrs``` r!catch_error_raise_cloud_api_errorr%s:( '&r)NN)%r! __future__rrrrregooglecloudsdk.api_lib.utilrapi_exceptionsrgooglecloudsdk.corer six.movesr compilerIrLrxr rrrr#r&r+r0 HttpExceptionr3r@rlroFormattableErrorPayloadrrrrrr rrrsJB&"' D0= "zz/ 1 "zz% & O))o++_%:%:  M5m5MMM  -!=!= NG{MNGb5.E5M{MM%0^;;%0P H-!=!= H(BF(X;?1'r