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__/channel.cpython-38.pyc
U

P��g.+�	@s�dZddlmZddlZddlZddlmZddlmZe�ddd�Z	dd	d
ddd
ddd�Z
dZdZdZ
dZdZdd�ZGdd�de�ZGdd�de�Zdd�Ze�d�d!dd ��ZdS)"a�Channel notifications support.

Classes and functions to support channel subscriptions and notifications
on those channels.

Notes:
  - This code is based on experimental APIs and is subject to change.
  - Notification does not do deduplication of notification ids, that's up to
    the receiver.
  - Storing the Channel between calls is up to the caller.


Example setting up a channel:

  # Create a new channel that gets notifications via webhook.
  channel = new_webhook_channel("https://example.com/my_web_hook")

  # Store the channel, keyed by 'channel.id'. Store it before calling the
  # watch method because notifications may start arriving before the watch
  # method returns.
  ...

  resp = service.objects().watchAll(
    bucket="some_bucket_id", body=channel.body()).execute()
  channel.update(resp)

  # Store the channel, keyed by 'channel.id'. Store it after being updated
  # since the resource_id value will now be correct, and that's needed to
  # stop a subscription.
  ...


An example Webhook implementation using webapp2. Note that webapp2 puts
headers in a case insensitive dictionary, as headers aren't guaranteed to
always be upper case.

  id = self.request.headers[X_GOOG_CHANNEL_ID]

  # Retrieve the channel by id.
  channel = ...

  # Parse notification from the headers, including validating the id.
  n = notification_from_headers(channel, self.request.headers)

  # Do app specific stuff with the notification here.
  if n.resource_state == 'sync':
    # Code to handle sync state.
  elif n.resource_state == 'exists':
    # Code to handle the exists state.
  elif n.resource_state == 'not_exists':
    # Code to handle the not exists state.


Example of unsubscribing.

  service.channels().stop(channel.body()).execute()
�)�absolute_importN)�_helpers)�errorsi���address�id�
expiration�params�resource_id�resource_uri�type�token)rrrr	�
resourceId�resourceUrirr
zX-GOOG-CHANNEL-IDzX-GOOG-MESSAGE-NUMBERzX-GOOG-RESOURCE-STATEzX-GOOG-RESOURCE-URIzX-GOOG-RESOURCE-IDcCs&i}|��D]\}}|||��<q|S)N)�items�upper)�headers�new_headers�k�v�r�D/opt/cppython/lib/python3.8/site-packages/googleapiclient/channel.py�_upper_header_keysgsrc@s"eZdZdZe�d�dd��ZdS)�Notificationa�A Notification from a Channel.

    Notifications are not usually constructed directly, but are returned
    from functions like notification_from_headers().

    Attributes:
      message_number: int, The unique id number of this notification.
      state: str, The state of the resource being monitored.
      uri: str, The address of the resource being monitored.
      resource_id: str, The unique identifier of the version of the resource at
        this event.
    �cCs||_||_||_||_dS)a�Notification constructor.

        Args:
          message_number: int, The unique id number of this notification.
          state: str, The state of the resource being monitored. Can be one
            of "exists", "not_exists", or "sync".
          resource_uri: str, The address of the resource being monitored.
          resource_id: str, The identifier of the watched resource.
        N)�message_number�staterr
)�selfrrrr
rrr�__init__|szNotification.__init__N)�__name__�
__module__�__qualname__�__doc__�util�
positionalrrrrrrns
rc@s4eZdZdZe�d�ddd��Zdd�Zd	d
�ZdS)�ChannelaA Channel for notifications.

    Usually not constructed directly, instead it is returned from helper
    functions like new_webhook_channel().

    Attributes:
      type: str, The type of delivery mechanism used by this channel. For
        example, 'web_hook'.
      id: str, A UUID for the channel.
      token: str, An arbitrary string associated with the channel that
        is delivered to the target address with each event delivered
        over this channel.
      address: str, The address of the receiving entity where events are
        delivered. Specific to the channel type.
      expiration: int, The time, in milliseconds from the epoch, when this
        channel will expire.
      params: dict, A dictionary of string to string, with additional parameters
        controlling delivery channel behavior.
      resource_id: str, An opaque id that identifies the resource that is
        being watched. Stable across different API versions.
      resource_uri: str, The canonicalized ID of the watched resource.
    rN�c		Cs4||_||_||_||_||_||_||_||_dS)a�Create a new Channel.

        In user code, this Channel constructor will not typically be called
        manually since there are functions for creating channels for each specific
        type with a more customized set of arguments to pass.

        Args:
          type: str, The type of delivery mechanism used by this channel. For
            example, 'web_hook'.
          id: str, A UUID for the channel.
          token: str, An arbitrary string associated with the channel that
            is delivered to the target address with each event delivered
            over this channel.
          address: str,  The address of the receiving entity where events are
            delivered. Specific to the channel type.
          expiration: int, The time, in milliseconds from the epoch, when this
            channel will expire.
          params: dict, A dictionary of string to string, with additional parameters
            controlling delivery channel behavior.
          resource_id: str, An opaque id that identifies the resource that is
            being watched. Stable across different API versions.
          resource_uri: str, The canonicalized ID of the watched resource.
        N)rrr
rrr	r
r)	rrrr
rrr	r
rrrrr�s#zChannel.__init__cCsZ|j|j|j|jd�}|jr&|j|d<|jr6|j|d<|jrF|j|d<|jrV|j|d<|S)z�Build a body from the Channel.

        Constructs a dictionary that's appropriate for passing into watch()
        methods as the value of body argument.

        Returns:
          A dictionary representation of the channel.
        )rr
rrr	rrr)rr
rrr	r
rr)r�resultrrr�body�s
�



zChannel.bodycCs4t��D]&\}}|�|�}|dk	rt|||�qdS)a�Update a channel with information from the response of watch().

        When a request is sent to watch() a resource, the response returned
        from the watch() request is a dictionary with updated channel information,
        such as the resource_id, which is needed when stopping a subscription.

        Args:
          resp: dict, The response from a watch() method.
        N)�CHANNEL_PARAMSr�get�setattr)r�resp�	json_name�
param_name�valuerrr�update�s

zChannel.update)NNr&r&)	rr r!r"r#r$rr(r0rrrrr%�s�+r%cCsft|�}|t}|j|kr0t�d|j|f��n2t|t�}|t}|t}|t	}t
||||�SdS)aParse a notification from the webhook request headers, validate
      the notification, and return a Notification object.

    Args:
      channel: Channel, The channel that the notification is associated with.
      headers: dict, A dictionary like object that contains the request headers
        from the webhook HTTP request.

    Returns:
      A Notification object.

    Raises:
      errors.InvalidNotificationError if the notification is invalid.
      ValueError if the X-GOOG-MESSAGE-NUMBER can't be converted to an int.
    zChannel id mismatch: %s != %sN)r�X_GOOG_CHANNEL_IDrrZInvalidNotificationError�int�X_GOOG_MESSAGE_NUMBER�X_GOOG_RESOURCE_STATE�X_GOOG_RESOURCE_URI�X_GOOG_RESOURCE_IDr)ZchannelrZ
channel_idrrrr
rrr�notification_from_headers�s
�r7�cCsZd}|r>|t}|jd|j|jddd}|dkr>d}tdtt���||||d�S)aCreate a new webhook Channel.

    Args:
      url: str, URL to post notifications to.
      token: str, An arbitrary string associated with the channel that
        is delivered to the target address with each notification delivered
        over this channel.
      expiration: datetime.datetime, A time in the future when the channel
        should expire. Can also be None if the subscription should use the
        default expiration. Note that different services may have different
        limits on how long a subscription lasts. Check the response from the
        watch() method to see the value the service has set for an expiration
        time.
      params: dict, Extra parameters to pass on channel creation. Currently
        not used for webhook channels.
    ri��iZweb_hook)rr	)�EPOCH�microseconds�seconds�daysr%�str�uuid�uuid4)�urlr
rr	Z
expiration_ms�deltarrr�new_webhook_channels �
�rC)NNN)r"�
__future__r�datetimer?Zgoogleapiclientrr#rr:r)r1r3r4r5r6r�objectrr%r7r$rCrrrr�<module>s49�n
F1le Man4ger