def test_construct_settings_override(self):
_override = {
'interfaces': {
_SERVICE_NAME: {
'methods': {
'PageStreamingMethod': None,
'BundlingMethod': {
'timeout_millis': 8000,
'bundling': None
}
}
}
}
}
defaults = api_callable.construct_settings(
_SERVICE_NAME, _A_CONFIG, _override, _RETRY_DICT,
bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS)
settings = defaults['bundling_method']
self.assertAlmostEqual(settings.timeout, 8.0)
self.assertIsNone(settings.bundler)
self.assertIsNone(settings.page_descriptor)
settings = defaults['page_streaming_method']
self.assertAlmostEqual(settings.timeout, 12.0)
self.assertIsInstance(settings.page_descriptor, PageDescriptor)
self.assertIsNone(settings.retry)
def test_construct_settings_override(self):
_override = {
'interfaces': {
_SERVICE_NAME: {
'methods': {
'PageStreamingMethod': None,
'BundlingMethod': {
'timeout_millis': 8000,
'bundling': None
}
}
}
}
}
defaults = api_callable.construct_settings(
_SERVICE_NAME,
_A_CONFIG,
_override,
_RETRY_DICT,
bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS)
settings = defaults['bundling_method']
self.assertAlmostEqual(settings.timeout, 8.0)
self.assertIsNone(settings.bundler)
self.assertIsNone(settings.page_descriptor)
settings = defaults['page_streaming_method']
self.assertAlmostEqual(settings.timeout, 12.0)
self.assertIsInstance(settings.page_descriptor, PageDescriptor)
self.assertIsNone(settings.retry)
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
metadata_transformer=None,
ssl_creds=None,
scopes=None,
client_config=None,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.beta.implementations.Channel`): A ``Channel``
object through which to make calls.
ssl_creds (:class:`grpc.beta.implementations.ClientCredentials`):
A `ClientCredentials` for use with an SSL-enabled channel.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
metadata_transformer (Callable[[], list]): A function that creates
the metadata for requests.
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A ImageAnnotatorApi object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'image_annotator_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.cloud.vision.v1.ImageAnnotator',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
kwargs={'metadata': metadata})
self.stub = config.create_stub(
image_annotator_pb2.beta_create_ImageAnnotator_stub,
service_path,
port,
ssl_creds=ssl_creds,
channel=channel,
metadata_transformer=metadata_transformer,
scopes=scopes)
self._batch_annotate_images = api_callable.create_api_call(
self.stub.BatchAnnotateImages,
settings=defaults['batch_annotate_images'])
def test_construct_settings(self):
defaults = api_callable.construct_settings(
_SERVICE_NAME,
_A_CONFIG,
dict(),
_RETRY_DICT,
bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS,
kwargs={'key1': 'value1'})
# Check values of the bundling method settings.
settings = defaults['bundling_method']
self.assertAlmostEqual(settings.timeout, 25.0)
self.assertIsInstance(settings.bundler, bundling.Executor)
self.assertIsInstance(settings.bundle_descriptor, BundleDescriptor)
self.assertIsNone(settings.page_descriptor)
# Check values of the page streaming method settings.
settings = defaults['page_streaming_method']
self.assertAlmostEqual(settings.timeout, 12.0)
self.assertIsNone(settings.bundler)
self.assertIsNone(settings.bundle_descriptor)
self.assertIsInstance(settings.page_descriptor, PageDescriptor)
# Check values that should be the same in both method settings.
for settings in defaults.values():
self.assertIsInstance(settings.retry, RetryOptions)
self.assertEqual(settings.kwargs['key1'], 'value1')
self.assertIn('metadata', settings.kwargs)
metadata = settings.kwargs['metadata'][0][1]
self.assertIn('gl-python/%s' % platform.python_version(), metadata)
self.assertIn('gax/%s' % GAX_VERSION, metadata)
self.assertIn('grpc/%s' % GRPC_VERSION, metadata)
def test_construct_settings_override2(self):
_override = {
'interfaces': {
_SERVICE_NAME: {
'retry_codes': {
'bar_retry': [],
'baz_retry': ['code_a']
},
'retry_params': {
'default': {
'initial_retry_delay_millis': 1000,
'retry_delay_multiplier': 1.2,
'max_retry_delay_millis': 10000,
'initial_rpc_timeout_millis': 3000,
'rpc_timeout_multiplier': 1.3,
'max_rpc_timeout_millis': 30000,
'total_timeout_millis': 300000
},
},
'methods': {
'BundlingMethod': {
'retry_params_name': 'default',
'retry_codes_name': 'baz_retry',
},
},
}
}
}
defaults = api_callable.construct_settings(
_SERVICE_NAME,
_A_CONFIG,
_override,
_RETRY_DICT,
bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS)
settings = defaults['bundling_method']
backoff = settings.retry.backoff_settings
self.assertEqual(backoff.initial_retry_delay_millis, 1000)
self.assertEqual(settings.retry.retry_codes, [_RETRY_DICT['code_a']])
self.assertIsInstance(settings.bundler, bundling.Executor)
self.assertIsInstance(settings.bundle_descriptor, BundleDescriptor)
# page_streaming_method is unaffected because it's not specified in
# overrides. 'bar_retry' or 'default' definitions in overrides should
# not affect the methods which are not in the overrides.
settings = defaults['page_streaming_method']
backoff = settings.retry.backoff_settings
self.assertEqual(backoff.initial_retry_delay_millis, 100)
self.assertEqual(backoff.retry_delay_multiplier, 1.2)
self.assertEqual(backoff.max_retry_delay_millis, 1000)
self.assertEqual(settings.retry.retry_codes, [_RETRY_DICT['code_c']])
def test_construct_settings_override(self):
_bundling_override = {'bundling_method': None}
_retry_override = {'page_streaming_method': None}
defaults = api_callable.construct_settings(
_SERVICE_NAME, _A_CONFIG, _bundling_override, _retry_override,
_RETRY_DICT, 30, bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS)
settings = defaults['bundling_method']
self.assertEquals(settings.timeout, 30)
self.assertIsNone(settings.bundler)
self.assertIsNone(settings.page_descriptor)
settings = defaults['page_streaming_method']
self.assertEquals(settings.timeout, 30)
self.assertIsInstance(settings.page_descriptor, PageDescriptor)
self.assertIsNone(settings.retry)
def test_construct_settings_override(self):
_bundling_override = {'bundling_method': None}
_retry_override = {'page_streaming_method': None}
defaults = api_callable.construct_settings(
_SERVICE_NAME, _A_CONFIG, _bundling_override, _retry_override,
_RETRY_DICT, 30, bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS)
settings = defaults['bundling_method']
self.assertEquals(settings.timeout, 30)
self.assertIsNone(settings.bundler)
self.assertIsNone(settings.page_descriptor)
settings = defaults['page_streaming_method']
self.assertEquals(settings.timeout, 30)
self.assertIsInstance(settings.page_descriptor, PageDescriptor)
self.assertIsNone(settings.retry)
def test_construct_with_explicit_metadata(self):
defaults = api_callable.construct_settings(
_SERVICE_NAME, _A_CONFIG, dict(), _RETRY_DICT,
bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS,
kwargs={'metadata': [('x-goog-api-client', 'foo/1.2.3')]})
settings = defaults['bundling_method']
metadata = settings.kwargs['metadata'][0][1]
# Ensure that the metadata string contains items that GAX adds,
# but not the original header.
self.assertNotIn('foo/1.2.3', metadata)
self.assertIn('gl-python/%s' % platform.python_version(), metadata)
self.assertIn('gax/%s' % GAX_VERSION, metadata)
self.assertIn('grpc/%s' % GRPC_VERSION, metadata)
def test_construct_settings_override2(self):
_override = {
'interfaces': {
_SERVICE_NAME: {
'retry_codes': {
'bar_retry': [],
'baz_retry': ['code_a']
},
'retry_params': {
'default': {
'initial_retry_delay_millis': 1000,
'retry_delay_multiplier': 1.2,
'max_retry_delay_millis': 10000,
'initial_rpc_timeout_millis': 3000,
'rpc_timeout_multiplier': 1.3,
'max_rpc_timeout_millis': 30000,
'total_timeout_millis': 300000
},
},
'methods': {
'BundlingMethod': {
'retry_params_name': 'default',
'retry_codes_name': 'baz_retry',
},
},
}
}
}
defaults = api_callable.construct_settings(
_SERVICE_NAME, _A_CONFIG, _override, _RETRY_DICT,
bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS)
settings = defaults['bundling_method']
backoff = settings.retry.backoff_settings
self.assertEqual(backoff.initial_retry_delay_millis, 1000)
self.assertEqual(settings.retry.retry_codes, [_RETRY_DICT['code_a']])
self.assertIsInstance(settings.bundler, bundling.Executor)
self.assertIsInstance(settings.bundle_descriptor, BundleDescriptor)
# page_streaming_method is unaffected because it's not specified in
# overrides. 'bar_retry' or 'default' definitions in overrides should
# not affect the methods which are not in the overrides.
settings = defaults['page_streaming_method']
backoff = settings.retry.backoff_settings
self.assertEqual(backoff.initial_retry_delay_millis, 100)
self.assertEqual(backoff.retry_delay_multiplier, 1.2)
self.assertEqual(backoff.max_retry_delay_millis, 1000)
self.assertEqual(settings.retry.retry_codes, [_RETRY_DICT['code_c']])
def test_construct_settings(self):
defaults = api_callable.construct_settings(
_SERVICE_NAME, _A_CONFIG, dict(), dict(), _RETRY_DICT, 30,
bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS)
settings = defaults['bundling_method']
self.assertEquals(settings.timeout, 30)
self.assertIsInstance(settings.bundler, bundling.Executor)
self.assertIsInstance(settings.bundle_descriptor, BundleDescriptor)
self.assertIsNone(settings.page_descriptor)
self.assertIsInstance(settings.retry, RetryOptions)
settings = defaults['page_streaming_method']
self.assertEquals(settings.timeout, 30)
self.assertIsNone(settings.bundler)
self.assertIsNone(settings.bundle_descriptor)
self.assertIsInstance(settings.page_descriptor, PageDescriptor)
self.assertIsInstance(settings.retry, RetryOptions)
def test_construct_settings(self):
defaults = api_callable.construct_settings(
_SERVICE_NAME, _A_CONFIG, dict(), dict(), _RETRY_DICT, 30,
bundle_descriptors=_BUNDLE_DESCRIPTORS,
page_descriptors=_PAGE_DESCRIPTORS)
settings = defaults['bundling_method']
self.assertEquals(settings.timeout, 30)
self.assertIsInstance(settings.bundler, bundling.Executor)
self.assertIsInstance(settings.bundle_descriptor, BundleDescriptor)
self.assertIsNone(settings.page_descriptor)
self.assertIsInstance(settings.retry, RetryOptions)
settings = defaults['page_streaming_method']
self.assertEquals(settings.timeout, 30)
self.assertIsNone(settings.bundler)
self.assertIsNone(settings.bundle_descriptor)
self.assertIsInstance(settings.page_descriptor, PageDescriptor)
self.assertIsInstance(settings.retry, RetryOptions)
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
metadata_transformer=None,
ssl_creds=None,
scopes=None,
client_config=None,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
ssl_creds (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
metadata_transformer (Callable[[], list]): A function that creates
the metadata for requests.
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A IAMApi object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(
pkg_resources.resource_string(__name__,
'iam_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.iam.admin.v1.IAM',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
kwargs={'metadata': metadata},
page_descriptors=self._PAGE_DESCRIPTORS)
self.iam_stub = config.create_stub(
iam_pb2.IAMStub,
service_path,
port,
ssl_creds=ssl_creds,
channel=channel,
metadata_transformer=metadata_transformer,
scopes=scopes)
self._list_service_accounts = api_callable.create_api_call(
self.iam_stub.ListServiceAccounts,
settings=defaults['list_service_accounts'])
self._get_service_account = api_callable.create_api_call(
self.iam_stub.GetServiceAccount,
settings=defaults['get_service_account'])
self._create_service_account = api_callable.create_api_call(
self.iam_stub.CreateServiceAccount,
settings=defaults['create_service_account'])
self._update_service_account = api_callable.create_api_call(
self.iam_stub.UpdateServiceAccount,
settings=defaults['update_service_account'])
self._delete_service_account = api_callable.create_api_call(
self.iam_stub.DeleteServiceAccount,
settings=defaults['delete_service_account'])
self._list_service_account_keys = api_callable.create_api_call(
self.iam_stub.ListServiceAccountKeys,
settings=defaults['list_service_account_keys'])
self._get_service_account_key = api_callable.create_api_call(
self.iam_stub.GetServiceAccountKey,
settings=defaults['get_service_account_key'])
self._create_service_account_key = api_callable.create_api_call(
self.iam_stub.CreateServiceAccountKey,
settings=defaults['create_service_account_key'])
self._delete_service_account_key = api_callable.create_api_call(
self.iam_stub.DeleteServiceAccountKey,
settings=defaults['delete_service_account_key'])
self._sign_blob = api_callable.create_api_call(
self.iam_stub.SignBlob, settings=defaults['sign_blob'])
self._get_iam_policy = api_callable.create_api_call(
self.iam_stub.GetIamPolicy, settings=defaults['get_iam_policy'])
self._set_iam_policy = api_callable.create_api_call(
self.iam_stub.SetIamPolicy, settings=defaults['set_iam_policy'])
self._test_iam_permissions = api_callable.create_api_call(
self.iam_stub.TestIamPermissions,
settings=defaults['test_iam_permissions'])
self._query_grantable_roles = api_callable.create_api_call(
self.iam_stub.QueryGrantableRoles,
settings=defaults['query_grantable_roles'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
app_name=None,
app_version='',
lib_name=None,
lib_version='',
metrics_headers=()):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
credentials (object): The authorization credentials to attach to
requests. These credentials identify this application to the
service.
ssl_credentials (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (list[string]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
app_name (string): The name of the application calling
the service. Recommended for analytics purposes.
app_version (string): The version of the application calling
the service. Recommended for analytics purposes.
lib_name (string): The API library software used for calling
the service. (Unless you are writing an API client itself,
leave this as default.)
lib_version (string): The API library software version used
for calling the service. (Unless you are writing an API client
itself, leave this as default.)
metrics_headers (dict): A dictionary of values for tracking
client library metrics. Ultimately serializes to a string
(e.g. 'foo/1.2.3 bar/3.14.1'). This argument should be
considered private.
Returns:
A SubscriberClient object.
"""
# Unless the calling application specifically requested
# OAuth scopes, request everything.
if scopes is None:
scopes = self._ALL_SCOPES
# Initialize an empty client config, if none is set.
if client_config is None:
client_config = {}
# Initialize metrics_headers as an ordered dictionary
# (cuts down on cardinality of the resulting string slightly).
metrics_headers = collections.OrderedDict(metrics_headers)
metrics_headers['gl-python'] = platform.python_version()
# The library may or may not be set, depending on what is
# calling this client. Newer client libraries set the library name
# and version.
if lib_name:
metrics_headers[lib_name] = lib_version
# Finally, track the GAPIC package version.
metrics_headers['gapic'] = pkg_resources.get_distribution(
'gapic-google-cloud-pubsub-v1', ).version
# Load the configuration defaults.
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'subscriber_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.pubsub.v1.Subscriber',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
metrics_headers=metrics_headers,
page_descriptors=self._PAGE_DESCRIPTORS, )
self.iam_policy_stub = config.create_stub(
iam_policy_pb2.IAMPolicyStub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self.subscriber_stub = config.create_stub(
pubsub_pb2.SubscriberStub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self._create_subscription = api_callable.create_api_call(
self.subscriber_stub.CreateSubscription,
settings=defaults['create_subscription'])
self._get_subscription = api_callable.create_api_call(
self.subscriber_stub.GetSubscription,
settings=defaults['get_subscription'])
self._update_subscription = api_callable.create_api_call(
self.subscriber_stub.UpdateSubscription,
settings=defaults['update_subscription'])
self._list_subscriptions = api_callable.create_api_call(
self.subscriber_stub.ListSubscriptions,
settings=defaults['list_subscriptions'])
self._delete_subscription = api_callable.create_api_call(
self.subscriber_stub.DeleteSubscription,
settings=defaults['delete_subscription'])
self._modify_ack_deadline = api_callable.create_api_call(
self.subscriber_stub.ModifyAckDeadline,
settings=defaults['modify_ack_deadline'])
self._acknowledge = api_callable.create_api_call(
self.subscriber_stub.Acknowledge, settings=defaults['acknowledge'])
self._pull = api_callable.create_api_call(
self.subscriber_stub.Pull, settings=defaults['pull'])
self._streaming_pull = api_callable.create_api_call(
self.subscriber_stub.StreamingPull,
settings=defaults['streaming_pull'])
self._modify_push_config = api_callable.create_api_call(
self.subscriber_stub.ModifyPushConfig,
settings=defaults['modify_push_config'])
self._list_snapshots = api_callable.create_api_call(
self.subscriber_stub.ListSnapshots,
settings=defaults['list_snapshots'])
self._create_snapshot = api_callable.create_api_call(
self.subscriber_stub.CreateSnapshot,
settings=defaults['create_snapshot'])
self._delete_snapshot = api_callable.create_api_call(
self.subscriber_stub.DeleteSnapshot,
settings=defaults['delete_snapshot'])
self._seek = api_callable.create_api_call(
self.subscriber_stub.Seek, settings=defaults['seek'])
self._set_iam_policy = api_callable.create_api_call(
self.iam_policy_stub.SetIamPolicy,
settings=defaults['set_iam_policy'])
self._get_iam_policy = api_callable.create_api_call(
self.iam_policy_stub.GetIamPolicy,
settings=defaults['get_iam_policy'])
self._test_iam_permissions = api_callable.create_api_call(
self.iam_policy_stub.TestIamPermissions,
settings=defaults['test_iam_permissions'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
credentials (object): The authorization credentials to attach to
requests. These credentials identify this application to the
service.
ssl_credentials (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (list[string]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A MetricsServiceV2Client object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'metrics_service_v2_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.logging.v2.MetricsServiceV2',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
kwargs={'metadata': metadata},
page_descriptors=self._PAGE_DESCRIPTORS)
self.metrics_service_v2_stub = config.create_stub(
logging_metrics_pb2.MetricsServiceV2Stub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self._list_log_metrics = api_callable.create_api_call(
self.metrics_service_v2_stub.ListLogMetrics,
settings=defaults['list_log_metrics'])
self._get_log_metric = api_callable.create_api_call(
self.metrics_service_v2_stub.GetLogMetric,
settings=defaults['get_log_metric'])
self._create_log_metric = api_callable.create_api_call(
self.metrics_service_v2_stub.CreateLogMetric,
settings=defaults['create_log_metric'])
self._update_log_metric = api_callable.create_api_call(
self.metrics_service_v2_stub.UpdateLogMetric,
settings=defaults['update_log_metric'])
self._delete_log_metric = api_callable.create_api_call(
self.metrics_service_v2_stub.DeleteLogMetric,
settings=defaults['delete_log_metric'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
credentials (object): The authorization credentials to attach to
requests. These credentials identify this application to the
service.
ssl_credentials (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (list[string]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A SpeechClient object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'speech_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.cloud.speech.v1beta1.Speech',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
kwargs={'metadata': metadata})
self.speech_stub = config.create_stub(
cloud_speech_pb2.SpeechStub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self._sync_recognize = api_callable.create_api_call(
self.speech_stub.SyncRecognize,
settings=defaults['sync_recognize'])
self._async_recognize = api_callable.create_api_call(
self.speech_stub.AsyncRecognize,
settings=defaults['async_recognize'])
self._streaming_recognize = api_callable.create_api_call(
self.speech_stub.StreamingRecognize,
settings=defaults['streaming_recognize'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
app_name=None,
app_version='',
lib_name=None,
lib_version='',
metrics_headers=()):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
credentials (object): The authorization credentials to attach to
requests. These credentials identify this application to the
service.
ssl_credentials (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (list[string]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
app_name (string): The name of the application calling
the service. Recommended for analytics purposes.
app_version (string): The version of the application calling
the service. Recommended for analytics purposes.
lib_name (string): The API library software used for calling
the service. (Unless you are writing an API client itself,
leave this as default.)
lib_version (string): The API library software version used
for calling the service. (Unless you are writing an API client
itself, leave this as default.)
metrics_headers (dict): A dictionary of values for tracking
client library metrics. Ultimately serializes to a string
(e.g. 'foo/1.2.3 bar/3.14.1'). This argument should be
considered private.
Returns:
A SubscriberClient object.
"""
# Unless the calling application specifically requested
# OAuth scopes, request everything.
if scopes is None:
scopes = self._ALL_SCOPES
# Initialize an empty client config, if none is set.
if client_config is None:
client_config = {}
# Initialize metrics_headers as an ordered dictionary
# (cuts down on cardinality of the resulting string slightly).
metrics_headers = collections.OrderedDict(metrics_headers)
metrics_headers['gl-python'] = platform.python_version()
# The library may or may not be set, depending on what is
# calling this client. Newer client libraries set the library name
# and version.
if lib_name:
metrics_headers[lib_name] = lib_version
# Finally, track the GAPIC package version.
metrics_headers['gapic'] = pkg_resources.get_distribution(
'google-cloud-pubsub', ).version
# Load the configuration defaults.
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'subscriber_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.pubsub.v1.Subscriber',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
metrics_headers=metrics_headers,
page_descriptors=self._PAGE_DESCRIPTORS,
)
self.iam_policy_stub = config.create_stub(
iam_policy_pb2.IAMPolicyStub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self.subscriber_stub = config.create_stub(
pubsub_pb2.SubscriberStub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self._create_subscription = api_callable.create_api_call(
self.subscriber_stub.CreateSubscription,
settings=defaults['create_subscription'])
self._get_subscription = api_callable.create_api_call(
self.subscriber_stub.GetSubscription,
settings=defaults['get_subscription'])
self._update_subscription = api_callable.create_api_call(
self.subscriber_stub.UpdateSubscription,
settings=defaults['update_subscription'])
self._list_subscriptions = api_callable.create_api_call(
self.subscriber_stub.ListSubscriptions,
settings=defaults['list_subscriptions'])
self._delete_subscription = api_callable.create_api_call(
self.subscriber_stub.DeleteSubscription,
settings=defaults['delete_subscription'])
self._modify_ack_deadline = api_callable.create_api_call(
self.subscriber_stub.ModifyAckDeadline,
settings=defaults['modify_ack_deadline'])
self._acknowledge = api_callable.create_api_call(
self.subscriber_stub.Acknowledge, settings=defaults['acknowledge'])
self._pull = api_callable.create_api_call(self.subscriber_stub.Pull,
settings=defaults['pull'])
self._streaming_pull = api_callable.create_api_call(
self.subscriber_stub.StreamingPull,
settings=defaults['streaming_pull'])
self._modify_push_config = api_callable.create_api_call(
self.subscriber_stub.ModifyPushConfig,
settings=defaults['modify_push_config'])
self._list_snapshots = api_callable.create_api_call(
self.subscriber_stub.ListSnapshots,
settings=defaults['list_snapshots'])
self._create_snapshot = api_callable.create_api_call(
self.subscriber_stub.CreateSnapshot,
settings=defaults['create_snapshot'])
self._delete_snapshot = api_callable.create_api_call(
self.subscriber_stub.DeleteSnapshot,
settings=defaults['delete_snapshot'])
self._seek = api_callable.create_api_call(self.subscriber_stub.Seek,
settings=defaults['seek'])
self._set_iam_policy = api_callable.create_api_call(
self.iam_policy_stub.SetIamPolicy,
settings=defaults['set_iam_policy'])
self._get_iam_policy = api_callable.create_api_call(
self.iam_policy_stub.GetIamPolicy,
settings=defaults['get_iam_policy'])
self._test_iam_permissions = api_callable.create_api_call(
self.iam_policy_stub.TestIamPermissions,
settings=defaults['test_iam_permissions'])
def __init__(self,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
lib_name=None,
lib_version='',
metrics_headers=()):
"""Constructor.
Args:
channel (~grpc.Channel): A ``Channel`` instance through
which to make calls.
credentials (~google.auth.credentials.Credentials): The authorization
credentials to attach to requests. These credentials identify this
application to the service.
ssl_credentials (~grpc.ChannelCredentials): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (Sequence[str]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
lib_name (str): The API library software used for calling
the service. (Unless you are writing an API client itself,
leave this as default.)
lib_version (str): The API library software version used
for calling the service. (Unless you are writing an API client
itself, leave this as default.)
metrics_headers (dict): A dictionary of values for tracking
client library metrics. Ultimately serializes to a string
(e.g. 'foo/1.2.3 bar/3.14.1'). This argument should be
considered private.
"""
# Unless the calling application specifically requested
# OAuth scopes, request everything.
if scopes is None:
scopes = self._ALL_SCOPES
# Initialize an empty client config, if none is set.
if client_config is None:
client_config = {}
# Initialize metrics_headers as an ordered dictionary
# (cuts down on cardinality of the resulting string slightly).
metrics_headers = collections.OrderedDict(metrics_headers)
metrics_headers['gl-python'] = platform.python_version()
# The library may or may not be set, depending on what is
# calling this client. Newer client libraries set the library name
# and version.
if lib_name:
metrics_headers[lib_name] = lib_version
# Finally, track the GAPIC package version.
metrics_headers['gapic'] = pkg_resources.get_distribution(
'google-cloud-videointelligence', ).version
# Load the configuration defaults.
defaults = api_callable.construct_settings(
'google.cloud.videointelligence.v1beta1.VideoIntelligenceService',
video_intelligence_service_client_config.config,
client_config,
config.STATUS_CODE_NAMES,
metrics_headers=metrics_headers, )
self.video_intelligence_service_stub = config.create_stub(
video_intelligence_pb2.VideoIntelligenceServiceStub,
channel=channel,
service_path=self.SERVICE_ADDRESS,
service_port=self.DEFAULT_SERVICE_PORT,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self.operations_client = operations_client.OperationsClient(
service_path=self.SERVICE_ADDRESS,
channel=channel,
credentials=credentials,
ssl_credentials=ssl_credentials,
scopes=scopes,
client_config=client_config,
metrics_headers=metrics_headers, )
self._annotate_video = api_callable.create_api_call(
self.video_intelligence_service_stub.AnnotateVideo,
settings=defaults['annotate_video'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
metadata_transformer=None,
ssl_creds=None,
scopes=None,
client_config=None,
timeout=_DEFAULT_TIMEOUT,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.beta.implementations.Channel`): A ``Channel``
object through which to make calls.
ssl_creds (:class:`grpc.beta.implementations.ClientCredentials`):
A `ClientCredentials` for use with an SSL-enabled channel.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
metadata_transformer (Callable[[], list]): A function that creates
the metadata for requests.
timeout (int): The default timeout, in seconds, for calls made
through this client
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A ConfigServiceV2Api object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'config_service_v2_client_config.json'))
defaults = api_callable.construct_settings(
'google.logging.v2.ConfigServiceV2',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
timeout,
kwargs={'metadata': metadata},
page_descriptors=self._PAGE_DESCRIPTORS)
self.stub = config.create_stub(
logging_config_pb2.beta_create_ConfigServiceV2_stub,
service_path,
port,
ssl_creds=ssl_creds,
channel=channel,
metadata_transformer=metadata_transformer,
scopes=scopes)
self._list_sinks = api_callable.create_api_call(
self.stub.ListSinks, settings=defaults['list_sinks'])
self._get_sink = api_callable.create_api_call(
self.stub.GetSink, settings=defaults['get_sink'])
self._create_sink = api_callable.create_api_call(
self.stub.CreateSink, settings=defaults['create_sink'])
self._update_sink = api_callable.create_api_call(
self.stub.UpdateSink, settings=defaults['update_sink'])
self._delete_sink = api_callable.create_api_call(
self.stub.DeleteSink, settings=defaults['delete_sink'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
metadata_transformer=None,
ssl_creds=None,
scopes=None,
client_config=None,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
ssl_creds (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
metadata_transformer (Callable[[], list]): A function that creates
the metadata for requests.
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A BigtableApi object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'bigtable_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.bigtable.v2.Bigtable',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
kwargs={'metadata': metadata})
self.bigtable_stub = config.create_stub(
bigtable_pb2.BigtableStub,
service_path,
port,
ssl_creds=ssl_creds,
channel=channel,
metadata_transformer=metadata_transformer,
scopes=scopes)
self._read_rows = api_callable.create_api_call(
self.bigtable_stub.ReadRows, settings=defaults['read_rows'])
self._sample_row_keys = api_callable.create_api_call(
self.bigtable_stub.SampleRowKeys,
settings=defaults['sample_row_keys'])
self._mutate_row = api_callable.create_api_call(
self.bigtable_stub.MutateRow, settings=defaults['mutate_row'])
self._mutate_rows = api_callable.create_api_call(
self.bigtable_stub.MutateRows, settings=defaults['mutate_rows'])
self._check_and_mutate_row = api_callable.create_api_call(
self.bigtable_stub.CheckAndMutateRow,
settings=defaults['check_and_mutate_row'])
self._read_modify_write_row = api_callable.create_api_call(
self.bigtable_stub.ReadModifyWriteRow,
settings=defaults['read_modify_write_row'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
metadata_transformer=None,
ssl_creds=None,
scopes=None,
client_config=None,
timeout=_DEFAULT_TIMEOUT,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.beta.implementations.Channel`): A ``Channel``
object through which to make calls.
ssl_creds (:class:`grpc.beta.implementations.ClientCredentials`):
A `ClientCredentials` for use with an SSL-enabled channel.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
metadata_transformer (Callable[[], list]): A function that creates
the metadata for requests.
timeout (int): The default timeout, in seconds, for calls made
through this client
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A MetricsServiceV2Api object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(pkg_resources.resource_string(
__name__, 'metrics_service_v2_client_config.json'))
defaults = api_callable.construct_settings(
'google.logging.v2.MetricsServiceV2',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
timeout,
kwargs={'metadata': metadata},
page_descriptors=self._PAGE_DESCRIPTORS)
self.stub = config.create_stub(
logging_metrics_pb2.beta_create_MetricsServiceV2_stub,
service_path,
port,
ssl_creds=ssl_creds,
channel=channel,
metadata_transformer=metadata_transformer,
scopes=scopes)
self._list_log_metrics = api_callable.create_api_call(
self.stub.ListLogMetrics,
settings=defaults['list_log_metrics'])
self._get_log_metric = api_callable.create_api_call(
self.stub.GetLogMetric,
settings=defaults['get_log_metric'])
self._create_log_metric = api_callable.create_api_call(
self.stub.CreateLogMetric,
settings=defaults['create_log_metric'])
self._update_log_metric = api_callable.create_api_call(
self.stub.UpdateLogMetric,
settings=defaults['update_log_metric'])
self._delete_log_metric = api_callable.create_api_call(
self.stub.DeleteLogMetric,
settings=defaults['delete_log_metric'])
def __init__(self,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
lib_name=None,
lib_version='',
metrics_headers=()):
"""Constructor.
Args:
channel (~grpc.Channel): A ``Channel`` instance through
which to make calls.
credentials (~google.auth.credentials.Credentials): The authorization
credentials to attach to requests. These credentials identify this
application to the service.
ssl_credentials (~grpc.ChannelCredentials): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (Sequence[str]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
lib_name (str): The API library software used for calling
the service. (Unless you are writing an API client itself,
leave this as default.)
lib_version (str): The API library software version used
for calling the service. (Unless you are writing an API client
itself, leave this as default.)
metrics_headers (dict): A dictionary of values for tracking
client library metrics. Ultimately serializes to a string
(e.g. 'foo/1.2.3 bar/3.14.1'). This argument should be
considered private.
"""
# Unless the calling application specifically requested
# OAuth scopes, request everything.
if scopes is None:
scopes = self._ALL_SCOPES
# Initialize an empty client config, if none is set.
if client_config is None:
client_config = {}
# Initialize metrics_headers as an ordered dictionary
# (cuts down on cardinality of the resulting string slightly).
metrics_headers = collections.OrderedDict(metrics_headers)
metrics_headers['gl-python'] = platform.python_version()
# The library may or may not be set, depending on what is
# calling this client. Newer client libraries set the library name
# and version.
if lib_name:
metrics_headers[lib_name] = lib_version
# Finally, track the GAPIC package version.
metrics_headers['gapic'] = pkg_resources.get_distribution(
'google-cloud-firestore', ).version
# Load the configuration defaults.
defaults = api_callable.construct_settings(
'google.firestore.v1beta1.Firestore',
firestore_client_config.config,
client_config,
config.STATUS_CODE_NAMES,
metrics_headers=metrics_headers,
page_descriptors=self._PAGE_DESCRIPTORS,
)
self.firestore_stub = config.create_stub(
firestore_pb2.FirestoreStub,
channel=channel,
service_path=self.SERVICE_ADDRESS,
service_port=self.DEFAULT_SERVICE_PORT,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self._get_document = api_callable.create_api_call(
self.firestore_stub.GetDocument, settings=defaults['get_document'])
self._list_documents = api_callable.create_api_call(
self.firestore_stub.ListDocuments,
settings=defaults['list_documents'])
self._create_document = api_callable.create_api_call(
self.firestore_stub.CreateDocument,
settings=defaults['create_document'])
self._update_document = api_callable.create_api_call(
self.firestore_stub.UpdateDocument,
settings=defaults['update_document'])
self._delete_document = api_callable.create_api_call(
self.firestore_stub.DeleteDocument,
settings=defaults['delete_document'])
self._batch_get_documents = api_callable.create_api_call(
self.firestore_stub.BatchGetDocuments,
settings=defaults['batch_get_documents'])
self._begin_transaction = api_callable.create_api_call(
self.firestore_stub.BeginTransaction,
settings=defaults['begin_transaction'])
self._commit = api_callable.create_api_call(
self.firestore_stub.Commit, settings=defaults['commit'])
self._rollback = api_callable.create_api_call(
self.firestore_stub.Rollback, settings=defaults['rollback'])
self._run_query = api_callable.create_api_call(
self.firestore_stub.RunQuery, settings=defaults['run_query'])
self._write = api_callable.create_api_call(self.firestore_stub.Write,
settings=defaults['write'])
self._listen = api_callable.create_api_call(
self.firestore_stub.Listen, settings=defaults['listen'])
self._list_collection_ids = api_callable.create_api_call(
self.firestore_stub.ListCollectionIds,
settings=defaults['list_collection_ids'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
credentials (object): The authorization credentials to attach to
requests. These credentials identify this application to the
service.
ssl_credentials (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (list[string]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A DatastoreClient object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'datastore_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.datastore.v1.Datastore',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
kwargs={'metadata': metadata})
self.datastore_stub = config.create_stub(
datastore_pb2.DatastoreStub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self._lookup = api_callable.create_api_call(
self.datastore_stub.Lookup, settings=defaults['lookup'])
self._run_query = api_callable.create_api_call(
self.datastore_stub.RunQuery, settings=defaults['run_query'])
self._begin_transaction = api_callable.create_api_call(
self.datastore_stub.BeginTransaction,
settings=defaults['begin_transaction'])
self._commit = api_callable.create_api_call(
self.datastore_stub.Commit, settings=defaults['commit'])
self._rollback = api_callable.create_api_call(
self.datastore_stub.Rollback, settings=defaults['rollback'])
self._allocate_ids = api_callable.create_api_call(
self.datastore_stub.AllocateIds, settings=defaults['allocate_ids'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
metadata_transformer=None,
ssl_creds=None,
scopes=None,
client_config=None,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
ssl_creds (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
metadata_transformer (Callable[[], list]): A function that creates
the metadata for requests.
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A PublisherApi object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'publisher_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.pubsub.v1.Publisher',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
kwargs={'metadata': metadata},
bundle_descriptors=self._BUNDLE_DESCRIPTORS,
page_descriptors=self._PAGE_DESCRIPTORS)
self.stub = config.create_stub(
pubsub_pb2.PublisherStub,
service_path,
port,
ssl_creds=ssl_creds,
channel=channel,
metadata_transformer=metadata_transformer,
scopes=scopes)
self._create_topic = api_callable.create_api_call(
self.stub.CreateTopic, settings=defaults['create_topic'])
self._publish = api_callable.create_api_call(
self.stub.Publish, settings=defaults['publish'])
self._get_topic = api_callable.create_api_call(
self.stub.GetTopic, settings=defaults['get_topic'])
self._list_topics = api_callable.create_api_call(
self.stub.ListTopics, settings=defaults['list_topics'])
self._list_topic_subscriptions = api_callable.create_api_call(
self.stub.ListTopicSubscriptions,
settings=defaults['list_topic_subscriptions'])
self._delete_topic = api_callable.create_api_call(
self.stub.DeleteTopic, settings=defaults['delete_topic'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
app_name=None,
app_version='',
lib_name=None,
lib_version='',
metrics_headers=()):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
credentials (object): The authorization credentials to attach to
requests. These credentials identify this application to the
service.
ssl_credentials (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (list[string]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
app_name (string): The name of the application calling
the service. Recommended for analytics purposes.
app_version (string): The version of the application calling
the service. Recommended for analytics purposes.
lib_name (string): The API library software used for calling
the service. (Unless you are writing an API client itself,
leave this as default.)
lib_version (string): The API library software version used
for calling the service. (Unless you are writing an API client
itself, leave this as default.)
metrics_headers (dict): A dictionary of values for tracking
client library metrics. Ultimately serializes to a string
(e.g. 'foo/1.2.3 bar/3.14.1'). This argument should be
considered private.
Returns:
A OperationsClient object.
"""
# Unless the calling application specifically requested
# OAuth scopes, request everything.
if scopes is None:
scopes = self._ALL_SCOPES
# Initialize an empty client config, if none is set.
if client_config is None:
client_config = {}
# Initialize metrics_headers as an ordered dictionary
# (cuts down on cardinality of the resulting string slightly).
metrics_headers = collections.OrderedDict(metrics_headers)
metrics_headers['gl-python'] = platform.python_version()
# The library may or may not be set, depending on what is
# calling this client. Newer client libraries set the library name
# and version.
if lib_name:
metrics_headers[lib_name] = lib_version
# Load the configuration defaults.
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'operations_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.longrunning.Operations',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
metrics_headers=metrics_headers,
page_descriptors=self._PAGE_DESCRIPTORS, )
self.operations_stub = config.create_stub(
operations_pb2.OperationsStub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self._get_operation = api_callable.create_api_call(
self.operations_stub.GetOperation,
settings=defaults['get_operation'])
self._list_operations = api_callable.create_api_call(
self.operations_stub.ListOperations,
settings=defaults['list_operations'])
self._cancel_operation = api_callable.create_api_call(
self.operations_stub.CancelOperation,
settings=defaults['cancel_operation'])
self._delete_operation = api_callable.create_api_call(
self.operations_stub.DeleteOperation,
settings=defaults['delete_operation'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
credentials=None,
ssl_credentials=None,
scopes=None,
client_config=None,
app_name=None,
app_version='',
lib_name=None,
lib_version='',
metrics_headers=()):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.Channel`): A ``Channel`` instance through
which to make calls.
credentials (object): The authorization credentials to attach to
requests. These credentials identify this application to the
service.
ssl_credentials (:class:`grpc.ChannelCredentials`): A
``ChannelCredentials`` instance for use with an SSL-enabled
channel.
scopes (list[string]): A list of OAuth2 scopes to attach to requests.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
app_name (string): The name of the application calling
the service. Recommended for analytics purposes.
app_version (string): The version of the application calling
the service. Recommended for analytics purposes.
lib_name (string): The API library software used for calling
the service. (Unless you are writing an API client itself,
leave this as default.)
lib_version (string): The API library software version used
for calling the service. (Unless you are writing an API client
itself, leave this as default.)
metrics_headers (dict): A dictionary of values for tracking
client library metrics. Ultimately serializes to a string
(e.g. 'foo/1.2.3 bar/3.14.1'). This argument should be
considered private.
Returns:
A OperationsClient object.
"""
# Unless the calling application specifically requested
# OAuth scopes, request everything.
if scopes is None:
scopes = self._ALL_SCOPES
# Initialize an empty client config, if none is set.
if client_config is None:
client_config = {}
# Initialize metrics_headers as an ordered dictionary
# (cuts down on cardinality of the resulting string slightly).
metrics_headers = collections.OrderedDict(metrics_headers)
metrics_headers['gl-python'] = platform.python_version()
# The library may or may not be set, depending on what is
# calling this client. Newer client libraries set the library name
# and version.
if lib_name:
metrics_headers[lib_name] = lib_version
# Load the configuration defaults.
default_client_config = json.loads(
pkg_resources.resource_string(
__name__, 'operations_client_config.json').decode())
defaults = api_callable.construct_settings(
'google.longrunning.Operations',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
metrics_headers=metrics_headers,
page_descriptors=self._PAGE_DESCRIPTORS,
)
self.operations_stub = config.create_stub(
operations_pb2.OperationsStub,
channel=channel,
service_path=service_path,
service_port=port,
credentials=credentials,
scopes=scopes,
ssl_credentials=ssl_credentials)
self._get_operation = api_callable.create_api_call(
self.operations_stub.GetOperation,
settings=defaults['get_operation'])
self._list_operations = api_callable.create_api_call(
self.operations_stub.ListOperations,
settings=defaults['list_operations'])
self._cancel_operation = api_callable.create_api_call(
self.operations_stub.CancelOperation,
settings=defaults['cancel_operation'])
self._delete_operation = api_callable.create_api_call(
self.operations_stub.DeleteOperation,
settings=defaults['delete_operation'])
def __init__(self,
service_path=SERVICE_ADDRESS,
port=DEFAULT_SERVICE_PORT,
channel=None,
metadata_transformer=None,
ssl_creds=None,
scopes=None,
client_config=None,
app_name='gax',
app_version=_GAX_VERSION):
"""Constructor.
Args:
service_path (string): The domain name of the API remote host.
port (int): The port on which to connect to the remote host.
channel (:class:`grpc.beta.implementations.Channel`): A ``Channel``
object through which to make calls.
ssl_creds (:class:`grpc.beta.implementations.ClientCredentials`):
A `ClientCredentials` for use with an SSL-enabled channel.
client_config (dict):
A dictionary for call options for each method. See
:func:`google.gax.construct_settings` for the structure of
this data. Falls back to the default config if not specified
or the specified config is missing data points.
metadata_transformer (Callable[[], list]): A function that creates
the metadata for requests.
app_name (string): The codename of the calling service.
app_version (string): The version of the calling service.
Returns:
A SubscriberApi object.
"""
if scopes is None:
scopes = self._ALL_SCOPES
if client_config is None:
client_config = {}
goog_api_client = '{}/{} {} gax/{} python/{}'.format(
app_name, app_version, self._CODE_GEN_NAME_VERSION,
self._GAX_VERSION, platform.python_version())
metadata = [('x-goog-api-client', goog_api_client)]
default_client_config = json.loads(pkg_resources.resource_string(
__name__, 'subscriber_client_config.json'))
defaults = api_callable.construct_settings(
'google.pubsub.v1.Subscriber',
default_client_config,
client_config,
config.STATUS_CODE_NAMES,
kwargs={'metadata': metadata},
page_descriptors=self._PAGE_DESCRIPTORS)
self.stub = config.create_stub(
pubsub_pb2.beta_create_Subscriber_stub,
service_path,
port,
ssl_creds=ssl_creds,
channel=channel,
metadata_transformer=metadata_transformer,
scopes=scopes)
self._create_subscription = api_callable.create_api_call(
self.stub.CreateSubscription,
settings=defaults['create_subscription'])
self._get_subscription = api_callable.create_api_call(
self.stub.GetSubscription,
settings=defaults['get_subscription'])
self._list_subscriptions = api_callable.create_api_call(
self.stub.ListSubscriptions,
settings=defaults['list_subscriptions'])
self._delete_subscription = api_callable.create_api_call(
self.stub.DeleteSubscription,
settings=defaults['delete_subscription'])
self._modify_ack_deadline = api_callable.create_api_call(
self.stub.ModifyAckDeadline,
settings=defaults['modify_ack_deadline'])
self._acknowledge = api_callable.create_api_call(
self.stub.Acknowledge,
settings=defaults['acknowledge'])
self._pull = api_callable.create_api_call(self.stub.Pull,
settings=defaults['pull'])
self._modify_push_config = api_callable.create_api_call(
self.stub.ModifyPushConfig,
settings=defaults['modify_push_config'])
