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

gcloud auth application-default login/google-cloud-sdk/lib/surface/firestore/indexes/composite/__init__.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2014 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.
+"""The gcloud firestore composite index command group."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.ALPHA)
+class Composite(base.Group):
+  """Manage composite indexes for Cloud Firestore."""
+  pass

gcloud auth application-default login/google-cloud-sdk/lib/surface/firestore/indexes/composite/create.yaml

@@ -0,0 +1,51 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: Create a new composite index.
+    description: Create a new composite index.
+    examples: |
+      The following command creates a composite index with fields `user_id` (in descending order)
+      followed by `timestamp` (in descending order) in the `Events` collection group.
+
+        $ {command} --collection-group=Events \
+            --field-config=field-path=user-id,order=descending \
+            --field-config=field-path=timestamp,order=descending
+
+        $ {command} --database=(default) --collection-group=Events \
+            --field-config=field-path=user-id,order=descending \
+            --field-config=field-path=timestamp,order=descending
+
+  request:
+    collection: firestore.projects.databases.collectionGroups.indexes
+    display_resource_type: index
+    modify_request_hooks:
+    # Normally we would perform this validation when parsing the '--field-config' arg but then we
+    # would have to write a whole custom 'type' hook and we would miss out on the built-in
+    # declarative ArgDict support. It's easier and it involves less custom hook code to do it here
+    # (which still happens before the API request is made, so ultimately it's not that much
+    # different).
+    - googlecloudsdk.command_lib.firestore.util:ValidateFieldConfig
+
+  response:
+    modify_response_hooks:
+    - googlecloudsdk.command_lib.firestore.util:ExtractOperationMetadata
+
+  async:
+    collection: firestore.projects.databases.operations
+    api_version: v1
+    extract_resource_result: false
+
+  arguments:
+    resource:
+      help_text: Collection group of the index.
+      is_positional: false
+      is_parent_resource: true
+      spec: !REF googlecloudsdk.command_lib.firestore.resources:collection_group
+
+    params:
+    - _REF_: googlecloudsdk.command_lib.firestore.flags:field_config
+      required: true
+    - _REF_: googlecloudsdk.command_lib.firestore.flags:query_scope
+    - _REF_: googlecloudsdk.command_lib.firestore.flags:api_scope
+    - _REF_: googlecloudsdk.command_lib.firestore.flags:multikey
+    - _REF_: googlecloudsdk.command_lib.firestore.flags:density
+    - _REF_: googlecloudsdk.command_lib.firestore.flags:unique

gcloud auth application-default login/google-cloud-sdk/lib/surface/firestore/indexes/composite/delete.yaml

@@ -0,0 +1,20 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: Delete the given composite index.
+    description: Delete the given composite index.
+    examples: |
+      The following command deletes the composite index with ID `3421ef`:
+
+        $ {command} 3421ef
+
+        $ {command} 3421ef --database=(default)
+
+  request:
+    collection: firestore.projects.databases.collectionGroups.indexes
+
+  arguments:
+    resource:
+      help_text: Index to delete.
+      spec: !REF googlecloudsdk.command_lib.firestore.resources:index
+      removed_flags:
+      - collection-group

gcloud auth application-default login/google-cloud-sdk/lib/surface/firestore/indexes/composite/describe.yaml

@@ -0,0 +1,50 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: Describe the given composite index.
+    description: Describe the given composite index.
+    examples: |
+      The following command describes the composite index with ID `3421ef`:
+
+        $ {command} 3421ef
+
+        $ {command} 3421ef --database=(default)
+
+  request:
+    collection: firestore.projects.databases.collectionGroups.indexes
+
+  arguments:
+    resource:
+      help_text: Index to describe.
+      spec: !REF googlecloudsdk.command_lib.firestore.resources:index
+      removed_flags:
+      - collection-group
+
+  output:
+    # This format string gets the field config table (fieldPath,order,arrayConfig) to show up as
+    # additional columns in the same row, as opposed to indented on the next line. Note that the
+    # double quotes are needed as opposed to a multi-line YAML string, since the latter escapes
+    # newline characters which we need to provide to .join() in order to get each field onto its
+    # own line.
+    #
+    # We could also use
+    # format: |
+    #   table[box](
+    #     name.basename(),
+    #     name.segment(-3):label=COLLECTION_GROUP,
+    #     queryScope,
+    #     state,
+    #     fields.slice(:-1):format="table(fieldPath,order,arrayConfig)")
+    # if we didn't care about the field config info showing up as columns in the existing row.
+    #
+    # TODO(b/120985936): Use an inline nested table when that's made possible
+    format: "table[all-box](\
+               name.basename(),\
+               name.segment(-3):label=COLLECTION_GROUP,\
+               queryScope,\
+               state,\
+               apiScope,\
+               fields.*extract('fieldPath').*flatten().join('\n'):label=FIELD_PATHS,\
+               fields.*extract('order').*flatten().join('\n'):label=ORDER,\
+               fields.*extract('arrayConfig').*flatten().join('\n'):label=ARRAY_CONFIG,\
+               fields.*extract('vectorConfig').*extract('dimension').*flatten().join('\n'):label=VECTOR_CONFIG)"
+    release_tracks: [BETA, GA]

gcloud auth application-default login/google-cloud-sdk/lib/surface/firestore/indexes/composite/list.yaml

@@ -0,0 +1,65 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: List composite indexes.
+    description: List composite indexes.
+    examples: |
+      The following command lists all composite indexes in the database:
+
+        $ {command}
+
+        $ {command} --database=(default)
+
+      The following command lists composite indexes in the `Events` collection group:
+
+        $ {command} --filter=COLLECTION_GROUP:Events
+
+  request:
+    collection: firestore.projects.databases.collectionGroups.indexes
+
+  response:
+    id_field: name
+
+  arguments:
+    resource:
+      help_text: Collection group of the index.
+      is_positional: false
+      # By using collection_group_with_default this resource arg is correctly determined to be
+      # optional and uses the special '-' collection group to list all indexes in the database.
+      spec: !REF googlecloudsdk.command_lib.firestore.resources:collection_group_with_default
+      # Ideally the API would only return indexes whose collection group matches the one in the
+      # request; however currently no matter what collection group you provide you'll get a list of
+      # all the indexes in all collection groups. Thus we remove the collection group flag here
+      # since it has no effect. The user can always filter the responses by collection group using
+      # the gcloud wide --filter flag.
+      removed_flags:
+      - collection-group
+
+  output:
+    # This format string gets the field config table (fieldPath,order,arrayConfig) to show up as
+    # additional columns in the same row, as opposed to indented on the next line. Note that the
+    # double quotes are needed as opposed to a multi-line YAML string, since the latter escapes
+    # newline characters which we need to provide to .join() in order to get each field onto its
+    # own line.
+    #
+    # We could also use
+    # format: |
+    #   table[box](
+    #     name.basename(),
+    #     name.segment(-3):label=COLLECTION_GROUP,
+    #     queryScope,
+    #     state,
+    #     fields.slice(:-1):format="table(fieldPath,order,arrayConfig)")
+    # if we didn't care about the field config info showing up as columns in the existing row.
+    #
+    # TODO(b/120985936): Use an inline nested table when that's made possible
+    format: "table[all-box](\
+               name.basename(),\
+               name.segment(-3):label=COLLECTION_GROUP:sort=1,\
+               queryScope,\
+               state,\
+               apiScope,\
+               fields.*extract('fieldPath').*flatten().join('\n'):label=FIELD_PATHS,\
+               fields.*extract('order').*flatten().join('\n'):label=ORDER,\
+               fields.*extract('arrayConfig').*flatten().join('\n'):label=ARRAY_CONFIG,\
+               fields.*extract('vectorConfig').*extract('dimension').*flatten().join('\n'):label=VECTOR_CONFIG)"
+    release_tracks: [BETA, GA]