feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/service_directory/endpoints/__init__.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""The endpoints command group for Service Directory CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class Endpoints(base.Group):
+  """Manage Service Directory endpoints."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/service_directory/endpoints/create.py

@@ -0,0 +1,107 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""`gcloud service-directory endpoints create` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.service_directory import endpoints
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.service_directory import flags
+from googlecloudsdk.command_lib.service_directory import resource_args
+from googlecloudsdk.command_lib.service_directory import util
+from googlecloudsdk.core import log
+
+_RESOURCE_TYPE = 'endpoint'
+_ENDPOINT_LIMIT = 512
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Create(base.CreateCommand):
+  """Creates an endpoint."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To create a Service Directory endpoint, run:
+
+            $ {command} my-endpoint --service=my-service --namespace=my-namespace --location=us-east1 --address=1.2.3.4 --port=5 --annotations=a=b,c=d  --network=projects/123456789/locations/global/networks/default
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddEndpointResourceArg(
+        parser,
+        """to create. The endpoint id must be 1-63 characters long and match
+        the regular expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?` which means
+        the first character must be a lowercase letter, and all following
+        characters must be a dash, lowercase letter, or digit, except the last
+        character, which cannot be a dash.""")
+    flags.AddAddressFlag(parser)
+    flags.AddPortFlag(parser)
+    flags.AddAnnotationsFlag(parser, _RESOURCE_TYPE, _ENDPOINT_LIMIT)
+    flags.AddNetworkFlag(parser)
+
+  def Run(self, args):
+    client = endpoints.EndpointsClient()
+    endpoint_ref = args.CONCEPTS.endpoint.Parse()
+    annotations = util.ParseAnnotationsArg(args.annotations, _RESOURCE_TYPE)
+
+    result = client.Create(endpoint_ref, args.address, args.port, annotations,
+                           args.network)
+    log.CreatedResource(endpoint_ref.endpointsId, _RESOURCE_TYPE)
+
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class CreateBeta(base.CreateCommand):
+  """Creates an endpoint."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To create a Service Directory endpoint, run:
+
+            $ {command} my-endpoint --service=my-service --namespace=my-namespace --location=us-east1 --address=1.2.3.4 --port=5 --metadata=a=b,c=d --network=projects/123456789/locations/global/networks/default
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddEndpointResourceArg(
+        parser,
+        """to create. The endpoint id must be 1-63 characters long and match
+        the regular expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?` which means
+        the first character must be a lowercase letter, and all following
+        characters must be a dash, lowercase letter, or digit, except the last
+        character, which cannot be a dash.""")
+    flags.AddAddressFlag(parser)
+    flags.AddPortFlag(parser)
+    flags.AddMetadataFlag(parser, _RESOURCE_TYPE, _ENDPOINT_LIMIT)
+    flags.AddNetworkFlag(parser)
+
+  def Run(self, args):
+    client = endpoints.EndpointsClientBeta()
+    endpoint_ref = args.CONCEPTS.endpoint.Parse()
+    metadata = util.ParseMetadataArg(args.metadata, _RESOURCE_TYPE)
+
+    result = client.Create(endpoint_ref, args.address, args.port, metadata,
+                           args.network)
+    log.CreatedResource(endpoint_ref.endpointsId, _RESOURCE_TYPE)
+
+    return result

gcloud auth application-default login/google-cloud-sdk/lib/surface/service_directory/endpoints/delete.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""`gcloud service-directory endpoints delete` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.service_directory import endpoints
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.service_directory import resource_args
+from googlecloudsdk.core import log
+
+_RESOURCE_TYPE = 'endpoint'
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Delete(base.DeleteCommand):
+  """Deletes an endpoint."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To delete a Service Directory endpoint, run:
+
+            $ {command} my-endpoint --service=my-service --namespace=my-namespace --location=us-east1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddEndpointResourceArg(parser, 'to delete.')
+
+  def Run(self, args):
+    client = endpoints.EndpointsClient(self.GetReleaseTrack())
+    endpoint_ref = args.CONCEPTS.endpoint.Parse()
+
+    result = client.Delete(endpoint_ref)
+    log.DeletedResource(endpoint_ref.endpointsId, _RESOURCE_TYPE)
+
+    return result
+
+  def GetReleaseTrack(self):
+    return base.ReleaseTrack.GA
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class DeleteBeta(Delete):
+  """Deletes an endpoint."""
+
+  def GetReleaseTrack(self):
+    return base.ReleaseTrack.BETA

gcloud auth application-default login/google-cloud-sdk/lib/surface/service_directory/endpoints/describe.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""`gcloud service-directory endpoints describe` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.service_directory import endpoints
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.service_directory import resource_args
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Describe(base.DescribeCommand):
+  """Describes an endpoint."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To describe a Service Directory endpoint, run:
+
+            $ {command} my-endpoint --service=my-service --namespace=my-namespace --location=us-east1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddEndpointResourceArg(parser, 'to describe.')
+
+  def Run(self, args):
+    client = endpoints.EndpointsClient(self.GetReleaseTrack())
+    endpoint_ref = args.CONCEPTS.endpoint.Parse()
+
+    return client.Describe(endpoint_ref)
+
+  def GetReleaseTrack(self):
+    return base.ReleaseTrack.GA
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class DescribeBeta(Describe):
+  """Describes an endpoint."""
+
+  def GetReleaseTrack(self):
+    return base.ReleaseTrack.BETA

gcloud auth application-default login/google-cloud-sdk/lib/surface/service_directory/endpoints/list.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""`gcloud service-directory endpoints list` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.service_directory import endpoints
+from googlecloudsdk.api_lib.util import common_args
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.service_directory import resource_args
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class List(base.ListCommand):
+  """Lists endpoints."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To list Service Directory endpoints, run:
+
+            $ {command} --service=my-service --namespace=my-namespace --location=us-east1
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddServiceResourceArg(parser, 'to list', positional=False)
+    base.LIMIT_FLAG.RemoveFromParser(parser)
+    base.URI_FLAG.RemoveFromParser(parser)
+
+  def Run(self, args):
+    client = endpoints.EndpointsClient(self.GetReleaseTrack())
+    service_ref = args.CONCEPTS.service.Parse()
+    order_by = common_args.ParseSortByArg(args.sort_by)
+
+    return client.List(service_ref, args.filter, order_by, args.page_size)
+
+  def GetReleaseTrack(self):
+    return base.ReleaseTrack.GA
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class ListBeta(List):
+  """Lists endpoints."""
+
+  def GetReleaseTrack(self):
+    return base.ReleaseTrack.BETA

gcloud auth application-default login/google-cloud-sdk/lib/surface/service_directory/endpoints/update.py

@@ -0,0 +1,91 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""`gcloud service-directory endpoints update` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.service_directory import endpoints
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.service_directory import flags
+from googlecloudsdk.command_lib.service_directory import resource_args
+from googlecloudsdk.command_lib.service_directory import util
+from googlecloudsdk.core import log
+
+_RESOURCE_TYPE = 'endpoint'
+_ENDPOINT_LIMIT = 512
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Update(base.UpdateCommand):
+  """Updates an endpoint."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To update a Service Directory endpoint, run:
+
+            $ {command} my-endpoint --service=my-service --namespace=my-namespace --location=us-east1 --address=1.2.3.4 --port=5 --annotations=a=b,c=d
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddEndpointResourceArg(parser, 'to update.')
+    flags.AddAddressFlag(parser)
+    flags.AddPortFlag(parser)
+    flags.AddAnnotationsFlag(parser, _RESOURCE_TYPE, _ENDPOINT_LIMIT)
+
+  def Run(self, args):
+    client = endpoints.EndpointsClient()
+    endpoint_ref = args.CONCEPTS.endpoint.Parse()
+    annotations = util.ParseAnnotationsArg(args.annotations, _RESOURCE_TYPE)
+
+    result = client.Update(endpoint_ref, args.address, args.port, annotations)
+    log.UpdatedResource(endpoint_ref.endpointsId, _RESOURCE_TYPE)
+
+    return result
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class UpdateBeta(base.UpdateCommand):
+  """Updates an endpoint."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To update a Service Directory endpoint, run:
+
+            $ {command} my-endpoint --service=my-service --namespace=my-namespace --location=us-east1 --address=1.2.3.4 --port=5 --metadata=a=b,c=d
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddEndpointResourceArg(parser, 'to update.')
+    flags.AddAddressFlag(parser)
+    flags.AddPortFlag(parser)
+    flags.AddMetadataFlag(parser, _RESOURCE_TYPE, _ENDPOINT_LIMIT)
+
+  def Run(self, args):
+    client = endpoints.EndpointsClientBeta()
+    endpoint_ref = args.CONCEPTS.endpoint.Parse()
+    metadata = util.ParseMetadataArg(args.metadata, _RESOURCE_TYPE)
+
+    result = client.Update(endpoint_ref, args.address, args.port, metadata)
+    log.UpdatedResource(endpoint_ref.endpointsId, _RESOURCE_TYPE)
+
+    return result