apache-airflow-providers-google 10.14.0rc2__py3-none-any.whl → 10.15.0rc1__py3-none-any.whl

airflow/providers/google/cloud/hooks/kubernetes_engine.py

@@ -28,10 +28,10 @@ from __future__ import annotations
 import contextlib
 import json
 import time
-import warnings
 from functools import cached_property
 from typing import TYPE_CHECKING, Sequence
 
+from deprecated import deprecated
 from gcloud.aio.auth import Token
 from google.api_core.exceptions import NotFound
 from google.api_core.gapic_v1.method import DEFAULT, _MethodDefault
@@ -48,6 +48,7 @@ from urllib3.exceptions import HTTPError
 
 from airflow import version
 from airflow.exceptions import AirflowException, AirflowProviderDeprecationWarning
+from airflow.providers.cncf.kubernetes.kube_client import _enable_tcp_keepalive
 from airflow.providers.cncf.kubernetes.utils.pod_manager import PodOperatorHookProtocol
 from airflow.providers.google.common.consts import CLIENT_INFO
 from airflow.providers.google.common.hooks.base_google import (
@@ -98,22 +99,23 @@ class GKEHook(GoogleBaseHook):
 
     # To preserve backward compatibility
     # TODO: remove one day
+    @deprecated(
+        reason=(
+            "The get_conn method has been deprecated. "
+            "You should use the get_cluster_manager_client method."
+        ),
+        category=AirflowProviderDeprecationWarning,
+    )
     def get_conn(self) -> container_v1.ClusterManagerClient:
-        warnings.warn(
-            "The get_conn method has been deprecated. You should use the get_cluster_manager_client method.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
         return self.get_cluster_manager_client()
 
     # To preserve backward compatibility
     # TODO: remove one day
+    @deprecated(
+        reason="The get_client method has been deprecated. You should use the get_conn method.",
+        category=AirflowProviderDeprecationWarning,
+    )
     def get_client(self) -> ClusterManagerClient:
-        warnings.warn(
-            "The get_client method has been deprecated. You should use the get_conn method.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
         return self.get_conn()
 
     def wait_for_operation(self, operation: Operation, project_id: str | None = None) -> Operation:
@@ -176,7 +178,7 @@ class GKEHook(GoogleBaseHook):
         retry: Retry | _MethodDefault = DEFAULT,
         timeout: float | None = None,
     ) -> Operation | None:
-        """Deletes the cluster, the Kubernetes endpoint, and all worker nodes.
+        """Delete the cluster, the Kubernetes endpoint, and all worker nodes.
 
         Firewalls and routes that were configured during cluster creation are
         also deleted. Other Google Compute Engine resources that might be in use
@@ -352,6 +354,7 @@ class GKEPodHook(GoogleBaseHook, PodOperatorHookProtocol):
         self,
         cluster_url: str,
         ssl_ca_cert: str,
+        disable_tcp_keepalive: bool | None = None,
         gcp_conn_id: str = "google_cloud_default",
         impersonation_chain: str | Sequence[str] | None = None,
         **kwargs,
@@ -363,6 +366,7 @@ class GKEPodHook(GoogleBaseHook, PodOperatorHookProtocol):
         )
         self._cluster_url = cluster_url
         self._ssl_ca_cert = ssl_ca_cert
+        self.disable_tcp_keepalive = disable_tcp_keepalive
 
     @cached_property
     def api_client(self) -> client.ApiClient:
@@ -397,6 +401,10 @@ class GKEPodHook(GoogleBaseHook, PodOperatorHookProtocol):
     def get_conn(self) -> client.ApiClient:
         configuration = self._get_config()
         configuration.refresh_api_key_hook = self._refresh_api_key_hook
+
+        if self.disable_tcp_keepalive is not True:
+            _enable_tcp_keepalive()
+
         return client.ApiClient(configuration)
 
     def _refresh_api_key_hook(self, configuration: client.configuration.Configuration):
@@ -500,14 +508,15 @@ class GKEPodAsyncHook(GoogleBaseAsyncHook):
         :param name: Name of the pod.
         :param namespace: Name of the pod's namespace.
         """
-        async with Token(scopes=self.scopes) as token:
-            async with self.get_conn(token) as connection:
-                v1_api = async_client.CoreV1Api(connection)
-                pod: V1Pod = await v1_api.read_namespaced_pod(
-                    name=name,
-                    namespace=namespace,
-                )
-            return pod
+        with await self.service_file_as_context() as service_file:  # type: ignore[attr-defined]
+            async with Token(scopes=self.scopes, service_file=service_file) as token:
+                async with self.get_conn(token) as connection:
+                    v1_api = async_client.CoreV1Api(connection)
+                    pod: V1Pod = await v1_api.read_namespaced_pod(
+                        name=name,
+                        namespace=namespace,
+                    )
+                return pod
 
     async def delete_pod(self, name: str, namespace: str):
         """Delete a pod.
@@ -515,18 +524,21 @@ class GKEPodAsyncHook(GoogleBaseAsyncHook):
         :param name: Name of the pod.
         :param namespace: Name of the pod's namespace.
         """
-        async with Token(scopes=self.scopes) as token, self.get_conn(token) as connection:
-            try:
-                v1_api = async_client.CoreV1Api(connection)
-                await v1_api.delete_namespaced_pod(
-                    name=name,
-                    namespace=namespace,
-                    body=client.V1DeleteOptions(),
-                )
-            except async_client.ApiException as e:
-                # If the pod is already deleted
-                if e.status != 404:
-                    raise
+        with await self.service_file_as_context() as service_file:  # type: ignore[attr-defined]
+            async with Token(scopes=self.scopes, service_file=service_file) as token, self.get_conn(
+                token
+            ) as connection:
+                try:
+                    v1_api = async_client.CoreV1Api(connection)
+                    await v1_api.delete_namespaced_pod(
+                        name=name,
+                        namespace=namespace,
+                        body=client.V1DeleteOptions(),
+                    )
+                except async_client.ApiException as e:
+                    # If the pod is already deleted
+                    if e.status != 404:
+                        raise
 
     async def read_logs(self, name: str, namespace: str):
         """Read logs inside the pod while starting containers inside.
@@ -539,19 +551,22 @@ class GKEPodAsyncHook(GoogleBaseAsyncHook):
         :param name: Name of the pod.
         :param namespace: Name of the pod's namespace.
         """
-        async with Token(scopes=self.scopes) as token, self.get_conn(token) as connection:
-            try:
-                v1_api = async_client.CoreV1Api(connection)
-                logs = await v1_api.read_namespaced_pod_log(
-                    name=name,
-                    namespace=namespace,
-                    follow=False,
-                    timestamps=True,
-                )
-                logs = logs.splitlines()
-                for line in logs:
-                    self.log.info("Container logs from %s", line)
-                return logs
-            except HTTPError:
-                self.log.exception("There was an error reading the kubernetes API.")
-                raise
+        with await self.service_file_as_context() as service_file:  # type: ignore[attr-defined]
+            async with Token(scopes=self.scopes, service_file=service_file) as token, self.get_conn(
+                token
+            ) as connection:
+                try:
+                    v1_api = async_client.CoreV1Api(connection)
+                    logs = await v1_api.read_namespaced_pod_log(
+                        name=name,
+                        namespace=namespace,
+                        follow=False,
+                        timestamps=True,
+                    )
+                    logs = logs.splitlines()
+                    for line in logs:
+                        self.log.info("Container logs from %s", line)
+                    return logs
+                except HTTPError:
+                    self.log.exception("There was an error reading the kubernetes API.")
+                    raise

airflow/providers/google/cloud/hooks/life_sciences.py

@@ -19,10 +19,10 @@
 from __future__ import annotations
 
 import time
-import warnings
 from typing import Sequence
 
 import google.api_core.path_template
+from deprecated import deprecated
 from googleapiclient.discovery import build
 
 from airflow.exceptions import AirflowException, AirflowProviderDeprecationWarning
@@ -32,6 +32,15 @@ from airflow.providers.google.common.hooks.base_google import GoogleBaseHook
 TIME_TO_SLEEP_IN_SECONDS = 5
 
 
+@deprecated(
+    reason=(
+        "This hook is deprecated. Consider using "
+        "Google Cloud Batch Operators' hook instead. "
+        "The Life Sciences API (beta) will be discontinued "
+        "on July 8, 2025 in favor of Google Cloud Batch."
+    ),
+    category=AirflowProviderDeprecationWarning,
+)
 class LifeSciencesHook(GoogleBaseHook):
     """
     Hook for the Google Cloud Life Sciences APIs.
@@ -76,17 +85,9 @@ class LifeSciencesHook(GoogleBaseHook):
         )
         self.api_version = api_version
 
-        warnings.warn(
-            """This hook is deprecated. Consider using Google Cloud Batch Operators' hook instead.
-            The Life Sciences API (beta) will be discontinued on July 8, 2025 in favor
-            of Google Cloud Batch.""",
-            AirflowProviderDeprecationWarning,
-            stacklevel=3,
-        )
-
     def get_conn(self) -> build:
         """
-        Retrieves the connection to Cloud Life Sciences.
+        Retrieve the connection to Cloud Life Sciences.
 
         :return: Google Cloud Life Sciences service object.
         """
@@ -98,7 +99,7 @@ class LifeSciencesHook(GoogleBaseHook):
     @GoogleBaseHook.fallback_to_default_project_id
     def run_pipeline(self, body: dict, location: str, project_id: str) -> dict:
         """
-        Runs a pipeline.
+        Run a pipeline.
 
         :param body: The request body.
         :param location: The location of the project. For example: "us-east1".
@@ -136,7 +137,7 @@ class LifeSciencesHook(GoogleBaseHook):
 
     def _wait_for_operation_to_complete(self, operation_name: str) -> None:
         """
-        Waits for the named operation to complete - checks status of the asynchronous call.
+        Wait for the named operation to complete - checks status of the asynchronous call.
 
         :param operation_name: The name of the operation.
         :return: The response returned by the operation.

airflow/providers/google/cloud/hooks/looker.py

@@ -54,7 +54,7 @@ class LookerHook(BaseHook):
         query_params: dict | None = None,
     ):
         """
-        Submits a PDT materialization job to Looker.
+        Submit a PDT materialization job to Looker.
 
         :param model: Required. The model of the PDT to start building.
         :param view: Required. The view of the PDT to start building.
@@ -83,7 +83,7 @@ class LookerHook(BaseHook):
         materialization_id: str,
     ):
         """
-        Gets the PDT materialization job status from Looker.
+        Get the PDT materialization job status from Looker.
 
         :param materialization_id: Required. The materialization id to check status for.
         """
@@ -100,7 +100,7 @@ class LookerHook(BaseHook):
         materialization_id: str,
     ) -> dict:
         """
-        Gets the PDT materialization job status.
+        Get the PDT materialization job status.
 
         :param materialization_id: Required. The materialization id to check status for.
         """
@@ -120,7 +120,7 @@ class LookerHook(BaseHook):
         materialization_id: str,
     ):
         """
-        Starts a PDT materialization job cancellation request.
+        Start a PDT materialization job cancellation request.
 
         :param materialization_id: Required. The materialization id to stop.
         """
@@ -140,7 +140,7 @@ class LookerHook(BaseHook):
         timeout: int | None = None,
     ) -> None:
         """
-        Helper method which polls a PDT materialization job to check if it finishes.
+        Poll a PDT materialization job to check if it finishes.
 
         :param materialization_id: Required. The materialization id to wait for.
         :param wait_time: Optional. Number of seconds between checks.
@@ -185,7 +185,7 @@ class LookerHook(BaseHook):
         self.log.info("PDT materialization job completed successfully. Job id: %s.", materialization_id)
 
     def get_looker_sdk(self):
-        """Returns Looker SDK client for Looker API 4.0."""
+        """Return Looker SDK client for Looker API 4.0."""
         conn = self.get_connection(self.looker_conn_id)
         settings = LookerApiSettings(conn)
 
@@ -211,7 +211,7 @@ class LookerApiSettings(api_settings.ApiSettings):
 
     def read_config(self):
         """
-        Fetches the connection settings from Airflow's connection object.
+        Fetch the connection settings from Airflow's connection object.
 
         Overrides the default logic of getting connection settings.
         """

airflow/providers/google/cloud/hooks/mlengine.py

@@ -97,7 +97,7 @@ class MLEngineHook(GoogleBaseHook):
 
     def get_conn(self) -> Resource:
         """
-        Retrieves the connection to MLEngine.
+        Retrieve the connection to MLEngine.
 
         :return: Google MLEngine services object.
         """
@@ -107,7 +107,7 @@ class MLEngineHook(GoogleBaseHook):
     @GoogleBaseHook.fallback_to_default_project_id
     def create_job(self, job: dict, project_id: str, use_existing_job_fn: Callable | None = None) -> dict:
         """
-        Launches a MLEngine job and wait for it to reach a terminal state.
+        Launch a MLEngine job and wait for it to reach a terminal state.
 
         :param project_id: The Google Cloud project id within which MLEngine
             job will be launched. If set to None or missing, the default project_id from the Google Cloud
@@ -169,7 +169,7 @@ class MLEngineHook(GoogleBaseHook):
         project_id: str,
     ):
         """
-        Launches a MLEngine job and wait for it to reach a terminal state.
+        Launch a MLEngine job and wait for it to reach a terminal state.
 
         :param project_id: The Google Cloud project id within which MLEngine
             job will be launched. If set to None or missing, the default project_id from the Google Cloud
@@ -202,7 +202,7 @@ class MLEngineHook(GoogleBaseHook):
         project_id: str,
     ) -> dict:
         """
-        Cancels a MLEngine job.
+        Cancel a MLEngine job.
 
         :param project_id: The Google Cloud project id within which MLEngine
             job will be cancelled. If set to None or missing, the default project_id from the Google Cloud
@@ -231,7 +231,7 @@ class MLEngineHook(GoogleBaseHook):
 
     def get_job(self, project_id: str, job_id: str) -> dict:
         """
-        Gets a MLEngine job based on the job id.
+        Get a MLEngine job based on the job id.
 
         :param project_id: The project in which the Job is located. If set to None or missing, the default
             project_id from the Google Cloud connection is used. (templated)
@@ -255,7 +255,7 @@ class MLEngineHook(GoogleBaseHook):
 
     def _wait_for_job_done(self, project_id: str, job_id: str, interval: int = 30):
         """
-        Waits for the Job to reach a terminal state.
+        Wait for the Job to reach a terminal state.
 
         This method will periodically check the job state until the job reach
         a terminal state.
@@ -284,7 +284,7 @@ class MLEngineHook(GoogleBaseHook):
         project_id: str,
     ) -> dict:
         """
-        Creates the Version on Google Cloud ML Engine.
+        Create the Version on Google Cloud ML Engine.
 
         :param version_spec: A dictionary containing the information about the version. (templated)
         :param model_name: The name of the Google Cloud ML Engine model that the version belongs to.
@@ -320,7 +320,7 @@ class MLEngineHook(GoogleBaseHook):
         project_id: str,
     ) -> dict:
         """
-        Sets a version to be the default. Blocks until finished.
+        Set a version to be the default. Blocks until finished.
 
         :param model_name: The name of the Google Cloud ML Engine model that the version belongs to.
             (templated)
@@ -351,7 +351,7 @@ class MLEngineHook(GoogleBaseHook):
         project_id: str,
     ) -> list[dict]:
         """
-        Lists all available versions of a model. Blocks until finished.
+        List all available versions of a model. Blocks until finished.
 
         :param model_name: The name of the Google Cloud ML Engine model that the version
             belongs to. (templated)
@@ -387,7 +387,7 @@ class MLEngineHook(GoogleBaseHook):
         project_id: str,
     ) -> dict:
         """
-        Deletes the given version of a model. Blocks until finished.
+        Delete the given version of a model. Blocks until finished.
 
         :param model_name: The name of the Google Cloud ML Engine model that the version
             belongs to. (templated)
@@ -467,7 +467,7 @@ class MLEngineHook(GoogleBaseHook):
         project_id: str,
     ) -> dict | None:
         """
-        Gets a Model. Blocks until finished.
+        Get a Model. Blocks until finished.
 
         :param model_name: The name of the model.
         :param project_id: The Google Cloud project name to which MLEngine model belongs. If set to None
@@ -581,7 +581,7 @@ class MLEngineAsyncHook(GoogleBaseAsyncHook):
         project_id: str | None = None,
     ) -> str | None:
         """
-        Polls for job status asynchronously using gcloud-aio.
+        Poll for job status asynchronously using gcloud-aio.
 
         Note that an OSError is raised when Job results are still pending.
         Exception means that Job finished with errors

airflow/providers/google/cloud/hooks/natural_language.py

@@ -74,7 +74,7 @@ class CloudNaturalLanguageHook(GoogleBaseHook):
 
     def get_conn(self) -> LanguageServiceClient:
         """
-        Retrieves connection to Cloud Natural Language service.
+        Retrieve connection to Cloud Natural Language service.
 
         :return: Cloud Natural Language service object
         """
@@ -92,7 +92,7 @@ class CloudNaturalLanguageHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> AnalyzeEntitiesResponse:
         """
-        Finds named entities in the text along with various properties.
+        Find named entities in the text along with various properties.
 
         Examples properties: entity types, salience, mentions for each entity, and others.
 

airflow/providers/google/cloud/hooks/os_login.py

@@ -78,7 +78,7 @@ class OSLoginHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> ImportSshPublicKeyResponse:
         """
-        Adds an SSH public key and returns the profile information.
+        Add an SSH public key and returns the profile information.
 
         Default POSIX account information is set when no username and UID exist as part of the login profile.
 

airflow/providers/google/cloud/hooks/pubsub.py

@@ -93,7 +93,7 @@ class PubSubHook(GoogleBaseHook):
 
     def get_conn(self) -> PublisherClient:
         """
-        Retrieves connection to Google Cloud Pub/Sub.
+        Retrieve connection to Google Cloud Pub/Sub.
 
         :return: Google Cloud Pub/Sub client object.
         """
@@ -118,7 +118,7 @@ class PubSubHook(GoogleBaseHook):
         project_id: str = PROVIDE_PROJECT_ID,
     ) -> None:
         """
-        Publishes messages to a Pub/Sub topic.
+        Publish messages to a Pub/Sub topic.
 
         :param topic: the Pub/Sub topic to which to publish; do not
             include the ``projects/{project}/topics/`` prefix.
@@ -191,7 +191,7 @@ class PubSubHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Creates a Pub/Sub topic, if it does not already exist.
+        Create a Pub/Sub topic, if it does not already exist.
 
         :param topic: the Pub/Sub topic name to create; do not
             include the ``projects/{project}/topics/`` prefix.
@@ -264,7 +264,7 @@ class PubSubHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes a Pub/Sub topic if it exists.
+        Delete a Pub/Sub topic if it exists.
 
         :param topic: the Pub/Sub topic name to delete; do not
             include the ``projects/{project}/topics/`` prefix.
@@ -318,7 +318,7 @@ class PubSubHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> str:
         """
-        Creates a Pub/Sub subscription, if it does not already exist.
+        Create a Pub/Sub subscription, if it does not already exist.
 
         :param topic: the Pub/Sub topic name that the subscription will be bound
             to create; do not include the ``projects/{project}/subscriptions/`` prefix.
@@ -435,7 +435,7 @@ class PubSubHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes a Pub/Sub subscription, if it exists.
+        Delete a Pub/Sub subscription, if it exists.
 
         :param subscription: the Pub/Sub subscription name to delete; do not
             include the ``projects/{project}/subscriptions/`` prefix.
@@ -483,7 +483,7 @@ class PubSubHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> list[ReceivedMessage]:
         """
-        Pulls up to ``max_messages`` messages from Pub/Sub subscription.
+        Pull up to ``max_messages`` messages from Pub/Sub subscription.
 
         :param subscription: the Pub/Sub subscription name to pull from; do not
             include the 'projects/{project}/topics/' prefix.
@@ -596,7 +596,7 @@ class PubSubAsyncHook(GoogleBaseAsyncHook):
 
     async def _get_subscriber_client(self) -> SubscriberAsyncClient:
         """
-        Returns async connection to the Google PubSub.
+        Return async connection to the Google PubSub.
 
         :return: Google Pub/Sub asynchronous client.
         """
@@ -671,7 +671,7 @@ class PubSubAsyncHook(GoogleBaseAsyncHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> list[ReceivedMessage]:
         """
-        Pulls up to ``max_messages`` messages from Pub/Sub subscription.
+        Pull up to ``max_messages`` messages from Pub/Sub subscription.
 
         :param subscription: the Pub/Sub subscription name to pull from; do not
             include the 'projects/{project}/topics/' prefix.

airflow/providers/google/cloud/hooks/secret_manager.py

@@ -63,7 +63,7 @@ class SecretsManagerHook(GoogleBaseHook):
 
     def get_conn(self) -> _SecretManagerClient:
         """
-        Retrieves the connection to Secret Manager.
+        Retrieve the connection to Secret Manager.
 
         :return: Secret Manager client.
         """

airflow/providers/google/cloud/hooks/spanner.py

@@ -76,7 +76,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
 
     def _get_client(self, project_id: str) -> Client:
         """
-        Provides a client for interacting with the Cloud Spanner API.
+        Provide a client for interacting with the Cloud Spanner API.
 
         :param project_id: The ID of the Google Cloud project.
         :return: Client
@@ -122,7 +122,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
         project_id: str,
     ) -> Instance | None:
         """
-        Gets information about a particular instance.
+        Get information about a particular instance.
 
         :param project_id: Optional, The ID of the Google Cloud project that owns the Cloud Spanner
             database. If set to None or missing, the default project_id from the Google Cloud connection
@@ -145,7 +145,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
         func: Callable[[Instance], Operation],
     ) -> None:
         """
-        Invokes a method on a given instance by applying a specified Callable.
+        Invoke a method on a given instance by applying a specified Callable.
 
         :param project_id: The ID of the Google Cloud project that owns the Cloud Spanner database.
         :param instance_id: The ID of the instance.
@@ -183,7 +183,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
         project_id: str,
     ) -> None:
         """
-        Creates a new Cloud Spanner instance.
+        Create a new Cloud Spanner instance.
 
         :param instance_id: The ID of the Cloud Spanner instance.
         :param configuration_name: The name of the instance configuration defining how the
@@ -213,7 +213,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
         project_id: str,
     ) -> None:
         """
-        Updates an existing Cloud Spanner instance.
+        Update an existing Cloud Spanner instance.
 
         :param instance_id: The ID of the Cloud Spanner instance.
         :param configuration_name: The name of the instance configuration defining how the
@@ -236,7 +236,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
     @GoogleBaseHook.fallback_to_default_project_id
     def delete_instance(self, instance_id: str, project_id: str) -> None:
         """
-        Deletes an existing Cloud Spanner instance.
+        Delete an existing Cloud Spanner instance.
 
         :param instance_id: The ID of the Cloud Spanner instance.
         :param project_id: Optional, the ID of the Google Cloud project that owns the Cloud Spanner
@@ -260,7 +260,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
         project_id: str,
     ) -> Database | None:
         """
-        Retrieves a database in Cloud Spanner; return None if the database does not exist in the instance.
+        Retrieve a database in Cloud Spanner; return None if the database does not exist in the instance.
 
         :param instance_id: The ID of the Cloud Spanner instance.
         :param database_id: The ID of the database in Cloud Spanner.
@@ -287,7 +287,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
         project_id: str,
     ) -> None:
         """
-        Creates a new database in Cloud Spanner.
+        Create a new database in Cloud Spanner.
 
         :param instance_id: The ID of the Cloud Spanner instance.
         :param database_id: The ID of the database to create in Cloud Spanner.
@@ -321,7 +321,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
         operation_id: str | None = None,
     ) -> None:
         """
-        Updates DDL of a database in Cloud Spanner.
+        Update DDL of a database in Cloud Spanner.
 
         :param instance_id: The ID of the Cloud Spanner instance.
         :param database_id: The ID of the database in Cloud Spanner.
@@ -357,7 +357,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
     @GoogleBaseHook.fallback_to_default_project_id
     def delete_database(self, instance_id: str, database_id, project_id: str) -> bool:
         """
-        Drops a database in Cloud Spanner.
+        Drop a database in Cloud Spanner.
 
         :param instance_id: The ID of the Cloud Spanner instance.
         :param database_id: The ID of the database in Cloud Spanner.
@@ -392,7 +392,7 @@ class SpannerHook(GoogleBaseHook, DbApiHook):
         project_id: str,
     ) -> None:
         """
-        Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
+        Execute an arbitrary DML query (INSERT, UPDATE, DELETE).
 
         :param instance_id: The ID of the Cloud Spanner instance.
         :param database_id: The ID of the database in Cloud Spanner.

airflow/providers/google/cloud/hooks/speech_to_text.py

@@ -65,7 +65,7 @@ class CloudSpeechToTextHook(GoogleBaseHook):
 
     def get_conn(self) -> SpeechClient:
         """
-        Retrieves connection to Cloud Speech.
+        Retrieve connection to Cloud Speech.
 
         :return: Google Cloud Speech client object.
         """