feat(storage): support delete_source_objects in compose API

Implements the delete_source_objects parameter in Blob.compose() to allow
automatic deletion of source objects upon successful composition.

Also adds unit and system tests to verify the new parameter and handles PR feedback.

Reference PR: googleapis/google-cloud-java#12873

Co-authored-by: nidhiii-27 <224584462+nidhiii-27@users.noreply.github.com>

Author: google-labs-jules[bot]

packages/google-cloud-storage/tests/system/test_blob.py

@@ -857,25 +857,20 @@ def test_blob_compose_delete_source_objects(shared_bucket, blobs_to_delete):
     payload_1 = b"AAA\n"
     source_1 = shared_bucket.blob("source-1-delete")
     source_1.upload_from_string(payload_1)
+    blobs_to_delete.append(source_1)
 
     payload_2 = b"BBB\n"
     source_2 = shared_bucket.blob("source-2-delete")
     source_2.upload_from_string(payload_2)
+    blobs_to_delete.append(source_2)
 
     destination = shared_bucket.blob("destination-delete")
     destination.compose([source_1, source_2], delete_source_objects=True)
     blobs_to_delete.append(destination)
 
     assert destination.download_as_bytes() == payload_1 + payload_2
-
-    try:
-        assert not source_1.exists()
-        assert not source_2.exists()
-    finally:
-        if source_1.exists():
-            blobs_to_delete.append(source_1)
-        if source_2.exists():
-            blobs_to_delete.append(source_2)
+    assert not source_1.exists()
+    assert not source_2.exists()
 
 
 def test_blob_compose_new_blob_wo_content_type(shared_bucket, blobs_to_delete):

packages/google-cloud-storage/tests/unit/test_blob.py

@@ -4491,7 +4491,9 @@ def test_compose_w_delete_source_objects(self):
         client._post_resource.return_value = api_response
         bucket = _Bucket(client=client)
         source_1 = self._make_one(source_1_name, bucket=bucket)
+        source_1._properties["generation"] = 1
         source_2 = self._make_one(source_2_name, bucket=bucket)
+        source_2._properties["generation"] = 2
         destination = self._make_one(destination_name, bucket=bucket)
         destination.content_type = content_type