Struct FileNode 

pub struct FileNode {

    pub path: PathBuf,
    pub is_dir: bool,
    pub size: u64,
    pub permissions: u32,
    pub uid: u32,
    pub gid: u32,
    pub modified: SystemTime,
    pub is_symlink: bool,
    pub is_hidden: bool,
    pub permission_denied: bool,
    pub is_ignored: bool,
    pub depth: usize,
    pub file_type: FileType,
    pub category: FileCategory,
    pub search_matches: Option<SearchMatches>,
    pub filesystem_type: FilesystemType,
    pub git_branch: Option<String>,
    pub traversal_context: Option<TraversalContext>,
    pub interest: Option<InterestScore>,
    pub security_findings: Vec<SecurityFinding>,
    pub change_status: Option<ChangeType>,
    pub content_hash: Option<String>,
}

FileNode: The Ultimate Backstage Pass

Every file and directory we meet gets one of these. It’s a VIP pass that holds all the juicy details: its name, size, when it was last cool (modified), and whether it’s on the super-secret “ignored” list. It’s the atom of our st universe.

Fields

path: PathBuf

The full path to the file or directory. The source of truth for location!

is_dir: bool

Is it a directory? true if yes, false if it’s a file or symlink.

size: u64

Size of the file in bytes. For directories, this is often 0 or metadata-dependent.

permissions: u32

File permissions (e.g., rwxr-xr-x). Stored as a u32, typically from Unix mode.

uid: u32

User ID of the owner (Unix-specific).

gid: u32

Group ID of the owner (Unix-specific).

modified: SystemTime

Timestamp of the last modification. Tells us how fresh or ancient a file is.

is_symlink: bool

Is it a symbolic link? true if yes. We handle these with care.

is_hidden: bool

Is it a hidden file (e.g., starts with a . on Unix)?

permission_denied: bool

Did we encounter a “Permission Denied” error when trying to access this? Important for gracefully handling parts of the filesystem we can’t read.

is_ignored: bool

Is this file or directory ignored based on .gitignore or default ignore rules?

depth: usize

The depth of this entry relative to the scan root (root is depth 0).

file_type: FileType

The specific type of the file (e.g., RegularFile, Symlink, Executable).

category: FileCategory

A category assigned based on extension or name, used for coloring and context. (e.g., Rust, Python, Image, Archive).

search_matches: Option<SearchMatches>

For content search: Information about where matches were found None if no search was performed or no matches.

filesystem_type: FilesystemType

The filesystem type this file resides on

git_branch: Option<String>

Git branch if this directory contains a .git folder

traversal_context: Option<TraversalContext>

How we reached this location (direct, symlink, mount, dependency)

interest: Option<InterestScore>

Interest score - how relevant is this file right now?

security_findings: Vec<SecurityFinding>

Security findings detected during scan

change_status: Option<ChangeType>

Change status since last scan (Added, Modified, Deleted, etc.)

content_hash: Option<String>

Content hash for change detection (Blake3/SHA256)

Trait Implementations

impl Clone for FileNode

fn clone(&self) -> FileNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileNode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileNode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FileNode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.