Module: Structure

Defined in:
lib/structure.rb,
lib/structure/types.rb,
lib/structure/builder.rb,
lib/structure/version.rb

Overview

A library for parsing data into immutable Ruby Data objects with type coercion

Defined Under Namespace

Modules: Types Classes: Builder

Constant Summary collapse

VERSION = 
"3.0.0"

Class Method Summary collapse

Class Method Details

.new(&block) ⇒ Object 



8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
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
50
51
52
53
54
55
 
# File 'lib/structure.rb', line 8

def new(&block)
  builder = Builder.new
  builder.instance_eval(&block) if block

  data_class = Data.define(*builder.attributes)

  # Generate predicate methods
  builder.predicate_methods.each do |predicate_name, attribute_name|
    data_class.define_method(predicate_name) do
      send(attribute_name)
    end
  end

  # Capture builder data in closure for parse method
  mappings = builder.mappings
  types = builder.types
  defaults = builder.defaults
  attributes = builder.attributes

  data_class.define_singleton_method(:parse) do |data = {}, **kwargs|
    # Merge kwargs into data - kwargs take priority as overrides
    # Convert kwargs symbol keys to strings to match source_key lookups
    string_kwargs = kwargs.transform_keys(&:to_s)
    data = data.merge(string_kwargs)

    final_kwargs = {}
    attributes.each do |attr|
      source_key = mappings[attr]
      value = if data.key?(source_key)
        data[source_key]
      elsif data.key?(source_key.to_sym)
        data[source_key.to_sym]
      elsif defaults.key?(attr)
        defaults[attr]
      end

      # Apply type coercion or transformation
      if types[attr] && !value.nil?
        value = types[attr].call(value)
      end

      final_kwargs[attr] = value
    end
    new(**final_kwargs)
  end

  data_class
end