Class Net::SSH::Multi::DynamicServer
In: lib/net/ssh/multi/dynamic_server.rb
Parent: Object

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.

Methods

[]   []=   each   evaluate!   new   to_ary  

Attributes

callback  [R]  The Proc object to call to evaluate the server(s)
master  [R]  The Net::SSH::Multi::Session instance that owns this dynamic server record.
options  [R]  The hash of options that will be used to initialize the server records.

Public Class methods

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.

Public Instance methods

Returns the value for the given key in the :properties hash of the options. If no :properties hash exists in options, this returns nil.

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.

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!).

Evaluates the callback and instantiates the servers, memoizing the result. Subsequent calls to evaluate! will simply return the cached list of servers.

to_ary()

Alias for evaluate!

[Validate]