_4SrSSKJr SSKJr SSKJr SSKJr SSKJ r SSKJ r SSKJ r SSKJr SSK Jr SS K Jr SS KJr SS Kr"S S \R$5r"SS\5rSrSrSrS"SjrSrSrSrSrS#SjrS#SjrSrS$Sjr\ R@RB4Sjr"S \ R@RBSS S 4Sjr#S"Sjr$S r%S!r&g )%z/Library for obtaining API clients and messages.)absolute_import)division)unicode_literals) exceptions)api_enablement) apis_internal) apis_util) properties)apis_mapNc\rSrSrSrSrg)Error#z$A base class for apis helper errors.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r'lib/googlecloudsdk/api_lib/util/apis.pyr r #s,rr c,^\rSrSrSrU4SjrSrU=r$)GapicRestUnsupportedError(z=An error for the unsupported REST transport on GAPIC Clients.c,>[[U] S5 g)Nz5REST transport is not yet supported for GAPIC Clients)superr__init__)self __class__s rr"GapicRestUnsupportedError.__init__+s ! NOrr)rrrrrrr __classcell__)rs@rrr(sEPPrrc[R"UR5H0up[R"U5Hup4[XU5 M M2 gN)six iteritemsMAP _AddToApisMap)unreleased_apis_mapapi_name api_versions api_versionapi_defs rAddUnreleasedAPIsr-1s@ # .A.E.E Fh # l ; H73!<!Grc[R"U5up[RR U05nU(+UlX$U'U[RU'g)aAdds the APIDef specified by the given arguments to the APIs map. This method should only be used for runtime patching of the APIs map. Additions to the map should ensure that there is only one and only one default version for each API. Args: api_name: str, The API name (or the command surface name, if different). api_version: str, The version of the API. api_def: APIDef for the API version. N)r_GetApiNameAndAliasr r&getdefault_version)r)r+r,_r*s rr'r'8sO11(;+(!!(B/, ,,'%{'(,,xrc.[R"U5$)zReturn available versions for given api. Args: api_name: str, The API name (or the command surface name, if different). Raises: UnknownAPIError: If api_name does not exist in the APIs map. Returns: list, of version names. )r _GetVersions)r)s r GetVersionsr5Ps  # #H --rc[R"U5upU[R;a[R "U5e[ RRR5nSnU(a!URSRX!5S5nU(dURX!5nU=(d [R"U5$)a=Resolves the version for an API based on the APIs map and API overrides. Args: api_name: str, The API name (or the command surface name, if different). api_version: str, The API version. Raises: apis_internal.UnknownAPIError: If api_name does not exist in the APIs map. Returns: str, The resolved version. Nz{}/{}) rr/r r&r UnknownAPIErrorr VALUESapi_client_overrides AllValuesr0format_GetDefaultVersion)r)r+api_name_aliasversion_overridesapi_version_overrides rResolveVersionr@`s+>>xH( X\\!  # #H -- ''<<FFH,00~3T; ,00M  5  * *8 46rii<c[R"U5nURR[:wag[ R "URR5nU(aX!4-$g)agReturns the API Enablement info or None if prompting is not necessary. Args: exception (apitools_exceptions.HttpError): Exception if an error occurred. Returns: tuple[str]: The project, service token, exception tuple to be used for prompting to enable the API. Raises: api_exceptions.HttpException: If gcloud should not prompt to enable the API. N)api_exceptions HttpExceptionpayload status_code)API_ENABLEMENT_ERROR_EXPECTED_STATUS_CODErGetApiEnablementInfostatus_message) exception parsed_errorenablement_infos rrHrHs^ --i8,&&/0 "77))+/ _ ,, rFc|[R"X5nU(aU(d[R"S5egUe)aPrompts to enable the API and throws if the answer is no. Args: project (str): The project that the API is not enabled on. service_token (str): The service token of the API to prompt for. exception (api_Exceptions.HttpException): Exception to throw if the prompt is denied. is_batch_request: If the request is a batch request. This determines how to get apitools to retry the request. Raises: api_exceptions.HttpException: API not enabled error if the user chooses to not enable the API. RetryN)rPromptToEnableApiapitools_exceptions RequestError)project service_tokenrJis_batch_requestapi_enable_attempteds rrOrOs; (99    , ,W 55  Orc.^^^SS0mUU4SjmU4SjnU$)z+Returns a callback for checking API errors.already_prompted_to_enableFc>[U5nU(a5TS(dT(a[R"S5eSTS'[U6 gg)NrWrNT)rHrPrQrO)response_as_errorrLskip_activation_promptstates r_CheckForApiEnablementError2CheckResponse.._CheckForApiEnablementErrorsH ++<=O + ,0F!..w77,0e ()) rc>Uc#[R"SUR-5eUR[:XauUR (aUR [ :agUR (a[RRU5e[RRU5eURS:a[RRU5eUR (a[RRU5e[RRU5n[RRRR5(a T"U5 gg)a@Checks API error. If it's an enablement error, prompt to enable & retry. If it's a resource exhausted error, no retry & return. Args: response: response that had an error. Raises: apitools_exceptions.RequestError: error which should signal apitools to retry. api_exceptions.HttpException: the parsed error. Nz,Request to url %s did not return a response.i)rPrQ request_urlrFRESOURCE_EXHAUSTED_STATUS_CODE retry_afterMAX_RETRY_DELAY_SECRetryAfterError FromResponseBadStatusCodeError HttpErrorr r8coreshould_prompt_to_enable_apiGetBool)responserYr\s r_CheckResponse%CheckResponse.._CheckResponses   , , 88;O;O O    !? ?   ("6"69L"L   !11>>xHH!44AA(KK    $  2 2 ? ? II     / / < -)**/// # %%..0+  . .1 -!;-  rc2[R"UUU5$)z)Returns effective endpoint for given api.)r_GetEffectiveApiEndpoint)r)r+ client_classs rGetEffectiveApiEndpointrhs  / /0;0< >>rcl[R"X5n[URRS/S9$)aReturns the messages module for the API specified in the args. Args: api_name: str, The API name (or the command surface name, if different). api_version: str, The version of the API. Returns: Module containing the definitions of messages for the specified API. something)fromlist)r GetApiDef __import__apitoolsmessages_full_modulepath)r)r+r,s rGetMessagesModulerps6  # #H :' G$$==)] ,,rc.[R"U5$r#)rUniversifyAddress)addresss rrrs  ( ( 11rr#)F)FNF)'r __future__rrrapitools.base.pyrrPgooglecloudsdk.api_lib.utilrrr rCrr %googlecloudsdk.generated_clients.apisr r$r rr-r'r5r@rGr`rbrHrOrmrprurxGRPCr|rrrrrrrrs 6&'>651D**: J   PP4(0 . 6B-0)!$4(-29x >"  @#,":":"?"?94&&++#.b>,$2r