Class: Puppet::Node::Facts

Inherits:
Object show all
Extended by:
Indirector
Includes:
Util::PsychSupport
Defined in:
lib/puppet/node/facts.rb

Overview

Manage a given node’s facts. This either accepts facts and stores them, or returns facts for a given node.

Defined Under Namespace

Modules: NodeExpirer Classes: Facter, Json, Memory, NetworkDevice, Rest, StoreConfigs, Yaml

Constant Summary

Constants included from Indirector

Indirector::BadNameRegexp

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Indirector

configure_routes, indirects

Methods included from Util::PsychSupport

#encode_with, #init_with

Constructor Details

#initialize(name, values = {}) ⇒ Facts

Returns a new instance of Facts.



36
37
38
39
40
41
 
# File 'lib/puppet/node/facts.rb', line 36

def initialize(name, values = {})
  @name = name
  @values = values

  add_timestamp
end

Instance Attribute Details

#name ⇒ Object

Returns the value of attribute name.



28
29
30
 
# File 'lib/puppet/node/facts.rb', line 28

def name
  @name
end

#timestamp ⇒ Object

Returns the value of attribute timestamp.



28
29
30
 
# File 'lib/puppet/node/facts.rb', line 28

def timestamp
  @timestamp
end

#values ⇒ Object

Returns the value of attribute values.



28
29
30
 
# File 'lib/puppet/node/facts.rb', line 28

def values
  @values
end

Class Method Details

.from_data_hash(data) ⇒ Object 



86
87
88
89
90
 
# File 'lib/puppet/node/facts.rb', line 86

def self.from_data_hash(data)
  new_facts = allocate
  new_facts.initialize_from_hash(data)
  new_facts
end

Instance Method Details

#==(other) ⇒ Object 



80
81
82
83
84
 
# File 'lib/puppet/node/facts.rb', line 80

def ==(other)
  return false unless name == other.name

  values == other.values
end

#add_extra_values(extra_values) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Add extra values, such as facts given to lookup on the command line. The extra values will override existing values.

Parameters:

  • extra_values (Hash{String=>Object}) —

    the values to add



67
68
69
70
 
# File 'lib/puppet/node/facts.rb', line 67

def add_extra_values(extra_values)
  @values.merge!(extra_values)
  nil
end

#add_local_facts ⇒ Object 



30
31
32
33
34
 
# File 'lib/puppet/node/facts.rb', line 30

def add_local_facts
  values["clientcert"] = Puppet.settings[:certname]
  values["clientversion"] = Puppet.version.to_s
  values["clientnoop"] = Puppet.settings[:noop]
end

#add_timestamp ⇒ Object 



117
118
119
 
# File 'lib/puppet/node/facts.rb', line 117

def add_timestamp
  @timestamp = Time.now
end

#initialize_from_hash(data) ⇒ Object 



43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/puppet/node/facts.rb', line 43

def initialize_from_hash(data)
  @name = data['name']
  @values = data['values']
  # Timestamp will be here in YAML, e.g. when reading old reports
  timestamp = @values.delete('_timestamp')
  # Timestamp will be here in JSON
  timestamp ||= data['timestamp']

  if timestamp.is_a? String
    @timestamp = Time.parse(timestamp)
  else
    @timestamp = timestamp
  end

  self.expiration = data['expiration']
  if expiration.is_a? String
    self.expiration = Time.parse(expiration)
  end
end

#sanitize ⇒ Object

Sanitize fact values by converting everything not a string, Boolean numeric, array or hash into strings.



74
75
76
77
78
 
# File 'lib/puppet/node/facts.rb', line 74

def sanitize
  values.each do |fact, value|
    values[fact] = sanitize_fact value
  end
end

#to_data_hash ⇒ Object 



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
 
# File 'lib/puppet/node/facts.rb', line 92

def to_data_hash
  result = {
    'name' => name,
    'values' => values
  }

  if @timestamp
    if @timestamp.is_a? Time
      result['timestamp'] = @timestamp.iso8601(9)
    else
      result['timestamp'] = @timestamp
    end
  end

  if expiration
    if expiration.is_a? Time
      result['expiration'] = expiration.iso8601(9)
    else
      result['expiration'] = expiration
    end
  end

  result
end

#to_yaml ⇒ Object 



121
122
123
124
 
# File 'lib/puppet/node/facts.rb', line 121

def to_yaml
  facts_to_display = Psych.parse_stream(YAML.dump(self))
  quote_special_strings(facts_to_display)
end