Struct ChainRegistry 

pub struct ChainRegistry { /* private fields */ }

Holds the registered migrators, normalizers, and validators that the chain runner will dispatch through.

Migrators are keyed by from_version (one per integer; duplicates are rejected at registration). Normalizers are keyed by schema_version, at most one per version. Validators are keyed by schema_version. Contiguity (no gaps in the migrator chain) is checked at runner-start time over the actual range being traversed, not at registration time.

Implementations

impl ChainRegistry

pub fn new() -> Self

pub fn register_migrator( &mut self, migrator: Box<dyn Migrator>, ) -> Result<(), MigrationError>

Register a migrator. Rejects duplicates and migrators whose to_version is not exactly from_version + 1.

pub fn register_normalizer( &mut self, normalizer: Box<dyn Normalizer>, ) -> Result<(), MigrationError>

Register a normalizer. Rejects duplicates at the same schema version. At most one normalizer per version is supported on purpose: composing multiple normalizers in a stable order is future work and not needed today.

pub fn register_validator(&mut self, validator: Box<dyn Validator>)

Register a validator. Replaces any existing validator at the same schema version (validators are policy-bearing; the latest registered one wins).

pub fn migrator_for(&self, from: GenomeSchemaVersion) -> Option<&dyn Migrator>

Look up the migrator that consumes genomes at from.

pub fn normalizer_for( &self, version: GenomeSchemaVersion, ) -> Option<&dyn Normalizer>

Look up the normalizer at version.

pub fn validator_for( &self, version: GenomeSchemaVersion, ) -> Option<&dyn Validator>

Look up the validator at version.

pub fn run_validator( &self, version: GenomeSchemaVersion, genome: &Value, ) -> ValidationReport

Run the validator at version if one is registered, otherwise return an empty advisory report stamped with that version. Used by the chain runner so callers always see a consistent shape.

pub fn migrator_count(&self) -> usize

Number of migrators currently registered.

pub fn normalizer_count(&self) -> usize

Number of normalizers currently registered.

pub fn validator_count(&self) -> usize

Number of validators currently registered.

Trait Implementations

impl Default for ChainRegistry

fn default() -> Self

Returns the “default value” for a type.