summaryrefslogtreecommitdiff
path: root/pkg/net-ssh-multi-1.1/lib/net/ssh/multi/subsession.rb
diff options
context:
space:
mode:
Diffstat (limited to 'pkg/net-ssh-multi-1.1/lib/net/ssh/multi/subsession.rb')
-rw-r--r--pkg/net-ssh-multi-1.1/lib/net/ssh/multi/subsession.rb48
1 files changed, 48 insertions, 0 deletions
diff --git a/pkg/net-ssh-multi-1.1/lib/net/ssh/multi/subsession.rb b/pkg/net-ssh-multi-1.1/lib/net/ssh/multi/subsession.rb
new file mode 100644
index 0000000..29e7866
--- /dev/null
+++ b/pkg/net-ssh-multi-1.1/lib/net/ssh/multi/subsession.rb
@@ -0,0 +1,48 @@
+require 'net/ssh/multi/session_actions'
+
+module Net; module SSH; module Multi
+
+ # A trivial class for representing a subset of servers. It is used
+ # internally for restricting operations to a subset of all defined
+ # servers.
+ #
+ # subsession = session.with(:app)
+ # subsession.exec("hostname")
+ class Subsession
+ include SessionActions
+
+ # The master session that spawned this subsession.
+ attr_reader :master
+
+ # The list of servers that this subsession can operate on.
+ attr_reader :servers
+
+ # Create a new subsession of the given +master+ session, that operates
+ # on the given +server_list+.
+ def initialize(master, server_list)
+ @master = master
+ @servers = server_list.uniq
+ end
+
+ # Works as Array#slice, but returns a new subsession consisting of the
+ # given slice of servers in this subsession. The new subsession will have
+ # the same #master session as this subsession does.
+ #
+ # s1 = subsession.slice(0)
+ # s2 = subsession.slice(3, -1)
+ # s3 = subsession.slice(1..4)
+ def slice(*args)
+ Subsession.new(master, Array(servers.slice(*args)))
+ end
+
+ # Returns a new subsession that consists of only the first server in the
+ # server list of the current subsession. This is just convenience for
+ # #slice(0):
+ #
+ # s1 = subsession.first
+ def first
+ slice(0)
+ end
+ end
+
+end; end; end \ No newline at end of file