Struct StringTracker 

pub struct StringTracker { /* private fields */ }

Thread-safe, bounded in-memory string tracker.

Implementations

impl StringTracker

pub fn new() -> Self

Create a tracker with validated defaults and built-in heuristics.

pub fn with_config(config: AnalysisConfig) -> AnalysisResult<Self>

Create a tracker with built-in components and validated limits.

pub fn with_components( analyzer: Box<dyn StringAnalyzer>, categorizer: Box<dyn Categorizer>, ) -> Self

Create a tracker with custom components and default limits.

pub fn with_components_and_config( analyzer: Box<dyn StringAnalyzer>, categorizer: Box<dyn Categorizer>, config: AnalysisConfig, ) -> AnalysisResult<Self>

Create a tracker with custom components and validated limits.

pub fn config(&self) -> &AnalysisConfig

Return this tracker’s immutable configuration.

pub fn track_string( &self, value: &str, file_path: &str, file_hash: &str, tool_name: &str, context: StringContext, ) -> AnalysisResult<()>

Track an occurrence using the current UTC time.

pub fn track_occurrence( &self, value: &str, occurrence: StringOccurrence, ) -> AnalysisResult<()>

Track an occurrence with a caller-supplied event timestamp.

pub fn track_strings( &self, strings: &[String], file_path: &str, file_hash: &str, tool_name: &str, ) -> AnalysisResult<()>

Track a batch and infer a context for each value.

The operation is sequential rather than transactional: if a later value fails validation or reaches capacity, earlier values remain tracked.

pub fn track_strings_from_results( &self, strings: &[String], file_path: &str, file_hash: &str, tool_name: &str, ) -> AnalysisResult<()>

Compatibility alias for StringTracker::track_strings.

pub fn get_statistics( &self, filter: Option<&StringFilter>, ) -> AnalysisResult<StringStatistics>

Calculate deterministic statistics for an optional validated filter.

pub fn get_string_details(&self, value: &str) -> Option<StringEntry>

Return a cloned entry for an exact value.

pub fn search_strings( &self, query: &str, limit: usize, ) -> AnalysisResult<Vec<StringEntry>>

Search values using Unicode lowercase substring matching.

pub fn get_related_strings( &self, value: &str, limit: usize, ) -> AnalysisResult<Vec<(String, f64)>>

Return related values using a deterministic, fixed-denominator score.

pub fn clear(&self)

Clear all retained state without changing configuration or components.

Trait Implementations

impl Clone for StringTracker

fn clone(&self) -> StringTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for StringTracker

fn default() -> Self

Returns the “default value” for a type.