Struct ValidatorRegistry 

pub struct ValidatorRegistry { /* private fields */ }

Registry that maps FileType values to cached validator instances.

This is the extension point for the validation engine. A ValidatorRegistry owns pre-constructed Validator instances for each supported FileType, eliminating per-file instantiation overhead.

Most callers should use ValidatorRegistry::with_defaults to obtain a registry pre-populated with all built-in validators. For advanced use cases (custom providers, disabling validators), use ValidatorRegistry::builder.

Implementations

impl ValidatorRegistry

pub fn new() -> Self

Create an empty registry with no registered validators.

pub fn with_defaults() -> Self

Create a registry pre-populated with built-in validators.

pub fn builder() -> ValidatorRegistryBuilder

Create a ValidatorRegistryBuilder for ergonomic construction.

Example

use agnix_core::ValidatorRegistry;

let registry = ValidatorRegistry::builder()
    .with_defaults()
    .without_validator("XmlValidator")
    .build();

pub fn register(&mut self, file_type: FileType, factory: ValidatorFactory)

Register a validator factory for a given file type.

The factory is called exactly once at registration time. If the validator’s name appears in the disabled set, the instance is immediately dropped (the factory is still called once to obtain the validator name). For built-in validators registered via with_defaults(), this factory call is avoided automatically using static names.

pub fn total_validator_count(&self) -> usize

Return the total number of cached validator instances across all file types.

pub fn total_factory_count(&self) -> usize

👎Deprecated since 0.12.2:

renamed to total_validator_count() - validators are now cached, not re-instantiated

Return the total number of registered validator instances across all file types.

pub fn validators_for(&self, file_type: FileType) -> &[Box<dyn Validator>]

Return a reference to the cached validator instances for the given file type.

Returns an empty slice if no validators are registered for file_type. Instances whose name() appeared in the disabled_validators set were already excluded at registration time.

pub fn disable_validator(&mut self, name: &'static str)

Disable a validator by name at runtime.

The name must match the value returned by Validator::name() (e.g., "XmlValidator"). Matching cached instances are removed from all file types. This is an O(n) scan over all cached validators, which is acceptable since this method is only called at startup.

pub fn disable_validator_owned(&mut self, name: &str)

Disable a validator by name from a runtime string.

Prefer disable_validator for string literals.

pub fn disabled_validator_count(&self) -> usize

Return the number of validator names currently disabled.

Trait Implementations

impl Default for ValidatorRegistry

fn default() -> Self

Returns the “default value” for a type.