Class: Build::Rule::Parameter

Inherits:
Object
  • Object
show all
Defined in:
lib/build/rule.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(direction, name, options = {}, &block) ⇒ Parameter

Returns a new instance of Parameter.



33
34
35
36
37
38
39
40
 
# File 'lib/build/rule.rb', line 33

def initialize(direction, name, options = {}, &block)
	@direction = direction
	@name = name
	
	@options = options
	
	@dynamic = block_given? ? Proc.new(&block) : nil
end

Instance Attribute Details

#direction ⇒ Object (readonly)

Returns the value of attribute direction.



42
43
44
 
# File 'lib/build/rule.rb', line 42

def direction
  @direction
end

#dynamic ⇒ Object (readonly)

Returns the value of attribute dynamic.



46
47
48
 
# File 'lib/build/rule.rb', line 46

def dynamic
  @dynamic
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



43
44
45
 
# File 'lib/build/rule.rb', line 43

def name
  @name
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



45
46
47
 
# File 'lib/build/rule.rb', line 45

def options
  @options
end

Instance Method Details

#applicable?(arguments) ⇒ Boolean

Returns:

  • (Boolean) 


74
75
76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/build/rule.rb', line 74

def applicable? arguments
	value = arguments.fetch(@name) do
		# Value couldn't be found, if it wasn't optional, this parameter didn't apply:
		return optional?
	end
	
	# If a pattern is provided, we must match it.
	if pattern = @options[:pattern]
		return Array(value).all? {|item| pattern.match(item)}
	end
	
	return true
end

#compute(arguments, scope) ⇒ Object 



88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/build/rule.rb', line 88

def compute(arguments, scope)
	if implicit?
		# Can be replaced if supplied:
		arguments[@name] || scope.instance_exec(arguments, &@dynamic) || @options[:default]
	elsif dynamic?
		# Argument is optional:
		scope.instance_exec(arguments[@name], arguments, &@dynamic) || @options[:default]
	elsif arguments.key?(@name)
		arguments[@name]
	else
		@options[:default]
	end
end

#default? ⇒ Boolean

Do we have a default value for this parameter?

Returns:

  • (Boolean) 


61
62
63
 
# File 'lib/build/rule.rb', line 61

def default?
	@options.key?(:default)
end

#dynamic? ⇒ Boolean

Returns:

  • (Boolean) 


56
57
58
 
# File 'lib/build/rule.rb', line 56

def dynamic?
	@dynamic != nil
end

#eql?(other) ⇒ Boolean

TODO fix implementation

Returns:

  • (Boolean) 


107
108
109
 
# File 'lib/build/rule.rb', line 107

def eql? other
	other.kind_of?(self.class) and @direction.eql?(other.direction) and @name.eql?(other.name) and @options.eql?(other.options) # and @dynamic == other.dynamic
end

#hash ⇒ Object 



102
103
104
 
# File 'lib/build/rule.rb', line 102

def hash
	[self.class, @direction, @name, @options].hash
end

#implicit? ⇒ Boolean

Returns:

  • (Boolean) 


65
66
67
 
# File 'lib/build/rule.rb', line 65

def implicit?
	dynamic? and @options[:implicit]
end

#input? ⇒ Boolean

Returns:

  • (Boolean) 


48
49
50
 
# File 'lib/build/rule.rb', line 48

def input?
	@direction == :input
end

#inspect ⇒ Object 



111
112
113
 
# File 'lib/build/rule.rb', line 111

def inspect
	"#{direction}:#{@name} (#{options.inspect})"
end

#optional? ⇒ Boolean

Optional parameters are those that are either defined as optional or implicit.

Returns:

  • (Boolean) 


70
71
72
 
# File 'lib/build/rule.rb', line 70

def optional?
	@options[:optional] || implicit? || default?
end

#output? ⇒ Boolean

Returns:

  • (Boolean) 


52
53
54
 
# File 'lib/build/rule.rb', line 52

def output?
	@direction == :output
end