U ڲg%@sdZddlmZdZddddgZddlmZdd lZdd lZdd l m Z dd l m Z dd l mZdd lmZdd lZdd lZdd lZdd lZdd lZdd lZdd lZdd lZdd lZdd lmZddlmZddl m!Z!dd l"Z"dd l#Z#z dd l$Z$Wne%k rd Z$YnXzddl&m'Z'dZ(Wne%k r>dZ(YnXddl)m*Z*m+Z+ddl,m-Z-m.Z.ddl/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5ddl6m7Z7m8Z8m9Z9m:Z:m;Z;mm?Z?m@Z@mAZAddlBmCZCde"_DeEeFZGeHdZIeHdZJdZKeKZLdZMdZNeOdd d!gZPd"d#d$d%d&ZQd'd(d)ZRd*d+dd,ZSd-d+dd,ZTd.ZUd/ZVd0ZWd1ZXd2ZYeOd3d4d5d6gZZd+d7d8Z[Gd9d:d:e\Z]eOd;gZ^GddZ`d?dZae.d@d d d d e:d dd d d d dd dfdAdZbdBdCZcdgdDdEZddFdGZee.dd d d d d e:d d d d df dHdZfdIdJZgdKdLZhdMdNZidOdPZjdQdRZkdSdTZldUdVZmdWdXZnGdYdZdZeoZpd[d\Zqdhd_d`ZrGdadbdbeoZsdcddZtdedfZud S)izVClient for discovery based APIs. A client library for Google's discovery based APIs. )absolute_importz$jcgregorio@google.com (Joe Gregorio)buildbuild_from_documentfix_method_name key2param) OrderedDictN)BytesGenerator) MIMEMultipart)MIMENonMultipart)MutualTLSChannelError)mtls)service_account)universeTF)_auth mimeparse)_add_query_parameter positional) HttpErrorInvalidJsonErrorMediaUploadSizeErrorUnacceptableMimeTypeErrorUnknownApiNameOrVersionUnknownFileType)BatchHttpRequestHttpMockHttpMockSequence HttpRequestMediaFileUpload MediaUpload build_http) JsonModel MediaModelRawModel)Schemasz{[^}]*}z[a-zA-Z0-9_-]+zDhttps://www.googleapis.com/discovery/v1/apis/{api}/{apiVersion}/restzAhttps://{api}.googleapis.com/$discovery/rest?version={apiVersion}z)A description of how to use this functionPUTPOSTPATCH ()ZKBZMBZGBZTBzThe request body.object) descriptiontypezOThe filename of the media request body, or an instance of a MediaUpload object.string)r-r.requiredzPThe MIME type of the media request body, or an instance of a MediaUpload object.) pageToken nextPageToken!GOOGLE_API_USE_CLIENT_CERTIFICATEGOOGLE_API_USE_MTLS_ENDPOINTGOOGLE_CLOUD_UNIVERSE_DOMAINzgoogleapis.comtraceppZuseripstrictquery)r.locationcseZdZfddZZS)APICoreVersionErrorcsd}t|dS)NzIgoogle-api-core >= 2.18.0 is required to use the universe domain feature.)super__init__)selfmessage __class__=/tmp/pip-unpacked-wheel-rfrvjkbl/googleapiclient/discovery.pyr=szAPICoreVersionError.__init__)__name__ __module__ __qualname__r= __classcell__rBrBr@rCr;sr;bodyc@seZdZejZdS)_BytesGeneratorN)rDrErFrwriteZ _write_linesrBrBrBrCrIsrIcCs6|dddd}t|s&|tkr.|dS|SdS)zFix method names to avoid '$' characters and reserved word conflicts. Args: name: string, method name. Returns: The name with '_' appended if the name is a reserved word and '$' and '-' replaced with '_'. $_-N)replacekeyword iskeywordRESERVED_WORDS)namerBrBrCrs cCsTg}t|}|ds"|d|D]"}|r>||q&|dq&d|S)zConverts key names into parameter names. For example, converting "max-results" -> "max_results" Args: key: string, the method key name. Returns: A safe method name based on the key name. rxrL)listisalphaappendisalnumjoin)keyresultcrBrBrCrs     cCs||d}|dkr$|dkr d}nd}|dkr4t}n|}d}t||D]}t||}zBt|||||| || |d }t|||||||| | | |d }WqWqFtk r}z |jjt j krWY qFn|W5d}~XYqFXqF|dkr| |dkrt d||fn|SdS)a)Construct a Resource for interacting with an API. Construct a Resource object for interacting with an API. The serviceName and version are the names from the Discovery service. Args: serviceName: string, name of the service. version: string, the version of the service. http: httplib2.Http, An instance of httplib2.Http or something that acts like it that HTTP requests will be made through. discoveryServiceUrl: string, a URI Template that points to the location of the discovery service. It should have two parameters {api} and {apiVersion} that when filled in produce an absolute URI to the discovery document for that service. developerKey: string, key obtained from https://code.google.com/apis/console. model: googleapiclient.Model, converts to and from the wire format. requestBuilder: googleapiclient.http.HttpRequest, encapsulator for an HTTP request. credentials: oauth2client.Credentials or google.auth.credentials.Credentials, credentials to be used for authentication. cache_discovery: Boolean, whether or not to cache the discovery doc. cache: googleapiclient.discovery_cache.base.CacheBase, an optional cache object for the discovery documents. client_options: Mapping object or google.api_core.client_options, client options to set user options on the client. (1) The API endpoint should be set through client_options. If API endpoint is not set, `GOOGLE_API_USE_MTLS_ENDPOINT` environment variable can be used to control which endpoint to use. (2) client_cert_source is not supported, client cert should be provided using client_encrypted_cert_source instead. In order to use the provided client cert, `GOOGLE_API_USE_CLIENT_CERTIFICATE` environment variable must be set to `true`. More details on the environment variables are here: https://google.aip.dev/auth/4114 adc_cert_path: str, client certificate file path to save the application default client certificate for mTLS. This field is required if you want to use the default client certificate. `GOOGLE_API_USE_CLIENT_CERTIFICATE` environment variable must be set to `true` in order to use this field, otherwise this field doesn't nothing. More details on the environment variables are here: https://google.aip.dev/auth/4114 adc_key_path: str, client encrypted private key file path to save the application default client encrypted private key for mTLS. This field is required if you want to use the default client certificate. `GOOGLE_API_USE_CLIENT_CERTIFICATE` environment variable must be set to `true` in order to use this field, otherwise this field doesn't nothing. More details on the environment variables are here: https://google.aip.dev/auth/4114 num_retries: Integer, number of times to retry discovery with randomized exponential backoff in case of intermittent/connection issues. static_discovery: Boolean, whether or not to use the static discovery docs included in the library. The default value for `static_discovery` depends on the value of `discoveryServiceUrl`. `static_discovery` will default to `True` when `discoveryServiceUrl` is also not provided, otherwise it will default to `False`. always_use_jwt_access: Boolean, whether always use self signed JWT for service account credentials. This only applies to google.oauth2.service_account.Credentials. Returns: A Resource object with methods for interacting with the service. Raises: google.auth.exceptions.MutualTLSChannelError: if there are any problems setting up mutual TLS channel. )api apiVersionNTF) num_retriesstatic_discovery) basehttp developerKeymodelrequestBuilder credentialsclient_options adc_cert_path adc_key_pathalways_use_jwt_accessname: %s version: %s) r_discovery_service_uri_options uritemplateexpand_retrieve_discovery_docrrrespstatus http_client NOT_FOUNDcloser) serviceNameversionrcdiscoveryServiceUrlrdrerfrgcache_discoverycacherhrirjr`rarkparamsZdiscovery_httpserviceZ discovery_urlZ requested_urlcontenterBrBrCrs\W      cCs2|dk r|gS|dkr&tdtgSttgSdS)aZ Returns Discovery URIs to be used for attempting to build the API Resource. Args: discoveryServiceUrl: string, the Original Discovery Service URL preferred by the customer. version: string, API Version requested Returns: A list of URIs to be tried for the Service Discovery, in order. NzADiscovery V1 does not support empty versions. Defaulting to V2...)loggerwarningV2_DISCOVERY_URI DISCOVERY_URI)rxrwrBrBrCrmZsrmc  Cs@ddlm} |r6|dkr | }|r6||} | r6| S|r^| ||} | rN| Std||f|} dtjkr~t|dtjd} |rt|d|} t d| t |t j | } | j |d \} } z| d } Wntk rYnXzt| }Wn8tk r"}zt d | tW5d}~XYnX|r<|r<||| | S) aRetrieves the discovery_doc from cache or the internet. Args: url: string, the URL of the discovery document. http: httplib2.Http, An instance of httplib2.Http or something that acts like it through which HTTP requests will be made. cache_discovery: Boolean, whether or not to cache the discovery doc. serviceName: string, name of the service. version: string, the version of the service. cache: googleapiclient.discovery_cache.base.Cache, an optional cache object for the discovery documents. developerKey: string, Key for controlling API usage, generated from the API Console. num_retries: Integer, number of times to retry discovery with randomized exponential backoff in case of intermittent/connection issues. static_discovery: Boolean, whether or not to use the static discovery docs included in the library. Returns: A unicode string representation of the discovery document. r$)discovery_cacheNrlZ REMOTE_ADDRZuserIprZzURL being requested: GET %s)r`utf-8zFailed to parse as JSON: )rTrZ autodetectgetZget_static_docrosenvironrrdebugrZ null_postprocexecutedecodeAttributeErrorjsonloads ValueErrorerrorrset)urlrcryrvrwrzrdr`rarr}Z actual_urlreqrqr|r~rBrBrCrptsF         rpcCs$ts t|dd}|r |tkr tdS)Nuniverse_domain) HAS_UNIVERSEgetattrDEFAULT_UNIVERSEr;)rgZcredentials_universerBrBrC4_check_api_core_compatible_with_credentials_universes  rc  Cs|dkrtjj}t|tjjr0tjj|}|dk rn|df|j dfg} | D]\} }| dk rNt d |qNt|t rt |}nt|trt |d}d|krt|ttfrtdttj|d|d}d}trttd}t|j|}| tj!|}nt"|d d}|r$t#|}|j$r6|j$}t%|}|dkrt&|'d i'd i'd i(}|r|s|j r|rtjj)*d |j rt+j,|j |j-|j.d}|dkrt+j/|j-|j.d}t0||j-st+1||}|r&t|t2j3r&| r&t4t2j3dr&|5| }|6||r8t+7|}nt8}d}tt9d}|dkr`t:d|rv|j;rvt:d|dkr|rt4|dr|j<r|j<}n"| r| rt=>rt=?| | }|r|\}}}t@rt|t@jAr|jBn|}|C||d|d|kr|r|j$stj|d|d}ttDd}|dkrPt:d|dksj|dkr|rtr|tj!krt:dtj!d|}nt"|dd}t0||dkr|'dg}tEd|k}tF|||||||||d S)!a Create a Resource for interacting with an API. Same as `build()`, but constructs the Resource object from a discovery document that is it given, as opposed to retrieving one over HTTP. Args: service: string or object, the JSON discovery document describing the API. The value passed in may either be the JSON string or the deserialized JSON. base: string, base URI for all HTTP requests, usually the discovery URI. This parameter is no longer used as rootUrl and servicePath are included within the discovery document. (deprecated) future: string, discovery document with future capabilities (deprecated). http: httplib2.Http, An instance of httplib2.Http or something that acts like it that HTTP requests will be made through. developerKey: string, Key for controlling API usage, generated from the API Console. model: Model class instance that serializes and de-serializes requests and responses. requestBuilder: Takes an http request and packages it up to be executed. credentials: oauth2client.Credentials or google.auth.credentials.Credentials, credentials to be used for authentication. client_options: Mapping object or google.api_core.client_options, client options to set user options on the client. (1) The API endpoint should be set through client_options. If API endpoint is not set, `GOOGLE_API_USE_MTLS_ENDPOINT` environment variable can be used to control which endpoint to use. (2) client_cert_source is not supported, client cert should be provided using client_encrypted_cert_source instead. In order to use the provided client cert, `GOOGLE_API_USE_CLIENT_CERTIFICATE` environment variable must be set to `true`. More details on the environment variables are here: https://google.aip.dev/auth/4114 adc_cert_path: str, client certificate file path to save the application default client certificate for mTLS. This field is required if you want to use the default client certificate. `GOOGLE_API_USE_CLIENT_CERTIFICATE` environment variable must be set to `true` in order to use this field, otherwise this field doesn't nothing. More details on the environment variables are here: https://google.aip.dev/auth/4114 adc_key_path: str, client encrypted private key file path to save the application default client encrypted private key for mTLS. This field is required if you want to use the default client certificate. `GOOGLE_API_USE_CLIENT_CERTIFICATE` environment variable must be set to `true` in order to use this field, otherwise this field doesn't nothing. More details on the environment variables are here: https://google.aip.dev/auth/4114 always_use_jwt_access: Boolean, whether always use self signed JWT for service account credentials. This only applies to google.oauth2.service_account.Credentials. Returns: A Resource object with methods for interacting with the service. Raises: google.auth.exceptions.MutualTLSChannelError: if there are any problems setting up mutual TLS channel. Nrgzclient_options.credentials_filez,Arguments http and {} are mutually exclusiverrootUrlzYou are using HttpMock or HttpMockSequence withouthaving the service discovery doc in cache. Try calling build() without mocking once first to populate the cache. servicePathrauthZoauth2scopeszGclient_options.credentials_file and credentials are mutually exclusive.)rquota_project_idwith_always_use_jwt_accessfalse)truerzQUnsupported GOOGLE_API_USE_CLIENT_CERTIFICATE value. Accepted values: true, falseziClientOptions.client_cert_source is not supported, please use ClientOptions.client_encrypted_cert_source.rclient_encrypted_cert_sourcerTZ mtlsRootUrlauto)neverralwayszTUnsupported GOOGLE_API_USE_MTLS_ENDPOINT value. Accepted values: never, auto, alwaysrz1mTLS is not supported in any universe other than .featuresZ dataWrapper rcbaseUrlrerdrf resourceDescrootDescschemar)GgoogleZapi_corerhZ ClientOptions isinstance collectionsabcMapping from_dictZcredentials_filerformatstrrrbytesrrrrrrurllibparseurljoinrrgetenvr5rZdetermine_domainrrNrrr;Z api_endpointr#rUrkeys exceptionsZDuplicateCredentialArgsrZcredentials_from_filerrZdefault_credentialsrZ with_scopesr Z CredentialshasattrrZ_create_self_signed_jwtZauthorized_httprr3r Zclient_cert_sourcerr Zhas_default_client_cert_sourceZ$default_client_encrypted_cert_sourcegoogle_auth_httplib2ZAuthorizedHttprcZadd_certificater4r Resource)r|rbfuturercrdrerfrgrhrirjrkZbanned_optionsoptionrRrZuniverse_domain_envZclient_universeZaudience_for_self_signed_jwtrrZclient_cert_to_useZuse_client_certZ cert_pathZkey_pathZ passphraseZ http_channelZ mtls_endpointZuse_mtls_endpointZhttp_credentialsrrBrBrCrs.K                              cCs|dkr6t|tdks(t|tdkr,|St|Snl|dkrJtt|S|dkr^tt|S|dkrvtt|St|tdkst|tdkr|St|SdS)afConvert value to a string based on JSON Schema type. See http://tools.ietf.org/html/draft-zyp-json-schema-03 for more details on JSON Schema. Args: value: any, the value to convert schema_type: string, the type that value should be interpreted as Returns: A string representation of 'value' based on the schema_type. r/rTintegernumberbooleanN)r.rintfloatboollower)valueZ schema_typerBrBrC_casts      rcCsRt|dkrdS|dd}t|}|dk rFt|dd|>St|SdS)zConvert a string media size, such as 10GB or 3TB into an integer. Args: maxSize: string, size as a string, such as 2MB or 7GB. Returns: The size as an integer value. r]rN)lenupper_MEDIA_SIZE_BIT_SHIFTSrr)maxSizeZunitsZ bit_shiftrBrBrC_media_size_to_longs  rcCsd|d|d|dS)aCreates an absolute media path URL. Constructed using the API root URI and service path from the discovery document and the relative path for the API method. Args: root_desc: Dictionary; the entire original deserialized discovery document. path_url: String; the relative URL for the API method. Relative to the API root, which is specified in the discovery document. Returns: String; the absolute URI for media upload for the API method. z'%(root)supload/%(service_path)s%(path)srr)rootZ service_pathpathrB) root_descpath_urlrBrBrC_media_path_url_from_infos rcCsv|di}|diD]\}}|||<qtD]}t||<q2|tkrrd|krrt}||d||d<|S)a#Updates parameters of an API method with values specific to this library. Specifically, adds whatever global parameters are specified by the API to the parameters for the individual method. Also adds parameters which don't appear in the discovery document, but are available to all discovery based APIs (these are listed in STACK_QUERY_PARAMETERS). SIDE EFFECTS: This updates the parameters dictionary object in the method description. Args: method_desc: Dictionary with metadata describing an API method. Value comes from the dictionary of methods stored in the 'methods' key in the deserialized discovery document. root_desc: Dictionary; the entire original deserialized discovery document. http_method: String; the HTTP method used to call the API method described in method_desc. schema: Object, mapping of schema names to schema descriptions. Returns: The updated Dictionary stored in the 'parameters' key of the method description dictionary. parametersrequestrH) setdefaultritemsSTACK_QUERY_PARAMETERS#STACK_QUERY_PARAMETER_DEFAULT_VALUEcopyHTTP_PAYLOAD_METHODSBODY_PARAMETER_DEFAULT_VALUEupdate) method_descr http_methodrrrRr-rHrBrBrC_fix_up_parameters&s  rcCs\|di}|dg}t|dd}d}|rRt||}t|d<t|d<|||fS)aAdds 'media_body' and 'media_mime_type' parameters if supported by method. SIDE EFFECTS: If there is a 'mediaUpload' in the method description, adds 'media_upload' key to parameters. Args: method_desc: Dictionary with metadata describing an API method. Value comes from the dictionary of methods stored in the 'methods' key in the deserialized discovery document. root_desc: Dictionary; the entire original deserialized discovery document. path_url: String; the relative URL for the API method. Relative to the API root, which is specified in the discovery document. parameters: A dictionary describing method parameters for method described in method_desc. Returns: Triple (accept, max_size, media_path_url) where: - accept is a list of strings representing what content types are accepted for media upload. Defaults to empty list if not in the discovery document. - max_size is a long representing the max size in bytes allowed for a media upload. Defaults to 0L if not in the discovery document. - media_path_url is a String; the absolute URI for media upload for the API method. Constructed using the API root URI and service path from the discovery document and the relative path for the API method. If media upload is not supported, this is None. Z mediaUploadacceptrrTN media_bodymedia_mime_type)rrr"MEDIA_BODY_PARAMETER_DEFAULT_VALUEr'MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE)rrrr media_uploadrmax_sizemedia_path_urlrBrBrC_fix_up_media_uploadRs     rc CsJ|d}|d}|d}t||||}t||||\}}} |||||| fS)aUpdates a method description in a discovery document. SIDE EFFECTS: Changes the parameters dictionary in the method description with extra parameters which are used locally. Args: method_desc: Dictionary with metadata describing an API method. Value comes from the dictionary of methods stored in the 'methods' key in the deserialized discovery document. root_desc: Dictionary; the entire original deserialized discovery document. schema: Object, mapping of schema names to schema descriptions. Returns: Tuple (path_url, http_method, method_id, accept, max_size, media_path_url) where: - path_url is a String; the relative URL for the API method. Relative to the API root, which is specified in the discovery document. - http_method is a String; the HTTP method used to call the API method described in the method description. - method_id is a String; the name of the RPC method associated with the API method, and is in the method description in the 'id' key. - accept is a list of strings representing what content types are accepted for media upload. Defaults to empty list if not in the discovery document. - max_size is a long representing the max size in bytes allowed for a media upload. Defaults to 0L if not in the discovery document. - media_path_url is a String; the absolute URI for media upload for the API method. Constructed using the API root URI and service path from the discovery document and the relative path for the API method. If media upload is not supported, this is None. r httpMethodid)rr) rrrrrZ method_idrrrrrBrBrC_fix_up_method_description{s  rcCs>tj|}tj|}|j|jkr(|Stj|j|jdS)a Update the media upload base url if its netloc doesn't match base url netloc. This can happen in case the base url was overridden by client_options.api_endpoint. Args: media_path_url: String; the absolute URI for media upload. base_url: string, base URL for the API. All requests are relative to this URI. Returns: String; the absolute URI for media upload. )netloc)rrurlparser urlunparse_replace)rbase_urlZparsed_media_urlZparsed_base_urlrBrBrC_fix_up_media_path_base_urls    rcCsZ|ds|dr"tj||S|dr0|n|d}|drN|ddn|}||S)z8Custom urljoin replacement supporting : before / in url.zhttp://zhttps:///r$N) startswithrrrendswith)rbrnew_basenew_urlrBrBrC_urljoins rc@s eZdZdZddZddZdS)ResourceMethodParametersa-Represents the parameters associated with a method. Attributes: argmap: Map from method parameter name (string) to query parameter name (string). required_params: List of required parameters (represented by parameter name as string). repeated_params: List of repeated parameters (represented by parameter name as string). pattern_params: Map from method parameter name (string) to regular expression (as a string). If the pattern is set for a parameter, the value for that parameter must match the regular expression. query_params: List of parameters (represented by parameter name as string) that will be used in the query string. path_params: Set of parameters (represented by parameter name as string) that will be used in the base URL path. param_types: Map from method parameter name (string) to parameter type. Type can be any valid JSON schema type; valid values are 'any', 'array', 'boolean', 'integer', 'number', 'object', or 'string'. Reference: http://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.1 enum_params: Map from method parameter name (string) to list of strings, where each list of strings is the list of acceptable enum values. cCs@i|_g|_g|_i|_g|_t|_i|_i|_| |dS)a]Constructor for ResourceMethodParameters. Sets default values and defers to set_parameters to populate. Args: method_desc: Dictionary with metadata describing an API method. Value comes from the dictionary of methods stored in the 'methods' key in the deserialized discovery document. N) argmaprequired_paramsrepeated_paramspattern_params query_paramsr path_params param_types enum_paramsset_parameters)r>rrBrBrCr=s z!ResourceMethodParameters.__init__c CsD|di}tt|}|D]\}}t|}||j|<|drV|d|j|<|drn|d|j|<|dr|j ||dr|j ||ddkr|j ||ddkr|j ||d d |j|<q$t|dD]N}t|d D]8}t|d } |j | | |j kr|j | qqd S) aPopulates maps and lists based on method description. Iterates through each parameter for the method and parses the values from the parameter dictionary. Args: method_desc: Dictionary with metadata describing an API method. Value comes from the dictionary of methods stored in the 'methods' key in the deserialized discovery document. rpatternenumr0repeatedr:r9rr.r/rN)rrsortedrrrrrrrWrrraddr URITEMPLATEfinditerVARNAMEgroupremove) r>rrZsorted_parametersargdescparammatch namematchrRrBrBrCrs0            z'ResourceMethodParameters.set_parametersN)rDrErF__doc__r=rrBrBrBrCrsrc s:tt| \t f dd}dtdg}tjdkrn|dt|di }| t tj }dd d gD}d |kr|d t |D]} | |kr|| q|D]} | |krqd } | j krd } d } | jkrd} dj| } | dd}d| krh|d| || | | dfn$| dd}|d| ||| | f| dg}| dg}|r|r|dt||D]\} }|d| |fqqdkr dr|dn|d| dt|dd ||fS)aeCreates a method for attaching to a Resource. Args: methodName: string, name of the method to use. methodDesc: object, fragment of deserialized discovery document that describes the method. rootDesc: object, the entire deserialized discovery document. schema: object, mapping of schema names to schema descriptions. c" s||D]}|jkr td|q t|}|D]}||dkr:||=q:jD]0}||krX|tks|tt  drXtd|qXj D]^\}}||krt ||t r||g}n||}|D]&}t||dkrtd|||fqqj D]l\}}||kr|jkr4t ||t s4||}n ||g}|D]&} | |krBtd|| t |fqBqi} i} | D]\} } j| d| jkrt| tgkrćfdd| D} n t| } | jkr| | j| <| jkr|| | j| <q||d d}|d d}|d d}|jr<|j| d <|j}d rVt}ndkrft}dd}i}||| | ||\}}}}t |}t |j!||}d}d}|rt |t r(|dkrt"#d|t$%|\}}|dkrt&|t'(|gd)st*|t+||d}nt |t,r:|}ntd|-dk r||-krldkr|nn t.dt|}t |j!||}t/||j!}|0rt1|dd}|0r|}n|dkr|2|d<|3d|-}t1|dd}nt4d}t5|dddt6|d7d}|8||9|t6|27d}d|d <|3d|-}|8||9|t:;} t<| d!d"}!|!j=|d!d#| >}|?}d$||d<t1|dd%}t"@d&|f|jA|jB|jC||||d'S)(Nz%Got an unexpected keyword argument {}responsezMissing required parameter "%s"z9Parameter "%s" value "%s" does not match the pattern "%s"z9Parameter "%s" value "%s" is not an allowed value in "%s"r/csg|]}t|qSrB)r).0rSZto_typerBrC sz0createMethod..method..rHrrrZ_mediar_rTzDmedia_mime_type argument not specified: trying to auto-detect for %s,)mimetypez*media_filename must be str or MediaUpload.rzMedia larger than: %sZ uploadType resumablez content-typeZmediarelatedZ_write_headerscSsdSNrBr>rBrBrCz.createMethod..method..rbinaryzContent-Transfer-EncodingF) mangle_from_)unixfromz multipart/related; boundary="%s" multipartzURL being requested: %s %s)methodrHheadersmethodIdr)D_validate_credentialsr TypeErrorrrUrr_PAGE_TOKEN_NAMES_findPageTokenName_methodPropertiesrrrrrerrrrrr.rrr _developerKey_modelrr!r"rrnror_baseUrlrr mimetypes guess_typerr best_matchrYrrrsizerrrrrZgetbytesr setattrr split set_payloadattachioBytesIOrIflattengetvalue get_boundaryr_requestBuilder_httpr)"r>kwargsrRrregexZpvaluesZpvalueenumsvaluesrZactual_query_paramsZactual_path_paramsrZZ cast_valueZ body_valueZmedia_filenamerre api_versionr$r{r9rHZ expanded_urlrrmultipart_boundaryrLrZmsgRootmsgpayloadfpg rrrZ mediaPathUrl methodDescr% methodNamerZpathUrlrrrCr#Cs                             .              zcreateMethod..methodr-z rzArgs: rcSsg|] }t|qSrB)r)rsrBrBrCrsz createMethod..ZparameterOrderrHrTz (repeated)z (required)z A parameter$refz< %s: object, %s%s%s The object takes the form of: %s r.r/z %s: %s, %s%s%s rZenumDescriptionsz Allowed values z %s - %s rrz/ Returns: The media object as a string. z( Returns: An object of the form: r)rrrrDEFAULT_METHOD_DOCrrrWrUrextendrrrrZprettyPrintByNameziprZprettyPrintSchemar3rY)rJrIrrr#ZdocsZskip_parametersZall_argsZ args_orderedrRr rr0Z paramdescZparamdocZ paramtyperZenumDescr rBrHrC createMethod-s~  4                  rPr1r2cs"tfdd}|fS)aCreates any _next methods for attaching to a Resource. The _next methods allow for easy iteration through list() responses. Args: methodName: string, name of the method to use. pageTokenName: string, name of request page token field. nextPageTokenName: string, name of response page token field. isPageTokenParameter: Boolean, True if request page token is a query parameter, False if request page token is a field of the request body. cs|d}|sdSt|}rHt|j||_td|jfnV|j}||j}||<| ||_t |j|_ d|j kr|j d=td|f|S)aRetrieves the next page of results. Args: previous_request: The request for the previous page. (required) previous_response: The response from the request for the previous page. (required) Returns: A request object that you can call 'execute()' on to request the next page. Returns None if there are no more items in the collection. NzNext page request URL: %s %szcontent-lengthzNext page request body: %s %s) rrrurirrr-Z deserializerH serializerZ body_sizer$)r>Zprevious_requestZprevious_responser2rrerHisPageTokenParameterrJnextPageTokenName pageTokenNamerBrC methodNextIs(      z$createNextMethod..methodNext)r)rJrVrUrTrWrBrSrCcreateNextMethod6s'rXc@s~eZdZdZerejndfddZddZddZ d d Z d d Z d dZ ddZ ddZddZddZddZddZdS)rz(A class for interacting with a resource.rTc CsNg|_||_||_||_||_||_||_||_||_| |_ d|_ | dS)aBuild a Resource from the API description. Args: http: httplib2.Http, Object to make http requests with. baseUrl: string, base URL for the API. All requests are relative to this URI. model: googleapiclient.Model, converts to and from the wire format. requestBuilder: class or callable that instantiates an googleapiclient.HttpRequest object. developerKey: string, key obtained from https://code.google.com/apis/console resourceDesc: object, section of deserialized discovery document that describes a resource. Note that the top level discovery document is considered a resource. rootDesc: object, the entire deserialized discovery document. schema: object, mapping of schema names to schema descriptions. universe_domain: string, the universe for the API. The default universe is "googleapis.com". FN) _dynamic_attrsr=r.r-r,r< _resourceDesc _rootDesc_schema_universe_domain_credentials_validated_set_service_methods) r>rcrrerfrdrrrrrBrBrCr=vszResource.__init__cCs|j|||j|<dS)zSets an instance attribute and tracks it in a list of dynamic attributes. Args: attr_name: string; The name of the attribute to be set value: The value being set on the object and tracked in the dynamic cache. N)rYrW__dict__)r> attr_namerrBrBrC_set_dynamic_attrs zResource._set_dynamic_attrcCs(t|j}|jD] }||=q|d=|S)zTrim the state down to something that can be pickled. Uses the fact that the instance variable _dynamic_attrs holds attrs that will be wiped and restored on pickle serialization. rY)rr`rY)r>Z state_dictZ dynamic_attrrBrBrC __getstate__s   zResource.__getstate__cCs|j|g|_|dS)zReconstitute the state of the object from being pickled. Uses the fact that the instance variable _dynamic_attrs holds attrs that will be wiped and restored on pickle serialization. N)r`rrYr_)r>staterBrBrC __setstate__s zResource.__setstate__cCs|SrrBrrBrBrC __enter__szResource.__enter__cCs |dSr)ru)r>exc_typeexcexc_tbrBrBrC__exit__szResource.__exit__cCs|jdS)zClose httplib2 connections.N)r=rurrBrBrCruszResource.closecCs<||j|j|j||j|j|j||j|jdSr)_add_basic_methodsrZr[r\_add_nested_resources_add_next_methodsrrBrBrCr_szResource._set_service_methodsc s||kr:d|d|ddfd fdd }|d|d|kr|dD]h\}}t||||\}}|||||j|d d rNt|d |||\}}|||||jqNdS) Nz%s%srZ batchPathbatchcs t|dS)aCreate a BatchHttpRequest object based on the discovery document. Args: callback: callable, A callback to be called for each response, of the form callback(id, response, exception). The first parameter is the request id, and the second is the deserialized response object. The third is an apiclient.errors.HttpError exception object if an HTTP error occurred while processing the request, or None if no error occurred. Returns: A BatchHttpRequest object based on the discovery document. )callback batch_uri)r)rorprBrCnew_batch_http_requestsz;Resource._add_basic_methods..new_batch_http_requestrrmethodsZsupportsMediaDownloadFr)N)rrbrrP__get__rA) r>rrrrrrJrIfixedMethodNamer#rBrqrCrks<     zResource._add_basic_methodsc sTd|krPfdd}|dD],\}}|||\}}|||||jq"dS)N resourcescs8t|}fdd}t|ddt|dd||fS)a&Create a method on the Resource to access a nested Resource. Args: methodName: string, name of the method to use. methodDesc: object, fragment of deserialized discovery document that describes the method. c s&t|j|j|j|j|j|jd S)Nr)rr=r.r-r,r<r]r)rIrrrBrCmethodResourceszTResource._add_nested_resources..createResourceMethod..methodResourcerzA collection resource.Z__is_resource__T)rr3)rJrIrwrr)rIrCcreateResourceMethods   z.createResourceMethod)rrbrtrA) r>rrrryrJrIrur#rBrxrCrls zResource._add_nested_resourcesc Csd|kr dS|dD]|\}}tt||d}|s6qd}t|di}|sbd}tt||d}|shqt|d|||\}} ||| ||jqdS)NrsrTrFr_next)rr)r*rrXrbrtrA) r>rrrJrIrUrTrVrur#rBrBrCrm)s6   zResource._add_next_methodscCs2t|jdd}tr&|jp(t|j|nd|_|jS)aValidates client's and credentials' universe domains are consistent. Returns: bool: True iff the configured universe domain is valid. Raises: UniverseMismatchError: If the configured universe domain is not valid. rgNT)rr=rr^rZcompare_domainsr])r>rgrBrBrCr&Hs  zResource._validate_credentialsN)rDrErFrrrrr=rbrcrerfrjrur_rkrlrmr&rBrBrBrCrss .   -&rcstfddtDdS)zSearch field names for one like a page token. Args: fields: container of string, names of fields. Returns: First name that is either 'pageToken' or 'nextPageToken' if one exists, otherwise None. c3s|]}|kr|VqdSrrB)rZ tokenNamefieldsrBrC isz%_findPageTokenName..N)nextr(r{rBr{rCr)^s r)cCs0||i}d|kr$||di}|diS)aGet properties of a field in a method description. Args: methodDesc: object, fragment of deserialized discovery document that describes the method. schema: object, mapping of schema names to schema descriptions. name: string, name of top-level field in method description. Returns: Object representing fragment of deserialized discovery document corresponding to 'properties' field of object corresponding to named field in method description, if it exists, otherwise empty dict. rLZ properties)r)rIrrRr rBrBrCr*ms r*)NNr$T)r1r2T)vr __future__r __author____all__rrcollections.abcremail.generatorrZemail.mime.multipartr Zemail.mime.nonmultipartr http.clientclientrsr7rrOloggingr/rr+rZgoogle.api_core.client_optionsrZgoogle.auth.exceptionsr Zgoogle.auth.transportr Z google.oauth2r Zhttplib2rnr ImportErrorZgoogle.api_corerrZgoogleapiclientrrZgoogleapiclient._helpersrrZgoogleapiclient.errorsrrrrrrZgoogleapiclient.httprrrrrrrZgoogleapiclient.modelr r!r"Zgoogleapiclient.schemar#ZRETRIES getLoggerrDrcompilerr rZV1_DISCOVERY_URIrrM frozensetrrrrrr(r3r4r5rrrrr;rQrIrrrrmrprrrrrrrrrrr,rrPrXrr)r*rBrBrBrCs               $            T ,)/Z  =l