Struct FileActionHandler 

pub struct FileActionHandler { /* private fields */ }

Handler for file action operations

Provides methods for specialized file operations that are separate from basic file CRUD operations.

Implementations

impl FileActionHandler

pub fn new(client: FilesClient) -> Self

Creates a new FileActionHandler

Arguments

• client - FilesClient instance

pub async fn begin_upload( &self, path: &str, size: Option<i64>, mkdir_parents: bool, ) -> Result<Vec<FileUploadPartEntity>>

Begin file upload (Stage 1 of upload process)

This must be called before uploading any file. It returns upload URLs and parameters needed to perform the actual upload.

Arguments

• path - Destination path for the file
• size - Total size of file in bytes (optional)
• mkdir_parents - Create parent directories if they don’t exist

Returns

Returns a vector of FileUploadPartEntity containing upload URLs and parameters. For small files, this will typically be a single element. For large files, it may contain multiple parts for parallel upload.

Examples

use files_sdk::{FilesClient, FileActionHandler};

let client = FilesClient::builder()
    .api_key("your-api-key")
    .build()?;

let handler = FileActionHandler::new(client);

// Begin upload for a 1KB file
let upload_info = handler
    .begin_upload("/uploads/test.txt", Some(1024), true)
    .await?;

println!("Upload URL: {:?}", upload_info[0].upload_uri);

pub async fn begin_multipart_upload( &self, path: &str, size: i64, parts: i32, mkdir_parents: bool, ) -> Result<Vec<FileUploadPartEntity>>

Begin multi-part upload for large files

For files larger than the default part size, this allows requesting multiple upload parts for parallel uploading.

Arguments

• path - Destination path for the file
• size - Total size of file in bytes
• parts - Number of parts to split the upload into
• mkdir_parents - Create parent directories if they don’t exist

Returns

Returns a vector of FileUploadPartEntity, one for each part

pub async fn copy_file(&self, path: &str, destination: &str) -> Result<()>

Copy a file to a new location

Arguments

• path - Source file path
• destination - Destination path

Examples

let handler = FileActionHandler::new(client);
handler.copy_file("/source/file.txt", "/dest/file.txt").await?;

pub async fn move_file(&self, path: &str, destination: &str) -> Result<()>

Move a file to a new location

Arguments

• path - Source file path
• destination - Destination path

Examples

let handler = FileActionHandler::new(client);
handler.move_file("/source/file.txt", "/dest/file.txt").await?;

pub async fn get_metadata(&self, path: &str) -> Result<FileEntity>

Get file metadata without downloading

This is useful when you want file information without generating download URLs or logging download activity.

Arguments

• path - File path

Examples

let handler = FileActionHandler::new(client);
let metadata = handler.get_metadata("/path/to/file.txt").await?;
println!("Size: {:?}", metadata.size);

Trait Implementations

impl Clone for FileActionHandler

fn clone(&self) -> FileActionHandler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileActionHandler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.