text: # Copyright 2014 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.
  
  """operations describe command."""
  
  from googlecloudsdk.api_lib.deployment_manager import dm_v2_util
  from googlecloudsdk.calliope import base
  from googlecloudsdk.calliope import exceptions
  from googlecloudsdk.core import log
  from googlecloudsdk.core import properties
  from googlecloudsdk.core import resource_printer
  from googlecloudsdk.third_party.apitools.base.py import exceptions as apitools_exceptions
  
  
  class Describe(base.Command):
    """Provide information about an operation.
  
    This command prints out all available details about an operation.
    """
  
    detailed_help = {
        'DESCRIPTION': '{description}',
        'EXAMPLES': """\
            To display information about an operation, run:
  
              $ {command} operation-name
            """,
    }
  
    @staticmethod
    def Args(parser):
      """Args is called by calliope to gather arguments for this command.
  
      Args:
        parser: An argparse parser that you can use to add arguments that go
            on the command line after this command. Positional arguments are
            allowed.
      """
      parser.add_argument('operation_name', help='Operation name.')
  
    def Run(self, args):
      """Run 'operations describe'.
  
      Args:
        args: argparse.Namespace, The arguments that this command was invoked
            with.
  
      Returns:
        The requested operation.
  
      Raises:
        HttpException: An http error response was received while executing api
            request.
      """
      client = self.context['deploymentmanager-client']
      messages = self.context['deploymentmanager-messages']
      project = properties.VALUES.core.project.Get(required=True)
  
      try:
        return client.operations.Get(
            messages.DeploymentmanagerOperationsGetRequest(
                project=project,
                operation=args.operation_name,
            )
        )
      except apitools_exceptions.HttpError as error:
        raise exceptions.HttpException(dm_v2_util.GetError(error))
  
    def Display(self, unused_args, result):
      """Display prints information about what just happened to stdout.
  
      Args:
        unused_args: The same as the args in Run.
  
        result: an Operation to display
  
      Raises:
        ValueError: if result is None or not an Operation
      """
      messages = self.context['deploymentmanager-messages']
      if not isinstance(result, messages.Operation):
        raise ValueError('result must be an Operation')
  
      resource_printer.Print(resources=result,
                             print_format=unused_args.format or 'yaml',
                             out=log.out)
  