Class: SSHKit::Host

Inherits:
Object
  • Object
show all
Defined in:
lib/sshkit/host.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(host_string_or_options_hash) ⇒ Host

Returns a new instance of Host.



23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/sshkit/host.rb', line 23

def initialize(host_string_or_options_hash)

  unless host_string_or_options_hash.is_a?(Hash)
    suitable_parsers = [
      SimpleHostParser,
      HostWithPortParser,
      HostWithUsernameAndPortParser,
      IPv6HostWithPortParser,
      HostWithUsernameParser,
    ].select do |p|
      p.suitable?(host_string_or_options_hash)
    end

    if suitable_parsers.any?
      suitable_parsers.first.tap do |parser|
        @user, @hostname, @port = parser.new(host_string_or_options_hash).attributes
      end
    else
      raise UnparsableHostStringError, "Cannot parse host string #{host_string_or_options_hash}"
    end
  else
    host_string_or_options_hash.each do |key, value|
      if self.respond_to?("#{key}=")
        send("#{key}=", value)
      else
        raise ArgumentError, "Unknown host property #{key}"
      end
    end
  end
end

Instance Attribute Details

#hostname ⇒ Object

Returns the value of attribute hostname.



9
10
11
 
# File 'lib/sshkit/host.rb', line 9

def hostname
  @hostname
end

#password ⇒ Object

Returns the value of attribute password.



9
10
11
 
# File 'lib/sshkit/host.rb', line 9

def password
  @password
end

#port ⇒ Object

Returns the value of attribute port.



9
10
11
 
# File 'lib/sshkit/host.rb', line 9

def port
  @port
end

#ssh_options ⇒ Object

Returns the value of attribute ssh_options.



9
10
11
 
# File 'lib/sshkit/host.rb', line 9

def ssh_options
  @ssh_options
end

#user ⇒ Object

Returns the value of attribute user.



9
10
11
 
# File 'lib/sshkit/host.rb', line 9

def user
  @user
end

Instance Method Details

#eql?(other_host) ⇒ Boolean Also known as: ==, equal?

Returns:

  • (Boolean) 


62
63
64
 
# File 'lib/sshkit/host.rb', line 62

def eql?(other_host)
  other_host.hash == hash
end

#hash ⇒ Object 



54
55
56
 
# File 'lib/sshkit/host.rb', line 54

def hash
  user.hash ^ hostname.hash ^ port.hash
end

#key=(new_key) ⇒ Object 



11
12
13
 
# File 'lib/sshkit/host.rb', line 11

def key=(new_key)
  @keys = [new_key]
end

#keys ⇒ Object 



19
20
21
 
# File 'lib/sshkit/host.rb', line 19

def keys
  Array(@keys)
end

#keys=(new_keys) ⇒ Object 



15
16
17
 
# File 'lib/sshkit/host.rb', line 15

def keys=(new_keys)
  @keys = new_keys
end

#netssh_options ⇒ Object 



72
73
74
75
76
77
78
79
80
81
 
# File 'lib/sshkit/host.rb', line 72

def netssh_options
  {}.tap do |sho|
    sho[:keys]          = keys     if keys.any?
    sho[:port]          = port     if port
    sho[:user]          = user     if user
    sho[:password]      = password if password
    sho[:forward_agent] = true
  end
  .merge(ssh_options || {})
end

#properties ⇒ Object 



83
84
85
 
# File 'lib/sshkit/host.rb', line 83

def properties
  @properties ||= OpenStruct.new
end

#to_s ⇒ Object 



68
69
70
 
# File 'lib/sshkit/host.rb', line 68

def to_s
  hostname
end

#username ⇒ Object 



58
59
60
 
# File 'lib/sshkit/host.rb', line 58

def username
  user
end