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

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 the Fault injection testing CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Experiments(base.Group):
+  """Manage Apphub resources."""
+
+  # See third_party/py/googlecloudsdk/calliope/base.py for a list of categories.
+  category = base.MANAGEMENT_TOOLS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/create.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to create a experiment in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To create a experiment with the id `my-experiment` and file path `my/path/to/yaml`, run:
+
+          $ {command} my-experiment --file=my/path/to/yaml
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Create(base.CreateCommand):
+  """Command to create a experiment in the Project/Location."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddCreateExperimentFlags(parser)
+
+  def Run(self, args):
+    """Run the create command."""
+    client = experiments.ExperimentsClient()
+    exp_ref = args.CONCEPTS.experiment.Parse()
+    parent_ref = exp_ref.Parent()
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'experiment id must be non-empty.'
+      )
+    if not args.file:
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'file path must be non-empty.'
+      )
+    return client.Create(
+        experiment=exp_ref.Name(),
+        experiment_config=args.file,
+        parent=parent_ref.RelativeName(),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/delete.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to delete a Experiment in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To delete a experiment with the id `my-experiment`, run:
+
+          $ {command} my-experiment
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Delete(base.DeleteCommand):
+  """Delete Experiment."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDeleteExperimentFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = experiments.ExperimentsClient()
+    exp_ref = args.CONCEPTS.experiment.Parse()
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'experiment id must be non-empty.'
+      )
+    return client.Delete(experiment=exp_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/describe.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to describe a Experiment in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        to describe a experiment with the id `my-experiment`, run:
+
+          $ {command} my-experiment
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Describe(base.DescribeCommand):
+  """Describe Experiment."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDescribeExperimentFlags(parser)
+
+  def Run(self, args):
+    """Run the describe command."""
+    client = experiments.ExperimentsClient()
+    exp_ref = args.CONCEPTS.experiment.Parse()
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'experiment id must be non-empty.'
+      )
+    return client.Describe(experiment=exp_ref.RelativeName())

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/list.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to List experiments in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To List all experiments, run:
+
+          $ {command}
+        """,
+}
+
+_FORMAT = """
+  table(
+    name.scope("experiments"):label=NAME,
+    name.scope("projects").segment(1):label=PROJECT,
+    name.scope("locations").segment(0):label=LOCATION,
+    description,
+    runFaults:label=FAULTS,
+    createTime.date(unit=1000, tz_default=UTC)
+  )
+"""
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class List(base.ListCommand):
+  """List Experiments."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddListExperimentFlags(parser)
+    parser.display_info.AddFormat(_FORMAT)
+
+  def Run(self, args):
+    """Run the list command."""
+    client = experiments.ExperimentsClient()
+    location_ref = args.CONCEPTS.location.Parse()
+    return client.List(
+        limit=args.limit,
+        page_size=args.page_size,
+        parent=location_ref.RelativeName(),
+    )

gcloud auth application-default login/google-cloud-sdk/lib/surface/fault_injection/experiments/update.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Command to update a experiment in the Project/Location."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.fault_injection import experiments
+from googlecloudsdk.calliope import base
+from googlecloudsdk.calliope import exceptions
+from googlecloudsdk.command_lib.fault_injection import flags
+
+
+_DETAILED_HELP = {
+    'DESCRIPTION': '{description}',
+    'EXAMPLES': """ \
+        To update a experiment with the id `my-experiment` and file path `my/path/to/yaml`, run:
+
+          $ {command} my-experiment --file=my/path/to/yaml
+        """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class Update(base.UpdateCommand):
+  """Command to update a experiment in the Project/Location."""
+
+  detailed_help = _DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    flags.AddUpdateExperimentFlags(parser)
+
+  def Run(self, args):
+    """Run the create command."""
+    client = experiments.ExperimentsClient()
+    exp_ref = args.CONCEPTS.experiment.Parse()
+    if not exp_ref.Name():
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'experiment id must be non-empty.'
+      )
+    if not args.file:
+      raise exceptions.InvalidArgumentException(
+          'experiment', 'file path must be non-empty.'
+      )
+    return client.Update(
+        experiment=exp_ref.RelativeName(),
+        experiment_config=args.file,
+    )