File: driver.rb

package info (click to toggle)
libnet-ssh-ruby 1.1.2-1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 3,472 kB
  • ctags: 2,465
  • sloc: ruby: 10,848; makefile: 17
file content (86 lines) | stat: -rw-r--r-- 2,680 bytes parent folder | download | duplicates (3)
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
#--
# =============================================================================
# Copyright (c) 2004,2005 Jamis Buck (jamis@37signals.com)
# All rights reserved.
#
# This source file is distributed as part of the Net::SSH Secure Shell Client
# library for Ruby. This file (and the library as a whole) may be used only as
# allowed by either the BSD license, or the Ruby license (or, by association
# with the Ruby license, the GPL). See the "doc" subdirectory of the Net::SSH
# distribution for the texts of these licenses.
# -----------------------------------------------------------------------------
# net-ssh website : http://net-ssh.rubyforge.org
# project website: http://rubyforge.org/projects/net-ssh
# =============================================================================
#++

module Net
  module SSH
    module Service
      module Shell

        # The service driver for the Shell service. It manages the creation of
        # new Shell::Shell and Shell::SyncShell subservices.
        #
        # Usage:
        #
        #   Net::SSH.start( host ) do |session|
        #     shell = session.shell.open
        #
        #     shell.cd "/home/foo"
        #     shell.mkdir "-p some/long/dir"
        #     shell.cd "some/long/dir"
        #     shell.touch "foo.txt"
        #     shell.exit
        #
        #     session.loop
        #   end
        #
        # Or:
        #
        #   Net::SSH.start( host ) do |session|
        #     shell = session.shell.sync
        #
        #     shell.cd "/home/foo"
        #
        #     out = shell.test "-e some/file.txt"
        #     if out.status == 0
        #       out = shell.cat "some/file.txt"
        #       puts out.stdout
        #     else
        #       puts "no such file 'some/file.txt'"
        #     end
        #
        #   end
        class Driver

          # Create a new driver with the given logger and shell and
          # sync factories.
          def initialize( log, shell_factory, sync_factory )
            @log = log
            @shell_factory = shell_factory
            @sync_factory = sync_factory
          end

          # Open a new shell, using the Shell::Shell subservice and
          # the given options.
          def open( options={} )
            pty_opts = options[:pty]

            @shell_factory.call( pty_opts )
          end
          
          # Open a new shell, using the Shell::SyncShell subservice and
          # the given options.
          def sync( options={} )
            pty_opts = options[:pty]

            @sync_factory.call( pty_opts )
          end
          
        end

      end # Shell
    end # Service
  end # SSH
end # Net