Module: Plushie::Encode

Defined in:
lib/plushie/encode.rb

Overview

Value encoding for the wire protocol.

Converts Ruby values to wire-safe representations during tree normalization. Called by Tree.normalize on each prop value.

Encoding rules:

  • true, false, nil, Integer, Float, String -> pass through
  • Symbol -> string (except true/false/nil which are not symbols in Ruby)
  • Array -> recursive encode
  • Hash -> recursive encode values (keys to strings)
  • Type module instances (Padding::Pad, Border::Spec, etc.) -> call to_wire
  • Unknown -> raise (fail-fast, no silent passthrough)

Class Method Summary collapse

Class Method Details

.encode_value(value) ⇒ Object

Encode a value for the wire protocol.

Parameters:

  • value (Object) —

    any Ruby value

Returns:

  • (Object) —

    wire-safe value



23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/plushie/encode.rb', line 23

def encode_value(value)
  case value
  when true, false, nil, Integer, Float
    value
  when String
    value
  when Symbol
    value.to_s
  when Array
    value.map { |v| encode_value(v) }
  when Hash
    value.each_with_object({}) do |(k, v), h|
      h[k.is_a?(Symbol) ? k.to_s : k] = encode_value(v)
    end
  else
    # Check for types that respond to to_wire (our typed structs)
    if value.respond_to?(:to_wire)
      encode_value(value.to_wire)
    elsif value.respond_to?(:to_h)
      encode_value(value.to_h)
    else
      raise ArgumentError,
        "cannot encode #{value.class} for wire protocol: #{value.inspect}. " \
        "Implement #to_wire or convert to a primitive type."
    end
  end
end