haive.core.schema.compatibility.converters¶

Type conversion system for schema compatibility.

Classes¶

`ConverterRegistry`	Registry for type converters.
`TypeConverter`	Abstract base class for type converters.

Functions¶

`get_converter_registry`()	Get the global converter registry.
`register_converter`(converter)	Register a converter in the global registry.

Module Contents¶

class haive.core.schema.compatibility.converters.ConverterRegistry[source]¶

Registry for type converters.

Init .

can_convert(source_type, target_type)[source]¶

Check if conversion is possible.

Parameters:

source_type (type[Any])
target_type (type[Any])

Return type:

bool

convert(value, source_type, target_type)[source]¶

Convert a value using the best available converter.

Parameters:

value (Any)
source_type (type[Any])
target_type (type[Any])

Return type:

Any

get_converter(source_type, target_type)[source]¶

Get the best converter for a type pair.

Parameters:

source_type (type[Any])
target_type (type[Any])

Return type:

TypeConverter | None

list_converters()[source]¶

List all registered converter names.

Return type:: list[str]

register(converter)[source]¶

Parameters:: converter (TypeConverter)
Return type:: None

unregister(name)[source]¶

Unregister a type converter.

Parameters:: name (str)
Return type:: None

class haive.core.schema.compatibility.converters.TypeConverter[source]¶

Bases: abc.ABC

Abstract base class for type converters.

abstractmethod can_convert(source_type, target_type)[source]¶

Check if this converter can handle the conversion.

Parameters:

source_type (type[Any])
target_type (type[Any])

Return type:

bool

abstractmethod convert(value, context)[source]¶

Convert a value from source to target type.

Parameters:

value (Any)
context (haive.core.schema.compatibility.types.ConversionContext)

Return type:

Any

estimate_quality(source_type, target_type)[source]¶

Estimate the quality of conversion.

Parameters:

source_type (type[Any])
target_type (type[Any])

Return type:

haive.core.schema.compatibility.types.ConversionQuality

property name: str¶

Abstractmethod:
Return type:: str

Unique name for this converter.

property priority: int¶

Priority for converter selection (higher = preferred).

Return type:: int

haive.core.schema.compatibility.converters.get_converter_registry()[source]¶

Get the global converter registry.

Return type:: ConverterRegistry

haive.core.schema.compatibility.converters.register_converter(converter)[source]¶

Parameters:: converter (TypeConverter)
Return type:: None