Struct MutationRegistry 

pub struct MutationRegistry { /* private fields */ }

Central registry for MutationSpec → Mutation conversion

Routes each MutationSpec to its appropriate Converter based on kind_name().

Implementations

impl MutationRegistry

pub fn new() -> Self

Create a new registry with all built-in converters registered

Uses register_all() for converters that handle multiple spec kinds, which automatically registers all kinds from spec_kinds(). This prevents the “forgot to register” bug.

pub fn register( &mut self, kind: &'static str, converter: Box<dyn MutationConverter>, )

Register a converter for a single spec kind

Note: Each spec kind can only have one converter. For converters handling multiple spec kinds, use register_all().

pub fn register_all<C: MutationConverter + Default + 'static>(&mut self)

Register a converter for all its spec_kinds() automatically.

This method creates a new instance of the converter for each spec kind it handles. Requires the converter to implement Default.

Example

// Instead of:
registry.register("FilterNext", Box::new(IdiomConverter::new()));
registry.register("MapUnwrapOr", Box::new(IdiomConverter::new()));
// ... 15 more lines

// Use:
registry.register_all::<IdiomConverter>();

pub fn can_handle(&self, spec: &MutationSpec) -> bool

Check if this registry can handle the given spec

pub fn get(&self, spec: &MutationSpec) -> Option<&dyn MutationConverter>

Get the converter for a spec, if registered

pub fn convert( &self, spec: &MutationSpec, ) -> Result<Box<dyn Mutation>, ConvertError>

👎Deprecated since 0.1.0:

Returns Box<dyn Mutation> for legacy apply(&mut PureFile). Use convert_v2() for ASTRegApply.

Convert a MutationSpec to a Mutation (DEPRECATED)

pub fn convert_v2( &self, spec: &MutationSpec, ctx: &AnalysisContext, ) -> Result<Vec<Box<dyn ASTRegApply>>, ConvertError>

Convert a MutationSpec to execution units (V2 API)

Returns a vector of ASTRegApply mutations that implement the spec. One spec may expand to multiple execution units.

Returns

• Ok(mutations) - Vector of mutations to execute
• Err(V2NotSupported) - Converter doesn’t implement convert_v2 yet
• Err(UnknownSpec) - No converter registered for this spec kind

pub fn pre_check( &self, spec: &MutationSpec, ctx: &AnalysisContext, ) -> Result<(), ConvertError>

Pre-check a MutationSpec before applying.

Uses GraphChecker to validate that targets exist before mutation. This catches errors early (e.g., field not found, type not found) without running cargo check.

Checks performed

Spec Kind	Check
Rename	Target symbol exists
AddField/RemoveField	Struct exists
AddDerive/RemoveDerive	Target type exists
AddVariant/RemoveVariant	Enum exists
AddMethod/RemoveMethod	Target type exists
ChangeVisibility	Target exists

pub fn len(&self) -> usize

Get the number of registered converters

pub fn is_empty(&self) -> bool

Check if the registry is empty

pub fn registered_kinds(&self) -> Vec<&'static str>

Get all registered spec kinds

Trait Implementations

impl Debug for MutationRegistry

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

Formats the value using the given formatter.

impl Default for MutationRegistry

fn default() -> Self

Returns the “default value” for a type.