Class: Facter::Util::Confine

Inherits:
Object
  • Object
show all
Includes:
Values
Defined in:
lib/facter/util/confine.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Values

convert, deep_freeze, deep_merge, flatten_structure

Constructor Details

#initialize(fact = nil, *values, &block) ⇒ Confine

Add the restriction. Requires the fact name, an operator, and the value we’re comparing to.

Parameters:

  • fact (Symbol) (defaults to: nil)

    Name of the fact

  • values (Array)

    One or more values to match against. They can be any type that provides a === method.

  • block (Proc)

    Alternatively a block can be supplied as a check. The fact value will be passed as the argument to the block. If the block returns true then the fact will be enabled, otherwise it will be disabled.

Raises:

  • (ArgumentError)


20
21
22
23
24
25
26
27
28
# File 'lib/facter/util/confine.rb', line 20

def initialize(fact = nil, *values, &block)
  raise ArgumentError, "The fact name must be provided" unless fact or block_given?
  if values.empty? and not block_given?
    raise ArgumentError, "One or more values or a block must be provided"
  end
  @fact = fact
  @values = values
  @block = block
end

Instance Attribute Details

#factObject



7
8
9
# File 'lib/facter/util/confine.rb', line 7

def fact
  @fact
end

#valuesObject



7
8
9
# File 'lib/facter/util/confine.rb', line 7

def values
  @values
end

Instance Method Details

#to_sObject



30
31
32
33
# File 'lib/facter/util/confine.rb', line 30

def to_s
  return @block.to_s if @block
  return "'%s' '%s'" % [@fact, @values.join(",")]
end

#true?Boolean

Evaluate the fact, returning true or false. if we have a block paramter then we only evaluate that instead

Returns:

  • (Boolean)


37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# File 'lib/facter/util/confine.rb', line 37

def true?
  if @block and not @fact then
    begin
      return !! @block.call
    rescue StandardError => error
      Facter.debug "Confine raised #{error.class} #{error}"
      return false
    end
  end

  unless fact = Facter[@fact]
    Facter.debug "No fact for %s" % @fact
    return false
  end
  value = convert(fact.value)

  return false if value.nil?

  if @block then
    begin
      return !! @block.call(value)
    rescue StandardError => error
      Facter.debug "Confine raised #{error.class} #{error}"
      return false
    end
  end

  return @values.any? do |v| convert(v) === value end
end