Struct Input 

pub struct Input<'a, X: TimestampXml> { /* private fields */ }

Prepared original input sequence; no canonical XML is buffered here.

Implementations

impl<X: TimestampXml> Input<'_, X>

pub fn element_coverage<W: Work>( &self, execution: &W, ) -> Result<CoverageFor<X, W>, CoverageError<<X as Xml>::Error, <X as Xml>::Id>>

Indexes the original elements canonicalized in their entirety by this prepared input, including nested counter-signature/material enclosures. Comments/text are not element claims; arbitrary transformed reference output grants no subtree coverage. The same original Part sequence and explicit successful ElementContent receipts drive replay and selection. Iterative O(depth) cursor frames and an identity set avoid recursive traversal and repeated scans of overlapping original subtrees.

impl<'a, X: TimestampXml> Input<'a, X>

pub fn prepare_append<W: Work>( xml: &'a X, bound: &Bound<X::Id, X::Document, X::Generation>, kind: AppendKind, method: X::Id, execution: &W, ) -> InputResult<Self, X>

Select the input before the new timestamp exists. method is an actual owner-validated CanonicalizationMethod in this immutable snapshot, including its parameters. It may be in the owner’s unpublished staging area; it must not be a new unsigned property or an extra ds:Object.

EN319132-1 §§5.3/5.5.2.2–3 distinguish creation’s full unsigned tail from validation’s prefix before an existing archive. Any material or RenewedDigestsV2 must already be staged before preparing this input. Mutation invalidates it; obtain a new input/request after any change. https://www.etsi.org/deliver/etsi_en/319100_319199/31913201/01.03.01_60/en_31913201v010301p.pdf

pub fn prepare<W: Work>( xml: &'a X, bound: &Bound<X::Id, X::Document, X::Generation>, stamp: &Timestamp<X>, execution: &W, ) -> InputResult<Self, X>

Selects every original input part before C14N, hashing or source callbacks.

pub fn location(&self) -> (Snapshot<X::Document, X::Generation>, X::Id)

Original enclosing XML location for a logical streamed-source failure. A logical stream offset must never be reported as a physical XML byte offset.

Trait Implementations

impl<X: TimestampXml> Source for Input<'_, X>

type Error = InputError<<X as Xml>::Error, <X as Xml>::Id>

The original acquisition failure, distinct from a signature mismatch.

fn stream<W: Work>( &mut self, receiver: &mut impl Receiver, execution: &W, ) -> Result<(), Self::Error>

Feeds every chunk once, returning an error for an incomplete source.