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/ip_blocks/__init__.py

@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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 ip-blocks' sub-group."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class IpBlocks(base.Group):
+  """Explore IP blocks used by Firebase Test Lab devices."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          """
+          Get a list of IP address blocks in CIDR notation used by Firebase Test
+          Lab devices.
+          """,
+      'EXAMPLES':
+          """
+          To see the list of the IP blocks used, their form factors, and
+          the date they were added to Firebase Test Lab, run:
+
+            $ {command} list
+      """
+  }
+
+  @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/ip_blocks/list.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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 ip-blocks 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 IP address blocks used by Firebase Test Lab devices."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          """List all IP address blocks used by Firebase Test Lab
+devices.""",
+      'EXAMPLES':
+          """To list all IP address blocks, run:
+
+  $ {command}
+
+To list only the CIDR blocks one per line, run:
+
+  $ {command} --format="value(BLOCK)"
+"""
+  }
+
+  @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](
+          block,
+          form.color(blue=VIRTUAL,yellow=PHYSICAL),
+          addedDate.date('%Y-%m-%d')
+        )
+    """)
+    base.URI_FLAG.RemoveFromParser(parser)
+
+  def Run(self, args):
+    """Run the 'gcloud firebase test ip-blocks 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 IP blocks we want to have printed later.
+    """
+    device_ip_block_catalog = util.GetDeviceIpBlocks(self.context)
+    return device_ip_block_catalog.ipBlocks