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

gcloud auth application-default login/google-cloud-sdk/lib/surface/emulators/pubsub/__init__.py

@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2015 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 pubsub emulator group."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.emulators import flags
+from googlecloudsdk.command_lib.emulators import pubsub_util
+from googlecloudsdk.command_lib.emulators import util
+from googlecloudsdk.command_lib.util import java
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class PubSub(base.Group):
+  """Manage your local pubsub emulator.
+
+  This set of commands allows you to start and use a local Pub/Sub emulator to
+  produce a local emulation of your production Google Pub/Sub environment. In
+  addition to having Java JRE (of version 7 or higher) installed and an
+  application built with Google Cloud Client libraries, you must have your
+  emulator configured (have it started with environment variables set) for
+  it to run successfully. The underlying commands help to set up this
+  configuration.
+
+  To stop the emulator, press Ctrl+C.
+
+  For a more comprehensive overview of Pub/Sub, see
+  https://cloud.google.com/pubsub/docs/overview. For Pub/Sub emulator specific
+  documentation, see https://cloud.google.com/pubsub/docs/emulator
+  """
+
+  detailed_help = {
+      'EXAMPLES': """\
+          To start a local pubsub emulator with the default directory for
+          configuration data, run:
+
+            $ {command} start
+
+          After starting the emulator, if your application and
+          emulator run on the same machine, set environment variables
+          automatically by running:
+
+            $ {command} env-init
+
+          If you're running your emulator on a different machine, run the above
+          command and use its resulting output to set the environment variables
+          on the machine that runs your application. This might look like:
+
+            $ export PUBSUB_EMULATOR_HOST=localhost:8538
+            $ export PUBSUB_PROJECT_ID=my-project-id
+
+          Your emulator is now ready for use.
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDataDirFlag(parser, pubsub_util.PUBSUB)
+
+  # Override
+  def Filter(self, context, args):
+    java.RequireJavaInstalled(pubsub_util.PUBSUB_TITLE)
+    util.EnsureComponentIsInstalled('pubsub-emulator', pubsub_util.PUBSUB_TITLE)
+
+    if not args.data_dir:
+      args.data_dir = pubsub_util.GetDataDir()

gcloud auth application-default login/google-cloud-sdk/lib/surface/emulators/pubsub/env_init.py

@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2015 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.
+"""gcloud pubsub emulator env_init command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.emulators import util
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class EnvInit(base.Command):
+  """Print the commands required to export pubsub emulator's env variables.
+
+  After starting the emulator, you need to set environment variables so that
+  your application connects to the emulator instead of the production
+  environment. Environment variables need to be set each time you start the
+  emulator. The environment variables depend on dynamically assigned port
+  numbers that could change when you restart the emulator.
+  """
+
+  detailed_help = {
+      'EXAMPLES': """
+To print the env variables exports for a pubsub emulator, run:
+
+  $ {command} --data-dir=DATA-DIR
+
+For a detailed walkthrough of setting Pub/Sub emulator environment
+variables, see https://cloud.google.com/pubsub/docs/emulator#env.
+""",
+  }
+
+  @staticmethod
+  def Args(parser):
+    parser.display_info.AddFormat('config[export]')
+
+  def Run(self, args):
+    return util.ReadEnvYaml(args.data_dir)

gcloud auth application-default login/google-cloud-sdk/lib/surface/emulators/pubsub/start.py

@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2015 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.
+"""gcloud pubsub emulator start command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import arg_parsers
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.emulators import pubsub_util
+from googlecloudsdk.command_lib.emulators import util
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class Start(base.Command):
+  """Start a local pubsub emulator.
+
+  This command starts a local pubsub emulator.
+
+  On successful start up, you should expect to see:
+
+  ```
+  ...
+  [pubsub] This is the Google Pub/Sub fake.
+  [pubsub] Implementation may be incomplete or differ from the real system.
+  ...
+  [pubsub] INFO: Server started, listening on 8538
+  ```
+  """
+
+  detailed_help = {
+      'EXAMPLES': """
+To start a local pubsub emulator, run:
+
+  $ {command} --data-dir=DATA-DIR
+""",
+  }
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument(
+        '--host-port',
+        required=False,
+        type=lambda arg: arg_parsers.HostPort.Parse(arg, ipv6_enabled=True),
+        help='The host:port to which the emulator should be bound. The default '
+             'value is [::1]:8085.')
+
+  # Override
+  def Run(self, args):
+    if not args.host_port:
+      args.host_port = arg_parsers.HostPort.Parse(util.GetHostPort(
+          pubsub_util.PUBSUB), ipv6_enabled=True)
+
+    with pubsub_util.Start(args) as pubsub_process:
+      util.WriteEnvYaml(pubsub_util.GetEnv(args), args.data_dir)
+      util.PrefixOutput(pubsub_process, pubsub_util.PUBSUB)