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

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/command_lib/recaptcha/firewall_policies_util.py

@@ -0,0 +1,95 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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 reCAPTCHA Firewall Policy Commands."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.util import apis
+from googlecloudsdk.calliope import exceptions
+
+
+def ParseFirewallActions(actions):
+  messages = apis.GetMessagesModule('recaptchaenterprise', 'v1')
+  actions_list = actions.split(',')
+  action_messages = []
+  for action in actions_list:
+    action_messages.append(ParseAction(action, messages))
+  return action_messages
+
+
+def ParseAction(action, messages):
+  """Parses a string action into a FirewallAction and returns it.
+
+  Actions are parsed to be one of AllowAction, BlockAction, RedirectAction,
+  SubstituteAction or SetHeaderAction.
+
+  Args:
+    action: The action string to parse.
+    messages: The message module in which FirewallAction is found in the cloud
+      API.
+
+  Returns:
+    An instance of FirewallAction containing the action represented in the given
+    string.
+
+  Raises:
+    BadArgumentException: A parsing error occurred.
+  """
+  parsed_action = messages.GoogleCloudRecaptchaenterpriseV1FirewallAction()
+  action_pieces = action.split('=')
+
+  # Validate argument length.
+  if action_pieces[0] in {'allow', 'block', 'redirect'
+                         } and len(action_pieces) > 1:
+    raise exceptions.BadArgumentException(
+        '--actions',
+        'Action {0} has > 0 arguments, expected 0.'.format(action_pieces[0]))
+  if action_pieces[0] == 'substitute' and len(action_pieces) != 2:
+    raise exceptions.BadArgumentException(
+        '--actions',
+        'SubstituteAction requires exactly one argument for path, in the form substitute=$PATH.'
+    )
+  if action_pieces[0] == 'set_header' and len(action_pieces) != 3:
+    raise exceptions.BadArgumentException(
+        '--actions',
+        'SetHeaderAction requires exactly two arguments for header key and value, in the form set_header=$KEY=$VALUE.'
+    )
+
+  # Parse action.
+  if action_pieces[0] == 'allow':
+    parsed_action.allow = messages.GoogleCloudRecaptchaenterpriseV1FirewallActionAllowAction(
+    )
+  elif action_pieces[0] == 'block':
+    parsed_action.block = messages.GoogleCloudRecaptchaenterpriseV1FirewallActionBlockAction(
+    )
+  elif action_pieces[0] == 'redirect':
+    parsed_action.redirect = messages.GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction(
+    )
+  elif action_pieces[0] == 'substitute':
+    parsed_action.substitute = messages.GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction(
+    )
+    parsed_action.substitute.path = action_pieces[1]
+  elif action_pieces[0] == 'set_header':
+    parsed_action.setHeader = messages.GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction(
+    )
+    parsed_action.setHeader.key, parsed_action.setHeader.value = action_pieces[
+        1], action_pieces[2]
+  else:
+    raise exceptions.BadArgumentException(
+        '--actions',
+        'Action string {0} cannot be parsed as FirewallAction.'.format(action))
+  return parsed_action

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/command_lib/recaptcha/hooks.py

@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+
+"""Declarative hooks for reCAPTCHA Enterprise Keys CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+from googlecloudsdk.generated_clients.apis.recaptchaenterprise.v1 import recaptchaenterprise_v1_messages as messages
+
+
+def SanitizePlatformSettings(unused_ref, args, request):
+  """Make sure that at most one platform setting is set at the same time."""
+  if args.android:
+    request.googleCloudRecaptchaenterpriseV1Key.iosSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.webSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.expressSettings = None
+  elif args.ios:
+    request.googleCloudRecaptchaenterpriseV1Key.androidSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.webSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.expressSettings = None
+  elif args.web:
+    request.googleCloudRecaptchaenterpriseV1Key.androidSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.iosSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.expressSettings = None
+  elif args.express:
+    request.googleCloudRecaptchaenterpriseV1Key.expressSettings = (
+        messages.GoogleCloudRecaptchaenterpriseV1ExpressKeySettings()
+    )
+    request.googleCloudRecaptchaenterpriseV1Key.androidSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.iosSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.webSettings = None
+  else:
+    request.googleCloudRecaptchaenterpriseV1Key.androidSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.iosSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.webSettings = None
+    request.googleCloudRecaptchaenterpriseV1Key.expressSettings = None
+
+  return request

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/command_lib/recaptcha/migrate_util.py

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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 reCAPTCHA Migrate Key Command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+
+from googlecloudsdk.core import log
+
+
+def LogMigrateSuccess(response, unused_ref):
+  """Expected to contain displayName field, return "key" otherwise."""
+  key_name = response.displayName or "reCAPTCHA key to Enterprise"
+  success_msg = "Migration of {} succeeded.".format(key_name)
+  msg_len = len(success_msg)
+  log.status.Print("-" * msg_len)
+  log.status.Print(success_msg)
+  log.status.Print("-" * msg_len)
+

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/command_lib/recaptcha/policies_util.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 reCAPTCHA policies commands."""
+
+from googlecloudsdk.calliope.concepts import concepts
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+
+
+def AddKeyResourceArg(parser, verb):
+  """Add a resource argument for a reCAPTCHA key."""
+  resource_spec = concepts.ResourceSpec(
+      'recaptchaenterprise.projects.keys',
+      resource_name='key',
+      keysId=concepts.ResourceParameterAttributeConfig(
+          name='key', help_text='The ID of the reCAPTCHA key.'
+      ),
+      projectsId=concepts.DEFAULT_PROJECT_ATTRIBUTE_CONFIG,
+      disable_auto_completers=True,
+  )
+
+  concept_parsers.ConceptParser.ForResource(
+      '--key',
+      resource_spec,
+      f'The reCAPTCHA key whose policy {verb}.',
+      required=True,
+  ).AddToParser(parser)

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/command_lib/recaptcha/resources.yaml

@@ -0,0 +1,29 @@
+project:
+  name: project
+  collection: recaptchaenterprise.projects
+  attributes:
+  - &project
+    parameter_name: projectsId
+    attribute_name: project
+    help: Cloud Project name.
+    property: core/project
+
+keys:
+  name: key
+  collection: recaptchaenterprise.projects.keys
+  attributes:
+  - *project
+  - &key
+    parameter_name: keysId
+    attribute_name: key
+    help: reCAPTCHA Key
+
+firewall_policies:
+  name: firewall_policy
+  collection: recaptchaenterprise.projects.firewallpolicies
+  attributes:
+  - *project
+  - &firewall_policy
+    parameter_name: firewallpoliciesId
+    attribute_name: firewall_policy
+    help: reCAPTCHA Firewall Policy