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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

use serde::{Deserialize, Serialize};

/// Bucket canned ACL. Used by `PutBucketAcl`, `GetBucketAcl`, and the
/// `x-oss-acl` header on `PutBucket`.
///
/// Unlike object ACLs there is no `default` value for a bucket.
#[derive(Copy, Clone, Debug, PartialEq, Eq, Default, Serialize, Deserialize)]
pub enum BucketAcl {
    /// Anonymous users can read and write objects in the bucket.
    #[serde(rename = "public-read-write")]
    PublicReadWrite,
    /// Anonymous users can only read. Only the owner / authorized users can
    /// write.
    #[serde(rename = "public-read")]
    PublicRead,
    /// Only the owner / authorized users can read and write.
    #[default]
    #[serde(rename = "private")]
    Private,
}

impl BucketAcl {
    /// Wire form used by OSS (value of the `x-oss-acl` header and the
    /// `<Grant>` XML element).
    pub fn as_str(&self) -> &'static str {
        match self {
            BucketAcl::PublicReadWrite => "public-read-write",
            BucketAcl::PublicRead => "public-read",
            BucketAcl::Private => "private",
        }
    }
}

impl AsRef<str> for BucketAcl {
    fn as_ref(&self) -> &str {
        self.as_str()
    }
}

/// Object canned ACL. Used by `PutObjectACL`, `GetObjectACL`, and the
/// `x-oss-object-acl` header on upload operations.
///
/// Unlike [`BucketAcl`] this includes a `Default` variant meaning "inherit
/// from the bucket".
#[derive(Copy, Clone, Debug, PartialEq, Eq, Default, Serialize, Deserialize)]
pub enum ObjectAcl {
    /// Inherits the bucket's ACL.
    #[default]
    #[serde(rename = "default")]
    Default,
    /// Anonymous users can read and write the object.
    #[serde(rename = "public-read-write")]
    PublicReadWrite,
    /// Anonymous users can only read.
    #[serde(rename = "public-read")]
    PublicRead,
    /// Only the owner / authorized users can read and write.
    #[serde(rename = "private")]
    Private,
}

impl ObjectAcl {
    pub fn as_str(&self) -> &'static str {
        match self {
            ObjectAcl::Default => "default",
            ObjectAcl::PublicReadWrite => "public-read-write",
            ObjectAcl::PublicRead => "public-read",
            ObjectAcl::Private => "private",
        }
    }
}

impl AsRef<str> for ObjectAcl {
    fn as_ref(&self) -> &str {
        self.as_str()
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn bucket_acl_wire_names() {
        assert_eq!(
            serde_json::to_string(&BucketAcl::PublicReadWrite).unwrap(),
            "\"public-read-write\""
        );
        assert_eq!(serde_json::to_string(&BucketAcl::PublicRead).unwrap(), "\"public-read\"");
        assert_eq!(serde_json::to_string(&BucketAcl::Private).unwrap(), "\"private\"");
    }

    #[test]
    fn bucket_acl_round_trip() {
        for acl in [
            BucketAcl::PublicReadWrite,
            BucketAcl::PublicRead,
            BucketAcl::Private,
        ] {
            let json = serde_json::to_string(&acl).unwrap();
            let back: BucketAcl = serde_json::from_str(&json).unwrap();
            assert_eq!(acl, back);
        }
    }

    #[test]
    fn object_acl_wire_names() {
        assert_eq!(serde_json::to_string(&ObjectAcl::Default).unwrap(), "\"default\"");
        assert_eq!(serde_json::to_string(&ObjectAcl::PublicRead).unwrap(), "\"public-read\"");
    }

    #[test]
    fn object_acl_round_trip() {
        for acl in [
            ObjectAcl::Default,
            ObjectAcl::PublicReadWrite,
            ObjectAcl::PublicRead,
            ObjectAcl::Private,
        ] {
            let s = serde_json::to_string(&acl).unwrap();
            let back: ObjectAcl = serde_json::from_str(&s).unwrap();
            assert_eq!(acl, back);
        }
    }
}