text: """Run a kubectl command."""
  # docs: file://./../../../../docs/source/commands.rst
  import logging
  import subprocess
  from typing import Any, Tuple
  
  import click
  
  from ....env_mgr.tfenv import TFEnvManager
  from ....utils import DOC_SITE
  from ... import options
  
  LOGGER = logging.getLogger(__name__.replace("._", "."))
  
  
  @click.command(
      "run", short_help="run terraform", context_settings={"ignore_unknown_options": True}
  )
  @click.argument("args", metavar="<args>", nargs=-1, required=True)
  @options.debug
  @options.no_color
  @options.verbose
  @click.pass_context
  def run(ctx: click.Context, args: Tuple[str, ...], **_: Any) -> None:
      """Run a Terraform command.
  
      Uses the version of Terraform specified in the ".terraform-version" file
      in the current directory.
  
      IMPORTANT: When using options shared with Runway "--" must be placed
      before the Terraform command.
  
      """
      try:
          ctx.exit(subprocess.call([TFEnvManager().install()] + list(args)))
      except ValueError as err:
          LOGGER.debug("terraform install failed", exc_info=True)
          if "unable to find" not in str(err):
              LOGGER.error(
                  "unexpected error encountered when trying to install Terraform",
                  exc_info=True,
              )
              ctx.exit(1)
          else:
              LOGGER.error("unable to find a .terraform-version file")
              LOGGER.error(
                  "learn how to use Runway to manage Terraform versions at "
                  "%s/page/terraform/advanced_features.html#version-management",
                  DOC_SITE,
              )
          ctx.exit(1)
  