Class: Factrey::Blueprint::Node

Inherits:
Object
  • Object
show all
Defined in:
lib/factrey/blueprint/node.rb

Overview

A node corresponds to an object to be created. A Factrey::Blueprint consists of a set of nodes.

Constant Summary collapse

ANONYMOUS_NAME_PREFIX =

A name prefix given to anonymous nodes for convenience.

"_anon_"
RESULT_NAME =

Name used for the node that hold the results of the blueprint.

:_result_

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, type, parent: nil, args: [], kwargs: {}) ⇒ Node

Returns a new instance of Node.

Raises:

  • (TypeError) 


25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/factrey/blueprint/node.rb', line 25

def initialize(name, type, parent: nil, args: [], kwargs: {})
  raise TypeError, "name must be a Symbol" if name && !name.is_a?(Symbol)
  raise TypeError, "type must be a Blueprint::Type" unless type.is_a? Blueprint::Type
  raise TypeError, "parent must be a Node" if parent && !parent.is_a?(Node)
  raise TypeError, "args must be an Array" unless args.is_a? Array
  raise TypeError, "kwargs must be a Hash" unless kwargs.is_a? Hash

  @name = name || :"#{ANONYMOUS_NAME_PREFIX}#{SecureRandom.hex(6)}"
  @type = type
  @parent = parent
  @args = args
  @kwargs = kwargs
end

Instance Attribute Details

#args ⇒ Array<Object> (readonly) 



21
22
23
 
# File 'lib/factrey/blueprint/node.rb', line 21

def args
  @args
end

#kwargs ⇒ Hash{Object => Object} (readonly) 



23
24
25
 
# File 'lib/factrey/blueprint/node.rb', line 23

def kwargs
  @kwargs
end

#name ⇒ Symbol (readonly) 



15
16
17
 
# File 'lib/factrey/blueprint/node.rb', line 15

def name
  @name
end

#parent ⇒ Node? (readonly) 



19
20
21
 
# File 'lib/factrey/blueprint/node.rb', line 19

def parent
  @parent
end

#type ⇒ Type (readonly) 



17
18
19
 
# File 'lib/factrey/blueprint/node.rb', line 17

def type
  @type
end

Class Method Details

.computed(name, value, parent: nil) ⇒ Object 



42
43
44
 
# File 'lib/factrey/blueprint/node.rb', line 42

def self.computed(name, value, parent: nil)
  new(name, Blueprint::Type::COMPUTED, parent:, args: [value])
end

Instance Method Details

#alias_ref ⇒ Ref? 



56
57
58
59
60
61
62
63
 
# File 'lib/factrey/blueprint/node.rb', line 56

def alias_ref
  case [type, args]
  in Blueprint::Type::COMPUTED, [Ref => ref]
    ref
  else
    nil
  end
end

#ancestors ⇒ Array<Node> 



66
 
# File 'lib/factrey/blueprint/node.rb', line 66

def ancestors = parent ? [parent].concat(parent.ancestors) : []

#anonymous? ⇒ Boolean 



47
 
# File 'lib/factrey/blueprint/node.rb', line 47

def anonymous? = name.start_with?(ANONYMOUS_NAME_PREFIX)

#auto_referenced_ancestors ⇒ Hash{Symbol => Node} 



69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/factrey/blueprint/node.rb', line 69

def auto_referenced_ancestors
  ancestors = self.ancestors
  candidates = {}
  type.auto_references.each do |type_name, attribute|
    next if kwargs.member? attribute # this attribute is explicitly specified

    # closer ancestors have higher (lower integer) priority
    compatible_node, priority = ancestors.each_with_index.find do |node, _|
      node.type.compatible_types.include?(type_name)
    end
    next unless compatible_node
    next if candidates.member?(attribute) && candidates[attribute][0] <= priority

    candidates[attribute] = [priority, compatible_node]
  end

  candidates.transform_values { _2 }
end

#result? ⇒ Boolean 



50
 
# File 'lib/factrey/blueprint/node.rb', line 50

def result? = name == RESULT_NAME

#to_ref ⇒ Ref 



53
 
# File 'lib/factrey/blueprint/node.rb', line 53

def to_ref = Ref.new(name)

#type_annotated_name ⇒ String

Used for debugging and error reporting.



90
 
# File 'lib/factrey/blueprint/node.rb', line 90

def type_annotated_name = "#{name}(#{type.name})"