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

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

@@ -48,7 +48,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         super().__init__(**kwargs)
 
     def get_dataproc_metastore_client(self) -> DataprocMetastoreClient:
-        """Returns DataprocMetastoreClient."""
+        """Return DataprocMetastoreClient."""
         client_options = ClientOptions(api_endpoint="metastore.googleapis.com:443")
 
         return DataprocMetastoreClient(
@@ -56,7 +56,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         )
 
     def get_dataproc_metastore_client_v1beta(self):
-        """Returns DataprocMetastoreClient (from v1 beta)."""
+        """Return DataprocMetastoreClient (from v1 beta)."""
         from google.cloud.metastore_v1beta import DataprocMetastoreClient
 
         client_options = ClientOptions(api_endpoint="metastore.googleapis.com:443")
@@ -65,7 +65,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         )
 
     def wait_for_operation(self, timeout: float | None, operation: Operation):
-        """Waits for long-lasting operation to complete."""
+        """Wait for long-lasting operation to complete."""
         try:
             return operation.result(timeout=timeout)
         except Exception:
@@ -86,7 +86,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Creates a new backup in a given project and location.
+        Create a new backup in a given project and location.
 
         :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
         :param region: Required. The ID of the Google Cloud region that the service belongs to.
@@ -143,7 +143,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Creates a new MetadataImport in a given project and location.
+        Create a new MetadataImport in a given project and location.
 
         :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
         :param region: Required. The ID of the Google Cloud region that the service belongs to.
@@ -200,7 +200,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Creates a metastore service in a project and location.
+        Create a metastore service in a project and location.
 
         :param region: Required. The ID of the Google Cloud region that the service belongs to.
         :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
@@ -250,7 +250,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Deletes a single backup.
+        Delete a single backup.
 
         :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
         :param region: Required. The ID of the Google Cloud region that the service belongs to.
@@ -298,7 +298,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Deletes a single service.
+        Delete a single service.
 
         :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
         :param region: Required. The ID of the Google Cloud region that the service belongs to.
@@ -342,7 +342,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Exports metadata from a service.
+        Export metadata from a service.
 
         :param destination_gcs_folder: A Cloud Storage URI of a folder, in the format
             ``gs://<bucket_name>/<path_inside_bucket>``. A sub-folder
@@ -391,7 +391,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Gets the details of a single service.
+        Get the details of a single service.
 
         :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
         :param region: Required. The ID of the Google Cloud region that the service belongs to.
@@ -474,7 +474,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Lists backups in a service.
+        List backups in a service.
 
         :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
         :param region: Required. The ID of the Google Cloud region that the service belongs to.
@@ -603,7 +603,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Updates the parameters of a single service.
+        Update the parameters of a single service.
 
         :param project_id: Required. The ID of the Google Cloud project that the service belongs to.
         :param region: Required. The ID of the Google Cloud region that the service belongs to.
@@ -660,7 +660,7 @@ class DataprocMetastoreHook(GoogleBaseHook):
         partition_names: list[str] | None = None,
     ) -> Operation:
         """
-        Lists Hive partitions.
+        List Hive partitions.
 
         :param project_id: Optional. The ID of a dbt Cloud project.
         :param service_id: Required. Dataproc Metastore service id.

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

@@ -57,7 +57,7 @@ class DatastoreHook(GoogleBaseHook):
 
     def get_conn(self) -> Resource:
         """
-        Establishes a connection to the Google API.
+        Establish a connection to the Google API.
 
         :return: a Google Cloud Datastore service object.
         """
@@ -200,7 +200,7 @@ class DatastoreHook(GoogleBaseHook):
 
     def get_operation(self, name: str) -> dict:
         """
-        Gets the latest state of a long-running operation.
+        Get the latest state of a long-running operation.
 
         .. seealso::
             https://cloud.google.com/datastore/docs/reference/data/rest/v1/projects.operations/get
@@ -216,7 +216,7 @@ class DatastoreHook(GoogleBaseHook):
 
     def delete_operation(self, name: str) -> dict:
         """
-        Deletes the long-running operation.
+        Delete the long-running operation.
 
         .. seealso::
             https://cloud.google.com/datastore/docs/reference/data/rest/v1/projects.operations/delete

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

@@ -103,7 +103,7 @@ class CloudDLPHook(GoogleBaseHook):
 
     def get_conn(self) -> DlpServiceClient:
         """
-        Provides a client for interacting with the Cloud DLP API.
+        Provide a client for interacting with the Cloud DLP API.
 
         :return: Google Cloud DLP API Client
         """
@@ -130,7 +130,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Starts asynchronous cancellation on a long-running DLP job.
+        Start asynchronous cancellation on a long-running DLP job.
 
         :param dlp_job_id: ID of the DLP job resource to be cancelled.
         :param project_id: (Optional) Google Cloud project ID where the
@@ -221,7 +221,7 @@ class CloudDLPHook(GoogleBaseHook):
         time_to_sleep_in_seconds: int = 60,
     ) -> DlpJob:
         """
-        Creates a new job to inspect storage or calculate risk metrics.
+        Create a new job to inspect storage or calculate risk metrics.
 
         :param project_id: (Optional) Google Cloud project ID where the
             DLP Instance exists. If set to None or missing, the default
@@ -383,7 +383,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> StoredInfoType:
         """
-        Creates a pre-built stored info type to be used for inspection.
+        Create a pre-built stored info type to be used for inspection.
 
         :param organization_id: (Optional) The organization ID. Required to set this
             field if parent resource is an organization.
@@ -480,7 +480,7 @@ class CloudDLPHook(GoogleBaseHook):
         self, template_id, organization_id=None, project_id=None, retry=DEFAULT, timeout=None, metadata=()
     ) -> None:
         """
-        Deletes a deidentify template.
+        Delete a deidentify template.
 
         :param template_id: The ID of deidentify template to be deleted.
         :param organization_id: (Optional) The organization ID. Required to set this
@@ -529,7 +529,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes a long-running DLP job.
+        Delete a long-running DLP job.
 
         This method indicates that the client is no longer interested in the DLP job result.
         The job will be cancelled if possible.
@@ -570,7 +570,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes an inspect template.
+        Delete an inspect template.
 
         :param template_id: The ID of the inspect template to be deleted.
         :param organization_id: (Optional) The organization ID. Required to set this
@@ -619,7 +619,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes a job trigger.
+        Delete a job trigger.
 
         :param job_trigger_id: The ID of the DLP job trigger to be deleted.
         :param project_id: (Optional) Google Cloud project ID where the
@@ -657,7 +657,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes a stored info type.
+        Delete a stored info type.
 
         :param stored_info_type_id: The ID of the stored info type to be deleted.
         :param organization_id: (Optional) The organization ID. Required to set this
@@ -706,7 +706,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> DeidentifyTemplate:
         """
-        Gets a deidentify template.
+        Get a deidentify template.
 
         :param template_id: The ID of deidentify template to be read.
         :param organization_id: (Optional) The organization ID. Required to set this
@@ -755,7 +755,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> DlpJob:
         """
-        Gets the latest state of a long-running Dlp Job.
+        Get the latest state of a long-running Dlp Job.
 
         :param dlp_job_id: The ID of the DLP job resource to be read.
         :param project_id: (Optional) Google Cloud project ID where the
@@ -793,7 +793,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> InspectTemplate:
         """
-        Gets an inspect template.
+        Get an inspect template.
 
         :param template_id: The ID of inspect template to be read.
         :param organization_id: (Optional) The organization ID. Required to set this
@@ -842,7 +842,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> JobTrigger:
         """
-        Gets a DLP job trigger.
+        Get a DLP job trigger.
 
         :param job_trigger_id: The ID of the DLP job trigger to be read.
         :param project_id: (Optional) Google Cloud project ID where the
@@ -880,7 +880,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> StoredInfoType:
         """
-        Gets a stored info type.
+        Get a stored info type.
 
         :param stored_info_type_id: The ID of the stored info type to be read.
         :param organization_id: (Optional) The organization ID. Required to set this
@@ -931,7 +931,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> InspectContentResponse:
         """
-        Finds potentially sensitive info in content; limits input size, processing time, and output size.
+        Find potentially sensitive info in content; limits input size, processing time, and output size.
 
         :param project_id: (Optional) Google Cloud project ID where the
             DLP Instance exists. If set to None or missing, the default
@@ -974,7 +974,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> list[DeidentifyTemplate]:
         """
-        Lists deidentify templates.
+        List deidentify templates.
 
         :param organization_id: (Optional) The organization ID. Required to set this
             field if parent resource is an organization.
@@ -1030,7 +1030,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> list[DlpJob]:
         """
-        Lists DLP jobs that match the specified filter in the request.
+        List DLP jobs that match the specified filter in the request.
 
         :param project_id: (Optional) Google Cloud project ID where the
             DLP Instance exists. If set to None or missing, the default
@@ -1074,7 +1074,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> ListInfoTypesResponse:
         """
-        Returns a list of the sensitive information types that the DLP API supports.
+        Return a list of the sensitive information types that the DLP API supports.
 
         :param language_code: (Optional) Optional BCP-47 language code for localized info
             type friendly names. If omitted, or if localized strings are not available,
@@ -1110,7 +1110,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> list[InspectTemplate]:
         """
-        Lists inspect templates.
+        List inspect templates.
 
         :param organization_id: (Optional) The organization ID. Required to set this
             field if parent resource is an organization.
@@ -1164,7 +1164,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> list[JobTrigger]:
         """
-        Lists job triggers.
+        List job triggers.
 
         :param project_id: (Optional) Google Cloud project ID where the
             DLP Instance exists. If set to None or missing, the default
@@ -1208,7 +1208,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> list[StoredInfoType]:
         """
-        Lists stored info types.
+        List stored info types.
 
         :param organization_id: (Optional) The organization ID. Required to set this
             field if parent resource is an organization.
@@ -1363,7 +1363,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> DeidentifyTemplate:
         """
-        Updates the deidentify template.
+        Update the deidentify template.
 
         :param template_id: The ID of deidentify template to be updated.
         :param organization_id: (Optional) The organization ID. Required to set this
@@ -1418,7 +1418,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> InspectTemplate:
         """
-        Updates the inspect template.
+        Update the inspect template.
 
         :param template_id: The ID of the inspect template to be updated.
         :param organization_id: (Optional) The organization ID. Required to set this
@@ -1472,7 +1472,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> JobTrigger:
         """
-        Updates a job trigger.
+        Update a job trigger.
 
         :param job_trigger_id: The ID of the DLP job trigger to be updated.
         :param project_id: (Optional) Google Cloud project ID where the
@@ -1520,7 +1520,7 @@ class CloudDLPHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> StoredInfoType:
         """
-        Updates the stored info type by creating a new version.
+        Update the stored info type by creating a new version.
 
         :param stored_info_type_id: The ID of the stored info type to be updated.
         :param organization_id: (Optional) The organization ID. Required to set this

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

@@ -74,7 +74,9 @@ def _fallback_object_url_to_object_name_and_bucket_name(
     object_name_keyword_arg_name="object_name",
 ) -> Callable[[T], T]:
     """
-    Decorator factory that convert object URL parameter to object name and bucket name parameter.
+    Convert object URL parameter to object name and bucket name parameter.
+
+    This method is a Decorator factory.
 
     :param object_url_keyword_arg_name: Name of the object URL parameter
     :param bucket_name_keyword_arg_name: Name of the bucket name parameter
@@ -160,7 +162,7 @@ class GCSHook(GoogleBaseHook):
         )
 
     def get_conn(self) -> storage.Client:
-        """Returns a Google Cloud Storage service object."""
+        """Return a Google Cloud Storage service object."""
         if not self._conn:
             self._conn = storage.Client(
                 credentials=self.get_credentials(), client_info=CLIENT_INFO, project=self.project_id
@@ -176,7 +178,7 @@ class GCSHook(GoogleBaseHook):
         destination_object: str | None = None,
     ) -> None:
         """
-        Copies an object from a bucket to another, with renaming if requested.
+        Copy an object from a bucket to another, with renaming if requested.
 
         destination_bucket or destination_object can be omitted, in which case
         source bucket/object is used, but not both.
@@ -304,7 +306,7 @@ class GCSHook(GoogleBaseHook):
         user_project: str | None = None,
     ) -> str | bytes:
         """
-        Downloads a file from Google Cloud Storage.
+        Download a file from Google Cloud Storage.
 
         When no filename is supplied, the operator loads the file into memory and returns its
         content. When a filename is supplied, it writes the file to the specified location and
@@ -366,7 +368,7 @@ class GCSHook(GoogleBaseHook):
         num_max_attempts: int | None = 1,
     ) -> bytes:
         """
-        Downloads a file from Google Cloud Storage.
+        Download a file from Google Cloud Storage.
 
         When no filename is supplied, the operator loads the file into memory and returns its
         content. When a filename is supplied, it writes the file to the specified location and
@@ -399,7 +401,7 @@ class GCSHook(GoogleBaseHook):
         user_project: str | None = None,
     ) -> Generator[IO[bytes], None, None]:
         """
-        Downloads the file to a temporary directory and returns a file handle.
+        Download the file to a temporary directory and returns a file handle.
 
         You can use this method by passing the bucket_name and object_name parameters
         or just object_url parameter.
@@ -435,7 +437,7 @@ class GCSHook(GoogleBaseHook):
         user_project: str | None = None,
     ) -> Generator[IO[bytes], None, None]:
         """
-        Creates temporary file, returns a file handle and uploads the files content on close.
+        Create temporary file, returns a file handle and uploads the files content on close.
 
         You can use this method by passing the bucket_name and object_name parameters
         or just object_url parameter.
@@ -478,7 +480,7 @@ class GCSHook(GoogleBaseHook):
         user_project: str | None = None,
     ) -> None:
         """
-        Uploads a local file or file data as string or bytes to Google Cloud Storage.
+        Upload a local file or file data as string or bytes to Google Cloud Storage.
 
         :param bucket_name: The bucket to upload to.
         :param object_name: The object name to set when uploading the file.
@@ -498,7 +500,7 @@ class GCSHook(GoogleBaseHook):
 
         def _call_with_retry(f: Callable[[], None]) -> None:
             """
-            Helper functions to upload a file or a string with a retry mechanism and exponential back-off.
+            Upload a file or a string with a retry mechanism and exponential back-off.
 
             :param f: Callable that should be retried.
             """
@@ -572,7 +574,7 @@ class GCSHook(GoogleBaseHook):
 
     def exists(self, bucket_name: str, object_name: str, retry: Retry = DEFAULT_RETRY) -> bool:
         """
-        Checks for the existence of a file in Google Cloud Storage.
+        Check for the existence of a file in Google Cloud Storage.
 
         :param bucket_name: The Google Cloud Storage bucket where the object is.
         :param object_name: The name of the blob_name to check in the Google cloud
@@ -601,7 +603,7 @@ class GCSHook(GoogleBaseHook):
 
     def is_updated_after(self, bucket_name: str, object_name: str, ts: datetime) -> bool:
         """
-        Checks if an blob_name is updated in Google Cloud Storage.
+        Check if an blob_name is updated in Google Cloud Storage.
 
         :param bucket_name: The Google Cloud Storage bucket where the object is.
         :param object_name: The name of the object to check in the Google cloud
@@ -621,7 +623,7 @@ class GCSHook(GoogleBaseHook):
         self, bucket_name: str, object_name: str, min_ts: datetime, max_ts: datetime
     ) -> bool:
         """
-        Checks if an blob_name is updated in Google Cloud Storage.
+        Check if an blob_name is updated in Google Cloud Storage.
 
         :param bucket_name: The Google Cloud Storage bucket where the object is.
         :param object_name: The name of the object to check in the Google cloud
@@ -642,7 +644,7 @@ class GCSHook(GoogleBaseHook):
 
     def is_updated_before(self, bucket_name: str, object_name: str, ts: datetime) -> bool:
         """
-        Checks if an blob_name is updated before given time in Google Cloud Storage.
+        Check if an blob_name is updated before given time in Google Cloud Storage.
 
         :param bucket_name: The Google Cloud Storage bucket where the object is.
         :param object_name: The name of the object to check in the Google cloud
@@ -680,7 +682,7 @@ class GCSHook(GoogleBaseHook):
 
     def delete(self, bucket_name: str, object_name: str) -> None:
         """
-        Deletes an object from the bucket.
+        Delete an object from the bucket.
 
         :param bucket_name: name of the bucket, where the object resides
         :param object_name: name of the object to delete
@@ -954,7 +956,7 @@ class GCSHook(GoogleBaseHook):
 
     def get_size(self, bucket_name: str, object_name: str) -> int:
         """
-        Gets the size of a file in Google Cloud Storage.
+        Get the size of a file in Google Cloud Storage.
 
         :param bucket_name: The Google Cloud Storage bucket where the blob_name is.
         :param object_name: The name of the object to check in the Google
@@ -971,7 +973,7 @@ class GCSHook(GoogleBaseHook):
 
     def get_crc32c(self, bucket_name: str, object_name: str):
         """
-        Gets the CRC32c checksum of an object in Google Cloud Storage.
+        Get the CRC32c checksum of an object in Google Cloud Storage.
 
         :param bucket_name: The Google Cloud Storage bucket where the blob_name is.
         :param object_name: The name of the object to check in the Google cloud
@@ -991,7 +993,7 @@ class GCSHook(GoogleBaseHook):
 
     def get_md5hash(self, bucket_name: str, object_name: str) -> str:
         """
-        Gets the MD5 hash of an object in Google Cloud Storage.
+        Get the MD5 hash of an object in Google Cloud Storage.
 
         :param bucket_name: The Google Cloud Storage bucket where the blob_name is.
         :param object_name: The name of the object to check in the Google cloud
@@ -1016,7 +1018,7 @@ class GCSHook(GoogleBaseHook):
         labels: dict | None = None,
     ) -> str:
         """
-        Creates a new bucket.
+        Create a new bucket.
 
         Google Cloud Storage uses a flat namespace, so you can't
         create a bucket with a name that is already in use.
@@ -1076,7 +1078,7 @@ class GCSHook(GoogleBaseHook):
         self, bucket_name: str, entity: str, role: str, user_project: str | None = None
     ) -> None:
         """
-        Creates a new ACL entry on the specified bucket_name.
+        Create a new ACL entry on the specified bucket_name.
 
         See: https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert
 
@@ -1111,7 +1113,7 @@ class GCSHook(GoogleBaseHook):
         user_project: str | None = None,
     ) -> None:
         """
-        Creates a new ACL entry on the specified object.
+        Create a new ACL entry on the specified object.
 
         See: https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert
 
@@ -1184,7 +1186,7 @@ class GCSHook(GoogleBaseHook):
         delete_extra_files: bool = False,
     ) -> None:
         """
-        Synchronizes the contents of the buckets.
+        Synchronize the contents of the buckets.
 
         Parameters ``source_object`` and ``destination_object`` describe the root sync directories. If they
         are not passed, the entire bucket will be synchronized. If they are passed, they should point
@@ -1342,7 +1344,7 @@ def parse_json_from_gcs(
     impersonation_chain: str | Sequence[str] | None = None,
 ) -> Any:
     """
-    Downloads and parses json file from Google cloud Storage.
+    Download and parses json file from Google cloud Storage.
 
     :param gcp_conn_id: Airflow Google Cloud connection ID.
     :param file_uri: full path to json file
@@ -1397,7 +1399,7 @@ class GCSAsyncHook(GoogleBaseAsyncHook):
     sync_hook_class = GCSHook
 
     async def get_storage_client(self, session: ClientSession) -> Storage:
-        """Returns a Google Cloud Storage service object."""
+        """Return a Google Cloud Storage service object."""
         token = await self.get_token(session=session)
         return Storage(
             token=token,

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

@@ -49,7 +49,7 @@ class GoogleDeploymentManagerHook(GoogleBaseHook):
         )
 
     def get_conn(self) -> Resource:
-        """Returns a Google Deployment Manager service object."""
+        """Return a Google Deployment Manager service object."""
         http_authorized = self._authorize()
         return build("deploymentmanager", "v2", http=http_authorized, cache_discovery=False)
 
@@ -61,7 +61,7 @@ class GoogleDeploymentManagerHook(GoogleBaseHook):
         order_by: str | None = None,
     ) -> list[dict[str, Any]]:
         """
-        Lists deployments in a google cloud project.
+        List deployments in a google cloud project.
 
         :param project_id: The project ID for this request.
         :param deployment_filter: A filter expression which limits resources returned in the response.
@@ -84,7 +84,7 @@ class GoogleDeploymentManagerHook(GoogleBaseHook):
         self, project_id: str | None, deployment: str | None = None, delete_policy: str | None = None
     ) -> None:
         """
-        Deletes a deployment and all associated resources in a google cloud project.
+        Delete a deployment and all associated resources in a google cloud project.
 
         :param project_id: The project ID for this request.
         :param deployment: The name of the deployment for this request.

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

@@ -32,12 +32,12 @@ if TYPE_CHECKING:
 
 
 def _b64encode(s: bytes) -> str:
-    """Base 64 encodes a bytes object to a string."""
+    """Encode a Base64 bytes object to a string."""
     return base64.b64encode(s).decode("ascii")
 
 
 def _b64decode(s: str) -> bytes:
-    """Base 64 decodes a string to bytes."""
+    """Decode a Base64 string to bytes."""
     return base64.b64decode(s.encode("utf-8"))
 
 
@@ -75,7 +75,7 @@ class CloudKMSHook(GoogleBaseHook):
 
     def get_conn(self) -> KeyManagementServiceClient:
         """
-        Retrieves connection to Cloud Key Management service.
+        Retrieve connection to Cloud Key Management service.
 
         :return: Cloud Key Management service object
         """