minio 0.4.0

MinIO SDK for Amazon S3 compatible object storage access
Documentation
// MinIO Rust Library for Amazon S3 Compatible Cloud Storage
// Copyright 2025 MinIO, Inc.
//
// 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
//
//     http://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::impl_has_s3fields;
use crate::s3::error::S3ServerError::S3Error;
use crate::s3::error::{Error, ValidationErr};
use crate::s3::minio_error_response::MinioErrorCode;
use crate::s3::response_traits::{HasBucket, HasRegion};
use crate::s3::types::{FromS3Response, S3Request};
use async_trait::async_trait;
use bytes::Bytes;
use http::HeaderMap;
use std::mem;

/// Response from the [`bucket_exists()`](crate::s3::client::MinioClient::bucket_exists) API.
///
/// Contains information about the existence of a bucket.
#[derive(Clone, Debug)]
pub struct BucketExistsResponse {
    request: S3Request,
    headers: HeaderMap,
    body: Bytes,

    pub(crate) exists: bool,
}
impl_has_s3fields!(BucketExistsResponse);

impl HasBucket for BucketExistsResponse {}
impl HasRegion for BucketExistsResponse {}

#[async_trait]
impl FromS3Response for BucketExistsResponse {
    async fn from_s3response(
        request: S3Request,
        response: Result<reqwest::Response, Error>,
    ) -> Result<Self, Error> {
        match response {
            Ok(mut resp) => Ok(Self {
                request,
                headers: mem::take(resp.headers_mut()),
                body: resp.bytes().await.map_err(ValidationErr::HttpError)?,
                exists: true,
            }),
            Err(Error::S3Server(S3Error(mut e)))
                if matches!(e.code(), MinioErrorCode::NoSuchBucket) =>
            {
                Ok(Self {
                    request,
                    headers: e.take_headers(),
                    body: Bytes::new(),
                    exists: false,
                })
            }
            Err(e) => Err(e),
        }
    }
}

impl BucketExistsResponse {
    /// Returns `true` if the bucket exists, `false` otherwise.
    pub fn exists(&self) -> bool {
        self.exists
    }
}