File: //snap/google-cloud-cli/current/lib/surface/resource_config/bulk_export.py
# -*- coding: utf-8 -*- #
# Copyright 2020 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.
"""Command for retrieving declarative configurations for Google Cloud Platform resources."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.util.declarative import flags as declarative_flags
from googlecloudsdk.command_lib.util.declarative.clients import kcc_client
from googlecloudsdk.core import log
_DETAILED_HELP = {
    'EXAMPLES':
        """
    To export all resources in a project to a local directory, run:
      $ {command} --path=/path/to/dir/
    To export all resources in a organization to stdout, run:
      $ {command} --organization=12345 --path=-
    To export all resources in a folder to stdout in Terraform format,
    run:
      $ {command} --folder=12345 --resource-format=terraform
    To export all resources in a project to stdout, using a custom Google Storage bucket for interim results,
    run:
      $ {command} --project=my-project --storage-path='gs://your-bucket-name/your/prefix/path'
    To export all Storage Bucket and Compute Instances resources in project my-project to stdout,
    run:
      $ {command} --project=my-project --resource-types=storage.cnrm.cloud.google.com/StorageBucket,ComputeInstance
    To export all resource types in file 'types-file.txt' in project my-project to stdout,
    run:
      $ {command} --project=my-project --resource-types-file=types-file.txt
    """
}
@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
class Export(base.DeclarativeCommand):
  """Export configurations for all assets within the specified project, organization, or folder."""
  detailed_help = _DETAILED_HELP
  @classmethod
  def Args(cls, parser):
    declarative_flags.AddBulkExportArgs(parser)
  def Run(self, args):
    client = kcc_client.KccClient()
    if args.IsSpecified('format'):
      log.warning('`--format` flag not supported for bulk-export. '
                  'To change the format of exported resources use the '
                  '`--resource-format` flag.')
      args.format = None
    else:
      client.BulkExport(args)
    return