/usr/lib/ruby/vendor_ruby/net/ssh/multi/dynamic_server.rb is in ruby-net-ssh-multi 1.2.1-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 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 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 | require 'net/ssh/multi/server'
module Net; module SSH; module Multi
# Represents a lazily evaluated collection of servers. This will usually be
# created via Net::SSH::Multi::Session#use(&block), and is useful for creating
# server definitions where the name or address of the servers are not known
# until run-time.
#
# session.use { lookup_ip_address_of_server }
#
# This prevents +lookup_ip_address_of_server+ from being invoked unless the
# server is actually needed, at which point it is invoked and the result
# cached.
#
# The callback should return either +nil+ (in which case no new servers are
# instantiated), a String (representing a connection specification), an
# array of Strings, or an array of Net::SSH::Multi::Server instances.
class DynamicServer
# The Net::SSH::Multi::Session instance that owns this dynamic server record.
attr_reader :master
# The Proc object to call to evaluate the server(s)
attr_reader :callback
# The hash of options that will be used to initialize the server records.
attr_reader :options
# Create a new DynamicServer record, owned by the given Net::SSH::Multi::Session
# +master+, with the given hash of +options+, and using the given Proc +callback+
# to lazily evaluate the actual server instances.
def initialize(master, options, callback)
@master, @options, @callback = master, options, callback
@servers = nil
end
# Returns the value for the given +key+ in the :properties hash of the
# +options+. If no :properties hash exists in +options+, this returns +nil+.
def [](key)
(options[:properties] ||= {})[key]
end
# Sets the given key/value pair in the +:properties+ key in the options
# hash. If the options hash has no :properties key, it will be created.
def []=(key, value)
(options[:properties] ||= {})[key] = value
end
# Iterates over every instantiated server record in this dynamic server.
# If the servers have not yet been instantiated, this does nothing (e.g.,
# it does _not_ automatically invoke #evaluate!).
def each
(@servers || []).each { |server| yield server }
end
# Evaluates the callback and instantiates the servers, memoizing the result.
# Subsequent calls to #evaluate! will simply return the cached list of
# servers.
def evaluate!
@servers ||= Array(callback[options]).map do |server|
case server
when String then Net::SSH::Multi::Server.new(master, server, options)
else server
end
end
end
alias to_ary evaluate!
end
end; end; end
|