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

@@ -0,0 +1,49 @@
+# -*- 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 android versions' command group."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class Versions(base.Group):
+  """Explore Android versions available for testing."""
+
+  detailed_help = {
+      'EXAMPLES': """\
+          To list information about all versions of the Android OS available
+          for running tests, including details such as OS code name and
+          release date, run:
+
+            $ {command} list
+
+          To view information about a specific Android OS version, run:
+
+            $ {command} describe VERSION_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.
+    """

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

@@ -0,0 +1,83 @@
+# -*- 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 android versions 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
+
+
+DETAILED_HELP = {
+    'EXAMPLES': """
+    To see attributes of the Android OS version 'my-version', run:
+
+      $ {command} my-version
+    """,
+}
+
+
+class Describe(base.DescribeCommand):
+  """Describe an Android OS version."""
+
+  detailed_help = {
+      'DESCRIPTION': 'Describe an Android OS version.',
+      'EXAMPLES': """To describe an Android OS version available for testing,
+run:
+
+  {command} Q
+
+To describe an Android OS version available for testing in JSON format,
+run:
+
+  {command} Q --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(
+        'version_id',
+        help='The version ID to describe, found using $ {parent_command} list.')
+
+  def Run(self, args):
+    """Run the 'gcloud firebase test android versions 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.AndroidVersion object to describe.
+    """
+    catalog = util.GetAndroidCatalog(self.context)
+    for version in catalog.versions:
+      if version.id == args.version_id:
+        return version
+    raise exceptions.VersionNotFoundError(args.version_id)
+
+
+Describe.detailed_help = DETAILED_HELP

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

@@ -0,0 +1,71 @@
+# -*- 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 android versions 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
+
+DETAILED_HELP = {
+    'EXAMPLES': """
+      To list all versions available for testing, run:
+
+        $ {command}
+    """,
+}
+
+
+class List(base.ListCommand):
+  """List all Android OS versions available for testing."""
+
+  @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=OS_VERSION_ID:align=center,
+            versionString:label=VERSION:align=center,
+            codeName,
+            apiLevel:align=center,
+            releaseDate.date(format='%Y-%m-%d'):align=center,
+            tags.list().color(green=default,red=deprecated,yellow=preview)
+          )
+    """)
+    base.URI_FLAG.RemoveFromParser(parser)
+
+  def Run(self, args):
+    """Run the 'gcloud firebase test android versions 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 Android OS versions we want to have printed later.
+    """
+    catalog = util.GetAndroidCatalog(self.context)
+    return catalog.versions
+
+
+List.detailed_help = DETAILED_HELP