o Fh/@sdZddlZddlZddlZddlmZddlmZddlmZddl Z ddl Z ddl Z ddl m Z ddlZ ddlZ ddlmZddlmZd Zd ZGd d d eZGd ddeZGdddeZGdddeeZdS)z@Base classes for client used to interact with Google Cloud APIs.N) PicklingError)Tuple)Union)environment_vars_determine_default_project)service_accountzThis library only supports credentials from google-auth-library-python. See https://google-auth.readthedocs.io/en/latest/ for help on authentication with this library.i,c@s,eZdZdZdZeddZeddZdS)_ClientFactoryMixinzeMixin to allow factories that create credentials. .. note:: This class is virtual. FcOsNd|vrtdtj|}|jrd|vr|d|d<||d<||i|S)aFactory to retrieve JSON credentials while creating client. :type info: dict :param info: The JSON object with a private key and other credentials information (downloaded from the Google APIs console). :type args: tuple :param args: Remaining positional arguments to pass to constructor. :param kwargs: Remaining keyword arguments to pass to constructor. :rtype: :class:`_ClientFactoryMixin` :returns: The client created with the retrieved JSON credentials. :raises TypeError: if there is a conflict with the kwargs and the credentials created by the factory. credentialsz,credentials must not be in keyword argumentsproject project_id) TypeErrorr Credentialsfrom_service_account_info _SET_PROJECTget)clsinfoargskwargsr rU/var/www/html/loop/nvenv/lib/python3.10/site-packages/google/cloud/client/__init__.pyr6s z-_ClientFactoryMixin.from_service_account_infocOsRtj|ddd }t|}Wdn1swY|j|g|Ri|S)aFactory to retrieve JSON credentials while creating client. :type json_credentials_path: str :param json_credentials_path: The path to a private key file (this file was given to you when you created the service account). This file must contain a JSON object with a private key and other credentials information (downloaded from the Google APIs console). :type args: tuple :param args: Remaining positional arguments to pass to constructor. :param kwargs: Remaining keyword arguments to pass to constructor. :rtype: :class:`_ClientFactoryMixin` :returns: The client created with the retrieved JSON credentials. :raises TypeError: if there is a conflict with the kwargs and the credentials created by the factory. rutf-8)encodingN)ioopenjsonloadr)rjson_credentials_pathrrjson_ficredentials_inforrrfrom_service_account_jsonTs z-_ClientFactoryMixin.from_service_account_jsonN)__name__ __module__ __qualname____doc__r classmethodrr"rrrrr ,s r c@sVeZdZUdZdZeeedfdfed< d ddZ ddZ e d d Z d d Z dS)ClientaClient to bundle configuration needed for API requests. Stores ``credentials`` and an HTTP object so that subclasses can pass them along to a connection class. If no value is passed in for ``_http``, a :class:`requests.Session` object will be created and authorized with the ``credentials``. If not, the ``credentials`` and ``_http`` need not be related. Callers and subclasses may seek to use the private key from ``credentials`` to sign data. Args: credentials (google.auth.credentials.Credentials): (Optional) The OAuth2 Credentials to use for this client. If not passed (and if no ``_http`` object is passed), falls back to the default inferred from the environment. client_options (google.api_core.client_options.ClientOptions): (Optional) Custom options for the client. _http (requests.Session): (Optional) HTTP object to make requests. Can be any object that defines ``request()`` with the same interface as :meth:`requests.Session.request`. If not passed, an ``_http`` object is created that is bound to the ``credentials`` for the current object. This parameter should be considered private, and could change in the future. Raises: google.auth.exceptions.DefaultCredentialsError: Raised if ``credentials`` is not specified and the library fails to acquire default credentials. N.SCOPEcCst|tr tjj|}|durtjj}|r"|jr"tjj d|r0t|tj j j s0t t|jp5|j}|sT|durT|jrKtj j|j|d\}}n tj j|d\}}tj j j||d|_|jri|j|j|_||_|j|_dS)NzK'credentials' and 'client_options.credentials_file' are mutually exclusive.)scopes) isinstancedictgoogleapi_coreclient_options from_dict ClientOptionscredentials_file exceptionsDuplicateCredentialArgsauthr r ValueError_GOOGLE_AUTH_CREDENTIALS_HELPr*r)load_credentials_from_filedefaultwith_scopes_if_required _credentialsquota_project_idwith_quota_project_http_internalclient_cert_source_client_cert_source)selfr _httpr/r*_rrr__init__s8        zClient.__init__cCstdddg)z1Explicitly state that clients are not pickleable. z4Pickling client objects is explicitly not supported.z>Clients have non-trivial state that is local and unpickleable.)rjoinrArrr __getstate__szClient.__getstate__cCs6|jdurtjjjj|jtd|_|j|j |jS)zGetter for object used for HTTP transport. :rtype: :class:`~requests.Session` :returns: An HTTP object. N)refresh_timeout) r>r-r5 transportrequestsAuthorizedSessionr;_CREDENTIALS_REFRESH_TIMEOUTconfigure_mtls_channelr@rGrrrrBs  z Client._httpcCs|jdur |jdSdS)zClean up transport, if set. Suggested use: .. code-block:: python import contextlib with contextlib.closing(client): # closes on exit do_something_with(client) N)r>closerGrrrrOs z Client.close)NNN)r#r$r%r&r)rrstr__annotations__rDrHpropertyrBrOrrrrr(ps " '  r(c@s&eZdZdZdddZeddZdS)_ClientProjectMixinaiMixin to allow setting the project on the client. :type project: str :param project: (Optional) the project which the client acts on behalf of. If not passed, falls back to the default inferred from the environment. :type credentials: :class:`google.auth.credentials.Credentials` :param credentials: (Optional) credentials used to discover a project, if not passed. :raises: :class:`EnvironmentError` if the project is neither passed in nor set on the credentials or in the environment. :class:`ValueError` if the project value is invalid. NcCs|durttjttj}|dur|durt|dd}|dur&||}|dur.tdt|t r8| d}t|t sAt d||_ dS)Nr zHProject was not passed and could not be determined from the environment.rzProject must be a string.)osgetenvrPROJECTLEGACY_PROJECTgetattr_determine_defaultEnvironmentErrorr+bytesdecoderPr6r )rAr r rrrrDs$       z_ClientProjectMixin.__init__cCst|S)z'Helper: use default project detection.r)r rrrrYsz&_ClientProjectMixin._determine_default)NN)r#r$r%r&rD staticmethodrYrrrrrSs  !rSc@seZdZdZdZdddZdS)ClientWithProjectaClient that also stores a project. :type project: str :param project: the project which the client acts on behalf of. If not passed falls back to the default inferred from the environment. :type credentials: :class:`~google.auth.credentials.Credentials` :param credentials: (Optional) The OAuth2 Credentials to use for this client. If not passed (and if no ``_http`` object is passed), falls back to the default inferred from the environment. :type _http: :class:`~requests.Session` :param _http: (Optional) HTTP object to make requests. Can be any object that defines ``request()`` with the same interface as :meth:`~requests.Session.request`. If not passed, an ``_http`` object is created that is bound to the ``credentials`` for the current object. This parameter should be considered private, and could change in the future. :raises: :class:`ValueError` if the project is neither passed in nor set in the environment. TNcCs&tj|||dtj||||ddS)N)r r )r r/rB)rSrDr()rAr r r/rBrrrrD?s zClientWithProject.__init__)NNNN)r#r$r%r&rrDrrrrr^"sr^)r&rrrTpicklertypingrrgoogle.api_core.client_optionsr-google.api_core.exceptions google.authrgoogle.auth.credentialsgoogle.auth.transport.requestsgoogle.cloud._helpersr google.oauth2rr7rMobjectr r(rSr^rrrrs,      Dz8