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

gcloud auth application-default login/google-cloud-sdk/lib/surface/services/groups/__init__.py

@@ -0,0 +1,23 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""Package for the groups CLI subcommands."""
+
+from googlecloudsdk.calliope import base
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class Groups(base.Group):
+  """View service group information."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/services/groups/list_ancestor_groups.py

@@ -0,0 +1,93 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""services groups list ancestor groups command."""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.services import serviceusage
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.services import common_flags
+from googlecloudsdk.core import properties
+
+_PROJECT_RESOURCE_TEMPLATE = 'projects/%s'
+_FOLDER_RESOURCE_TEMPLATE = 'folders/%s'
+_ORGANIZATION_RESOURCE_TEMPLATE = 'organizations/%s'
+_SERVICE_RESOURCE_TEMPLATE = 'services/%s'
+_GROUP_RESOURCE_TEMPLATE = 'groups/%s'
+
+
+# TODO(b/321801975) make command public after suv2alpha launch.
+@base.UniverseCompatible
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class ListAncestorGroups(base.ListCommand):
+  """List ancestor groups of a specific service.
+
+  List ancestor groups of a specific service.
+
+  ## EXAMPLES
+
+    List ancestor groups of service my-service:
+
+   $ {command} my-service
+
+   List ancestor groups of service my-service for a specific project '12345678':
+
+    $ {command} my-service --project=12345678
+  """
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument('service', help='Name of the service.')
+
+    common_flags.add_resource_args(parser)
+
+    base.PAGE_SIZE_FLAG.SetDefault(parser, 50)
+
+    # Remove unneeded list-related flags from parser
+    base.URI_FLAG.RemoveFromParser(parser)
+
+    parser.display_info.AddFormat("""
+          table(
+            groupName:label=''
+          )
+        """)
+
+  def Run(self, args):
+    """Run command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Resource name and its parent name.
+    """
+    if args.IsSpecified('folder'):
+      resource_name = _FOLDER_RESOURCE_TEMPLATE % args.folder
+    elif args.IsSpecified('organization'):
+      resource_name = _ORGANIZATION_RESOURCE_TEMPLATE % args.organization
+    elif args.IsSpecified('project'):
+      resource_name = _PROJECT_RESOURCE_TEMPLATE % args.project
+    else:
+      project = properties.VALUES.core.project.Get(required=True)
+      resource_name = _PROJECT_RESOURCE_TEMPLATE % project
+    response = serviceusage.ListAncestorGroups(
+        resource_name,
+        _SERVICE_RESOURCE_TEMPLATE % args.service,
+    )
+
+    return response

gcloud auth application-default login/google-cloud-sdk/lib/surface/services/groups/list_descendant_services.py

@@ -0,0 +1,94 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""services groups list descendant services command."""
+
+from googlecloudsdk.api_lib.services import serviceusage
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.services import common_flags
+from googlecloudsdk.core import properties
+
+_PROJECT_RESOURCE = 'projects/%s'
+_FOLDER_RESOURCE = 'folders/%s'
+_ORGANIZATION_RESOURCE = 'organizations/%s'
+_SERVICE_RESOURCE = 'services/%s'
+_GROUP_RESOURCE = 'groups/%s'
+
+
+# TODO(b/402831836): Do not make the command public.
+@base.UniverseCompatible
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class ListDescendantServices(base.ListCommand):
+  """List descendant services of a specific service and group.
+
+  List descendant services of a specific service and group.
+
+  ## EXAMPLES
+
+   List descendant services of service my-service and group my-group:
+
+   $ {command} my-service my-group
+
+   List descendant services of service my-service and group my-group
+   for a specific project '12345678':
+
+    $ {command} my-service my-group --project=12345678
+  """
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument('service', help='Name of the service.')
+    parser.add_argument(
+        'group', help='Service group name, for example "dependencies".'
+    )
+    common_flags.add_resource_args(parser)
+
+    base.PAGE_SIZE_FLAG.SetDefault(parser, 50)
+
+    # Remove unneeded list-related flags from parser
+    base.URI_FLAG.RemoveFromParser(parser)
+
+    parser.display_info.AddFormat("""
+          table(
+            serviceName:label=''
+          )
+        """)
+
+  def Run(self, args):
+    """Run command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Resource name and its parent name.
+    """
+    if args.IsSpecified('folder'):
+      resource_name = _FOLDER_RESOURCE % args.folder
+    elif args.IsSpecified('organization'):
+      resource_name = _ORGANIZATION_RESOURCE % args.organization
+    elif args.IsSpecified('project'):
+      resource_name = _PROJECT_RESOURCE % args.project
+    else:
+      project = properties.VALUES.core.project.Get(required=True)
+      resource_name = _PROJECT_RESOURCE % project
+    response = serviceusage.ListDescendantServices(
+        resource_name,
+        '{}/{}'.format(
+            _SERVICE_RESOURCE % args.service, _GROUP_RESOURCE % args.group
+        ),
+    )
+    return response

gcloud auth application-default login/google-cloud-sdk/lib/surface/services/groups/list_expanded_members.py

@@ -0,0 +1,108 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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.
+"""services groups list expanded members command."""
+import collections
+
+from googlecloudsdk.api_lib.services import exceptions
+from googlecloudsdk.api_lib.services import serviceusage
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.services import common_flags
+from googlecloudsdk.command_lib.services import util
+from googlecloudsdk.core import properties
+
+_PROJECT_RESOURCE = 'projects/%s'
+_FOLDER_RESOURCE = 'folders/%s'
+_ORGANIZATION_RESOURCE = 'organizations/%s'
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class ListExpandedMembers(base.ListCommand):
+  """List expanded members of a specific service and group.
+
+  List expanded members of a specific service and group.
+
+  ## EXAMPLES
+
+   List expanded members of service my-service and group my-group:
+
+   $ {command} my-service my-group
+
+   List expanded members of service my-service and group my-group
+   for a specific project '12345678':
+
+    $ {command} my-service my-group --project=12345678
+  """
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument('service', help='Name of the service.')
+    parser.add_argument(
+        'group', help='Service group name, for example "dependencies".'
+    )
+    common_flags.add_resource_args(parser)
+
+    base.PAGE_SIZE_FLAG.SetDefault(parser, 50)
+
+    # Remove unneeded list-related flags from parser
+    base.URI_FLAG.RemoveFromParser(parser)
+
+    parser.display_info.AddFormat("""
+          table(
+            Name:label=''
+          )
+        """)
+
+  def Run(self, args):
+    """Run command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Resource name and its parent name.
+    """
+    if args.IsSpecified('folder'):
+      resource_name = _FOLDER_RESOURCE % args.folder
+    elif args.IsSpecified('organization'):
+      resource_name = _ORGANIZATION_RESOURCE % args.organization
+    elif args.IsSpecified('project'):
+      resource_name = _PROJECT_RESOURCE % args.project
+    else:
+      project = properties.VALUES.core.project.Get(required=True)
+      resource_name = _PROJECT_RESOURCE % project
+
+    if not util.IsValidGroupName(args.service, args.group):
+      raise exceptions.InvalidGroupNameError(
+          util.GetGroupName(args.service, args.group)
+      )
+
+    response = serviceusage.ListExpandedMembers(
+        resource_name,
+        util.GetGroupName(args.service, args.group),
+        page_size=args.page_size,
+    )
+    service_names = []
+    results = collections.namedtuple('Service', ['name'])
+    for service in response:
+      service_names.append(results(name=service))
+
+    if not service_names:
+      raise exceptions.EmptyMembersError(
+          util.GetGroupName(args.service, args.group)
+      )
+
+    return service_names

gcloud auth application-default login/google-cloud-sdk/lib/surface/services/groups/list_members.py

@@ -0,0 +1,115 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+"""services groups list members command."""
+import collections
+
+from googlecloudsdk.api_lib.services import exceptions
+from googlecloudsdk.api_lib.services import serviceusage
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.services import common_flags
+from googlecloudsdk.command_lib.services import util
+from googlecloudsdk.core import properties
+
+_PROJECT_RESOURCE = 'projects/{}'
+_FOLDER_RESOURCE = 'folders/{}'
+_ORGANIZATION_RESOURCE = 'organizations/{}'
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class ListGroupMembers(base.ListCommand):
+  """List members of a specific service and group.
+
+  List members of a specific service and group.
+
+  ## EXAMPLES
+
+   List members of service my-service and group my-group:
+
+   $ {command} my-service my-group
+
+   List members of service my-service and group my-group
+   for a specific project '12345678':
+
+    $ {command} my-service my-group --project=12345678
+  """
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument('service', help='Name of the service.')
+    parser.add_argument(
+        'group', help='Service group name, for example "dependencies".'
+    )
+    common_flags.add_resource_args(parser)
+
+    base.PAGE_SIZE_FLAG.SetDefault(parser, 50)
+
+    # Remove unneeded list-related flags from parser
+    base.URI_FLAG.RemoveFromParser(parser)
+
+    parser.display_info.AddFormat("""
+          table(
+            name,
+            reason
+          )
+        """)
+
+  def Run(self, args):
+    """Run command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      Resource name and its parent name.
+    """
+    if args.IsSpecified('folder'):
+      resource_name = _FOLDER_RESOURCE.format(args.folder)
+    elif args.IsSpecified('organization'):
+      resource_name = _ORGANIZATION_RESOURCE.format(args.organization)
+    elif args.IsSpecified('project'):
+      resource_name = _PROJECT_RESOURCE.format(args.project)
+    else:
+      project = properties.VALUES.core.project.Get(required=True)
+      resource_name = _PROJECT_RESOURCE.format(project)
+
+    if not util.IsValidGroupName(args.service, args.group):
+      raise exceptions.InvalidGroupNameError(
+          util.GetGroupName(args.service, args.group)
+      )
+
+    member_states = serviceusage.ListGroupMembers(
+        resource_name,
+        util.GetGroupName(args.service, args.group),
+        args.page_size,
+    )
+
+    members = []
+    results = collections.namedtuple('Member', ['name', 'reason'])
+
+    for member_state in member_states:
+      member = member_state.member
+      if member.groupName:
+        members.append(results(member.groupName, member.reason))
+      else:
+        members.append(results(member.serviceName, member.reason))
+
+    if not members:
+      raise exceptions.EmptyMembersError(
+          util.GetGroupName(args.service, args.group)
+      )
+
+    return members