Struct EvaluationMetadata 

#[non_exhaustive]
pub struct EvaluationMetadata {
    pub file_size: u64,
    pub evaluation_time_ms: f64,
    pub rules_evaluated: usize,
    pub magic_file: Option<PathBuf>,
    pub timed_out: bool,
}

Metadata about the evaluation process

Contains diagnostic information about how the evaluation was performed, including performance metrics and statistics about rule processing.

Examples

use libmagic_rs::EvaluationMetadata;
use std::path::PathBuf;

let metadata = EvaluationMetadata::new(
    8192,
    2.5,
    42,
    Some(PathBuf::from("/usr/share/misc/magic")),
    false,
);

assert_eq!(metadata.file_size, 8192);
assert!(!metadata.timed_out);

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

file_size: u64

Size of the analyzed file or buffer in bytes

evaluation_time_ms: f64

Time taken to evaluate rules in milliseconds

rules_evaluated: usize

Number of top-level rules that were evaluated

magic_file: Option<PathBuf>

Path to the magic file used, or None for built-in rules

timed_out: bool

Whether evaluation was stopped due to timeout

Implementations

impl EvaluationMetadata

pub fn new( file_size: u64, evaluation_time_ms: f64, rules_evaluated: usize, magic_file: Option<PathBuf>, timed_out: bool, ) -> Self

Construct a new library-side EvaluationMetadata from the four always-set fields. magic_file and timed_out default to None / false; use struct-update syntax with EvaluationMetadata::default() to set them explicitly.

Trait Implementations

impl Clone for EvaluationMetadata

fn clone(&self) -> EvaluationMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EvaluationMetadata

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

Formats the value using the given formatter.

impl Default for EvaluationMetadata

fn default() -> Self

Returns the “default value” for a type.

impl Serialize for EvaluationMetadata

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

where __S: Serializer,

Serialize this value into the given Serde serializer.