Struct ResourceTracker 

pub struct ResourceTracker {
    current_depth: usize,
    max_depth_seen: usize,
    anchor_count: usize,
    bytes_processed: usize,
    alias_depth: usize,
    complexity_score: usize,
    collection_items: usize,
    total_alias_nodes: usize,
}

Tracks resource usage during parsing

Fields

current_depth: usize

max_depth_seen: usize

anchor_count: usize

bytes_processed: usize

alias_depth: usize

complexity_score: usize

collection_items: usize

total_alias_nodes: usize

Cumulative count of nodes materialized via alias expansion in the current document. Guards the billion-laughs gap where complexity_score alone trips only after substantial allocation.

Implementations

impl ResourceTracker

pub fn new() -> Self

Creates a new resource tracker

pub fn check_depth(&mut self, limits: &Limits, depth: usize) -> Result<()>

Checks if depth limit is exceeded

pub fn add_anchor(&mut self, limits: &Limits) -> Result<()>

Increments and checks anchor count

pub fn add_bytes(&mut self, limits: &Limits, bytes: usize) -> Result<()>

Tracks bytes processed

pub fn check_string_length(&self, limits: &Limits, length: usize) -> Result<()>

Checks string length

pub fn enter_alias(&mut self, limits: &Limits) -> Result<()>

Tracks alias expansion depth

pub fn exit_alias(&mut self)

Exits alias expansion

pub fn add_collection_item(&mut self, limits: &Limits) -> Result<()>

Tracks collection items

pub fn add_complexity(&mut self, limits: &Limits, score: usize) -> Result<()>

Adds to complexity score

pub fn add_alias_materialization( &mut self, limits: &Limits, nodes: usize, ) -> Result<()>

Charges an alias-expansion materialization against the cumulative node-count budget. Call this before cloning the anchored value so the check fires before memory is committed.

nodes is the node count of the resolved value (e.g. calculate_value_complexity).

Errors

Returns an error if the cumulative materialization would exceed limits.max_total_alias_nodes.

pub fn reset(&mut self)

Resets the tracker for a new document

pub fn stats(&self) -> ResourceStats

Gets current statistics

Trait Implementations

impl Clone for ResourceTracker

fn clone(&self) -> ResourceTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResourceTracker

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

Formats the value using the given formatter.

impl Default for ResourceTracker

fn default() -> ResourceTracker

Returns the “default value” for a type.