Module: A2A::Configuration::Inheritance

Included in:
A2A::Configuration
Defined in:
lib/a2a/configuration/inheritance.rb

Overview

Module for configuration inheritance support

Instance Method Summary collapse

Instance Method Details

#child(**overrides) ⇒ Configuration

Create a child configuration with inheritance

Parameters:

  • Configuration overrides

Returns:

  • New configuration instance



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
 
# File 'lib/a2a/configuration/inheritance.rb', line 10

def child(**overrides)
  # Create new instance without loading defaults to avoid overwriting parent values
  child_config = self.class.allocate
  child_config.instance_variable_set(:@environment, @environment)
  child_config.instance_variable_set(:@parent_config, self)
  child_config.instance_variable_set(:@overrides, overrides)
  child_config.instance_variable_set(:@config_file, nil)

  # Copy all instance variables from parent to child (deep copy for complex objects)
  instance_variables.each do |var|
    next if i[@parent_config @overrides @config_file].include?(var)

    value = instance_variable_get(var)
    # Deep copy arrays and hashes to prevent shared references
    copied_value = case value
                   when Array
                     value.dup
                   when Hash
                     value.dup
                   else
                     value
                   end
    child_config.instance_variable_set(var, copied_value)
  end

  # Apply overrides after copying parent values
  child_config.send(:apply_overrides, overrides)

  child_config
end

#get(key) ⇒ Object

Get configuration value with inheritance support

Parameters:

  • Configuration key

Returns:

  • Configuration value



44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/a2a/configuration/inheritance.rb', line 44

def get(key)
  # Convert key to instance variable name
  ivar_name = "@#{key}"

  # Check if we have the instance variable set
  if instance_variable_defined?(ivar_name)
    value = instance_variable_get(ivar_name)
    # Return value if it's not nil, or if we don't have a parent
    return value unless value.nil? && @parent_config
  end

  # Fall back to parent configuration if value is nil and parent exists
  @parent_config&.get(key)
end

#merge!(other) ⇒ self

Merge configuration from another configuration object

Parameters:

  • Configuration to merge from

Returns:



89
90
91
92
93
94
95
96
97
98
 
# File 'lib/a2a/configuration/inheritance.rb', line 89

def merge!(other)
  return self unless other.is_a?(A2A::Configuration)

  other.to_h.each do |key, value|
    setter = "#{key}="
    send(setter, value) if respond_to?(setter)
  end

  self
end

#validate_inheritance! ⇒ Boolean

Validate that child configuration properly inherits from parent

Returns:

  • true if inheritance is working correctly



61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
 
# File 'lib/a2a/configuration/inheritance.rb', line 61

def validate_inheritance!
  return true unless @parent_config

  # Check that we can access parent values when child values are nil
  parent_attrs = @parent_config.to_h
  parent_attrs.each do |key, parent_value|
    next if parent_value.nil?

    # Get child value directly (not through inheritance)
    child_ivar = "@#{key}"
    child_value = instance_variable_defined?(child_ivar) ? instance_variable_get(child_ivar) : nil

    # If child value is nil, get should return parent value
    next unless child_value.nil?

    inherited_value = get(key)
    unless inherited_value == parent_value
      raise A2A::Errors::ConfigurationError,
            "Inheritance failed for #{key}: expected #{parent_value.inspect}, got #{inherited_value.inspect}"
    end
  end

  true
end