Class: Fulmar::Shell

Inherits:
Object
  • Object
show all
Defined in:
lib/fulmar/shell.rb

Overview

Implements simple access to shell commands

Constant Summary collapse

VERSION = 
'1.6.3'
DEFAULT_OPTIONS = 
{
  login: false,
  bundler: true #
}

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(path = '.', host = 'localhost') ⇒ Shell

Returns a new instance of Shell.



18
19
20
21
22
23
24
25
26
27
28
 
# File 'lib/fulmar/shell.rb', line 18

def initialize(path = '.', host = 'localhost')
  @host = host.nil? ? 'no_hostname_set' : host
  @path = (path.nil? || path.empty?) ? '.' : path
  @path = File.expand_path(@path) if local?
  @last_output = []
  @last_error = []
  @debug = false
  @quiet = false
  @strict = false
  @clean_environment = [] # list of things to clean from environment variables
end

Instance Attribute Details

#debug ⇒ Object

Returns the value of attribute debug.



10
11
12
 
# File 'lib/fulmar/shell.rb', line 10

def debug
  @debug
end

#last_error ⇒ Object

Returns the value of attribute last_error.



10
11
12
 
# File 'lib/fulmar/shell.rb', line 10

def last_error
  @last_error
end

#last_output ⇒ Object

Returns the value of attribute last_output.



10
11
12
 
# File 'lib/fulmar/shell.rb', line 10

def last_output
  @last_output
end

#path ⇒ Object

Returns the value of attribute path.



11
12
13
 
# File 'lib/fulmar/shell.rb', line 11

def path
  @path
end

#quiet ⇒ Object

Returns the value of attribute quiet.



10
11
12
 
# File 'lib/fulmar/shell.rb', line 10

def quiet
  @quiet
end

#strict ⇒ Object

Returns the value of attribute strict.



10
11
12
 
# File 'lib/fulmar/shell.rb', line 10

def strict
  @strict
end

Instance Method Details

#local? ⇒ Boolean

Returns:

  • (Boolean) 


59
60
61
 
# File 'lib/fulmar/shell.rb', line 59

def local?
  @host == 'localhost'
end

#run(command, options = DEFAULT_OPTIONS) ⇒ Object 



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
 
# File 'lib/fulmar/shell.rb', line 30

def run(command, options = DEFAULT_OPTIONS)
  reset_output
  command = [command] if command.class == String

  # is a custom path given?
  if options[:in]
    # is it absolute?
    path = options[:in][0, 1] == '/' ? options[:in] : "#{@path}/#{options[:in]}"
  else
    path = @path
  end

  options[:error_message] ||= 'Last shell command returned an error.'

  command.unshift "cd #{path}"

  # invoke a login shell?
  shell_command = shell_command(options[:login])

  @clean_environment << 'bundler' if options[:escape_bundler]

  if local?
    execute("#{shell_command} '#{escape_for_sh(command.join(' && '))}'", options[:error_message])
  else
    remote_command = escape_for_sh("#{shell_command} '#{escape_for_sh(command.join(' && '))}'")
    execute("ssh #{@host} '#{remote_command}'", options[:error_message])
  end
end