Class: Cmds::Result

Inherits:
Object
  • Object
show all
Defined in:
lib/cmds/result.rb

Overview

A simple data structure returned from calling #capture on a Cmds instance.

It contains the exit status code, standard output and standard error, as well as the actual string command issued (after all substitutions).

Instances also have a few convenience methods.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(cmd, status, out, err) ⇒ Result

Returns a new instance of Result.

Parameters:

  • cmd (String) —

    #cmd attribute.

  • status (Fixnum) —

    #status attribute.

  • out (String) —

    #out attribute.

  • err (String) —

    #err attribute.



46
47
48
49
50
51
 
# File 'lib/cmds/result.rb', line 46

def initialize cmd, status, out, err
  @cmd = cmd
  @status = status
  @out = out
  @err = err
end

Instance Attribute Details

#cmd ⇒ String (readonly)

The command string that was executed.

Returns:

  • (String) 


18
19
20
 
# File 'lib/cmds/result.rb', line 18

def cmd
  @cmd
end

#err ⇒ String (readonly)

The command process' standard error.

Returns:

  • (String) 


39
40
41
 
# File 'lib/cmds/result.rb', line 39

def err
  @err
end

#out ⇒ String (readonly)

The command process' standard output.

Returns:

  • (String) 


32
33
34
 
# File 'lib/cmds/result.rb', line 32

def out
  @out
end

#status ⇒ Fixnum (readonly)

The command process' exit status code.

Returns:

  • (Fixnum) 


25
26
27
 
# File 'lib/cmds/result.rb', line 25

def status
  @status
end

Instance Method Details

#assert ⇒ Result

Raises an error if the command failed (exited with a #status other than 0).

Returns:

  • (Result) —

    it's self (so that it can be chained).

Raises:

  • (SystemCallError) —

    if the command failed.



75
76
77
78
 
# File 'lib/cmds/result.rb', line 75

def assert
  Cmds.check_status @cmd, @status, @err
  self
end

#error? ⇒ Boolean

Returns true if #status is not 0.

Returns:

  • (Boolean) —

    true if #status is not 0.



63
64
65
 
# File 'lib/cmds/result.rb', line 63

def error?
  ! ok?
end

#ok? ⇒ Boolean

Returns true if #status is 0.

Returns:

  • (Boolean) —

    true if #status is 0.



56
57
58
 
# File 'lib/cmds/result.rb', line 56

def ok?
  @status == 0
end

#to_h ⇒ Hash<Symbol, V>

Get a Hash containing the instance variable values for easy logging, JSON dumping, etc.

Examples:

Cmds( "echo %s", "hey" ).to_h
# => {:cmd=>"echo hey", :status=>0, :out=>"hey\n", :err=>""}

Returns:

  • (Hash<Symbol, V>) 


90
91
92
93
94
 
# File 'lib/cmds/result.rb', line 90

def to_h
  instance_variables.map { |name|
    [name.to_s.sub('@', '').to_sym, instance_variable_get( name )]
  }.to_h
end