Class: Bolt::Target

Inherits:
Object
  • Object
show all
Defined in:
lib/bolt/target.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(uri, options = nil) ⇒ Target

Returns a new instance of Target.



16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/bolt/target.rb', line 16

def initialize(uri, options = nil)
  @uri = uri
  @uri_obj = parse(uri)
  @options = options || {}
  @options.freeze

  if @options['user']
    @user = @options['user']
  end

  if @options['password']
    @password = @options['password']
  end

  if @options['port']
    @port = @options['port']
  end

  if @options['protocol']
    @protocol = @options['protocol']
  end
end

Instance Attribute Details

#inventory=(value) ⇒ Object (writeonly)

Sets the attribute inventory

Parameters:

  • value —

    the value to set the attribute inventory to.



9
10
11
 
# File 'lib/bolt/target.rb', line 9

def inventory=(value)
  @inventory = value
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



8
9
10
 
# File 'lib/bolt/target.rb', line 8

def options
  @options
end

#uri ⇒ Object (readonly)

Returns the value of attribute uri.



8
9
10
 
# File 'lib/bolt/target.rb', line 8

def uri
  @uri
end

Class Method Details

.from_asserted_hash(hash) ⇒ Object

Satisfies the Puppet datatypes API



12
13
14
 
# File 'lib/bolt/target.rb', line 12

def self.from_asserted_hash(hash)
  new(hash['uri'], hash['options'])
end

Instance Method Details

#eql?(other) ⇒ Boolean Also known as: ==

Returns:

  • (Boolean) 


72
73
74
 
# File 'lib/bolt/target.rb', line 72

def eql?(other)
  self.class.equal?(other.class) && @uri == other.uri
end

#features ⇒ Object 



64
65
66
67
68
69
70
 
# File 'lib/bolt/target.rb', line 64

def features
  if @inventory
    @inventory.features(self)
  else
    Set.new
  end
end

#hash ⇒ Object 



77
78
79
 
# File 'lib/bolt/target.rb', line 77

def hash
  @uri.hash ^ @options.hash
end

#host ⇒ Object 



85
86
87
 
# File 'lib/bolt/target.rb', line 85

def host
  @uri_obj.hostname
end

#name ⇒ Object

name is currently just uri but should be used instead to identify the Target ouside the transport or uri options.



91
92
93
 
# File 'lib/bolt/target.rb', line 91

def name
  uri
end

#password ⇒ Object 



107
108
109
 
# File 'lib/bolt/target.rb', line 107

def password
  Addressable::URI.unencode_component(@uri_obj.password) || @password
end

#port ⇒ Object 



95
96
97
 
# File 'lib/bolt/target.rb', line 95

def port
  @uri_obj.port || @port
end

#protocol ⇒ Object 



99
100
101
 
# File 'lib/bolt/target.rb', line 99

def protocol
  @uri_obj.scheme || @protocol
end

#to_s ⇒ Object 



81
82
83
 
# File 'lib/bolt/target.rb', line 81

def to_s
  "Target('#{@uri}', #{@options})"
end

#update_conf(conf) ⇒ Object 



39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/bolt/target.rb', line 39

def update_conf(conf)
  @protocol = conf[:transport]

  t_conf = conf[:transports][protocol.to_sym]
  # Override url methods
  @user = t_conf['user']
  @password = t_conf['password']
  @port = t_conf['port']

  url_keys = %w[user password port]
  @options = t_conf.reject { |k, _| url_keys.include?(k) }.merge(@options)

  self
end

#user ⇒ Object 



103
104
105
 
# File 'lib/bolt/target.rb', line 103

def user
  Addressable::URI.unencode_component(@uri_obj.user) || @user
end