feat(storage): initial client and integration test

src/integration-tests/Cargo.toml

@@ -41,9 +41,14 @@ wkt.workspace         = true
 package = "google-cloud-firestore"
 path    = "../../src/firestore"
 
+[dependencies.storage]
+package = "google-cloud-storage"
+path    = "../../src/storage"
+
 [dependencies.sm]
-package = "google-cloud-secretmanager-v1"
-path    = "../../src/generated/cloud/secretmanager/v1"
+package          = "google-cloud-secretmanager-v1"
+path             = "../../src/generated/cloud/secretmanager/v1"
+default-features = false
 
 [dependencies.smo]
 package = "secretmanager-openapi-v1"

src/integration-tests/src/lib.rs

@@ -17,6 +17,7 @@ pub type Result<T> = std::result::Result<T, gax::error::Error>;
 pub mod error_details;
 pub mod firestore;
 pub mod secret_manager;
+pub mod storage;
 pub mod workflows;
 
 pub const SECRET_ID_LENGTH: usize = 64;

src/integration-tests/src/storage.rs

@@ -0,0 +1,104 @@
+// Copyright 2025 Google LLC
+//
+// 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
+//
+//     https://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.
+
+use crate::Error;
+use crate::Result;
+use gax::paginator::{ItemPaginator, Paginator};
+
+pub const BUCKET_ID_LENGTH: usize = 32;
+
+pub async fn buckets(builder: storage::client::ClientBuilder) -> Result<()> {
+    // Enable a basic subscriber. Useful to troubleshoot problems and visually
+    // verify tracing is doing something.
+    #[cfg(feature = "log-integration-tests")]
+    let _guard = {
+        use tracing_subscriber::fmt::format::FmtSpan;
+        let subscriber = tracing_subscriber::fmt()
+            .with_level(true)
+            .with_thread_ids(true)
+            .with_span_events(FmtSpan::NEW | FmtSpan::CLOSE)
+            .finish();
+
+        tracing::subscriber::set_default(subscriber)
+    };
+
+    let project_id = crate::project_id()?;
+    let client = builder.build().await?;
+
+    cleanup_stale_buckets(&client, &project_id).await?;
+
+    Ok(())
+}
+
+async fn cleanup_stale_buckets(client: &storage::client::Storage, project_id: &str) -> Result<()> {
+    use std::time::{Duration, SystemTime, UNIX_EPOCH};
+    let stale_deadline = SystemTime::now()
+        .duration_since(UNIX_EPOCH)
+        .map_err(Error::other)?;
+    let stale_deadline = stale_deadline - Duration::from_secs(48 * 60 * 60);
+    let stale_deadline = wkt::Timestamp::clamp(stale_deadline.as_secs() as i64, 0);
+
+    let mut items = client
+        .list_buckets(format!("projects/{project_id}"))
+        .paginator()
+        .await
+        .items();
+    let mut pending = Vec::new();
+    let mut names = Vec::new();
+    while let Some(bucket) = items.next().await {
+        let item = bucket?;
+        if let Some("true") = item.labels.get("integration-test").map(String::as_str) {
+            if let Some(true) = item.create_time.map(|v| v < stale_deadline) {
+                let client = client.clone();
+                let name = item.name.clone();
+                pending.push(tokio::spawn(
+                    async move { cleanup_bucket(client, name).await },
+                ));
+                names.push(item.name);
+            }
+        }
+    }
+
+    let r: std::result::Result<Vec<_>, _> = futures::future::join_all(pending)
+        .await
+        .into_iter()
+        .collect();
+    r.map_err(Error::other)?
+        .into_iter()
+        .zip(names)
+        .for_each(|(r, name)| println!("deleting bucket {name} resulted in {r:?}"));
+
+    Ok(())
+}
+
+async fn cleanup_bucket(client: storage::client::Storage, name: String) -> Result<()> {
+    let mut objects = client
+        .list_objects(&name)
+        .set_versions(true)
+        .paginator()
+        .await
+        .items();
+    let mut pending = Vec::new();
+    while let Some(object) = objects.next().await {
+        let object = object?;
+        pending.push(
+            client
+                .delete_object(object.bucket, object.name)
+                .set_generation(object.generation)
+                .send(),
+        );
+    }
+    let _ = futures::future::join_all(pending).await;
+    client.delete_bucket(&name).send().await
+}

src/integration-tests/tests/driver.rs

@@ -78,6 +78,17 @@ mod driver {
             .map_err(report)
     }
 
+    #[test_case(storage::client::Storage::builder().with_tracing().with_retry_policy(retry_policy()); "with tracing enabled")]
+    #[test_case(storage::client::Storage::builder().with_retry_policy(retry_policy()); "with retry enabled")]
+    #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
+    async fn run_storage_buckets(
+        builder: storage::client::ClientBuilder,
+    ) -> integration_tests::Result<()> {
+        integration_tests::storage::buckets(builder)
+            .await
+            .map_err(report)
+    }
+
     #[test_case(ta::client::TelcoAutomation::builder().with_tracing(); "with tracing enabled")]
     #[tokio::test(flavor = "multi_thread", worker_threads = 1)]
     async fn run_error_details(