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

gcloud auth application-default login/google-cloud-sdk/lib/surface/firebase/test/network_profiles/__init__.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 firebase test network-profiles' command group."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class NetworkProfiles(base.Group):
+  """Explore network profiles available for testing.
+
+  A network traffic profile consists of a set of parameters to emulate network
+  conditions when running a test. This feature only works on physical devices.
+  The network shaping parameters are:
+
+  - *RULE*: Where to apply traffic shaping. The UP rule shapes the
+    connection from the device to the internet. The DOWN rule shapes the
+    connection from the internet to the device.
+  - *DELAY*: The delay in packet transmission, in ms.
+  - *LOSS_RATIO*: The ratio of packets dropped during transmission.
+  - *DUPLICATION_RATIO*: The ratio of packets duplicated during
+    transmission.
+  - *BANDWIDTH*: The average packet transmission rate in kbits/s, as
+    defined by the token bucket algorithm.
+  - *BURST*: The total size, in kbits, by which packets can exceed the
+    bandwidth, as defined by the token bucket algorithm.
+  """
+
+  detailed_help = {
+      'EXAMPLES': """\
+          To list all network profiles which can be used for testing, run:
+
+            $ {command} list
+
+          To view information about a specific network profile, run:
+
+            $ {command} describe PROFILE_ID
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Method called by Calliope to register flags common to this sub-group.
+
+    Args:
+      parser: An argparse parser used to add arguments that immediately follow
+          this group in the CLI. Positional arguments are allowed.
+    """
+    pass

gcloud auth application-default login/google-cloud-sdk/lib/surface/firebase/test/network_profiles/describe.py

@@ -0,0 +1,73 @@
+# -*- 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 firebase test network-profiles describe' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.firebase.test import exceptions
+from googlecloudsdk.api_lib.firebase.test import util
+from googlecloudsdk.calliope import base
+
+
+class Describe(base.DescribeCommand):
+  """Describe a network profile."""
+
+  detailed_help = {
+      'DESCRIPTION': """Describe a network profile.
+
+Run `$ {parent_command} --help` for descriptions of the network profile
+parameters.
+""",
+      'EXAMPLES': """To describe a network profile, run:
+
+  {command} GSM
+
+To describe a network profiles in JSON format, run:
+
+  {command} GSM --format=json
+"""
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Method called by Calliope to register flags for this command.
+
+    Args:
+      parser: An argparse parser used to add arguments that follow this
+          command in the CLI. Positional arguments are allowed.
+    """
+    # Positional arg
+    parser.add_argument(
+        'profile_id',
+        help=
+        'The network profile to describe, found using $ {parent_command} list.')
+
+  def Run(self, args):
+    """Run the 'gcloud firebase test network-profiles describe' command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation (i.e. group and command arguments combined).
+
+    Returns:
+      The testing_v1_messages.NetworkConfiguration object to describe.
+    """
+    catalog = util.GetNetworkProfileCatalog(self.context)
+    for profile in catalog.configurations:
+      if profile.id == args.profile_id:
+        return profile
+    raise exceptions.NetworkProfileNotFoundError(args.profile_id)

gcloud auth application-default login/google-cloud-sdk/lib/surface/firebase/test/network_profiles/list.py

@@ -0,0 +1,79 @@
+# -*- 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 firebase test network-profiles list' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.firebase.test import util
+from googlecloudsdk.calliope import base
+
+
+class List(base.ListCommand):
+  """List all network profiles available for testing."""
+
+  detailed_help = {
+      'DESCRIPTION': """List all network profiles available for testing.
+
+Run `$ {parent_command} --help` for descriptions of the network profile
+parameters.
+""",
+      'EXAMPLES': """To list all network profiles, run:
+
+  {command}
+
+To list all GSM network profiles, run:
+
+  {command} --filter="id:GSM"
+"""
+  }
+
+  @staticmethod
+  def Args(parser):
+    """Method called by Calliope to register flags for this command.
+
+    Args:
+      parser: An argparse parser used to add arguments that follow this
+          command in the CLI. Positional arguments are allowed.
+    """
+    parser.display_info.AddFormat("""
+          table[box](
+            id:label=PROFILE_ID,
+            synthesize((rule:up, upRule),(rule:down, downRule)):
+              format="table[box](
+                rule,
+                delay,
+                packetLossRatio:label=LOSS_RATIO,
+                packetDuplicationRatio:label=DUPLICATION_RATIO,
+                bandwidth,
+                burst
+              )"
+          )
+    """)
+    base.URI_FLAG.RemoveFromParser(parser)
+
+  def Run(self, args):
+    """Run the 'gcloud firebase test network-profiles list' command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation (i.e. group and command arguments combined).
+
+    Returns:
+      The list of network profiles we want to have printed later or None.
+    """
+    catalog = util.GetNetworkProfileCatalog(self.context)
+    return getattr(catalog, 'configurations', None)