pub mod builders;
mod input;
pub use input::{DownloadObjectsInput, DownloadObjectsInputBuilder};
mod output;
pub use output::{DownloadObjectsOutput, DownloadObjectsOutputBuilder};
mod handle;
pub use handle::DownloadObjectsHandle;
mod observability;
pub(crate) mod transfer;
use transfer::DownloadObjectsTransfer;
use std::sync::Arc;
use crate::config::user_agent::OperationFeatures;
use crate::io::walk::S3WalkContext;
use crate::transfer::TransferContext;
use aws_runtime::sdk_feature::AwsSdkFeature;
#[derive(Clone, Default, Debug)]
pub(crate) struct DownloadObjects;
impl DownloadObjects {
pub(crate) fn orchestrate(
handle: Arc<crate::client::Handle>,
input: DownloadObjectsInput,
) -> Result<DownloadObjectsHandle, crate::error::Error> {
if input
.destination()
.is_none_or(|destination| destination.as_os_str().is_empty())
{
return Err(crate::error::invalid_input("destination is required"));
}
let bucket = input
.bucket()
.ok_or_else(|| crate::error::invalid_input("bucket is required"))?
.to_string();
let pipeline_depth = input
.max_concurrent_downloads()
.map(|n| n.max(1))
.unwrap_or(super::DEFAULT_MAX_CONCURRENT_CHILDREN);
let walker = input.walker().cloned().unwrap_or_default();
let features = OperationFeatures::new([AwsSdkFeature::S3TransferDownloadDirectory]);
let s3_client = features.apply_to_client(&handle.s3_client);
let walk_ctx = S3WalkContext::builder()
.sdk_client(s3_client)
.bucket(&bucket)
.build();
let walk = walker.walk(walk_ctx);
let (ctx, completion_rx) = TransferContext::new(handle.clone());
let transfer = DownloadObjectsTransfer::new(ctx, &input, walk, pipeline_depth);
handle
.scheduler
.enqueue_transfer(Box::new(transfer.clone()));
Ok(DownloadObjectsHandle {
completion_rx: Some(completion_rx),
transfer,
})
}
}