Struct FileHandle 

pub struct FileHandle {
    pub id: String,
    pub path: PathBuf,
    pub metadata: FileMetadata,
    pub ref_count: Arc<AtomicUsize>,
}

A handle to a stored file

FileHandle tracks the file ID, path, and metadata. Note: Reference counting is managed by FileIndex, not FileHandle. FileHandle’s ref_count is for informational purposes only.

Fields

id: String

Unique file ID (SHA256 hash)

path: PathBuf

Storage path relative to the data directory

metadata: FileMetadata

File metadata

ref_count: Arc<AtomicUsize>

Local reference count view (for debugging/information)

Implementations

impl FileHandle

pub fn new(id: String, path: PathBuf, metadata: FileMetadata) -> Self

Create a new file handle

pub fn with_ref_count( id: String, path: PathBuf, metadata: FileMetadata, count: usize, ) -> Self

Create from index entry with specific ref count

pub fn ref_count(&self) -> usize

Get the current reference count

pub fn is_last_ref(&self) -> bool

Check if this is the last reference

pub fn full_path(&self, base_dir: &Path) -> PathBuf

Get the full path given a base directory

pub fn touch(&mut self)

Update last accessed timestamp

pub fn extension(&self) -> Option<&str>

Get file extension (if any)

pub fn is_image(&self) -> bool

Check if file is an image

pub fn is_text(&self) -> bool

Check if file is a text file

Trait Implementations

impl Clone for FileHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileHandle

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

Formats the value using the given formatter.