Struct FileHandler 

pub struct FileHandler { /* private fields */ }

Handler for file operations

Provides methods for downloading, uploading, updating, and deleting files.

Implementations

impl FileHandler

pub fn new(client: FilesClient) -> Self

Creates a new FileHandler

Arguments

• client - FilesClient instance

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

Download a file or get file information

Arguments

• path - File path to download

Returns

Returns a FileEntity containing file information including a download_uri for the actual file download.

Examples

use files_sdk::{FilesClient, FileHandler};

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

let handler = FileHandler::new(client);
let file = handler.download_file("/path/to/file.txt").await?;

if let Some(uri) = file.download_uri {
    println!("Download from: {}", uri);
}

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

Get file metadata only (no download URL, no logging)

This is a convenience method that calls FileActionHandler::get_metadata()

Arguments

• path - File path

pub async fn upload_file(&self, path: &str, data: &[u8]) -> Result<FileEntity>

Upload a file (complete two-stage upload process)

This method handles the complete upload process:

1. Calls begin_upload to get upload URLs
2. Uploads the file data
3. Finalizes the upload

Arguments

• path - Destination path for the file
• data - File contents as bytes

Examples

let handler = FileHandler::new(client);

let data = b"Hello, Files.com!";
let file = handler.upload_file("/uploads/test.txt", data).await?;
println!("Uploaded: {:?}", file.path);

pub async fn update_file( &self, path: &str, custom_metadata: Option<HashMap<String, String>>, provided_mtime: Option<String>, priority_color: Option<String>, ) -> Result<FileEntity>

Update file metadata

Arguments

• path - File path
• custom_metadata - Custom metadata key-value pairs (optional)
• provided_mtime - Custom modification time (optional)
• priority_color - Priority color (optional)

Examples

let handler = FileHandler::new(client);

let mut metadata = HashMap::new();
metadata.insert("category".to_string(), "reports".to_string());

handler.update_file("/path/to/file.txt", Some(metadata), None, None).await?;

pub async fn delete_file(&self, path: &str, recursive: bool) -> Result<()>

Delete a file

Arguments

• path - File path to delete
• recursive - If path is a folder, delete recursively

Examples

let handler = FileHandler::new(client);
handler.delete_file("/path/to/file.txt", false).await?;

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

Copy a file

This is a convenience method that calls FileActionHandler::copy_file()

Arguments

• source - Source file path
• destination - Destination path

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

Move a file

This is a convenience method that calls FileActionHandler::move_file()

Arguments

• source - Source file path
• destination - Destination path

Trait Implementations

impl Clone for FileHandler

fn clone(&self) -> FileHandler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileHandler

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

Formats the value using the given formatter.