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

gcloud auth application-default login/google-cloud-sdk/lib/surface/apigee/applications/__init__.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*- # Lint as: python3
+# Copyright 2020 Google Inc. 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 applications command group for the Apigee CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class Applications(base.Group):
+  """Manage third-party applications which call Apigee API proxies."""
+
+  detailed_help = {
+      "DESCRIPTION":
+          """
+          {description}
+
+          `{command}` manages applications that want to use APIs exposed via
+          Apigee.
+          """,
+      "EXAMPLES":
+          """
+          To get the names and UUIDs of all applications in the active Cloud
+          Platform project, run:
+
+              $ {command} list
+
+          To get a JSON representation of an application in the active Cloud
+          Platform project, including its API keys, run:
+
+              $ {command} describe APP_UUID --format=json
+          """,
+  }

gcloud auth application-default login/google-cloud-sdk/lib/surface/apigee/applications/describe.py

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*- # Lint as: python3
+# Copyright 2020 Google Inc. 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 an Apigee application."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib import apigee
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.apigee import defaults
+from googlecloudsdk.command_lib.apigee import resource_args
+
+
+class Describe(base.DescribeCommand):
+  """Describe an Apigee application."""
+
+  detailed_help = {
+      "DESCRIPTION": """
+          {description}
+
+          `{command}` retrieves the application's details, including its
+          developer, credentials, API products, and other information.
+          """,
+      "EXAMPLES": """
+          To describe an application for the active Cloud Platform project whose
+          UUID is ``46d6151e-0000-4dfa-b9c7-c03b8b58bb2f'', run:
+
+              $ {command} 46d6151e-0000-4dfa-b9c7-c03b8b58bb2f
+
+          To describe that application in the Apigee organization ``my-org'',
+          formatted as a JSON object, run:
+
+              $ {command} 46d6151e-0000-4dfa-b9c7-c03b8b58bb2f --organization=my-org --format=json
+          """
+  }
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddSingleResourceArgument(
+        parser, "organization.app",
+        "Application to be described. To get a list of available applications, "
+        "run `{parent_command} list`.",
+        argument_name="APPLICATION",
+        fallthroughs=[defaults.GCPProductOrganizationFallthrough()])
+
+  def Run(self, args):
+    """Run the describe command."""
+    identifiers = args.CONCEPTS.application.Parse().AsDict()
+    return apigee.ApplicationsClient.Describe(identifiers)

gcloud auth application-default login/google-cloud-sdk/lib/surface/apigee/applications/list.py

@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*- # Lint as: python3
+# Copyright 2020 Google Inc. 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 Apigee applications."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib import apigee
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.apigee import defaults
+from googlecloudsdk.command_lib.apigee import resource_args
+
+
+# Placeholder developer identifier that should include all developers. No real
+# developer ID should have / in it, as they're email addresses.
+ANY_DEVELOPER = "/ANY/"
+
+
+class List(base.ListCommand):
+  """List Apigee applications."""
+
+  detailed_help = {
+      "EXAMPLES":
+          """
+          To list all Apigee applications in the active Cloud Platform project,
+          run:
+
+              $ {command}
+
+          To list all Apigee applications belonging to the developer
+          ``horse@example.com'' in an Apigee organization called ``my-org'',
+          formatted as JSON, run:
+
+              $ {command} --developer=horse@example.com --organization=my-org --format=json
+          """
+  }
+
+  @staticmethod
+  def Args(parser):
+    fallthroughs = [
+        defaults.GCPProductOrganizationFallthrough(),
+        defaults.StaticFallthrough("developer", ANY_DEVELOPER)
+    ]
+    resource_args.AddSingleResourceArgument(
+        parser,
+        "organization.developer",
+        "Apigee organization, and optionally developer, whose applications "
+        "should be listed. If developer is not specified, all developers will "
+        "be listed.\n\n"
+        "To get a list of valid developers, run:\n\n"
+        "    $ {grandparent_command} developers list\n\n",
+        positional=False,
+        fallthroughs=fallthroughs)
+    parser.display_info.AddFormat("table(appId, name)")
+
+  def Run(self, args):
+    """Run the list command."""
+    identifiers = args.CONCEPTS.developer.Parse().AsDict()
+    if identifiers["developersId"] == ANY_DEVELOPER:
+      del identifiers["developersId"]
+    return apigee.ApplicationsClient.List(identifiers)