Struct FileInfo 

pub struct FileInfo {

    pub path: PathBuf,
    pub relative_path: String,
    pub size: u64,
    pub modified: Option<SystemTime>,
    pub decision: RenderDecision,
    pub file_type: FileType,
    pub language: Language,
    pub content: Option<String>,
    pub token_estimate: Option<usize>,
    pub line_count: Option<usize>,
    pub char_count: Option<usize>,
    pub is_binary: bool,
    pub git_status: Option<GitStatus>,
    pub centrality_score: Option<f64>,
}

Comprehensive file metadata structure

Fields

path: PathBuf

Absolute path to the file on disk

relative_path: String

Path relative to repository root (forward slash separated)

size: u64

File size in bytes

modified: Option<SystemTime>

File modification time

decision: RenderDecision

Analysis decision (include/exclude)

file_type: FileType

Detected file type

language: Language

Detected programming language

content: Option<String>

File content (loaded on demand)

token_estimate: Option<usize>

Estimated token count for LLM processing

line_count: Option<usize>

Line count (if text file)

char_count: Option<usize>

Character count (if text file)

is_binary: bool

Whether the file is likely binary

git_status: Option<GitStatus>

Git status information (if available)

centrality_score: Option<f64>

PageRank centrality score (0.0-1.0, higher means more important)

Implementations

impl FileInfo

pub fn new<P>( path: P, relative_path: String, decision: RenderDecision, ) -> Result<FileInfo, ScribeError>

where P: AsRef<Path>,

Create a new FileInfo from a path

pub fn load_content(&mut self) -> Result<(), ScribeError>

Load file content and compute statistics

pub fn estimate_tokens(content: &str) -> usize

Estimate token count for LLM processing using tiktoken

This method uses the shared global TokenCounter instance for optimal performance. If tiktoken fails, it falls back to the legacy character-based estimation.

pub fn estimate_tokens_with_path(content: &str, file_path: &Path) -> usize

Estimate token count for LLM processing with file context

This method uses the file path to apply language-specific multipliers for more accurate token estimation.

pub fn detect_binary(path: &Path) -> bool

Detect whether a file is binary using libmagic-compatible signatures with sensible fallbacks for small or unknown files.

pub fn detect_binary_with_hint(path: &Path, extension: &str) -> bool

Detect whether a file is binary, allowing the caller to provide an extension hint for fallback heuristics.

pub fn detect_binary_from_bytes(bytes: &[u8], extension: Option<&str>) -> bool

Detect whether in-memory content represents a binary file.

pub fn detect_binary_by_extension(extension: &str) -> bool

Check if file extension indicates binary content (fallback heuristic).

pub fn classify_file_type( path: &str, language: &Language, extension: &str, ) -> FileType

Classify file type based on path and language

pub fn classify_file_type_with_binary( path: &str, language: &Language, extension: &str, is_binary: bool, ) -> FileType

Classify file type when the binary state is already known.

pub fn human_size(&self) -> String

Get human-readable size

pub fn should_include(&self) -> bool

Check if file should be included in analysis

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

Get file name (last component of path)

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

Get file stem (name without extension)

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

Get file extension

Trait Implementations

impl Clone for FileInfo

fn clone(&self) -> FileInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileInfo

fn deserialize<__D>( __deserializer: __D, ) -> Result<FileInfo, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FileInfo

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

where __S: Serializer,

Serialize this value into the given Serde serializer.