box-open-sdk 0.1.1

Generated Box API SDK for Rust (community, unofficial).
Documentation
// Code generated by box-gantry. DO NOT EDIT.

use crate::internal::path_escape;
use crate::runtime::{self, Error};

/// Optional parameters for [`FilesManager::get`].
#[derive(Clone, Debug, Default)]
pub struct FilesGetOptions {
    pub fields: Option<Vec<String>>,
    pub if_none_match: Option<String>,
    pub boxapi: Option<String>,
    pub x_rep_hints: Option<String>,
}

/// Optional parameters for [`FilesManager::update`].
#[derive(Clone, Debug, Default)]
pub struct FilesUpdateOptions {
    pub fields: Option<Vec<String>>,
    pub if_match: Option<String>,
}

/// Optional parameters for [`FilesManager::delete`].
#[derive(Clone, Debug, Default)]
pub struct FilesDeleteOptions {
    pub if_match: Option<String>,
}

/// Optional parameters for [`FilesManager::copy`].
#[derive(Clone, Debug, Default)]
pub struct FilesCopyOptions {
    pub fields: Option<Vec<String>>,
}

/// Optional parameters for [`FilesManager::get_thumbnail`].
#[derive(Clone, Debug, Default)]
pub struct FilesGetThumbnailOptions {
    pub min_height: Option<i64>,
    pub min_width: Option<i64>,
    pub max_height: Option<i64>,
    pub max_width: Option<i64>,
}

/// Operations for the "files" API area.
pub struct FilesManager {
    session: std::sync::Arc<runtime::Client>,
}

impl FilesManager {
    pub(crate) fn new(session: std::sync::Arc<runtime::Client>) -> Self {
        Self { session }
    }

    pub async fn get(
        &self,
        file_id: String,
        opts: Option<FilesGetOptions>,
    ) -> Result<crate::models::schemas::FileFull, Error> {
        let mut url = self.session.base_url("api");
        url.push_str("/files");
        url.push('/');
        let seg = path_escape(&file_id);
        url.push_str(&seg);
        let mut req = self.session.new_request("GET", &url);
        let opts = opts.unwrap_or_default();
        if let Some(value) = opts.fields {
            req = runtime::with_query(req, "fields", &value.join(","));
        }
        if let Some(value) = opts.if_none_match {
            req = runtime::with_header(req, "if-none-match", &value);
        }
        if let Some(value) = opts.boxapi {
            req = runtime::with_header(req, "boxapi", &value);
        }
        if let Some(value) = opts.x_rep_hints {
            req = runtime::with_header(req, "x-rep-hints", &value);
        }
        let resp = self.session.fetch(req).await?;
        let data = runtime::response_bytes(&resp)?;
        Ok(serde_json::from_slice(&data)?)
    }

    pub async fn update(
        &self,
        file_id: String,
        body: crate::models::schemas::FileUpdateRequest,
        opts: Option<FilesUpdateOptions>,
    ) -> Result<crate::models::schemas::FileFull, Error> {
        let mut url = self.session.base_url("api");
        url.push_str("/files");
        url.push('/');
        let seg = path_escape(&file_id);
        url.push_str(&seg);
        let mut req = self.session.new_request("PUT", &url);
        let opts = opts.unwrap_or_default();
        if let Some(value) = opts.fields {
            req = runtime::with_query(req, "fields", &value.join(","));
        }
        if let Some(value) = opts.if_match {
            req = runtime::with_header(req, "if-match", &value);
        }
        let payload = serde_json::to_vec(&body)?;
        req = runtime::with_json_body(req, &payload);
        let resp = self.session.fetch(req).await?;
        let data = runtime::response_bytes(&resp)?;
        Ok(serde_json::from_slice(&data)?)
    }

    pub async fn delete(
        &self,
        file_id: String,
        opts: Option<FilesDeleteOptions>,
    ) -> Result<(), Error> {
        let mut url = self.session.base_url("api");
        url.push_str("/files");
        url.push('/');
        let seg = path_escape(&file_id);
        url.push_str(&seg);
        let mut req = self.session.new_request("DELETE", &url);
        let opts = opts.unwrap_or_default();
        if let Some(value) = opts.if_match {
            req = runtime::with_header(req, "if-match", &value);
        }
        let _ = self.session.fetch(req).await?;
        Ok(())
    }

    pub async fn copy(
        &self,
        file_id: String,
        body: crate::models::schemas::FileCopyRequest,
        opts: Option<FilesCopyOptions>,
    ) -> Result<crate::models::schemas::FileFull, Error> {
        let mut url = self.session.base_url("api");
        url.push_str("/files");
        url.push('/');
        let seg = path_escape(&file_id);
        url.push_str(&seg);
        url.push_str("/copy");
        let mut req = self.session.new_request("POST", &url);
        let opts = opts.unwrap_or_default();
        if let Some(value) = opts.fields {
            req = runtime::with_query(req, "fields", &value.join(","));
        }
        let payload = serde_json::to_vec(&body)?;
        req = runtime::with_json_body(req, &payload);
        let resp = self.session.fetch(req).await?;
        let data = runtime::response_bytes(&resp)?;
        Ok(serde_json::from_slice(&data)?)
    }

    pub async fn get_thumbnail(
        &self,
        file_id: String,
        extension: crate::models::schemas::GetIdThumbnailIdExtension,
        opts: Option<FilesGetThumbnailOptions>,
    ) -> Result<runtime::Stream, Error> {
        let mut url = self.session.base_url("api");
        url.push_str("/files");
        url.push('/');
        let seg = path_escape(&file_id);
        url.push_str(&seg);
        url.push('/');
        url.push_str("thumbnail.");
        let seg = path_escape(&extension.0);
        url.push_str(&seg);
        let mut req = self.session.new_request("GET", &url);
        let opts = opts.unwrap_or_default();
        if let Some(value) = opts.min_height {
            req = runtime::with_query(req, "min_height", &value.to_string());
        }
        if let Some(value) = opts.min_width {
            req = runtime::with_query(req, "min_width", &value.to_string());
        }
        if let Some(value) = opts.max_height {
            req = runtime::with_query(req, "max_height", &value.to_string());
        }
        if let Some(value) = opts.max_width {
            req = runtime::with_query(req, "max_width", &value.to_string());
        }
        let resp = self.session.fetch(req).await?;
        Ok(runtime::response_stream(&resp))
    }
}