def get_subscription(self, subscription, options=None):
"""
Gets the configuration details of a subscription.
Example:
>>> from google.cloud.gapic.pubsub.v1 import subscriber_client
>>> client = subscriber_client.SubscriberClient()
>>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
>>> response = client.get_subscription(subscription)
Args:
subscription (string): The name of the subscription to get.
Format is ``projects/{project}/subscriptions/{sub}``.
options (:class:`google.gax.CallOptions`): Overrides the default
settings for this call, e.g, timeout, retries etc.
Returns:
A :class:`google.cloud.proto.pubsub.v1.pubsub_pb2.Subscription` instance.
Raises:
:exc:`google.gax.errors.GaxError` if the RPC is aborted.
:exc:`ValueError` if the parameters are invalid.
"""
# Create the request object.
request = pubsub_pb2.GetSubscriptionRequest(subscription=subscription)
return self._get_subscription(request, options)
def test_get_subscription(self, mock_create_stub):
# Mock gRPC layer
grpc_stub = mock.Mock()
mock_create_stub.return_value = grpc_stub
client = subscriber_client.SubscriberClient()
# Mock request
subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
# Mock response
name = 'name3373707'
topic = 'topic110546223'
ack_deadline_seconds = 2135351438
retain_acked_messages = False
expected_response = pubsub_pb2.Subscription(
name=name,
topic=topic,
ack_deadline_seconds=ack_deadline_seconds,
retain_acked_messages=retain_acked_messages)
grpc_stub.GetSubscription.return_value = expected_response
response = client.get_subscription(subscription)
self.assertEqual(expected_response, response)
grpc_stub.GetSubscription.assert_called_once()
args, kwargs = grpc_stub.GetSubscription.call_args
self.assertEqual(len(args), 2)
self.assertEqual(len(kwargs), 1)
self.assertIn('metadata', kwargs)
actual_request = args[0]
expected_request = pubsub_pb2.GetSubscriptionRequest(
subscription=subscription)
self.assertEqual(expected_request, actual_request)