modio/request/files/multipart/
create_multipart_upload_session.rs

1use std::future::IntoFuture;
2
3use serde_derive::Serialize;
4
5use crate::client::Client;
6use crate::request::{Output, RequestBuilder, Route};
7use crate::response::ResponseFuture;
8use crate::types::files::multipart::UploadSession;
9use crate::types::id::{GameId, ModId};
10
11/// Create a session for uploading files in multiple part.
12pub struct CreateMultipartUploadSession<'a> {
13    http: &'a Client,
14    game_id: GameId,
15    mod_id: ModId,
16    fields: CreateMultipartUploadSessionFields<'a>,
17}
18
19#[derive(Serialize)]
20struct CreateMultipartUploadSessionFields<'a> {
21    filename: &'a str,
22    #[serde(skip_serializing_if = "Option::is_none")]
23    nonce: Option<&'a str>,
24}
25
26impl<'a> CreateMultipartUploadSession<'a> {
27    pub(crate) const fn new(
28        http: &'a Client,
29        game_id: GameId,
30        mod_id: ModId,
31        filename: &'a str,
32    ) -> Self {
33        Self {
34            http,
35            game_id,
36            mod_id,
37            fields: CreateMultipartUploadSessionFields {
38                filename,
39                nonce: None,
40            },
41        }
42    }
43
44    /// An optional nonce to provide to prevent duplicate upload sessions
45    /// from being created concurrently.
46    ///
47    /// Maximun 64 characters (Recommended: SHA-256)
48    pub const fn nonce(mut self, nonce: &'a str) -> Self {
49        self.fields.nonce = Some(nonce);
50        self
51    }
52}
53
54impl IntoFuture for CreateMultipartUploadSession<'_> {
55    type Output = Output<UploadSession>;
56    type IntoFuture = ResponseFuture<UploadSession>;
57
58    fn into_future(self) -> Self::IntoFuture {
59        let route = Route::CreateMultipartUploadSession {
60            game_id: self.game_id,
61            mod_id: self.mod_id,
62        };
63        match RequestBuilder::from_route(&route).form(&self.fields) {
64            Ok(req) => self.http.request(req),
65            Err(err) => ResponseFuture::failed(err),
66        }
67    }
68}