ossify 0.4.0

A modern, easy-to-use, and reqwest-powered Rust SDK for Alibaba Cloud Object Storage Service (OSS)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use std::collections::HashMap;
use std::future::Future;

use http::{HeaderMap, HeaderName, Method};
use serde::Serialize;

use crate::body::XMLBody;
use crate::error::Result;
use crate::ops::common::{BucketAcl, DataRedundancyType, StorageClass};
use crate::response::EmptyResponseProcessor;
use crate::{Client, Ops, Prepared, Request, ser};

/// Configuration for creating a bucket
#[derive(Debug, Clone, Default, Serialize)]
#[serde(rename_all = "PascalCase")]
pub struct PutBucketConfiguration {
    pub storage_class: Option<StorageClass>,
    pub data_redundancy_type: Option<DataRedundancyType>,
}

/// Options for creating a bucket
#[derive(Debug, Clone, Default)]
pub struct PutBucketOptions {
    pub acl: Option<BucketAcl>,
    pub resource_group_id: Option<String>,
    pub tags: HashMap<String, String>,
}

impl PutBucketOptions {
    fn into_headers(self) -> Result<HeaderMap> {
        let mut headers = HeaderMap::new();

        if let Some(acl) = self.acl {
            headers.insert(HeaderName::from_static("x-oss-acl"), acl.as_str().parse()?);
        }
        if let Some(resource_group_id) = self.resource_group_id {
            headers.insert(HeaderName::from_static("x-oss-resource-group-id"), resource_group_id.parse()?);
        }
        if !self.tags.is_empty() {
            let tags_str = ser::to_string(&self.tags)?;
            headers.insert(HeaderName::from_static("x-oss-bucket-tagging"), tags_str.parse()?);
        }

        Ok(headers)
    }
}

/// Put bucket operation
pub struct PutBucket {
    pub config: PutBucketConfiguration,
    pub options: PutBucketOptions,
}

impl Ops for PutBucket {
    type Response = EmptyResponseProcessor;
    type Body = XMLBody<PutBucketConfiguration>;
    type Query = ();

    fn prepare(self) -> Result<Prepared<(), PutBucketConfiguration>> {
        Ok(Prepared {
            method: Method::PUT,
            body: Some(self.config),
            headers: Some(self.options.into_headers()?),
            ..Default::default()
        })
    }
}

pub trait PutBucketOps {
    /// Create a new bucket
    ///
    /// Official document: <https://www.alibabacloud.com/help/en/oss/developer-reference/putbucket>
    fn put_bucket(
        &self,
        config: PutBucketConfiguration,
        options: Option<PutBucketOptions>,
    ) -> impl Future<Output = Result<()>>;
}

impl PutBucketOps for Client {
    async fn put_bucket(
        &self,
        config: PutBucketConfiguration,
        options: Option<PutBucketOptions>,
    ) -> Result<()> {
        let ops = PutBucket {
            config,
            options: options.unwrap_or_default(),
        };
        self.request(ops).await
    }
}