File: //snap/google-cloud-cli/current/lib/googlecloudsdk/api_lib/composer/util.py
# -*- coding: utf-8 -*- #
# Copyright 2017 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.
"""Utilities for calling the Composer API."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
import itertools
from apitools.base.py import encoding
from apitools.base.py import list_pager
from googlecloudsdk.api_lib.util import apis
from googlecloudsdk.calliope import base
import six
COMPOSER_API_NAME = 'composer'
COMPOSER_GA_API_VERSION = 'v1'
COMPOSER_BETA_API_VERSION = 'v1beta1'
COMPOSER_ALPHA_API_VERSION = 'v1alpha2'
DEFAULT_PAGE_SIZE = 30
def GetApiVersion(release_track=base.ReleaseTrack.GA):
  if release_track == base.ReleaseTrack.BETA:
    return COMPOSER_BETA_API_VERSION
  elif release_track == base.ReleaseTrack.ALPHA:
    return COMPOSER_ALPHA_API_VERSION
  return COMPOSER_GA_API_VERSION
def GetClientInstance(release_track=base.ReleaseTrack.GA):
  return apis.GetClientInstance(
      COMPOSER_API_NAME, GetApiVersion(release_track=release_track))
def GetMessagesModule(release_track=base.ReleaseTrack.GA):
  return apis.GetMessagesModule(
      COMPOSER_API_NAME, GetApiVersion(release_track=release_track))
def AggregateListResults(request_cls,
                         service,
                         location_refs,
                         field,
                         page_size,
                         limit=None,
                         location_attribute='parent'):
  """Collects the results of a List API call across a list of locations.
  Args:
    request_cls: class, the apitools.base.protorpclite.messages.Message class
        corresponding to the API request message used to list resources in a
        location.
    service: apitools.base.py.BaseApiService, a service whose list
        method to call with an instance of `request_cls`
    location_refs: [core.resources.Resource], a list of resource references to
        locations in which to list resources.
    field: str, the name of the field within the list method's response from
        which to extract a list of resources
    page_size: int, the maximum number of resources to retrieve in each API
        call
    limit: int, the maximum number of results to return. None if all available
        results should be returned.
    location_attribute: str, the name of the attribute in `request_cls` that
        should be populated with the name of the location
  Returns:
    A generator over up to `limit` resources if `limit` is not None. If `limit`
    is None, the generator will yield all resources in all requested locations.
  """
  results = []
  for location_ref in location_refs:
    request = request_cls()
    setattr(request, location_attribute, location_ref.RelativeName())
    results = itertools.chain(
        results,
        list_pager.YieldFromList(
            service,
            request=request,
            field=field,
            limit=None if limit is None else limit,
            batch_size=DEFAULT_PAGE_SIZE if page_size is None else page_size,
            batch_size_attribute='pageSize'))
  return itertools.islice(results, limit)
def ParseOperationJsonMetadata(metadata_value, metadata_type):
  if not metadata_value:
    return metadata_type()
  return encoding.JsonToMessage(metadata_type,
                                encoding.MessageToJson(metadata_value))
def DictToMessage(dictionary, msg_type):
  return msg_type(additionalProperties=[
      msg_type.AdditionalProperty(key=key, value=value)
      for key, value in six.iteritems(dictionary)
  ])