Class: Net::SSH::Test::Channel

Inherits:
Object
  • Object
show all
Defined in:
lib/net/ssh/test/channel.rb

Overview

A mock channel, used for scripting actions in tests. It wraps a Net::SSH::Test::Script instance, and delegates to it for the most part. This class has little real functionality on its own, but rather acts as a convenience for scripting channel-related activity for later comparison in a unit test.

story do |session|
  channel = session.opens_channel
  channel.sends_exec "ls"
  channel.gets_data "result of ls"
  channel.gets_extended_data "some error coming from ls"
  channel.gets_close
  channel.sends_close
end

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(script) ⇒ Channel

Creates a new Test::Channel instance on top of the given script (which must be a Net::SSH::Test::Script instance).



30
31
32
33
 
# File 'lib/net/ssh/test/channel.rb', line 30

def initialize(script)
  @script = script
  @local_id = @remote_id = nil
end

Instance Attribute Details

#local_id ⇒ Object

Returns the local (client-assigned) id for this channel, or a Proc object that will return the local-id later if the local id has not yet been set. (See Net::SSH::Test::Packet#instantiate!.)



38
39
40
 
# File 'lib/net/ssh/test/channel.rb', line 38

def local_id
  @local_id || Proc.new { @local_id or raise "local-id has not been set yet!" }
end

#remote_id ⇒ Object

Returns the remote (server-assigned) id for this channel, or a Proc object that will return the remote-id later if the remote id has not yet been set. (See Net::SSH::Test::Packet#instantiate!.)



45
46
47
 
# File 'lib/net/ssh/test/channel.rb', line 45

def remote_id
  @remote_id || Proc.new { @remote_id or raise "remote-id has not been set yet!" }
end

#script ⇒ Object (readonly)

The Net::SSH::Test::Script instance employed by this mock channel.



20
21
22
 
# File 'lib/net/ssh/test/channel.rb', line 20

def script
  @script
end

Instance Method Details

#gets_close ⇒ Object

Scripts the reception of a “channel close” packet from the remote end.

channel.gets_close



141
142
143
 
# File 'lib/net/ssh/test/channel.rb', line 141

def gets_close
  script.gets_channel_close(self)
end

#gets_data(data) ⇒ Object

Scripts the reception of a channel data packet from the remote end.

channel.gets_data "bar"



112
113
114
 
# File 'lib/net/ssh/test/channel.rb', line 112

def gets_data(data)
  script.gets_channel_data(self, data)
end

#gets_eof ⇒ Object

Scripts the reception of an EOF packet from the remote end.

channel.gets_eof



134
135
136
 
# File 'lib/net/ssh/test/channel.rb', line 134

def gets_eof
  script.gets_channel_eof(self)
end

#gets_exit_status(status = 0) ⇒ Object

Scripts the reception of an “exit-status” channel request packet.

channel.gets_exit_status(127)



127
128
129
 
# File 'lib/net/ssh/test/channel.rb', line 127

def gets_exit_status(status = 0)
  script.gets_channel_request(self, "exit-status", false, status)
end

#gets_extended_data(data) ⇒ Object

Scripts the reception of a channel extended data packet from the remote end.

channel.gets_extended_data "whoops"



120
121
122
 
# File 'lib/net/ssh/test/channel.rb', line 120

def gets_extended_data(data)
  script.gets_channel_extended_data(self, data)
end

#inject_remote_delay! ⇒ Object

Because adjacent calls to #gets_data will sometimes cause the data packets to be concatenated (causing expectations in tests to fail), you may need to separate those calls with calls to #inject_remote_delay! (which essentially just mimics receiving an empty data packet):

channel.gets_data "abcdefg"
channel.inject_remote_delay!
channel.gets_data "hijklmn"



57
58
59
 
# File 'lib/net/ssh/test/channel.rb', line 57

def inject_remote_delay!
  gets_data("")
end

#sends_close ⇒ Object

Scripts the sending of a “channel close” packet across the channel.

channel.sends_close



98
99
100
 
# File 'lib/net/ssh/test/channel.rb', line 98

def sends_close
  script.sends_channel_close(self)
end

#sends_data(data) ⇒ Object

Scripts the sending of a data packet across the channel.

channel.sends_data "foo"



84
85
86
 
# File 'lib/net/ssh/test/channel.rb', line 84

def sends_data(data)
  script.sends_channel_data(self, data)
end

#sends_eof ⇒ Object

Scripts the sending of an EOF packet across the channel.

channel.sends_eof



91
92
93
 
# File 'lib/net/ssh/test/channel.rb', line 91

def sends_eof
  script.sends_channel_eof(self)
end

#sends_exec(command, reply = true, success = true) ⇒ Object

Scripts the sending of an “exec” channel request packet to the mock server. If reply is true, then the server is expected to reply to the request, otherwise no response to this request will be sent. If success is true, then the request will be successful, otherwise a failure will be scripted.

channel.sends_exec "ls -l"



68
69
70
 
# File 'lib/net/ssh/test/channel.rb', line 68

def sends_exec(command, reply = true, success = true)
  script.sends_channel_request(self, "exec", reply, command, success)
end

#sends_request_pty ⇒ Object

Scripts the sending of a “request pty” request packet across the channel.

channel.sends_request_pty



105
106
107
 
# File 'lib/net/ssh/test/channel.rb', line 105

def sends_request_pty
  script.sends_channel_request_pty(self)
end

#sends_subsystem(subsystem, reply = true, success = true) ⇒ Object

Scripts the sending of a “subsystem” channel request packet to the mock server. See #sends_exec for a discussion of the meaning of the reply and success arguments.

channel.sends_subsystem "sftp"



77
78
79
 
# File 'lib/net/ssh/test/channel.rb', line 77

def sends_subsystem(subsystem, reply = true, success = true)
  script.sends_channel_request(self, "subsystem", reply, subsystem, success)
end