Enum IncludeLoader 

#[non_exhaustive]
pub enum IncludeLoader {
    Disabled,
    System,
    Custom(Arc<dyn IncludeSourceProvider + Send + Sync>),
}

Selects how the parser loads include sources.

crate::SafeMode sets processing restrictions independently of this choice. Safe-mode path checks and allow-uri-read apply to every provider. The default is Self::System. Secure mode never calls a provider.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Disabled

Do not load include targets. Preserve directives unless Secure mode requires a link fallback.

Applies to string, reader, and file input. Disabled includes are reported through source recovery diagnostics.

System

Load local targets from the operating-system filesystem. With network, also load permitted HTTP(S) targets outside bare WebAssembly.

This is the default for all parse entry points.

Custom(Arc<dyn IncludeSourceProvider + Send + Sync>)

Load sources through a caller-supplied provider.

Implementations

impl IncludeLoader

pub fn custom( provider: impl IncludeSourceProvider + Send + Sync + 'static, ) -> Self

Load include sources through provider.

Trait Implementations

impl Clone for IncludeLoader

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IncludeLoader

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

Formats the value using the given formatter.

impl Default for IncludeLoader

fn default() -> Self

Returns the “default value” for a type.