Class: CMDx::CoercionRegistry

Inherits:
Object
  • Object
show all
Defined in:
lib/cmdx/coercion_registry.rb

Overview

Registry for managing type coercion handlers.

Provides a centralized way to register, deregister, and execute type coercions for various data types including arrays, numbers, dates, and other primitives.

Supports copy-on-write semantics: a duped registry shares the parent’s data until a write operation triggers materialization.

Instance Method Summary collapse

Constructor Details

#initialize(registry = nil) ⇒ CoercionRegistry

Initialize a new coercion registry.

Examples:

registry = CoercionRegistry.new
registry = CoercionRegistry.new(custom: CustomCoercion)

Parameters:

  • registry (Hash{Symbol => Class}, nil) (defaults to: nil) —

    optional initial registry hash

Rbs:

  • (?Hash[Symbol, Class]? registry) -> void



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/cmdx/coercion_registry.rb', line 22

def initialize(registry = nil)
  @registry = registry || {
    array: Coercions::Array,
    big_decimal: Coercions::BigDecimal,
    boolean: Coercions::Boolean,
    complex: Coercions::Complex,
    date: Coercions::Date,
    datetime: Coercions::DateTime,
    float: Coercions::Float,
    hash: Coercions::Hash,
    integer: Coercions::Integer,
    rational: Coercions::Rational,
    string: Coercions::String,
    time: Coercions::Time
  }
end

Instance Method Details

#coerce(type, task, value, options = EMPTY_HASH) ⇒ Object

Coerce a value to the specified type using the registered handler.

Examples:

result = registry.coerce(:integer, task, "42")
result = registry.coerce(:boolean, task, "true", strict: true)

Parameters:

  • type (Symbol) —

    the type to coerce to

  • task (Object) —

    the task context for the coercion

  • value (Object) —

    the value to coerce

  • options (Hash) (defaults to: EMPTY_HASH) —

    additional options for the coercion

Options Hash (options):

  • :* (Object) —

    Any coercion option key-value pairs

Returns:

  • (Object) —

    the coerced value

Raises:

  • (TypeError) —

    when the type is not registered

Rbs:

  • (Symbol type, untyped task, untyped value, ?Hash[Symbol, untyped] options) -> untyped



118
119
120
121
122
 
# File 'lib/cmdx/coercion_registry.rb', line 118

def coerce(type, task, value, options = EMPTY_HASH)
  raise TypeError, "unknown coercion type #{type.inspect}" unless registry.key?(type)

  Utils::Call.invoke(task, registry[type], value, options)
end

#deregister(name) ⇒ CoercionRegistry

Remove a coercion handler for a type.

Examples:

registry.deregister(:custom_type)
registry.deregister("another_type")

Parameters:

  • name (Symbol, String) —

    the type name to deregister

Returns:

Rbs:

  • ((Symbol | String) name) -> self



94
95
96
97
98
99
 
# File 'lib/cmdx/coercion_registry.rb', line 94

def deregister(name)
  materialize!

  @registry.delete(name.to_sym)
  self
end

#initialize_dup(source) ⇒ Object

Sets up copy-on-write state when duplicated via dup.

Parameters:

Rbs:

  • (CoercionRegistry source) -> void



44
45
46
47
48
 
# File 'lib/cmdx/coercion_registry.rb', line 44

def initialize_dup(source)
  @parent = source
  @registry = nil
  super
end

#register(name, coercion) ⇒ CoercionRegistry

Register a new coercion handler for a type.

Examples:

registry.register(:custom_type, CustomCoercion)
registry.register("another_type", AnotherCoercion)

Parameters:

  • name (Symbol, String) —

    the type name to register

  • coercion (Class) —

    the coercion class to handle this type

Returns:

Rbs:

  • ((Symbol | String) name, Class coercion) -> self



76
77
78
79
80
81
 
# File 'lib/cmdx/coercion_registry.rb', line 76

def register(name, coercion)
  materialize!

  @registry[name.to_sym] = coercion
  self
end

#registry ⇒ Hash{Symbol => Class} Also known as: to_h

Returns the internal registry mapping coercion types to handler classes. Delegates to the parent registry when not yet materialized.

Examples:

registry.registry # => { integer: Coercions::Integer, boolean: Coercions::Boolean }

Returns:

  • (Hash{Symbol => Class}) —

    Hash of coercion type names to coercion classes

Rbs:

  • () -> Hash[Symbol, Class]



59
60
61
 
# File 'lib/cmdx/coercion_registry.rb', line 59

def registry
  @registry || @parent.registry
end