libquarkpan 0.4.0

Async Rust client library for Quark Drive upload, download, listing, and folder creation
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

use std::sync::Arc;

use crate::QuarkPanInner;
use crate::error::{QuarkPanError, Result};
use crate::model::{BoxByteStream, DownloadInfo};

pub struct DownloadBuilder {
    inner: Arc<QuarkPanInner>,
    fid: Option<String>,
    start_offset: Option<u64>,
}

impl DownloadBuilder {
    pub(crate) fn new(inner: Arc<QuarkPanInner>) -> Self {
        Self {
            inner,
            fid: None,
            start_offset: None,
        }
    }

    /// Sets the target fid to download.
    pub fn fid(mut self, fid: impl Into<String>) -> Self {
        self.fid = Some(fid.into());
        self
    }

    /// Starts reading the remote file from the given byte offset.
    pub fn start_offset(mut self, start_offset: u64) -> Self {
        self.start_offset = Some(start_offset);
        self
    }

    /// Prepares the download request.
    pub fn prepare(self) -> Result<DownloadRequest> {
        let fid = self
            .fid
            .ok_or_else(|| QuarkPanError::missing_field("fid"))?;
        Ok(DownloadRequest {
            inner: self.inner,
            fid,
            start_offset: self.start_offset,
        })
    }
}

pub struct DownloadRequest {
    inner: Arc<QuarkPanInner>,
    fid: String,
    start_offset: Option<u64>,
}

impl DownloadRequest {
    /// Fetches the current download metadata, including the temporary url and md5 when available.
    pub async fn info(&self) -> Result<DownloadInfo> {
        self.inner.api.get_download_info(&self.fid).await
    }

    /// Opens a byte stream for the target file.
    pub async fn stream(&self) -> Result<BoxByteStream> {
        self.inner
            .api
            .download_stream(&self.fid, self.start_offset)
            .await
    }
}