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
126
127

use std::future::Future;

use http::Method;
use serde::{Deserialize, Serialize};

use crate::body::NoneBody;
use crate::error::Result;
use crate::response::HeaderResponseProcessor;
use crate::ser::OnlyKeyField;
use crate::{Client, Ops, Prepared, Request};

/// GetSymlink request parameters
#[derive(Debug, Clone, Default, Serialize)]
pub struct GetSymlinkParams {
    symlink: OnlyKeyField,

    /// Version ID for retrieving a specific version of the symbolic link
    #[serde(rename = "versionId")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub version_id: Option<String>,
}

impl GetSymlinkParams {
    pub fn new() -> Self {
        Self {
            symlink: OnlyKeyField,
            version_id: None,
        }
    }

    /// Set the Version ID
    pub fn version_id(mut self, version_id: impl Into<String>) -> Self {
        self.version_id = Some(version_id.into());
        self
    }
}

/// GetSymlink response
#[derive(Debug, Clone, Deserialize)]
pub struct GetSymlinkResponse {
    /// The destination object to which the symbolic link points
    #[serde(rename = "x-oss-symlink-target")]
    pub symlink_target: String,
    /// Version ID of the symbolic link (if versioning is enabled)
    #[serde(rename = "x-oss-version-id")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub version_id: Option<String>,
    /// Whether this is a delete marker
    #[serde(rename = "x-oss-delete-marker")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub delete_marker: Option<String>,
}

/// GetSymlink operation
pub struct GetSymlink {
    pub object_key: String,
    pub params: GetSymlinkParams,
}

impl Ops for GetSymlink {
    type Response = HeaderResponseProcessor<GetSymlinkResponse>;
    type Body = NoneBody;
    type Query = GetSymlinkParams;

    fn prepare(self) -> Result<Prepared<GetSymlinkParams>> {
        Ok(Prepared {
            method: Method::GET,
            key: Some(self.object_key),
            query: Some(self.params),
            ..Default::default()
        })
    }
}

/// GetSymlink operations trait
pub trait GetSymlinkOperations {
    /// Get a symbolic link information
    ///
    /// Official documentation: <https://www.alibabacloud.com/help/en/oss/developer-reference/getsymlink>
    fn get_symlink(
        &self,
        object_key: impl Into<String>,
        params: GetSymlinkParams,
    ) -> impl Future<Output = Result<GetSymlinkResponse>>;
}

impl GetSymlinkOperations for Client {
    async fn get_symlink(
        &self,
        object_key: impl Into<String>,
        params: GetSymlinkParams,
    ) -> Result<GetSymlinkResponse> {
        let ops = GetSymlink {
            object_key: object_key.into(),
            params,
        };

        self.request(ops).await
    }
}

// =============================================================================
// Convenience builder and helper functions
// =============================================================================

/// GetSymlinkRequest builder
#[derive(Debug, Clone, Default)]
pub struct GetSymlinkRequestBuilder {
    params: GetSymlinkParams,
}

impl GetSymlinkRequestBuilder {
    pub fn new() -> Self {
        Self::default()
    }

    /// Set the Version ID
    pub fn version_id(mut self, version_id: impl Into<String>) -> Self {
        self.params.version_id = Some(version_id.into());
        self
    }

    /// Build parameters
    pub fn build(self) -> GetSymlinkParams {
        self.params
    }
}