stately-files 0.5.0

File upload and relative path management for stately
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

//! Request types for file management endpoints.

use serde::Deserialize;
use utoipa::{IntoParams, ToSchema};

/// Request body for saving file content directly.
#[derive(Debug, Deserialize, ToSchema)]
pub struct FileSaveRequest {
    /// File content as string.
    pub content: String,
    /// Optional filename. Defaults to "unnamed.txt" if not provided.
    pub name:    Option<String>,
}

/// Query parameters for listing files.
#[derive(Debug, Deserialize, IntoParams, ToSchema)]
#[into_params(parameter_in = Query)]
pub struct FileListQuery {
    /// Path to list files from, relative to the uploads directory.
    /// If not provided, lists the root uploads directory.
    pub path: Option<String>,
}

/// Query parameters for downloading files.
#[derive(Debug, Deserialize, IntoParams, ToSchema)]
#[into_params(parameter_in = Query)]
pub struct FileDownloadQuery {
    /// Specific version UUID to download.
    /// If not provided, returns the latest version.
    pub version: Option<String>,
}