Struct RuleVersionMigrator 

pub struct RuleVersionMigrator { /* private fields */ }

Registry and executor for rule-set schema migrations.

Steps are registered individually and queried on demand to build a MigrationPlan. Migration is simulated (no actual rule-set bytes are transformed; the struct tracks counts and emits warnings for lossy operations).

Implementations

impl RuleVersionMigrator

pub fn new() -> Self

Create an empty migrator with no registered steps.

pub fn register_step(&mut self, step: MigrationStep)

Register a migration step.

Steps may be registered in any order; plan will sort and chain them as required.

pub fn plan( &self, from: RuleSchemaVersion, to: RuleSchemaVersion, ) -> Option<MigrationPlan>

Build an ordered migration plan from from to to.

• If from == to: returns Some(MigrationPlan { steps: vec![] }).
• If from < to (upgrade): attempts to find a sequential chain of registered steps that covers every version hop between from and to.
• If from > to (downgrade): attempts the same but in reverse; a downgrade warning is embedded in the first step’s description (the warning is surfaced as a MigrationResult::warnings entry when migrate is called).
• Returns None when no complete path exists.

pub fn migrate( &self, from: RuleSchemaVersion, to: RuleSchemaVersion, ) -> MigrationResult

Execute a migration from from to to and return the result.

The migration is simulated: no actual rule-set data is mutated. The result carries counts of applied steps and transforms, plus any warnings generated (e.g. for ConvertType or downgrade operations).

pub fn registered_paths(&self) -> Vec<(RuleSchemaVersion, RuleSchemaVersion)>

Return all registered (from, to) version pairs.

Trait Implementations

impl Default for RuleVersionMigrator

fn default() -> Self

Returns the “default value” for a type.