o ˷eh<@sdZddlZddlmZddlmZddlmZdZdZ dZ d Z d Z d Z d Zd ZdZeeeZeeZdZGdddeZddZdS)z*Support for bucket notification resources.N)NotFound)_DEFAULT_TIMEOUT) DEFAULT_RETRYOBJECT_FINALIZEOBJECT_METADATA_UPDATE OBJECT_DELETEOBJECT_ARCHIVE JSON_API_V1NONEz-//pubsub.googleapis.com/projects/{}/topics/{}z)(?P[a-z][a-z0-9-]{4,28}[a-z0-9])z (?P[A-Za-z](\w|[-_.~+%])+)zpResource has invalid topic: {}; see https://cloud.google.com/storage/docs/json_api/v1/notifications/insert#topicc@seZdZdZdddddedfddZeddZeddZ ed d Z ed d Z ed dZ eddZ eddZeddZeddZeddZeddZeddZeddZdd Zd!d"Zdedfd#d$Zdeefd%d&Zdeefd'd(Zdeefd)d*ZdS)+BucketNotificationaRepresent a single notification resource for a bucket. See: https://cloud.google.com/storage/docs/json_api/v1/notifications :type bucket: :class:`google.cloud.storage.bucket.Bucket` :param bucket: Bucket to which the notification is bound. :type topic_name: str :param topic_name: (Optional) Topic name to which notifications are published. :type topic_project: str :param topic_project: (Optional) Project ID of topic to which notifications are published. If not passed, uses the project ID of the bucket's client. :type custom_attributes: dict :param custom_attributes: (Optional) Additional attributes passed with notification events. :type event_types: list(str) :param event_types: (Optional) Event types for which notification events are published. :type blob_name_prefix: str :param blob_name_prefix: (Optional) Prefix of blob names for which notification events are published. :type payload_format: str :param payload_format: (Optional) Format of payload for notification events. :type notification_id: str :param notification_id: (Optional) The ID of the notification. Nc Cs||_||_|dur|jj}|durtd||_i|_|dur%||jd<|dur.||jd<|dur7||jd<|dur@||jd<||jd<dS)Nz8Client project not set: pass an explicit topic_project.custom_attributes event_typesobject_name_prefixidpayload_format)_bucket _topic_nameclientproject ValueError_topic_project _properties) selfbucket topic_name topic_projectr r blob_name_prefixrnotification_idrX/var/www/ideatree/venv/lib/python3.10/site-packages/google/cloud/storage/notification.py__init__Ts"     zBucketNotification.__init__cCs>|d}|dur tdt|\}}||||d}||_|S)aConstruct an instance from the JSON repr returned by the server. See: https://cloud.google.com/storage/docs/json_api/v1/notifications :type resource: dict :param resource: JSON repr of the notification :type bucket: :class:`google.cloud.storage.bucket.Bucket` :param bucket: Bucket to which the notification is bound. :rtype: :class:`BucketNotification` :returns: the new notification instance topicNzResource has no topic)r)getr_parse_topic_pathr)clsresourcer topic_pathnamerinstancerrr from_api_reprzs  z BucketNotification.from_api_reprcC|jS)z*Bucket to which the notification is bound.)rrrrrrzBucketNotification.bucketcCr*)z0Topic name to which notifications are published.)rr+rrrrr,zBucketNotification.topic_namecCr*)z9Project ID of topic to which notifications are published.)rr+rrrrr,z BucketNotification.topic_projectcC |jdS)z2Custom attributes passed with notification events.r rr"r+rrrr  z$BucketNotification.custom_attributescCr-)z8Event types for which notification events are published.r r.r+rrrr r/zBucketNotification.event_typescCr-)zAPrefix of blob names for which notification events are published.rr.r+rrrrr/z#BucketNotification.blob_name_prefixcCr-)z)Format of payload of notification events.rr.r+rrrrr/z!BucketNotification.payload_formatcCr-)z'Server-set ID of notification resource.rr.r+rrrrr/z"BucketNotification.notification_idcCr-))Server-set ETag of notification resource.etagr.r+rrrr1r/zBucketNotification.etagcCr-)r0selfLinkr.r+rrr self_linkr/zBucketNotification.self_linkcCs|jjS)z%The client bound to this notfication.)rrr+rrrrszBucketNotification.clientcCsd|jjd|jS)z#The URL path for this notification./b/z/notificationConfigs/)rr'rr+rrrpathszBucketNotification.pathcCs|dur|j}|S)a:Check client or verify over-ride. :type client: :class:`~google.cloud.storage.client.Client` or ``NoneType`` :param client: the client to use. :rtype: :class:`google.cloud.storage.client.Client` :returns: The client passed in or the bucket's client. N)r)rrrrr_require_clients z"BucketNotification._require_clientcCs|j|j|dS)zwHelper for :meth:`reload`. :type response: dict :param response: resource mapping from server N)rclearupdate)rresponserrr_set_propertiess z"BucketNotification._set_propertiescCs|jdur td|j||}i}|jjdur |jj|d<d|jjd}|j}|jdurr5 propertiesrrrcreates,        zBucketNotification.createcCsh|jdur td||}i}|jjdur|jj|d<z |j|j|||dWdSty3YdSw)aTest whether this notification exists. See: https://cloud.google.com/storage/docs/json_api/v1/notifications/get If :attr:`user_project` is set on the bucket, bills the API request to that project. :type client: :class:`~google.cloud.storage.client.Client` or ``NoneType`` :param client: (Optional) The client to use. If not passed, falls back to the ``client`` stored on the current bucket. :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 notification exists, else False. :raises ValueError: if the notification has no ID. N%Notification not intialized by serverr;r=FT)rrr6rrA _get_resourcer5rrrr?r@r>rrrexistss"     zBucketNotification.existscCsZ|jdur td||}i}|jjdur|jj|d<|j|j|||d}||dS)aUpdate this notification from the server configuration. See: https://cloud.google.com/storage/docs/json_api/v1/notifications/get If :attr:`user_project` is set on the bucket, bills the API request to that project. :type client: :class:`~google.cloud.storage.client.Client` or ``NoneType`` :param client: (Optional) The client to use. If not passed, falls back to the ``client`` stored on the current bucket. :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 ValueError: if the notification has no ID. NrHr;r=)rrr6rrArIr5r:)rrr?r@r>r9rrrreloadIs    zBucketNotification.reloadcCsP|jdur td||}i}|jjdur|jj|d<|j|j|||ddS)aDelete this notification. See: https://cloud.google.com/storage/docs/json_api/v1/notifications/delete If :attr:`user_project` is set on the bucket, bills the API request to that project. :type client: :class:`~google.cloud.storage.client.Client` or ``NoneType`` :param client: (Optional) The client to use. If not passed, falls back to the ``client`` stored on the current bucket. :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 notification does not exist. :raises ValueError: if the notification has no ID. NrHr;r=)rrr6rrA_delete_resourcer5rJrrrdeletess     zBucketNotification.delete)__name__ __module__ __qualname____doc__NONE_PAYLOAD_FORMATr classmethodr)propertyrrrr r rrrr1r3rr5r6r:rrGrrKrLrNrrrrr -sT) &              4/*r cCs4t|}|durtt||d|dfS)aiVerify that a topic path is in the correct format. .. _resource manager docs: https://cloud.google.com/resource-manager/ reference/rest/v1beta1/projects# Project.FIELDS.project_id .. _topic spec: https://cloud.google.com/storage/docs/json_api/v1/ notifications/insert#topic Expected to be of the form: //pubsub.googleapis.com/projects/{project}/topics/{topic} where the ``project`` value must be "6 to 30 lowercase letters, digits, or hyphens. It must start with a letter. Trailing hyphens are prohibited." (see `resource manager docs`_) and ``topic`` must have length at least two, must start with a letter and may only contain alphanumeric characters or ``-``, ``_``, ``.``, ``~``, ``+`` or ``%`` (i.e characters used for URL encoding, see `topic spec`_). Args: topic_path (str): The topic path to be verified. Returns: Tuple[str, str]: The ``project`` and ``topic`` parsed from the ``topic_path``. Raises: ValueError: If the topic path is invalid. Nr'r) _TOPIC_REF_REmatchr _BAD_TOPICrDgroup)r&rWrrrr#s r#)rRregoogle.api_core.exceptionsrgoogle.cloud.storage.constantsrgoogle.cloud.storage.retryrOBJECT_FINALIZE_EVENT_TYPE!OBJECT_METADATA_UPDATE_EVENT_TYPEOBJECT_DELETE_EVENT_TYPEOBJECT_ARCHIVE_EVENT_TYPEJSON_API_V1_PAYLOAD_FORMATrSrC_PROJECT_PATTERN_TOPIC_NAME_PATTERNrD_TOPIC_REF_PATTERNcompilerVrXobjectr r#rrrrs,      s