Class: Runfile::Runner

Inherits:
Object
  • Object
show all
Includes:
SettingsMixin, Singleton
Defined in:
lib/runfile/runner.rb

Overview

The Runner class is the main workhorse behind Runfile. It handles all the Runfile DSL commands and executes the Runfile with the help of two more specialized classes:

  1. DocoptHelper - for deeper docopt related actions

  2. RunfileHelper - for Runfile creation and system wide search

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from SettingsMixin

#settings

Constructor Details

#initialize ⇒ Runner

Initialize all variables to sensible defaults.



19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/runfile/runner.rb', line 19

def initialize
  @superspace = nil     # used when filename != Runfile
  @last_usage = nil     # dsl: usage
  @last_help  = nil     # dsl: help
  @namespace  = nil     # dsl: command
  @actions  = {}        # dsl: action
  @options  = {}        # dsl: option
  @examples = []        # dsl: example
  @name     = "Runfile" # dsl: name
  @version  = false     # dsl: version
  @summary  = false     # dsl: summary
end

Instance Attribute Details

#last_help ⇒ Object

Returns the value of attribute last_help.



15
16
17
 
# File 'lib/runfile/runner.rb', line 15

def last_help
  @last_help
end

#last_usage ⇒ Object

Returns the value of attribute last_usage.



15
16
17
 
# File 'lib/runfile/runner.rb', line 15

def last_usage
  @last_usage
end

#name ⇒ Object

Returns the value of attribute name.



15
16
17
 
# File 'lib/runfile/runner.rb', line 15

def name
  @name
end

#namespace ⇒ Object

Returns the value of attribute namespace.



15
16
17
 
# File 'lib/runfile/runner.rb', line 15

def namespace
  @namespace
end

#summary ⇒ Object

Returns the value of attribute summary.



15
16
17
 
# File 'lib/runfile/runner.rb', line 15

def summary
  @summary
end

#superspace ⇒ Object

Returns the value of attribute superspace.



15
16
17
 
# File 'lib/runfile/runner.rb', line 15

def superspace
  @superspace
end

#version ⇒ Object

Returns the value of attribute version.



15
16
17
 
# File 'lib/runfile/runner.rb', line 15

def version
  @version
end

Instance Method Details

#add_action(name, altname = nil, &block) ⇒ Object

Add an action to the @actions array, and use the last known usage and help messages sent by the DSL.



47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/runfile/runner.rb', line 47

def add_action(name, altname=nil, &block)
  if @last_usage.nil?
    @last_usage = altname ? "(#{name}|#{altname})" : name 
  end
  [@namespace, @superspace].each do |prefix|
    prefix or next
    name = "#{prefix}_#{name}"
    @last_usage = "#{prefix} #{last_usage}" unless @last_usage == false
  end
  name = name.to_sym
  @actions[name] = Action.new(block, @last_usage, @last_help)
  @last_usage = nil
  @last_help = nil
  if altname 
    @last_usage = false
    add_action(altname, nil, &block)
  end
end

#add_example(command) ⇒ Object

Add example command.



74
75
76
 
# File 'lib/runfile/runner.rb', line 74

def add_example(command)
  @examples << (@namespace ? "#{@namespace} #{command}" : command)
end

#add_option(flag, text, scope = nil) ⇒ Object

Add an option flag and its help text.



67
68
69
70
71
 
# File 'lib/runfile/runner.rb', line 67

def add_option(flag, text, scope=nil)
  scope or scope = 'Options'
  @options[scope] ||= {}
  @options[scope][flag] = text
end

#cross_call(command_string) ⇒ Object

Invoke action from another action. Used by the DSL’s #call function. Expects to get a single string that looks as if it was typed in the command prompt.



92
93
94
95
96
97
98
99
100
 
# File 'lib/runfile/runner.rb', line 92

def cross_call(command_string) 
  argv = command_string.split /\s(?=(?:[^"]|"[^"]*")*$)/
  begin
    docopt_exec argv
  rescue Docopt::Exit => ex
    puts "Cross call failed: #{command_string}"
    abort ex.message
  end
end

#execute(argv, filename = 'Runfile') ⇒ Object

Load and execute a Runfile call.



33
34
35
36
37
38
39
40
41
42
43
 
# File 'lib/runfile/runner.rb', line 33

def execute(argv, filename='Runfile')
  @ignore_settings = !filename
  filename and File.file?(filename) or handle_no_runfile argv
  begin
    load settings.helper if settings.helper
    load filename
  rescue => ex
    abort "Runfile error:\n#{ex.message}\n#{ex.backtrace[0]}"
  end
  run *argv
end

#run(*argv) ⇒ Object

Run the command. This is a wrapper around docopt. It will generate the docopt document on the fly, using all the information collected so far.



81
82
83
84
85
86
87
 
# File 'lib/runfile/runner.rb', line 81

def run(*argv)
  begin
    docopt_exec argv
  rescue Docopt::Exit => ex
    puts ex.message
  end
end