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

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastore/operations/__init__.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. 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 command group for Cloud Datastore operations."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+class Operations(base.Group):
+  """Manage Long Running Operations for Cloud Datastore."""
+  pass

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastore/operations/cancel.py

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. 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 gcloud datastore operations cancel command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.datastore import operations
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.datastore import flags
+from googlecloudsdk.core import properties
+from googlecloudsdk.core import resources
+from googlecloudsdk.core.console import console_io
+
+
+class Cancel(base.Command):
+  """Cancel a currently-running Cloud Datastore admin operation."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To cancel the currently-running operation with id `exampleId`, run:
+
+            $ {command} exampleId
+
+          or
+
+            $ {command} projects/your-project-id/operations/exampleId
+      """
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command.
+
+    Args:
+      parser: argparse.ArgumentParser, the parser for this command.
+    """
+    flags.AddOperationNameFlag(parser, 'cancel')
+
+  def Run(self, args):
+    name = resources.REGISTRY.Parse(
+        args.name,
+        params={
+            'projectsId': properties.VALUES.core.project.GetOrFail,
+        },
+        collection='datastore.projects.operations').RelativeName()
+    console_io.PromptContinue(
+        message='The operation [{}] will be cancelled.'.format(name),
+        cancel_on_no=True)
+
+    return operations.CancelOperation(name)

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastore/operations/delete.py

@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. 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 gcloud datastore operations delete command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.datastore import operations
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.datastore import flags
+from googlecloudsdk.core import properties
+from googlecloudsdk.core import resources
+from googlecloudsdk.core.console import console_io
+
+
+class Delete(base.DeleteCommand):
+  """Delete a completed Cloud Datastore admin operation."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To delete the completed operation with id `exampleId`, run:
+
+            $ {command} exampleId
+
+          or
+
+            $ {command} projects/your-project-id/operations/exampleId
+      """
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command.
+
+    Args:
+      parser: argparse.ArgumentParser, the parser for this command.
+    """
+    flags.AddOperationNameFlag(parser, 'delete')
+
+  def Run(self, args):
+    name = resources.REGISTRY.Parse(
+        args.name,
+        params={
+            'projectsId': properties.VALUES.core.project.GetOrFail,
+        },
+        collection='datastore.projects.operations').RelativeName()
+    console_io.PromptContinue(
+        message='The operation [{}] will be deleted.'.format(name),
+        cancel_on_no=True)
+
+    return operations.DeleteOperation(name)

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastore/operations/describe.py

@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. 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 gcloud datastore operations describe command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.datastore import operations
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.datastore import flags
+from googlecloudsdk.core import properties
+from googlecloudsdk.core import resources
+
+
+class Describe(base.DescribeCommand):
+  """Retrieves information about a Cloud Datastore admin operation."""
+
+  detailed_help = {
+      'EXAMPLES':
+          """\
+          To see information on the operation with id `exampleId`, run:
+
+            $ {command} exampleId
+
+          or
+
+            $ {command} projects/your-project-id/operations/exampleId
+      """
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command.
+
+    Args:
+      parser: argparse.ArgumentParser, the parser for this command.
+    """
+    flags.AddOperationNameFlag(parser, 'retrieve')
+
+  def Run(self, args):
+    name = resources.REGISTRY.Parse(
+        args.name,
+        params={
+            'projectsId': properties.VALUES.core.project.GetOrFail,
+        },
+        collection='datastore.projects.operations').RelativeName()
+    return operations.GetOperation(name)

gcloud auth application-default login/google-cloud-sdk/lib/surface/datastore/operations/list.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2017 Google LLC. 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 gcloud datastore operations list command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.datastore import operations
+from googlecloudsdk.api_lib.datastore import rewrite_backend
+from googlecloudsdk.calliope import base
+from googlecloudsdk.core import properties
+from googlecloudsdk.core.resource import resource_projection_spec
+
+
+class List(base.ListCommand):
+  """List pending Cloud Datastore admin operations and their status.
+
+  Filters are case-sensitive and have the following syntax:
+
+    field = value [AND [field = value]] ...
+
+  where `field` is one of `kind`, `namespace`, `type`, or `labels.[KEY]`, and
+  `[KEY]` is a label key. `kind` and `namespace` may be `*` to query for
+  operations on all kinds and/or all namespaces. `type` may be one of
+  `export_entities` or `import_entities`.
+
+  Only the logical `AND` operator is
+  supported; space-separated items are treated as having an implicit `AND`
+  operator.
+
+  ## EXAMPLES
+
+  To see the list of all operations, run:
+
+    $ {command}
+
+  To see the list of all export operations, run:
+
+    $ {command} --filter='type:export_entities'
+
+  To see the list of all export operations for kind 'MyKind', run:
+
+    $ {command} --filter='type:export_entities AND kind:MyKind'
+
+  To see the list of all operations with particular labels, run:
+
+    $ {command} --filter='labels.run = daily'
+  """
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    base.PAGE_SIZE_FLAG.SetDefault(parser, operations.DEFAULT_PAGE_SIZE)
+    base.LIMIT_FLAG.SetDefault(parser, operations.DEFAULT_PAGE_SIZE)
+
+  def Run(self, args):
+    frontend_filter, backend_filter = self._ConvertFilter(args.filter, args)
+    # Override existing filter with frontend filter.
+    args.filter = frontend_filter
+    return operations.ListOperations(
+        project=properties.VALUES.core.project.Get(required=True),
+        limit=args.limit,
+        operation_filter=backend_filter)
+
+  def _ConvertFilter(self, expression, args):
+    """Translates user-provided filter spec into one our backend understands.
+
+    Args:
+      expression: a filter spec to translate
+      args: the args namespace object
+    Returns:
+      A tuple of string filter specs. The first is the frontend spec for post
+      filtering, the second is a spec that the Datastore Admin API understands.
+    """
+    operation_rewrite_backend = rewrite_backend.OperationsRewriteBackend()
+    display_info = args.GetDisplayInfo()
+    defaults = resource_projection_spec.ProjectionSpec(
+        symbols=display_info.transforms, aliases=display_info.aliases)
+    return operation_rewrite_backend.Rewrite(expression, defaults=defaults)