a ù!f'&ã@sTdZddlmZddlmZddlmZddlmZddlm Z Gdd„de ƒZ d S) zµConfigure HMAC keys that can be used to authenticate requests to Google Cloud Storage. See [HMAC keys documentation](https://cloud.google.com/storage/docs/authentication/hmackeys) é)ÚNotFound)Ú_rfc3339_nanos_to_datetime)Ú_DEFAULT_TIMEOUT)Ú DEFAULT_RETRY)ÚDEFAULT_RETRY_IF_ETAG_IN_JSONc@süeZdZdZdZdZdZeefZd)dd„Zdd „Z d d „Z e d d „ƒZ e dd„ƒZ e dd„ƒZe dd„ƒZe dd„ƒZe dd„ƒZejdd„ƒZe dd„ƒZe dd„ƒZe dd„ƒZe dd „ƒZeefd!d"„Zeefd#d$„Zeefd%d&„Zeefd'd(„ZdS)*ÚHMACKeyMetadataaMetadata about an HMAC service account key withn Cloud Storage. :type client: :class:`~google.cloud.stoage.client.Client` :param client: client associated with the key metadata. :type access_id: str :param access_id: (Optional) Unique ID of an existing key. :type project_id: str :param project_id: (Optional) Project ID of an existing key. Defaults to client's project. :type user_project: str :param user_project: (Optional) This parameter is currently ignored. ZACTIVEZINACTIVEZDELETEDNcCs:||_i|_|dur||jd<|dur0||jd<||_dS)NÚaccessIdÚ projectId)Ú_clientÚ _propertiesÚ _user_project)ÚselfÚclientÚ access_idZ project_idÚ user_project©rú^/var/www/html/python-backend/venv/lib/python3.9/site-packages/google/cloud/storage/hmac_key.pyÚ__init__9s  zHMACKeyMetadata.__init__cCs(t||jƒstS|j|jko&|j|jkS©N)Ú isinstanceÚ __class__ÚNotImplementedr r)r ÚotherrrrÚ__eq__Es zHMACKeyMetadata.__eq__cCst|jƒt|jƒSr)Úhashr r©r rrrÚ__hash__KszHMACKeyMetadata.__hash__cCs |j d¡S)z|Access ID of the key. :rtype: str or None :returns: unique identifier of the key within a project. r©r ÚgetrrrrrNszHMACKeyMetadata.access_idcCs |j d¡S)z•ETag identifying the version of the key metadata. :rtype: str or None :returns: ETag for the version of the key's metadata. ÚetagrrrrrrWszHMACKeyMetadata.etagcCs |j d¡S)zID of the key, including the Project ID and the Access ID. :rtype: str or None :returns: ID of the key. Úidrrrrrr `szHMACKeyMetadata.idcCs |j d¡S)zzProject ID associated with the key. :rtype: str or None :returns: project identfier for the key. r rrrrrÚprojectiszHMACKeyMetadata.projectcCs |j d¡S)z­Service account e-mail address associated with the key. :rtype: str or None :returns: e-mail address for the service account which created the key. ZserviceAccountEmailrrrrrÚservice_account_emailrsz%HMACKeyMetadata.service_account_emailcCs |j d¡S)zÂGet / set key's state. One of: - ``ACTIVE`` - ``INACTIVE`` - ``DELETED`` :rtype: str or None :returns: key's current state. Ústaterrrrrr#{s zHMACKeyMetadata.statecCs||jd<dS)Nr#)r ©r Úvaluerrrr#‰scCs |j d¡}|durt|ƒSdS)á3Retrieve the timestamp at which the HMAC key was created. :rtype: :class:`datetime.datetime` or ``NoneType`` :returns: Datetime object parsed from RFC3339 valid timestamp, or ``None`` if the bucket's resource has not been loaded from the server. Z timeCreatedN©r rrr$rrrÚ time_createds zHMACKeyMetadata.time_createdcCs |j d¡}|durt|ƒSdS)r&ÚupdatedNr'r$rrrr)šs zHMACKeyMetadata.updatedcCs:|jdurtdƒ‚|j}|dur(|jj}d|›d|j›S)z%Resource path for the metadata's key.NzNo 'access_id' set.z /projects/z /hmacKeys/)rÚ ValueErrorr!r )r r!rrrÚpath§s  zHMACKeyMetadata.pathcCs|jS)z—Project ID to be billed for API requests made via this bucket. This property is currently ignored by the server. :rtype: str )r rrrrr´szHMACKeyMetadata.user_projectcCsPz2i}|jdur|j|d<|jj|j|||dWntyFYdS0dSdS)a#Determine whether or not the key for this metadata exists. :type timeout: float or tuple :param timeout: (Optional) The amount of time, in seconds, to wait for the server response. See: :ref:`configuring_timeouts` :type retry: google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy :param retry: (Optional) How to retry the RPC. See: :ref:`configuring_retries` :rtype: bool :returns: True if the key exists in Cloud Storage. NÚ userProject©Z query_paramsÚtimeoutÚretryFT)rr Ú _get_resourcer+r©r r.r/Ú qs_paramsrrrÚexists¾s  ü  zHMACKeyMetadata.existscCs4i}|jdur|j|d<|jj|j|||d|_dS)a4Reload properties from Cloud Storage. :type timeout: float or tuple :param timeout: (Optional) The amount of time, in seconds, to wait for the server response. See: :ref:`configuring_timeouts` :type retry: google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy :param retry: (Optional) How to retry the RPC. See: :ref:`configuring_retries` :raises :class:`~google.api_core.exceptions.NotFound`: if the key does not exist on the back-end. Nr,r-)rr r0r+r r1rrrÚreloadÞs  üzHMACKeyMetadata.reloadcCs@i}|jdur|j|d<d|ji}|jj|j||||d|_dS)a9Save writable properties to Cloud Storage. :type timeout: float or tuple :param timeout: (Optional) The amount of time, in seconds, to wait for the server response. See: :ref:`configuring_timeouts` :type retry: google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy :param retry: (Optional) How to retry the RPC. See: :ref:`configuring_retries` :raises :class:`~google.api_core.exceptions.NotFound`: if the key does not exist on the back-end. Nr,r#r-)rr#r Z _put_resourcer+r )r r.r/r2ÚpayloadrrrÚupdateùs   ûzHMACKeyMetadata.updatecCs2i}|jdur|j|d<|jj|j|||ddS)a1Delete the key from Cloud Storage. :type timeout: float or tuple :param timeout: (Optional) The amount of time, in seconds, to wait for the server response. See: :ref:`configuring_timeouts` :type retry: google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy :param retry: (Optional) How to retry the RPC. See: :ref:`configuring_retries` :raises :class:`~google.api_core.exceptions.NotFound`: if the key does not exist on the back-end. Nr,r-)rr Z_delete_resourcer+r1rrrÚdeletes  üzHMACKeyMetadata.delete)NNN)Ú__name__Ú __module__Ú __qualname__Ú__doc__Z ACTIVE_STATEZINACTIVE_STATEZ DELETED_STATEZ_SETTABLE_STATESrrrÚpropertyrrr r!r"r#Úsetterr(r)r+rrrr3r4rr6r7rrrrrsD             rN) r;Zgoogle.cloud.exceptionsrZgoogle.cloud._helpersrZgoogle.cloud.storage.constantsrZgoogle.cloud.storage.retryrrÚobjectrrrrrÚs