Struct FolderHandler 

pub struct FolderHandler { /* private fields */ }

Handler for folder operations

Provides methods for listing, creating, and managing folders.

Implementations

impl FolderHandler

pub fn new(client: FilesClient) -> Self

Creates a new FolderHandler

Arguments

• client - FilesClient instance

pub async fn list_folder( &self, path: &str, per_page: Option<i32>, cursor: Option<String>, ) -> Result<(Vec<FileEntity>, PaginationInfo)>

List folder contents

Returns files and subdirectories within the specified folder.

Arguments

• path - Folder path to list (empty string for root)
• per_page - Number of items per page (optional, max 10,000)
• cursor - Pagination cursor (optional)

Returns

Returns a tuple of (files, pagination_info)

Examples

use files_sdk::{FilesClient, FolderHandler};

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

let handler = FolderHandler::new(client);
let (files, pagination) = handler.list_folder("/", None, None).await?;

for file in files {
    println!("{}: {}", file.file_type.unwrap_or_default(), file.path.unwrap_or_default());
}

if pagination.has_next() {
    println!("More results available");
}

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

List all folder contents (auto-pagination)

Automatically handles pagination to retrieve all items in a folder.

Arguments

• path - Folder path to list

Examples

let handler = FolderHandler::new(client);
let all_files = handler.list_folder_all("/uploads").await?;
println!("Total files: {}", all_files.len());

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

Create a new folder

Note: In Files.com, folders are created implicitly when uploading files with mkdir_parents=true. This method creates an empty folder.

Arguments

• path - Folder path to create
• mkdir_parents - Create parent directories if they don’t exist

Examples

let handler = FolderHandler::new(client);
handler.create_folder("/new/folder", true).await?;

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

Delete a folder

Arguments

• path - Folder path to delete
• recursive - Delete folder and all contents recursively

Examples

let handler = FolderHandler::new(client);
handler.delete_folder("/old/folder", true).await?;

pub async fn search_folder( &self, path: &str, search: &str, per_page: Option<i32>, ) -> Result<(Vec<FileEntity>, PaginationInfo)>

Search for files within a folder

Arguments

• path - Folder path to search in
• search - Search query string
• per_page - Number of results per page (optional)

Examples

let handler = FolderHandler::new(client);
let (results, _) = handler.search_folder("/", "report", None).await?;
println!("Found {} files", results.len());

Trait Implementations

impl Clone for FolderHandler

fn clone(&self) -> FolderHandler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FolderHandler

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

Formats the value using the given formatter.