Struct ExtractionTracker 

pub struct ExtractionTracker { /* private fields */ }

Mutable accounting state owned by one artifact-extractor invocation.

Implementations

impl ExtractionTracker

pub fn new( artifact: impl Into<String>, extractor: impl Into<String>, budgets: &ExtractionBudgets, ) -> Self

Starts a fresh tracker for one physical artifact and one extractor.

pub fn with_clock( artifact: impl Into<String>, extractor: impl Into<String>, budgets: &ExtractionBudgets, clock: Box<dyn ExtractionClock>, ) -> Self

Starts a tracker with an injected monotonic clock.

pub fn budgets(&self) -> &ExtractionBudgets

Returns the effective limits for this invocation.

pub fn check_input_bytes( &self, observed: u64, ) -> Result<(), ExtractionLimitExceeded>

Checks source bytes before parsing or decoding them.

Errors

Returns ExtractionLimitExceeded when observed exceeds the input-byte maximum.

pub fn check_string_bytes( &self, observed: u64, ) -> Result<(), ExtractionLimitExceeded>

Checks one string token before a structured parser allocates it.

This does not charge the accumulated output counter; callers must still charge retained values immediately before materializing extraction output.

Errors

Returns ExtractionLimitExceeded when observed exceeds the per-string maximum.

pub fn check_identifier_bytes( &self, observed: u64, ) -> Result<(), ExtractionLimitExceeded>

Checks one identifier token before a structured parser allocates it.

Errors

Returns ExtractionLimitExceeded when observed exceeds the per-identifier maximum.

pub fn check_accumulated_string_bytes( &self, observed: u64, ) -> Result<(), ExtractionLimitExceeded>

Checks lexical string accumulation before structured parsing.

Errors

Returns ExtractionLimitExceeded when the observed lexical bytes exceed the accumulated output-string maximum.

pub fn charge_work( &mut self, amount: u64, ) -> Result<(), ExtractionLimitExceeded>

Charges deterministic work before the associated allocation or traversal.

Errors

Returns ExtractionLimitExceeded before accepting work beyond the configured maximum or when the sampled structured deadline has elapsed.

pub fn check_work_units( &self, observed: u64, ) -> Result<(), ExtractionLimitExceeded>

Checks a conservative prospective work count without accepting it.

Errors

Returns ExtractionLimitExceeded when observed exceeds the work maximum.

pub fn charge_tree_sitter_node( &mut self, depth: u64, ) -> Result<(), ExtractionLimitExceeded>

Charges one Tree-sitter node before visiting its children.

Errors

Returns ExtractionLimitExceeded for excessive AST depth, node count, or sampled Tree-sitter wall time.

pub fn charge_observation( &mut self, amount: u64, ) -> Result<(), ExtractionLimitExceeded>

Charges observations before inserting them into a collection.

Errors

Returns ExtractionLimitExceeded before the observation maximum is exceeded.

pub fn check_observations( &self, observed: u64, ) -> Result<(), ExtractionLimitExceeded>

Checks a conservative prospective observation count without accepting materialization.

Errors

Returns ExtractionLimitExceeded when observed exceeds the observation maximum.

pub fn ensure_observations( &mut self, minimum: u64, ) -> Result<(), ExtractionLimitExceeded>

Ensures at least the supplied number of output observations has been charged.

Errors

Returns ExtractionLimitExceeded when the minimum would exceed the observation maximum.

pub fn charge_string( &mut self, value: &str, ) -> Result<(), ExtractionLimitExceeded>

Charges extracted string bytes and validates the per-value ceiling before cloning.

Errors

Returns ExtractionLimitExceeded for an oversized value or accumulated string total.

pub fn charge_portable_path( &mut self, value: &str, ) -> Result<(), ExtractionLimitExceeded>

Charges a portable path before it is materialized.

Errors

Returns ExtractionLimitExceeded for an oversized path or accumulated string total.

pub fn charge_identifier( &mut self, value: &str, ) -> Result<(), ExtractionLimitExceeded>

Charges an identifier before it is materialized.

Errors

Returns ExtractionLimitExceeded for an oversized identifier or accumulated string total.

pub fn charge_identifier_bytes( &mut self, bytes: u64, ) -> Result<(), ExtractionLimitExceeded>

Charges a prospective identifier byte length before allocating its owned value.

Errors

Returns ExtractionLimitExceeded before the identifier or accumulated string maximum is exceeded.

pub fn check_structural_depth( &self, depth: u64, ) -> Result<(), ExtractionLimitExceeded>

Checks structured nesting before entering the next level.

Errors

Returns ExtractionLimitExceeded when depth exceeds the structural maximum.

pub fn check_ast_depth(&self, depth: u64) -> Result<(), ExtractionLimitExceeded>

Checks AST nesting before visiting a syntax node.

Errors

Returns ExtractionLimitExceeded when depth exceeds the AST maximum.

pub fn check_structured_time(&self) -> Result<(), ExtractionLimitExceeded>

Checks structured wall time immediately, including parser callbacks.

Errors

Returns ExtractionLimitExceeded after the structured wall-time deadline.

pub fn check_tree_sitter_time(&self) -> Result<(), ExtractionLimitExceeded>

Checks Tree-sitter wall time immediately, including parser callbacks.

Errors

Returns ExtractionLimitExceeded after the Tree-sitter wall-time deadline.

pub fn bounded_json_writer(&self) -> BoundedJsonWriter

Creates a JSON writer that refuses the first byte beyond the output ceiling.

pub fn output_limit_error( &self, writer: &BoundedJsonWriter, ) -> Option<ExtractionLimitExceeded>

Converts an output-writer overflow into the invocation’s typed limit error.

Trait Implementations

impl Debug for ExtractionTracker

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

Formats the value using the given formatter.