ly4na

Server : LiteSpeed
System : Linux server51.dnsbootclub.com 4.18.0-553.62.1.lve.el8.x86_64 #1 SMP Mon Jul 21 17:50:35 UTC 2025 x86_64
User : nandedex ( 1060)
PHP Version : 8.1.33
Disable Function : NONE
Directory : /opt/cppython/lib/python3.8/site-packages/googleapiclient/__pycache__/
Upload File :
Current File : //opt/cppython/lib/python3.8/site-packages/googleapiclient/__pycache__/discovery.cpython-38.pyc
U

P��g%�@s�dZddlmZdZddddgZddlmZdd	lZdd	lZdd
l	m
Z
ddlmZddl
mZdd	lmZdd	lZdd	lZdd	lZdd	lZdd	lZdd	lZdd	lZdd	lZdd	lZdd
lmZddlmZddl m!Z!dd	l"Z"dd	l#Z#zdd	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;m<Z<m=Z=ddl>m?Z?m@Z@mAZAddlBmCZCde"_De�EeF�ZGe�Hd�ZIe�Hd�ZJdZKeKZLdZMdZNeOdd d!g�ZPd"d#d$d%d&�ZQd'd(d)�ZRd*d+dd,�ZSd-d+dd,�ZTd.ZUd/ZVd0ZWd1ZXd2ZYeOd3d4d5d6g�ZZd+d7d8�Z[Gd9d:�d:e\�Z]eOd;g�Z^Gd<d=�d=e
�Z_d>d�Z`d?d�Zae.d@�d	d	d	d	e:d	dd	d	d	d	dd	dfdAd��ZbdBdC�ZcdgdDdE�ZddFdG�Zee.d�d	d	d	d	d	e:d	d	d	d	dfdHd��ZfdIdJ�ZgdKdL�ZhdMdN�ZidOdP�ZjdQdR�ZkdSdT�ZldUdV�ZmdWdX�ZnGdYdZ�dZeo�Zpd[d\�Zqdhd_d`�ZrGdadb�dbeo�Zsdcdd�Ztdedf�Zud	S)izVClient for discovery based APIs.

A client library for Google's discovery based APIs.
�)�absolute_importz$jcgregorio@google.com (Joe Gregorio)�build�build_from_document�fix_method_name�	key2param)�OrderedDictN)�BytesGenerator)�
MIMEMultipart)�MIMENonMultipart)�MutualTLSChannelError)�mtls)�service_account)�universeTF)�_auth�	mimeparse)�_add_query_parameter�
positional)�	HttpError�InvalidJsonError�MediaUploadSizeError�UnacceptableMimeTypeError�UnknownApiNameOrVersion�UnknownFileType)�BatchHttpRequest�HttpMock�HttpMockSequence�HttpRequest�MediaFileUpload�MediaUpload�
build_http)�	JsonModel�
MediaModel�RawModel)�Schemas�z{[^}]*}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 function�PUT�POST�PATCH�
���()ZKB�MB�GB�TBzThe request body.�object)�description�typezOThe filename of the media request body, or an instance of a MediaUpload object.�string)r0r1�requiredzPThe MIME type of the media request body, or an instance of a MediaUpload object.)�	pageToken�
nextPageToken�!GOOGLE_API_USE_CLIENT_CERTIFICATE�GOOGLE_API_USE_MTLS_ENDPOINT�GOOGLE_CLOUD_UNIVERSE_DOMAINzgoogleapis.com�trace�ppZuserip�strict�query)r1�locationcseZdZ�fdd�Z�ZS)�APICoreVersionErrorcsd}t��|�dS)NzIgoogle-api-core >= 2.18.0 is required to use the universe domain feature.)�super�__init__)�self�message��	__class__��F/opt/cppython/lib/python3.8/site-packages/googleapiclient/discovery.pyr@�s�zAPICoreVersionError.__init__)�__name__�
__module__�__qualname__r@�
__classcell__rErErCrFr>�sr>�bodyc@seZdZejZdS)�_BytesGeneratorN)rGrHrIr�writeZ_write_linesrErErErFrL�srLcCs6|�dd��dd�}t�|�s&|tkr.|dS|SdS)z�Fix 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)�replace�keyword�	iskeyword�RESERVED_WORDS)�namerErErFr�s
cCsTg}t|�}|d��s"|�d�|D]"}|��r>|�|�q&|�d�q&d�|�S)z�Converts 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.
    r�xrO�)�list�isalpha�append�isalnum�join)�key�result�crErErFr�s
�cCs||d�}|dkr$|dkr d}nd}|dkr4t�}n|}d}t||�D]�}t�||�}zBt||||||	||
|d�	}t||||||||
|||d�}Wq�WqFtk
r�}z |jjt	j
kr�WY�qFn|�W5d}~XYqFXqF|dkr�|��|dk�rtd||f��n|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_retries�static_discovery)
�base�http�developerKey�model�requestBuilder�credentials�client_options�
adc_cert_path�adc_key_path�always_use_jwt_access�name: %s  version: %s)
r�_discovery_service_uri_options�uritemplate�expand�_retrieve_discovery_docrr�resp�status�http_client�	NOT_FOUND�closer)�serviceName�versionrf�discoveryServiceUrlrgrhrirj�cache_discovery�cacherkrlrmrcrdrn�paramsZdiscovery_http�serviceZ
discovery_urlZ
requested_url�content�erErErFr�s\W
��


cCs2|dk	r|gS|dkr&t�d�tgSttgSdS)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...)�logger�warning�V2_DISCOVERY_URI�
DISCOVERY_URI)r{rzrErErFrpZs�rpc	
Cs@ddlm}	|r6|dkr |	��}|r6|�|�}
|
r6|
S|r^|	�||�}
|
rN|
Std||f��|}dtjkr~t|dtjd�}|r�t|d|�}t	�
d|�t|tj|�}|j
|d	�\}
}
z|
�d
�}
Wntk
r�YnXzt�|
�}Wn8tk
�r"}zt	�d|
�t��W5d}~XYnX|�r<|�r<|�||
�|
S)a�Retrieves 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_cacheNroZREMOTE_ADDRZuserIpr]zURL being requested: GET %s)rc�utf-8zFailed to parse as JSON: )rWr�Z
autodetect�getZget_static_docr�os�environrr��debugrZ
null_postproc�execute�decode�AttributeError�json�loads�
ValueError�errorr�set)�urlrfr|ryrzr}rgrcrdr�r�Z
actual_url�reqrtrr�rErErFrstsF 

�
rscCs$ts t|dd�}|r |tkr t�dS)N�universe_domain)�HAS_UNIVERSE�getattr�DEFAULT_UNIVERSEr>)rjZcredentials_universerErErF�4_check_api_core_compatible_with_credentials_universe�sr�cCs�|dkrtjj��}t|tjj�r0tjj�|�}|dk	rn|df|j	dfg}|D]\}
}|
dk	rNt
d�|���qNt|t�r�t
�|�}nt|t�r�t
�|�d��}d|kr�t|ttf�r�t�d�t��tj�|d|d�}d}t�rt�td�}t�|j|�}|� tj!|�}nt"|d	d�}|�r$t#�|}|j$�r6|j$}t%|�}|dk�r�t&|�'d
i��'di��'di��(��}|�r�|�s�|j	�r�|�r�tjj)�*d
��|j	�r�t+j,|j	|j-|j.d�}|dk�r�t+j/|j-|j.d�}t0|�|j-�s�t+�1||�}|�r&t|t2j3��r&|�r&t4t2j3d��r&|�5|�}|�6|�|�r8t+�7|�}nt8�}d}t�t9d�}|dk�r`t:d��|�rv|j;�rvt:d��|dk�r�|�r�t4|d��r�|j<�r�|j<}n"|	�r�|
�r�t=�>��r�t=�?|	|
�}|�r|�\}}}t@�r�t|t@jA��r�|jBn|}|�C||d|�d|k�r�|�r|j$�s�tj�|d|d�}t�tDd�}|dk�rPt:d��|dk�sj|dk�r�|�r�t�r�|tj!k�r�t:dtj!�d���|}nt"|dd�}t0|�|dk�r�|�'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.
    Nrjzclient_options.credentials_filez,Arguments http and {} are mutually exclusiver��rootUrlz�You are using HttpMock or HttpMockSequence withouthaving the service discovery doc in cache. Try calling build() without mocking once first to populate the cache.�servicePathr��authZoauth2�scopeszGclient_options.credentials_file and credentials are mutually exclusive.)r��quota_project_id�with_always_use_jwt_access�false)�truer�zQUnsupported GOOGLE_API_USE_CLIENT_CERTIFICATE value. Accepted values: true, falseziClientOptions.client_cert_source is not supported, please use ClientOptions.client_encrypted_cert_source.r��client_encrypted_cert_sourcerWZmtlsRootUrl�auto)�neverr��alwayszTUnsupported GOOGLE_API_USE_MTLS_ENDPOINT value. Accepted values: never, auto, alwaysr�z1mTLS is not supported in any universe other than �.�featuresZdataWrapper�	rf�baseUrlrhrgri�resourceDesc�rootDesc�schemar�)G�googleZapi_corerkZ
ClientOptions�
isinstance�collections�abc�Mapping�	from_dictZcredentials_filer��format�strr�r��bytesr�rrr�r�r�urllib�parse�urljoinr�r��getenvr8rZdetermine_domainr�rQr�r�r>Zapi_endpointr#rXr��keys�
exceptionsZDuplicateCredentialArgsrZcredentials_from_filer�r�Zdefault_credentialsr�Zwith_scopesr
�Credentials�hasattrr�Z_create_self_signed_jwtZauthorized_httprr6rZclient_cert_sourcer�rZhas_default_client_cert_sourceZ$default_client_encrypted_cert_source�google_auth_httplib2ZAuthorizedHttprfZadd_certificater7r �Resource)rre�futurerfrgrhrirjrkrlrmrnZbanned_options�optionrUr�Zuniverse_domain_envZclient_universeZaudience_for_self_signed_jwtr�r�Zclient_cert_to_useZuse_client_certZ	cert_pathZkey_pathZ
passphraseZhttp_channelZ
mtls_endpointZuse_mtls_endpointZhttp_credentialsr�rErErFr�s.K��

��
���
��
��
�


��
��������
�
�
���
�
���
�cCs�|dkr6t|�td�ks(t|�td�kr,|St|�Snl|dkrJtt|��S|dkr^tt|��S|dkrvtt|����St|�td�ks�t|�td�kr�|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.
    r2rW�integer�number�booleanN)r1r��int�float�bool�lower)�valueZschema_typerErErF�_cast�s
 
 r�cCsRt|�dkrdS|dd���}t�|�}|dk	rFt|dd��|>St|�SdS)z�Convert 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`r���N)�len�upper�_MEDIA_SIZE_BIT_SHIFTSr�r�)�maxSizeZunitsZ	bit_shiftrErErF�_media_size_to_long�s	
r�cCsd|d|d|d�S)a�Creates 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)sr�r�)�rootZservice_path�pathrE)�	root_desc�path_urlrErErF�_media_path_url_from_infos
�r�cCsv|�di�}|�di���D]\}}|||<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.
    �
parameters�requestrK)	�
setdefaultr��items�STACK_QUERY_PARAMETERS�#STACK_QUERY_PARAMETER_DEFAULT_VALUE�copy�HTTP_PAYLOAD_METHODS�BODY_PARAMETER_DEFAULT_VALUE�update)�method_descr��http_methodr�r�rUr0rKrErErF�_fix_up_parameters&s
r�cCs\|�di�}|�dg�}t|�dd��}d}|rRt||�}t��|d<t��|d<|||fS)a�Adds '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.
    ZmediaUpload�acceptr�rWN�
media_body�media_mime_type)r�r�r��"MEDIA_BODY_PARAMETER_DEFAULT_VALUEr��'MEDIA_MIME_TYPE_PARAMETER_DEFAULT_VALUE)r�r�r�r��media_uploadr��max_size�media_path_urlrErErF�_fix_up_media_uploadRs
r�c
CsJ|d}|d}|d}t||||�}t||||�\}}}	||||||	fS)a�Updates 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��
httpMethod�id)r�r�)
r�r�r�r�r�Z	method_idr�r�r�r�rErErF�_fix_up_method_description{s �
r�cCs>tj�|�}tj�|�}|j|jkr(|Stj�|j|jd��S)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)r�r��urlparser��
urlunparse�_replace)r��base_urlZparsed_media_urlZparsed_base_urlrErErF�_fix_up_media_path_base_url�s�r�cCsZ|�d�s|�d�r"tj�||�S|�d�r0|n|d}|�d�rN|dd�n|}||S)z8Custom urljoin replacement supporting : before / in url.zhttp://zhttps://�/r$N)�
startswithr�r�r��endswith)rer��new_base�new_urlrErErF�_urljoin�s

r�c@s eZdZdZdd�Zdd�ZdS)�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)
�argmap�required_params�repeated_params�pattern_params�query_paramsr��path_params�param_types�enum_params�set_parameters)rAr�rErErFr@�s
z!ResourceMethodParameters.__init__c
CsD|�di�}tt|����}|��D]�\}}t|�}||j|<|�d�rV|d|j|<|�d�rn|d|j|<|�d�r�|j�	|�|�d�r�|j
�	|�|�d�dkr�|j�	|�|�d�dkr�|j�
|�|�d	d
�|j|<q$t�|d�D]N}t�|�d��D]8}t|�d��}	|j�
|	�|	|jk�r|j�|	��qq�dS)
a�Populates 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.
        r��pattern�enumr3�repeatedr=r<r�r1r2rN)r�r�sortedr�rr�rrr�rZr�rr�addr�URITEMPLATE�finditer�VARNAME�group�remove)
rAr�r�Zsorted_parameters�arg�desc�param�match�	namematchrUrErErFrs0




z'ResourceMethodParameters.set_parametersN)rGrHrI�__doc__r@rrErErErFr��sr�cs:t���t�|�	�\������t�������������	f
dd�}��dt�dg}t�j�dkrn|�d�t|�di��	��}|�
t�t�j�	��}dd	���d
g�D�}d|kr�|�d�t|�D]}	|	|kr�|�|	�q�|D]�}
|
|kr�q�d}|
�j
k�rd
}d}|
�jk�rd}�d�j|
}
|
�dd�}d|
k�rh|�d|
|||�	�|
d�f�n$|
�dd�}|�d|
||||f�|
�dg�}|
�dg�}|r�|r�|�d�t||�D]\}	}|�d|	|f��q�q�d�k�r ��d��r|�d�n|�d�|��	��d��t|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]}|�jkrtd�|���qt|���}|D]}||dkr:||=q:�jD]0}||krX|tks|tt	��
d��rXtd|��qX�j
��D]^\}}||kr�t||t
�r�||g}n||}|D]&}t�||�dkr�td|||f��q�q��j��D]l\}}||kr�|�jk�r4t||t
��s4||}n
||g}|D]&}	|	|k�rBtd||	t
|�f���qBq�i}
i}|��D]�\}}	�j�|d��|�jk�r�t|	�tg�k�rćfdd�|	D�}
n
t|	��}
|�jk�r�|
|
�j|<|�jk�r||
|�j|<�q||�d	d�}|�d
d�}|�dd�}|j�r<|j|
d<|j}��d
��rVt�}nd�k�rft�}��dd�}i}|�|||
||�\}}}}t��	|�}t |j!||�}d}d}|�r�t|t
��r(|dk�r�t"�#d|�t$�%|�\}}|dk�r�t&|��t'�(|gd�)����st*|��t+||d�}nt|t,��r:|}ntd��|�-�dk	�r||�-��k�rldk�r|nnt.d���t��|�}t |j!||�}t/||j!�}|�0��r�t1|dd�}|�0��r�|}n�|dk�r�|�2�|d<|�3d|�-��}t1|dd�}n�t4d�}t5|ddd��t6|d�7d��}|�8|�|�9|�t6|�2��7d��}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"r2csg|]}t|���qSrE)r�)�.0rV�Zto_typerErF�
<listcomp>�sz0createMethod.<locals>.method.<locals>.<listcomp>rKr�r�r]�_mediarbrWzDmedia_mime_type argument not specified: trying to auto-detect for %s�,)�mimetypez*media_filename must be str or MediaUpload.rzMedia larger than: %sZ
uploadType�	resumablezcontent-typeZmedia�relatedZ_write_headerscSsdS�NrE�rArErErF�<lambda>��z.createMethod.<locals>.method.<locals>.<lambda>r��binaryzContent-Transfer-EncodingF)�mangle_from_)�unixfromz multipart/related; boundary="%s"�	multipartzURL being requested: %s %s)�methodrK�headers�methodIdr)D�_validate_credentialsr��	TypeErrorr�rXr�r��_PAGE_TOKEN_NAMES�_findPageTokenName�_methodPropertiesrr�r�r��rerrr�rr�r1r�rr�
_developerKey�_modelr�r!r"r�rqrrr��_baseUrlr�r��	mimetypes�
guess_typerr�
best_matchr\rrr�sizerr�rrrZgetbytesr	�setattrr
�split�set_payload�attach�io�BytesIOrL�flatten�getvalue�get_boundaryr��_requestBuilder�_httpr)"rA�kwargsrUr��regexZpvaluesZpvalue�enums�valuesr�Zactual_query_paramsZactual_path_paramsr]Z
cast_valueZ
body_valueZmedia_filenamer�rh�api_versionr(r~r<rKZexpanded_urlr�r�multipart_boundaryrOr�ZmsgRoot�msg�payload�fp�g�
r�r�r�ZmediaPathUrl�
methodDescr)�
methodNamer�ZpathUrlr�rrFr'Cs



����


��



�
�
.






��zcreateMethod.<locals>.methodr0z

rzArgs:
r�cSsg|]}t|��qSrE)r)r�srErErFr�sz createMethod.<locals>.<listcomp>ZparameterOrderrKrWz (repeated)z (required)zA parameter�$refz<  %s: object, %s%s%s
    The object takes the form of:

%s

r1r2z  %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)rr�r�r��DEFAULT_METHOD_DOCr�r�rZrXr��extendr�r	r�r�ZprettyPrintByName�zipr�ZprettyPrintSchemar7r\)rNrMr�r�r'�docsZskip_parametersZall_argsZargs_orderedrUrrr3Z	paramdescZparamdocZ	paramtyperZenumDescrrErLrF�createMethod-s~

�4



����


rUr4r5cs"t�������fdd�}�|fS)a�Creates 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�|�|_t�d�|jf�nV|j}|�|j�}||�<|�	|�|_t
|j�|_d|jkr�|jd=t�d�|f�|S)a�Retrieves 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)
r�r�r�urir�r�r1ZdeserializerK�	serializer�Z	body_sizer()rAZprevious_requestZprevious_responser5r�rhrK��isPageTokenParameterrN�nextPageTokenName�
pageTokenNamerErF�
methodNextIs(
�
z$createNextMethod.<locals>.methodNext)r)rNr[rZrYr\rErXrF�createNextMethod6s'r]c@s~eZdZdZerejndfdd�Zdd�Zdd�Z	d	d
�Z
dd�Zd
d�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�ZdS)r�z(A class for interacting with a resource.rWc

CsNg|_||_||_||_||_||_||_||_||_|	|_	d|_
|��dS)a�Build 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_attrsrAr2r1r0r@�
_resourceDesc�	_rootDesc�_schema�_universe_domain�_credentials_validated�_set_service_methods)
rArfr�rhrirgr�r�r�r�rErErFr@vszResource.__init__cCs|j�|�||j|<dS)z�Sets 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)r^rZ�__dict__)rA�	attr_namer�rErErF�_set_dynamic_attr�szResource._set_dynamic_attrcCs(t�|j�}|jD]
}||=q|d=|S)z�Trim 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.
        r^)r�rer^)rAZ
state_dictZdynamic_attrrErErF�__getstate__�s

zResource.__getstate__cCs|j�|�g|_|��dS)z�Reconstitute 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)rer�r^rd)rA�staterErErF�__setstate__�szResource.__setstate__cCs|SrrEr rErErF�	__enter__�szResource.__enter__cCs|��dSr)rx)rA�exc_type�exc�exc_tbrErErF�__exit__�szResource.__exit__cCs|j��dS)zClose httplib2 connections.N)rArxr rErErFrx�szResource.closecCs<|�|j|j|j�|�|j|j|j�|�|j|j�dSr)�_add_basic_methodsr_r`ra�_add_nested_resources�_add_next_methodsr rErErFrd�szResource._set_service_methodsc	s�||kr:d|d|�dd�f�d�fdd�	}|�d|�d|kr�|d��D]h\}}t||||�\}}|�||�||j��|�d	d
�rNt|d|||�\}}|�||�||j��qNdS)
Nz%s%sr�Z	batchPath�batchcst|�d�S)a�Create 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)rt�rurErF�new_batch_http_request�sz;Resource._add_basic_methods.<locals>.new_batch_http_requestrw�methodsZsupportsMediaDownloadFr)N)r�rgr�rU�__get__rD)	rAr�r�r�rwrNrM�fixedMethodNamer'rErvrFrp�s<
�����zResource._add_basic_methodsc	sTd|krP��fdd�}|d��D],\}}|||�\}}|�||�||j��q"dS)N�	resourcescs8t|�}���fdd�}t|dd�t|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.
                cs&t|j|j|j|j|j���|jd�	S)Nr�)r�rAr2r1r0r@rbr )rMr�r�rErF�methodResources�zTResource._add_nested_resources.<locals>.createResourceMethod.<locals>.methodResourcerzA collection resource.Z__is_resource__T)rr7)rNrMr|�r�r�)rMrF�createResourceMethods

z<Resource._add_nested_resources.<locals>.createResourceMethod)r�rgryrD)	rAr�r�r�r~rNrMrzr'rEr}rFrqs�zResource._add_nested_resourcesc
Cs�d|krdS|d��D]|\}}tt||d��}|s6qd}t|�di��}|sbd}tt||d��}|shqt|d|||�\}}	|�||	�||j��qdS)NrxrTr�Fr��_next)r�r-r.r�r]rgryrD)
rAr�r�rNrMrZrYr[rzr'rErErFrr)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.
        rjNT)r�rAr�rcrZcompare_domainsrb)rArjrErErFr*Hs	���zResource._validate_credentialsN)rGrHrIrr�rr�r@rgrhrjrkrorxrdrprqrrr*rErErErFr�ss�
.

-&r�cst�fdd�tD�d�S)z�Search 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|VqdSrrE)rZ	tokenName��fieldsrErF�	<genexpr>isz%_findPageTokenName.<locals>.<genexpr>N)�nextr,r�rEr�rFr-^s
�r-cCs0|�|i�}d|kr$|�|di�}|�di�S)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.
    rP�
properties)r�)rMr�rUrrErErFr.msr.)NNr$T)r4r5T)vr�
__future__r�
__author__�__all__r�r�collections.abcr��email.generatorrZemail.mime.multipartr	Zemail.mime.nonmultipartr
�http.client�clientrvr;r�rR�loggingr3r�r/r�Zgoogle.api_core.client_optionsr�Zgoogle.auth.exceptionsrZgoogle.auth.transportrZ
google.oauth2r
Zhttplib2rqr��ImportErrorZgoogle.api_corerr�ZgoogleapiclientrrZgoogleapiclient._helpersrrZgoogleapiclient.errorsrrrrrrZgoogleapiclient.httprrrrrrrZgoogleapiclient.modelr r!r"Zgoogleapiclient.schemar#ZRETRIES�	getLoggerrGr��compilerr
r�ZV1_DISCOVERY_URIr�rQ�	frozensetr�r�r�r�r�r,r6r7r8r�r�r�r�r>rTrLrrrrprsr�rr�r�r�r�r�r�r�r�r/r�rUr]r�r-r.rErErErF�<module>s

 $	


��
�
�
	
� �
T�,)/Z
�
=l
F1le Man4ger